Actualizar webhook

Configura las URLs de webhook para cada entorno. Los eventos se envían como `POST` con el body del documento procesado. Usa el `webhookSecret` para verificar la autenticidad del evento en tu servidor.

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

Parámetros del request

Campo

Descripción

webhook

objectrequerido

URLs de webhook por entorno. Ambos campos son opcionales — envía solo el que quieres actualizar. Pasa null para limpiar.

demo

string | nullopcional

URL que recibirá los eventos del entorno demo. null para desactivar.Ej: https://tuapp.com/webhook/facturalo

prod

string | nullopcional

URL que recibirá los eventos del entorno de producción. null para desactivar.Ej: https://tuapp.com/webhook/facturalo

Parámetros del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	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 { FacturaloCuentaClient } from "@facturalo-pe/node";

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

const result = await cuenta.empresas.actualizarWebhook("6f1c2a10-6805-11f1-8869-aba1fc00c9df", {
  demo: "https://tuapp.com/webhook/facturalo",
  prod: "https://tuapp.com/webhook/facturalo"
});
console.log(result);

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

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Webhook actualizado correctamente.",
  "data": {
    "empresa": {
      "id": "afcfac05-b5c2-45c4-90d9-7e6f03c9e863",
      "ruc": "20614694557",
      "nombre": "CONSULTIA DIGITAL S.A.C.",
      "claves": {
        "demo": {
          "token": "sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "webhookUrl": "https://tuapp.com/webhook/facturalo",
          "webhookSecret": "whsec_test_xxxxxxxxxxxxxxxxxxx"
        },
        "prod": {
          "token": "sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "webhookUrl": "https://tuapp.com/webhook/facturalo",
          "webhookSecret": "whsec_live_xxxxxxxxxxxxxxxxxxx"
        }
      }
    }
  }
}