Consultar ticket

Las guías de remisión se procesan de forma asíncrona por SUNAT. Este endpoint consulta el resultado usando el ticket retornado al emitir la guía.

POSThttps://api.facturalo.pe/api/v3/guias/ticket

Estados posibles

EN_PROCESOSUNAT aún está procesando el ticket. Vuelve a consultar en unos segundos.
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.

Parámetros del body

ticket
stringrequerido
Ticket retornado por SUNAT al emitir la guía.Ej: DEMO-20260613-043550

Campos del response

data
objectrequerido
Datos de la guía procesada.
estado
stringrequerido
Estado del procesamiento. 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.
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
stringrequerido
Ticket consultado.
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.
hash
stringrequerido
Hash de firma digital del XML.
cadenaQr
stringrequerido
Cadena para el código QR.
codigoBarras
stringrequerido
Cadena para el código de barras.
Request bodyjson
{
  "ticket": "DEMO-20260613-043550"
}
200 — Aceptadajson
{
  "success": true,
  "message": "La Guía de Remisión ha sido aceptada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "guia": {
      "id": "8b328c40-673d-11f1-b70c-456216ecc78b",
      "estado": "ACEPTADA",
      "serie": "T001",
      "correlativo": "00000001",
      "tipo": "GUIA_REMISION",
      "fechaEmision": "2026-06-14",
      "tipoTransporte": "PÚBLICO",
      "motivoTraslado": "01",
      "cliente": {
        "tipoDocumento": "6",
        "numeroDocumento": "20100070970",
        "denominacion": "EMPRESA DISTRIBUIDORA SAC"
      },
      "datosTraslado": {
        "fecha": "2026-06-14",
        "fechaEntregaBienes": "2026-06-14",
        "pesoBrutoTotal": 150.5,
        "pesoUnidadMedida": "KGM",
        "numeroBultos": 10,
        "indicadorDeEnvio": "01"
      },
      "datosTransportista": {
        "tipoDocumento": "6",
        "numeroDocumento": "20415932376",
        "denominacion": "TRANSPORTES RÁPIDOS SAC",
        "numeroMTC": "MTC-123456"
      },
      "puntoPartida": {
        "ubigeo": "150101",
        "direccion": "AV. INDUSTRIAL 123, LIMA"
      },
      "puntoLlegada": {
        "ubigeo": "040101",
        "direccion": "JR. COMERCIO 456, AREQUIPA"
      },
      "items": [
        {
          "codigo": "PROD-001",
          "descripcion": "TELEVISOR LED 55 PULGADAS",
          "unidadMedida": "NIU",
          "cantidad": 5
        }
      ],
      "documentosRelacionados": []
    },
    "sunat": {
      "codigo": "0",
      "mensaje": "La Guia de Remision ha sido aceptada.",
      "notas": [],
      "ticket": "DEMO-20260613-043550",
      "nombreArchivo": "20601476551-09-T001-1"
    },
    "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 | T001 | 00000001 | 14/06/2026 | 20100070970 | MdDtBpTOHVP7B37uwiBvuaCG1H4= |",
    "codigoBarras": "20601476551 | 09 | T001 | 00000001 | 14/06/2026 | 20100070970 | MdDtBpTOHVP7B37uwiBvuaCG1H4= |"
  }
}
404 — Ticket no encontradojson
{
  "success": false,
  "message": "Ticket no encontrado.",
  "data": []
}