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

Query

Campo

Descripción

Authorization

header · stringrequerido

Token de empresa (sk_test_... o sk_live_...).Ej: sk_test_...

Parámetros del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	Contenedor principal del resultado.

Tipos de evento

tipo	estado posible	Significado
guia.recibida	ok	La API recibió y validó el payload de la guía.
guia.xml_generado	ok	El XML fue generado y firmado digitalmente. Aún no enviado a SUNAT.
guia.sunat.enviando	pendiente	La guía está siendo enviada a SUNAT. Espera respuesta.
guia.sunat.respuesta	okerror	SUNAT respondió. Revisa sunat.estado para el resultado final (ACEPTADA / RECHAZADA).
documento.webhook.enviado	ok	El webhook fue enviado a tu servidor y respondió 2xx.
documento.webhook.fallido	error	El webhook falló (timeout, 4xx, 5xx). Puedes reenviarlo manualmente.

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

import { FacturaloClient } from "@facturalo-pe/node";

const facturalo = new FacturaloClient({ token: process.env.FACTURALO_TOKEN! });

const result = await facturalo.guias.eventos("83ad82a0-680e-11f1-8e35-2d93ac0f2c84");
console.log(result.eventos);

SDK oficial @facturalo-pe/node · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "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"
    }
  }
}