> ## Documentation Index
> Fetch the complete documentation index at: https://docs.json.pe/llms.txt
> Use this file to discover all available pages before exploring further.

# Descarga Guía JSON (SUNAT)

> Consulta la guía de remisión electrónica (GRE) en formato JSON estructurado.

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`                  | `20293774308` | RUC del emisor                         |
| `tipoDocumento`           | `09`          | Tipo de comprobante (guía de remisión) |
| `numSerieComprobante`     | `T002`        | Serie del comprobante                  |
| `numDocumentoComprobante` | `7721`        | Correlativo                            |

**URL resultante:**

```
GET /sunat/guia/json/20293774308-09-T002-7721
```

## Ejemplo de respuesta

```json theme={null}
{
  "success": true,
  "message": "Exito",
  "data": {
    "codCpe": "09",
    "numRuc": "20293774308",
    "numSerie": "T002",
    "numCpe": 7721,
    "emisor": { "...": "..." },
    "receptor": { "...": "..." },
    "traslado": { "...": "..." }
  }
}
```

<Alert type="info">
  El objeto `data` contiene el detalle completo de la guía: estado, emisión, emisor, receptor, traslado (bienes, partida, llegada, vehículo, conductor), documentos relacionados y auditoría.
</Alert>


## OpenAPI

````yaml GET /sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}
openapi: 3.0.1
info:
  title: json.pe - API Consulta RUC, DNI, Placa, SOAT, Licencia de Conducir y más
  description: >-
    Documentación oficial de [json.pe](https://json.pe) — API Consulta RUC, DNI,
    Placa, SOAT, Licencia de Conducir y más. Regístrate gratis en
    [json.pe/signup](https://json.pe/signup).
  version: 1.0.0
servers:
  - url: https://api.json.pe/api
security:
  - bearerAuth: []
paths:
  /sunat/guia/json/{numRuc}-{tipoDocumento}-{numSerieComprobante}-{numDocumentoComprobante}:
    get:
      tags:
        - sunat
      description: >-
        Consulta guía de remisión electrónica (GRE) en formato JSON por datos de
        comprobante.
      parameters:
        - name: numRuc
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: '20293774308'
        - name: tipoDocumento
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: '09'
        - name: numSerieComprobante
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: T002
        - name: numDocumentoComprobante
          in: path
          required: true
          style: simple
          schema:
            type: string
            example: '7721'
      responses:
        '200':
          description: Guía obtenida correctamente en formato JSON estructurado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sunat-guia'
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error'
components:
  schemas:
    sunat-guia:
      type: object
      properties:
        success:
          type: boolean
          description: El estado de la respuesta  true o false
        message:
          type: string
          description: Mensaje de la respuesta
        data:
          type: object
          description: Datos detallados de la respuesta
      example:
        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
    error:
      required:
        - message
        - success
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
      example:
        success: false
        message: Bad Request
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````