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",
  "webhook_url": "https://mi-erp.com/api/emizor/callback"
}

Detalles del Payload de Petición

Parámetro	Tipo	Requerido	Descripción
event_type	String	Sí	Nombre exacto del evento a suscribir (ej. invoice_status).
webhook_url	String (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, "message": "Webhook configurado correctamente para el evento invoice_status."}
• 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.