BuildNexion

Catálogo de eventos

Estos son los eventos que puedes suscribir desde POST /v1/webhooks. Todos comparten la misma envoltura { id, type, created_at, organization_id, data: { object } } que se describe en la introducción.

Facturas

EventoCuándo
invoice.createdUna factura se crea (manual, OCR o API).
invoice.updatedSe modifica algún campo (importe, fechas, líneas).
invoice.paidEl estado pasa a paid.
invoice.reconciledSe concilia con uno o varios albaranes.
invoice.deletedSe archiva.

Ejemplo: invoice.created

json
{
  "id":         "evt_8gpQ2nL",
  "type":       "invoice.created",
  "created_at": "2026-05-25T10:30:00.000Z",
  "organization_id": "org_91pQyKn",
  "data": {
    "object": {
      "id":              "inv_W3pNxL2YqAt",
      "project_id":      "prj_8GcyLwT4mPq",
      "provider_id":     "prov_4kqRpBn",
      "invoice_number":  "F-2026-00128",
      "issue_date":      "2026-05-12",
      "subtotal_amount": 248050,
      "tax_amount":      52091,
      "total_amount":    300141,
      "currency":        "EUR",
      "status":          "pending"
    }
  }
}

Albaranes

EventoCuándo
delivery_note.createdAlbarán nuevo (manual, OCR o API).
delivery_note.updatedSe modifican líneas o cabecera.
delivery_note.reconciledSe enlaza con una o varias facturas.
delivery_note.deletedSe archiva.

Presupuestos

EventoCuándo
budget.createdPresupuesto nuevo.
budget.sentSe envía al cliente.
budget.acceptedEl cliente lo acepta.
budget.rejectedEl cliente lo rechaza.

Ejemplo: budget.accepted

json
{
  "id":         "evt_44KpRm",
  "type":       "budget.accepted",
  "created_at": "2026-05-25T11:02:00.000Z",
  "organization_id": "org_91pQyKn",
  "data": {
    "object": {
      "id":          "bud_NkM2pYqL",
      "project_id":  "prj_8GcyLwT4mPq",
      "name":        "Presupuesto v3 — Reforma integral",
      "sale_amount": 3100625,
      "accepted_at": "2026-05-25T11:02:00.000Z"
    }
  }
}

Proyectos

EventoCuándo
project.createdProyecto nuevo.
project.updatedCambia algún campo de cabecera.
project.finishedEl estado pasa a finished.
project.archivedSe archiva.

Proveedores

EventoCuándo
provider.createdProveedor nuevo.
provider.updatedCambia algún campo.

Suscribirse a varios eventos

En POST /v1/webhooks pasa el array completo en el campo events. Puedes usar el comodín * para suscribirte a todos los eventos de un recurso:

json
{
  "url":    "https://tu-servidor.com/buildnexion/webhook",
  "events": ["invoice.*", "budget.accepted"]
}