Consultar guía

Retorna el estado y datos de una guía de remisión. El {id} es el ID retornado al emitir la guía.

GEThttps://api.facturalo.pe/api/v3/guias/{id}

Estados posibles

EN_PROCESOLa guía fue recibida y está siendo procesada por SUNAT.
ACEPTADASUNAT aceptó la guía de remisión correctamente.
RECHAZADASUNAT rechazó la guía. Revisa sunat.codigo y sunat.mensaje.
OBSERVADASUNAT aceptó la guía con observaciones. Revisa sunat.notas.
NO_ENVIADALa guía aún no fue enviada a SUNAT.

Campos del response

data
objectrequerido
Datos de la guía.
estado
stringrequerido
Estado global de la guía. Ver tabla de estados.
entorno
stringrequerido
"demo" o "produccion".
guia
objectrequerido
Datos del comprobante.
id
stringrequerido
ID de la guía.
serie
stringrequerido
Serie de la guía.
correlativo
stringrequerido
Número correlativo.
tipo
stringrequerido
"GUIA_REMISION".
fechaEmision
stringrequerido
Fecha de emisión.
tipoTransporte
stringrequerido
"TRANSPORTE PÚBLICO" o "TRANSPORTE PRIVADO".
motivoTraslado
stringrequerido
Código de motivo de traslado.
sunat
objectrequerido
Respuesta de SUNAT.
codigo
stringrequerido
"0" = éxito. Otro valor = error.
mensaje
stringrequerido
Mensaje descriptivo de SUNAT.
notas
arrayrequerido
Advertencias de SUNAT (puede ser vacío).
ticket
string | nullopcional
Ticket de procesamiento SUNAT.
nombreArchivo
string | nullopcional
Nombre del archivo XML enviado a SUNAT.
enlaces
objectrequerido
URLs de descarga.
pdf
stringrequerido
URL del PDF de la guía.
xml
stringrequerido
URL del XML firmado.
cdr
stringrequerido
URL del CDR (Constancia de Recepción SUNAT).
hash
stringrequerido
Hash de firma digital del XML.
cadenaQr
stringrequerido
Cadena para el código QR de la guía.
codigoBarras
stringrequerido
Cadena para el código de barras.
Requestjson
// Sin body — GET request
// GET /guias/8b328c40-673d-11f1-b70c-456216ecc78b
200 — Guía encontradajson
{
  "success": true,
  "message": "Guía encontrada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "guia": {
      "id": "8b328c40-673d-11f1-b70c-456216ecc78b",
      "serie": "V001",
      "correlativo": "00000002",
      "tipo": "GUIA_REMISION",
      "fechaEmision": "2026-06-13",
      "tipoTransporte": "TRANSPORTE PÚBLICO",
      "motivoTraslado": "01"
    },
    "sunat": {
      "codigo": "0",
      "mensaje": "La Guia de Remision ha sido aceptada.",
      "notas": [],
      "ticket": "DEMO-20260613-043550",
      "nombreArchivo": "20161515648-31-V001-2"
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/guias/8b328c40-673d-11f1-b70c-456216ecc78b.pdf",
      "xml": "https://api.facturalo.pe/api/v3/guias/8b328c40-673d-11f1-b70c-456216ecc78b.xml",
      "cdr": "https://api.facturalo.pe/api/v3/guias/8b328c40-673d-11f1-b70c-456216ecc78b.cdr"
    },
    "hash": "MdDtBpTOHVP7B37uwiBvuaCG1H4=",
    "cadenaQr": "20601476551 | 09 | V001 | 00000002 | 13/06/2026 | 20100070970 | MdDtBpTOHVP7B37uwiBvuaCG1H4= |",
    "codigoBarras": "20601476551 | 09 | V001 | 00000002 | 13/06/2026 | 20100070970 | MdDtBpTOHVP7B37uwiBvuaCG1H4= |"
  }
}
404 — No encontradajson
{
  "success": false,
  "message": "Guía no encontrada en el entorno DEMO.",
  "data": []
}