Eventos de guía

Retorna la línea de tiempo completa del procesamiento de una guía: desde la recepción hasta la respuesta de SUNAT y el envío del webhook. Útil para depurar el estado de una guía en proceso.

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

Parámetros del request

Authorization
header · stringrequerido
Token de empresa (sk_test_... o sk_live_...).Ej: sk_test_...

Parámetros del response

data
objectrequerido
Contenedor principal del resultado.
guia
objectrequerido
Datos de la guía consultada.
id
stringrequerido
ID de la guía.
serie
stringrequerido
Serie de la guía.
correlativo
stringrequerido
Correlativo de la guía.
tipo
stringrequerido
Tipo de documento.
estado
stringrequerido
Estado actual: EN_PROCESO, ACEPTADA, RECHAZADA.
entorno
stringrequerido
"demo" o "prod".
total_eventos
numberrequerido
Cantidad total de eventos registrados para esta guía.
eventos
arrayrequerido
Línea de tiempo del procesamiento de la guía.
id
stringrequerido
ID del evento.
tipo
stringrequerido
Tipo de evento: guia.recibida, guia.xml_generado, guia.sunat.enviando, guia.sunat.respuesta, documento.webhook.enviado.
estado
stringrequerido
"ok", "pendiente" o "error".
duracion_ms
numberopcional
Duración del procesamiento en milisegundos.
sunat
object | nullopcional
Respuesta de SUNAT. Presente en guia.xml_generado y guia.sunat.respuesta.
http_status
string | nullopcional
Código HTTP recibido al enviar el webhook. Presente en documento.webhook.enviado.
respuesta
object | nullopcional
Detalle del envío al webhook: url, evento y body de respuesta.
fecha
stringrequerido
Fecha y hora del evento en ISO 8601 con zona horaria.
enlaces
objectrequerido
URLs de descarga de los archivos generados.
pdf
stringrequerido
URL del PDF de la guía.
xml
stringrequerido
URL del XML firmado.
cdr
stringrequerido
URL del CDR de SUNAT.

Tipos de evento

tipoestado posibleSignificado
guia.recibidaokLa API recibió y validó el payload de la guía.
guia.xml_generadookEl XML fue generado y firmado digitalmente. Aún no enviado a SUNAT.
guia.sunat.enviandopendienteLa guía está siendo enviada a SUNAT. Espera respuesta.
guia.sunat.respuestaokerrorSUNAT respondió. Revisa sunat.estado para el resultado final (ACEPTADA / RECHAZADA).
documento.webhook.enviadookEl webhook fue enviado a tu servidor y respondió 2xx.
documento.webhook.fallidoerrorEl webhook falló (timeout, 4xx, 5xx). Puedes reenviarlo manualmente.
Requestjson
// Sin body — GET request
// Authorization: sk_test_...
200 — Eventos obtenidosjson
{
  "success": true,
  "message": "Eventos de la guía obtenidos correctamente.",
  "data": {
    "guia": {
      "id": "46ed7c66-2de8-450d-8a25-9fb2e9e09c41",
      "serie": "T001",
      "correlativo": "00000130",
      "tipo": "GUIA_REMISION",
      "estado": "ACEPTADA"
    },
    "entorno": "demo",
    "total_eventos": 5,
    "eventos": [
      {
        "id": "3ff0e8b0-4bf4-4241-9be7-bebb0c152c1f",
        "tipo": "guia.recibida",
        "estado": "ok",
        "duracion_ms": 0,
        "fecha": "2026-06-14T10:18:35-05:00"
      },
      {
        "id": "2c71f525-10ca-49cc-9d5d-10202c91d962",
        "tipo": "guia.xml_generado",
        "estado": "ok",
        "duracion_ms": 0,
        "sunat": {
          "notas": [],
          "codigo": 0,
          "estado": "NO_ENVIADA",
          "mensaje": "XML generado y firmado correctamente."
        },
        "fecha": "2026-06-14T10:18:35-05:00"
      },
      {
        "id": "431f0253-8ce2-424f-ab73-49f20c726ad1",
        "tipo": "guia.sunat.enviando",
        "estado": "pendiente",
        "fecha": "2026-06-14T10:18:35-05:00"
      },
      {
        "id": "8fad28f9-5dc5-421c-bd12-9f42b85a161b",
        "tipo": "guia.sunat.respuesta",
        "estado": "ok",
        "duracion_ms": 69,
        "sunat": {
          "notas": [],
          "codigo": "0",
          "estado": "ACEPTADA",
          "mensaje": "La Guia de Remision ha sido aceptada."
        },
        "fecha": "2026-06-14T10:18:35-05:00"
      },
      {
        "id": "6d6f4cea-0ad4-4a4b-9f15-e9ecd7865a41",
        "tipo": "documento.webhook.enviado",
        "estado": "ok",
        "duracion_ms": 14,
        "http_status": "200",
        "respuesta": {
          "url": "https://tuapp.com/webhooks/facturalo",
          "evento": "guia.sunat.respuesta",
          "body": {
            "success": true,
            "evento": "guia.sunat.respuesta",
            "message": "Webhook recibido correctamente.",
            "timestamp": "2026-06-14T10:18:35-05:00"
          }
        },
        "fecha": "2026-06-14T10:18:35-05:00"
      }
    ],
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/guias/46ed7c66-2de8-450d-8a25-9fb2e9e09c41.pdf",
      "xml": "https://api.facturalo.pe/api/v3/guias/46ed7c66-2de8-450d-8a25-9fb2e9e09c41.xml",
      "cdr": "https://api.facturalo.pe/api/v3/guias/46ed7c66-2de8-450d-8a25-9fb2e9e09c41.cdr"
    }
  }
}