Descarga Guía JSON

cURL

curl --request GET \
  --url https://api.json.com.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.json.com.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.com.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.com.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.com.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.com.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.json.com.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": "20123456789",
    "cantidad": null,
    "codTipoCpe": "00",
    "numSerie": "T112",
    "observacion": null,
    "numCpe": 9,
    "codEstado": "02",
    "desEstado": "Baja",
    "emision": {
      "fecEmision": "2026-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": "LAB",
      "numAutorizacionMtc": null,
      "indEncSunNumAutorizacionMtc": null,
      "indSubContratacion": "0",
      "autorizacion": null,
      "subContratador": null
    },
    "traslado": {
      "codMotivoTraslado": "01",
      "desMotivoTraslado": "Venta",
      "desMotivoTrasladoOtros": null,
      "fecInicioTraslado": "2026-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": 699.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": "CARNE",
          "codUniMedida": "KGM",
          "desUniMedida": "KILOGRAMO",
          "numCantidad": 66.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": "ESPECIAL",
          "codUniMedida": "KGM",
          "desUniMedida": "KILOGRAMO",
          "numCantidad": 50,
          "indFrecuente": "0",
          "docRelacionado": null
        },
        {
          "numOrden": 3,
          "codTipoDocumento": null,
          "desCortaTipoDocumento": null,
          "numSerie": null,
          "numDocumento": null,
          "numItem": null,
          "indBienRegulado": "0",
          "codBien": "160",
          "codProductoSunat": null,
          "codSubPartida": null,
          "codGtin": null,
          "desBien": "MUSLO",
          "codUniMedida": "KGM",
          "desUniMedida": "KILOGRAMO",
          "numCantidad": 185.4,
          "indFrecuente": "0",
          "docRelacionado": null
        }
      ],
      "partida": {
        "indFrecuente": "0",
        "direccion": {
          "codUbigeo": "150101",
          "desDepartamento": "LIMA ",
          "desProvincia": "LIMA ",
          "desDistrito": "CERCADO DE LIMA",
          "desDireccion": "AV. NICOLÁS DE PIÉROLA",
          "contribuyente": {
            "numEstablecimiento": 0,
            "numRuc": null,
            "desRuc": null
          },
          "puerto": null,
          "numLatitud": null,
          "numLongitud": null
        }
      },
      "llegada": {
        "indFrecuente": "0",
        "direccion": {
          "codUbigeo": "150509",
          "desDepartamento": "HUARAZ",
          "desProvincia": "HUARAZ ",
          "desDistrito": "ÁNCASH ",
          "desDireccion": "PANAMERICANA",
          "contribuyente": {
            "numEstablecimiento": 0,
            "numRuc": null,
            "desRuc": null
          },
          "puerto": null,
          "numLatitud": null,
          "numLongitud": null
        }
      },
      "pagadorFlete": null,
      "vehiculo": [
        {
          "indTipoVehiculo": "1",
          "desTipoVehiculo": "Principal",
          "numPlaca": "IAA721",
          "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": "1234567",
          "numLicencia": "A40709568",
          "desNombre": "JUAN *****O ***NA",
          "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": "20123456789",
      "desNombre": "LABB****",
      "indFrecuente": "0"
    },
    "remitente": null,
    "docRelacionado": null,
    "docGrePorEvento": null,
    "baja": {
      "fecRegistro": "2026-05-16T12:11:40",
      "codUsuario": "MARBE",
      "codMotivo": "02",
      "desMotivo": "Iniciar el traslado "
    },
    "noConformidad": null,
    "auditoria": {
      "codUsuRegis": "MARBE",
      "fecRegis": "2026-05-15T11:18:32",
      "codUsuModif": "MARBE",
      "fecModif": "2026-05-16T12:11:40",
      "numSchemaVersion": "1.0"
    },
    "desTipoCpe": "sin evento"
  }
}

{
  "success": false,
  "message": "Bad Request"
}

GET

sunat

guia

json

{numRuc}

{tipoDocumento}

{numSerieComprobante}

{numDocumentoComprobante}

cURL

curl --request GET \
  --url https://api.json.com.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.json.com.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.com.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.com.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.com.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.com.pe/api/sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.json.com.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": "20123456789",
    "cantidad": null,
    "codTipoCpe": "00",
    "numSerie": "T112",
    "observacion": null,
    "numCpe": 9,
    "codEstado": "02",
    "desEstado": "Baja",
    "emision": {
      "fecEmision": "2026-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": "LAB",
      "numAutorizacionMtc": null,
      "indEncSunNumAutorizacionMtc": null,
      "indSubContratacion": "0",
      "autorizacion": null,
      "subContratador": null
    },
    "traslado": {
      "codMotivoTraslado": "01",
      "desMotivoTraslado": "Venta",
      "desMotivoTrasladoOtros": null,
      "fecInicioTraslado": "2026-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": 699.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": "CARNE",
          "codUniMedida": "KGM",
          "desUniMedida": "KILOGRAMO",
          "numCantidad": 66.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": "ESPECIAL",
          "codUniMedida": "KGM",
          "desUniMedida": "KILOGRAMO",
          "numCantidad": 50,
          "indFrecuente": "0",
          "docRelacionado": null
        },
        {
          "numOrden": 3,
          "codTipoDocumento": null,
          "desCortaTipoDocumento": null,
          "numSerie": null,
          "numDocumento": null,
          "numItem": null,
          "indBienRegulado": "0",
          "codBien": "160",
          "codProductoSunat": null,
          "codSubPartida": null,
          "codGtin": null,
          "desBien": "MUSLO",
          "codUniMedida": "KGM",
          "desUniMedida": "KILOGRAMO",
          "numCantidad": 185.4,
          "indFrecuente": "0",
          "docRelacionado": null
        }
      ],
      "partida": {
        "indFrecuente": "0",
        "direccion": {
          "codUbigeo": "150101",
          "desDepartamento": "LIMA ",
          "desProvincia": "LIMA ",
          "desDistrito": "CERCADO DE LIMA",
          "desDireccion": "AV. NICOLÁS DE PIÉROLA",
          "contribuyente": {
            "numEstablecimiento": 0,
            "numRuc": null,
            "desRuc": null
          },
          "puerto": null,
          "numLatitud": null,
          "numLongitud": null
        }
      },
      "llegada": {
        "indFrecuente": "0",
        "direccion": {
          "codUbigeo": "150509",
          "desDepartamento": "HUARAZ",
          "desProvincia": "HUARAZ ",
          "desDistrito": "ÁNCASH ",
          "desDireccion": "PANAMERICANA",
          "contribuyente": {
            "numEstablecimiento": 0,
            "numRuc": null,
            "desRuc": null
          },
          "puerto": null,
          "numLatitud": null,
          "numLongitud": null
        }
      },
      "pagadorFlete": null,
      "vehiculo": [
        {
          "indTipoVehiculo": "1",
          "desTipoVehiculo": "Principal",
          "numPlaca": "IAA721",
          "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": "1234567",
          "numLicencia": "A40709568",
          "desNombre": "JUAN *****O ***NA",
          "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": "20123456789",
      "desNombre": "LABB****",
      "indFrecuente": "0"
    },
    "remitente": null,
    "docRelacionado": null,
    "docGrePorEvento": null,
    "baja": {
      "fecRegistro": "2026-05-16T12:11:40",
      "codUsuario": "MARBE",
      "codMotivo": "02",
      "desMotivo": "Iniciar el traslado "
    },
    "noConformidad": null,
    "auditoria": {
      "codUsuRegis": "MARBE",
      "fecRegis": "2026-05-15T11:18:32",
      "codUsuModif": "MARBE",
      "fecModif": "2026-05-16T12:11:40",
      "numSchemaVersion": "1.0"
    },
    "desTipoCpe": "sin evento"
  }
}

{
  "success": false,
  "message": "Bad Request"
}

Descripción

Consulta la guía de remisión electrónica (GRE) emitida en SUNAT y recibe los datos en formato JSON estructurado. Incluye emisor, receptor, traslado, bienes, vehículos, conductores y más.

Parámetros de la guía

Parámetro	Ejemplo	Descripción
numRuc	20123456789	Número de RUC del emisor.
tipoDocumento	09	Tipo de documento electrónico.
numSerieComprobante	T112	Serie del comprobante.
numDocumentoComprobante	6621	Correlativo.

URL de ejemplo

GET /sunat/guia/json/202645878-09-T112-6621

Ejemplo de respuesta

{
  "success": true,
  "message": "Exito",
  "data": {
    "codCpe": "09",
    "numRuc": "20123456789",
    "numSerie": "T112",
    "numCpe": 6621,
    "emisor": { "...": "..." },
    "receptor": { "...": "..." },
    "traslado": { "...": "..." }
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

numRuc

string

required

Número de RUC del emisor.

Example:

"20123456789"

tipoDocumento

string

required

Tipo de documento del comprobante.

Example:

"09"

numSerieComprobante

string

required

Número de serie del comprobante.

Example:

"T112"

numDocumentoComprobante

string

required

Número del documento o comprobante.

Example:

"6621"

Response

Guía obtenida correctamente en formato JSON estructurado.

success

boolean

Indica si la operación fue exitosa.

Example:

true

message

string

Mensaje descriptivo del resultado.

Example:

"Exito"

data

object

Datos detallados de la respuesta.

INTRODUCCIÓN

API CONSULTA

API RECIBO

INTEGRACIONES

Descripción

Parámetros de la guía

URL de ejemplo

Ejemplo de respuesta

Authorizations

Path Parameters

Response

​Descripción

​Parámetros de la guía

​URL de ejemplo

​Ejemplo de respuesta

Authorizations

Path Parameters

Response

Descripción

Parámetros de la guía

URL de ejemplo

Ejemplo de respuesta