Activar / desactivar eventos

Activa o desactiva eventos webhook por entorno. Solo se modifican los eventos enviados en el payload — los demás permanecen igual.

PATCHhttps://api.facturalo.pe/api/v3/empresas/{uuid}/webhook/eventos

Parámetros del request

Campo

Descripción

entorno

stringrequerido

Entorno a modificar. Valores: "demo" o "prod".Ej: demo

eventos

arrayrequerido

Lista de eventos a activar o desactivar. Solo se modifican los enviados.

evento

stringrequerido

Nombre del evento (ej: documento.correo.enviado).

activo

booleanrequerido

true para activar, false para desactivar.

Parámetros del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	Estado completo de todos los eventos tras la actualización.

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

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

const cuenta = new FacturaloCuentaClient({ token: process.env.FACTURALO_USER_TOKEN! });

const result = await cuenta.empresas.actualizarEventosWebhook("6f1c2a10-6805-11f1-8869-aba1fc00c9df", "demo", [
  {
    evento: "documento.correo.enviado",
    activo: true
  },
  {
    evento: "documento.correo.fallido",
    activo: true
  }
]);
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 webhook actualizados correctamente.",
  "data": {
    "entorno": "demo",
    "eventos": [
      {
        "evento": "documento.sunat.respuesta",
        "activo": true
      },
      {
        "evento": "documento.anulado",
        "activo": true
      },
      {
        "evento": "documento.correo.enviado",
        "activo": true
      },
      {
        "evento": "documento.correo.fallido",
        "activo": true
      },
      {
        "evento": "guia.sunat.respuesta",
        "activo": true
      },
      {
        "evento": "documento.error",
        "activo": true
      }
    ]
  }
}