Saltar al contenido principal

Configurar Webhooks Globales

Configurar Webhooks Globales​

  • URL: POST /api/partner/v1/webhooks
  • Cabeceras Obligatorias: Authorization: Bearer <TOKEN_PARTNER_API>
  • Content-Type: application/json
  • Descripción: Registra o actualiza la URL receptora de un evento global a nivel de Partner. No requiere tenant-key.

Ejemplo de Payload de Petición (Request Body)​

{
  "event_type": "invoice_status",
  "callback_url": "https://mi-erp.com/api/emizor/callback"
}

Detalles del Payload de Petición​

ParámetroTipoRequeridoDescripción
event_typeStringSíNombre exacto del evento a suscribir (ej. invoice_status).
callback_urlString (URL)SíURL válida en formato http:// o https:// que recibirá los datos del evento vía POST.

Eventos Soportados​

  • invoice_status: Se dispara cuando una factura cambia de estado ante el SIN (Válida, Anulada, Rechazada, etc).
  • update_parametrics: Se dispara cuando finaliza exitosamente la sincronización en segundo plano de catálogos del SIN.
  • update_branch: Se dispara cuando se registra o actualiza una sucursal para una empresa.
  • quota.warning: Se dispara cuando el cliente alcanza el 90% del límite de consumo mensual establecido.
  • quota.exhausted: Se dispara cuando el cliente excede su límite mensual (bloqueando emisiones).

Respuestas​

  • 200 OK:
{
  "status": true,
  "webhook": {
    "id": 1,
    "partner_id": 123,
    "event_type": "invoice_status",
    "callback_url": "https://mi-erp.com/api/emizor/callback",
    "created_at": "2026-08-24T10:00:00.000000Z",
    "updated_at": "2026-08-24T10:00:00.000000Z"
  }
}
  • 422 Unprocessable Entity: Si la URL no es válida (debe ser un formato HTTP/HTTPS correcto) o si el tipo de evento no existe en la lista de eventos soportados.