Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
curl --request GET \
--url https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Exito",
"data": {
"codCpe": "09",
"numRuc": "20538878309",
"cantidad": null,
"codTipoCpe": "00",
"numSerie": "T004",
"observacion": null,
"numCpe": 9,
"codEstado": "02",
"desEstado": "Baja",
"emision": {
"fecEmision": "2024-05-15T00:00:00",
"indSEE": "2",
"indOrigen": "3",
"desNota": null,
"desHashQr": "dJrFNbxgXQWmXxr4BC1LQMp5vX/Aj8qqj8VGzi8pcO01nPkJ9ZcA6m4wVYrSLKd4xRcw4nizVVaozuYzxhDN9HxRNxqehXMUsbMlOHDb2kc=",
"desQr": "https://e-factura.sunat.gob.pe/v1/contribuyente/gre/comprobantes/descargaqr?hashqr=dJrFNbxgXQWmXxr4BC1LQMp5vX/Aj8qqj8VGzi8pcO01nPkJ9ZcA6m4wVYrSLKd4xRcw4nizVVaozuYzxhDN9HxRNxqehXMUsbMlOHDb2kc=",
"receptorObs": null,
"pse": null,
"firma": {
"idCertificado": "34b26f7af41589ac80",
"digestValue": "4mt0ivPSpPdgqCYBS+fkIMuVKSU=",
"fecFirma": null
},
"numIpCliente": null,
"numFecEmision": 20240515,
"numRangoHora": 0
},
"emisor": {
"desNombre": "INVERSIONES E & F AYALA Y ARIAS S.A.C.",
"numAutorizacionMtc": null,
"indEncSunNumAutorizacionMtc": null,
"indSubContratacion": "0",
"autorizacion": null,
"subContratador": null
},
"traslado": {
"codMotivoTraslado": "01",
"desMotivoTraslado": "Venta",
"desMotivoTrasladoOtros": null,
"fecInicioTraslado": "2024-05-15T00:00:00",
"numPlacaVehiculo": null,
"fecEntrega": null,
"indModalidadTraslado": "02",
"desModalidadTraslado": "Privado",
"indTrasladoVehiculo": "0",
"indTransbordo": "0",
"indRetornoVehicEnvEmbVacio": "0",
"indRetornoVehicVacio": "0",
"indPagadorFlete": "00",
"indTrasladoDua": "0",
"desTrasladoDua": "Parcial",
"indTrasladoTotalBienes": "0",
"numBultosPallets": null,
"desBien": null,
"codUnidadMedidaPb": "KGM",
"numPesoBruto": 839.6,
"numPesoBrutoItemsSel": null,
"desSustentoPesoBrutoItemsSel": "",
"contenedores": null,
"autorizacion": null,
"bien": [
{
"numOrden": 1,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "479",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "CHULETA DE LOMO",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 77.2,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 2,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "28",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "MOLIDA ESPECIAL",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 30,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 3,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "17",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "GUISO ESPECIAL",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 102.7,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 4,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "36",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "SANCOCHADO",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 156.1,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 5,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "16",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "GUISO CON HUESO",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 216.2,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 6,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "460",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "PIERNA FRESCA",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 257.4,
"indFrecuente": "0",
"docRelacionado": null
}
],
"partida": {
"indFrecuente": "0",
"direccion": {
"codUbigeo": "150103",
"desDepartamento": "LIMA ",
"desProvincia": "LIMA ",
"desDistrito": "ATE",
"desDireccion": "AV NICOLAS AYLLON 1217",
"contribuyente": {
"numEstablecimiento": 0,
"numRuc": null,
"desRuc": null
},
"puerto": null,
"numLatitud": null,
"numLongitud": null
}
},
"llegada": {
"indFrecuente": "0",
"direccion": {
"codUbigeo": "150509",
"desDepartamento": "LIMA ",
"desProvincia": "CAÑETE ",
"desDistrito": "MALA",
"desDireccion": "PANAMERICANA SUR KM 90",
"contribuyente": {
"numEstablecimiento": 0,
"numRuc": null,
"desRuc": null
},
"puerto": null,
"numLatitud": null,
"numLongitud": null
}
},
"pagadorFlete": null,
"vehiculo": [
{
"indTipoVehiculo": "1",
"desTipoVehiculo": "Principal",
"numPlaca": "BUI721",
"numTucChv": null,
"indTucChv": "4",
"indEncSunNumTucChv": "0",
"indFrecuente": "0",
"indEncSunNumPlaca": "0",
"autorizacion": null
}
],
"conductor": [
{
"indTipoOrden": "1",
"desTipoOrden": "Principal",
"codTipoDocIdentidad": "1",
"desTipoDocIdentidad": "DOCUMENTO NACIONAL DE IDENTIDAD",
"numDocIdentidad": "40700608",
"numLicencia": "Q40700608",
"desNombre": "YAÑE GAMONAL YONE",
"codEmisorLicencia": null,
"indFrecuente": "0",
"indEncSunNumLicencia": "1"
}
],
"proveedor": null,
"comprador": {
"codTipoDocIdentidad": "",
"desTipoDocIdentidad": "",
"numDocIdentidad": "",
"desNombre": "",
"indFrecuente": "0"
},
"transportista": null
},
"receptor": {
"codTipoDocIdentidad": "6",
"desTipoDocIdentidad": "REGISTRO ÚNICO DE CONTRIBUYENTES",
"numDocIdentidad": "20510631715",
"desNombre": "S.I.G. SERVICIOS GENERALES E.I.R.L.",
"indFrecuente": "0"
},
"remitente": null,
"docRelacionado": null,
"docGrePorEvento": null,
"baja": {
"fecRegistro": "2024-05-16T12:11:40",
"codUsuario": "ERIKASAC",
"codMotivo": "02",
"desMotivo": "Con baja - Antes de iniciar el traslado "
},
"noConformidad": null,
"auditoria": {
"codUsuRegis": "ERIKASAC",
"fecRegis": "2024-05-15T11:18:32",
"codUsuModif": "ERIKASAC",
"fecModif": "2024-05-16T12:11:40",
"numSchemaVersion": "1.0"
},
"desTipoCpe": "sin evento"
}
}{
"success": false,
"message": "Bad Request"
}Consulta la guía de remisión electrónica (GRE) en formato JSON estructurado.
curl --request GET \
--url https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.json.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "Exito",
"data": {
"codCpe": "09",
"numRuc": "20538878309",
"cantidad": null,
"codTipoCpe": "00",
"numSerie": "T004",
"observacion": null,
"numCpe": 9,
"codEstado": "02",
"desEstado": "Baja",
"emision": {
"fecEmision": "2024-05-15T00:00:00",
"indSEE": "2",
"indOrigen": "3",
"desNota": null,
"desHashQr": "dJrFNbxgXQWmXxr4BC1LQMp5vX/Aj8qqj8VGzi8pcO01nPkJ9ZcA6m4wVYrSLKd4xRcw4nizVVaozuYzxhDN9HxRNxqehXMUsbMlOHDb2kc=",
"desQr": "https://e-factura.sunat.gob.pe/v1/contribuyente/gre/comprobantes/descargaqr?hashqr=dJrFNbxgXQWmXxr4BC1LQMp5vX/Aj8qqj8VGzi8pcO01nPkJ9ZcA6m4wVYrSLKd4xRcw4nizVVaozuYzxhDN9HxRNxqehXMUsbMlOHDb2kc=",
"receptorObs": null,
"pse": null,
"firma": {
"idCertificado": "34b26f7af41589ac80",
"digestValue": "4mt0ivPSpPdgqCYBS+fkIMuVKSU=",
"fecFirma": null
},
"numIpCliente": null,
"numFecEmision": 20240515,
"numRangoHora": 0
},
"emisor": {
"desNombre": "INVERSIONES E & F AYALA Y ARIAS S.A.C.",
"numAutorizacionMtc": null,
"indEncSunNumAutorizacionMtc": null,
"indSubContratacion": "0",
"autorizacion": null,
"subContratador": null
},
"traslado": {
"codMotivoTraslado": "01",
"desMotivoTraslado": "Venta",
"desMotivoTrasladoOtros": null,
"fecInicioTraslado": "2024-05-15T00:00:00",
"numPlacaVehiculo": null,
"fecEntrega": null,
"indModalidadTraslado": "02",
"desModalidadTraslado": "Privado",
"indTrasladoVehiculo": "0",
"indTransbordo": "0",
"indRetornoVehicEnvEmbVacio": "0",
"indRetornoVehicVacio": "0",
"indPagadorFlete": "00",
"indTrasladoDua": "0",
"desTrasladoDua": "Parcial",
"indTrasladoTotalBienes": "0",
"numBultosPallets": null,
"desBien": null,
"codUnidadMedidaPb": "KGM",
"numPesoBruto": 839.6,
"numPesoBrutoItemsSel": null,
"desSustentoPesoBrutoItemsSel": "",
"contenedores": null,
"autorizacion": null,
"bien": [
{
"numOrden": 1,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "479",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "CHULETA DE LOMO",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 77.2,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 2,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "28",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "MOLIDA ESPECIAL",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 30,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 3,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "17",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "GUISO ESPECIAL",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 102.7,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 4,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "36",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "SANCOCHADO",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 156.1,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 5,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "16",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "GUISO CON HUESO",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 216.2,
"indFrecuente": "0",
"docRelacionado": null
},
{
"numOrden": 6,
"codTipoDocumento": null,
"desCortaTipoDocumento": null,
"numSerie": null,
"numDocumento": null,
"numItem": null,
"indBienRegulado": "0",
"codBien": "460",
"codProductoSunat": null,
"codSubPartida": null,
"codGtin": null,
"desBien": "PIERNA FRESCA",
"codUniMedida": "KGM",
"desUniMedida": "KILOGRAMO",
"numCantidad": 257.4,
"indFrecuente": "0",
"docRelacionado": null
}
],
"partida": {
"indFrecuente": "0",
"direccion": {
"codUbigeo": "150103",
"desDepartamento": "LIMA ",
"desProvincia": "LIMA ",
"desDistrito": "ATE",
"desDireccion": "AV NICOLAS AYLLON 1217",
"contribuyente": {
"numEstablecimiento": 0,
"numRuc": null,
"desRuc": null
},
"puerto": null,
"numLatitud": null,
"numLongitud": null
}
},
"llegada": {
"indFrecuente": "0",
"direccion": {
"codUbigeo": "150509",
"desDepartamento": "LIMA ",
"desProvincia": "CAÑETE ",
"desDistrito": "MALA",
"desDireccion": "PANAMERICANA SUR KM 90",
"contribuyente": {
"numEstablecimiento": 0,
"numRuc": null,
"desRuc": null
},
"puerto": null,
"numLatitud": null,
"numLongitud": null
}
},
"pagadorFlete": null,
"vehiculo": [
{
"indTipoVehiculo": "1",
"desTipoVehiculo": "Principal",
"numPlaca": "BUI721",
"numTucChv": null,
"indTucChv": "4",
"indEncSunNumTucChv": "0",
"indFrecuente": "0",
"indEncSunNumPlaca": "0",
"autorizacion": null
}
],
"conductor": [
{
"indTipoOrden": "1",
"desTipoOrden": "Principal",
"codTipoDocIdentidad": "1",
"desTipoDocIdentidad": "DOCUMENTO NACIONAL DE IDENTIDAD",
"numDocIdentidad": "40700608",
"numLicencia": "Q40700608",
"desNombre": "YAÑE GAMONAL YONE",
"codEmisorLicencia": null,
"indFrecuente": "0",
"indEncSunNumLicencia": "1"
}
],
"proveedor": null,
"comprador": {
"codTipoDocIdentidad": "",
"desTipoDocIdentidad": "",
"numDocIdentidad": "",
"desNombre": "",
"indFrecuente": "0"
},
"transportista": null
},
"receptor": {
"codTipoDocIdentidad": "6",
"desTipoDocIdentidad": "REGISTRO ÚNICO DE CONTRIBUYENTES",
"numDocIdentidad": "20510631715",
"desNombre": "S.I.G. SERVICIOS GENERALES E.I.R.L.",
"indFrecuente": "0"
},
"remitente": null,
"docRelacionado": null,
"docGrePorEvento": null,
"baja": {
"fecRegistro": "2024-05-16T12:11:40",
"codUsuario": "ERIKASAC",
"codMotivo": "02",
"desMotivo": "Con baja - Antes de iniciar el traslado "
},
"noConformidad": null,
"auditoria": {
"codUsuRegis": "ERIKASAC",
"fecRegis": "2024-05-15T11:18:32",
"codUsuModif": "ERIKASAC",
"fecModif": "2024-05-16T12:11:40",
"numSchemaVersion": "1.0"
},
"desTipoCpe": "sin evento"
}
}{
"success": false,
"message": "Bad Request"
}| Parámetro | Ejemplo | Descripción |
|---|---|---|
numRuc | 20293774308 | RUC del emisor |
tipoDocumento | 09 | Tipo de comprobante (guía de remisión) |
numSerieComprobante | T002 | Serie del comprobante |
numDocumentoComprobante | 7721 | Correlativo |
GET /sunat/guia/json/20293774308-09-T002-7721
{
"success": true,
"message": "Exito",
"data": {
"codCpe": "09",
"numRuc": "20293774308",
"numSerie": "T002",
"numCpe": 7721,
"emisor": { "...": "..." },
"receptor": { "...": "..." },
"traslado": { "...": "..." }
}
}
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
"20293774308"
"09"
"T002"
"7721"
