Ir al contenido
Facturalo

Listar webhooks enviados

Retorna el historial de webhooks enviados. Filtra por estado o evento para encontrar envíos fallidos y reenviarlos.

GEThttps://api.facturalo.pe/api/v3/webhooks

Query

Campo
Descripción
Authorization
header · stringrequerido
Token de empresa (sk_test_... o sk_live_...).Ej: sk_test_...
estado
query · stringopcional
Filtra por estado: "FALLIDO" · "OK".Ej: FALLIDO
evento
query · stringopcional
Filtra por tipo de evento.Ej: documento.sunat.respuesta
per_page
query · intopcional
Registros por página. Default: 20.Ej: 20
page
query · intopcional
Página a consultar. Default: 1.Ej: 1

Parámetros del response

CampoTipoRequeridoDescripción
dataobjectSíContenedor principal del resultado.

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.webhooks.listar({ estado: "error", pagina: 1 });
console.log(result.webhooks);
SDK oficial @facturalo-pe/node · guía en /sdks
Response

Elige un ejemplo de respuesta:

application/json
200OK
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 42,
        "tipo": "WEBHOOK_ENVIADO",
        "estado": "OK",
        "evento": "documento.sunat.respuesta",
        "url": "https://tuapp.com/webhooks/facturalo",
        "httpStatus": 200,
        "error": null,
        "duracionMs": 85,
        "documento": {
          "id": "eb5e89d0-67d9-11f1-8bd0-5b2bb30404ab",
          "serie": "F001",
          "correlativo": "00000123"
        },
        "fecha": "2026-06-14T09:52:56-05:00"
      }
    ],
    "total": 1,
    "per_page": 20,
    "current_page": 1
  }
}