Webhooks

Webhook triggered on installment status updates

post

The platform supports webhook notifications to inform clients of changes in the status of submitted invoice installments.

This webhook is triggered whenever a installment status is updated in the anticipation process.

To use this feature, you must implement an HTTPS POST endpoint on your system to receive event notifications. Once a webhook is triggered, our platform will send a POST request to the configured URL with the relevant payload.

Anticipation status:

• Created: Invoice installment submitted

• Updated: Invoice installment updated

• Deleted: Invoice installment deleted

• Requested: Anticipation requested

• Approved: Anticipation approved

• Rejected: Anticipation rejected

• Cancelled: Anticipation cancelled

• Settled: Anticipation settled

• Failed: Invoice installment update failed

Body

issue_datestring · dateRequired

invoice_numberstringRequired

invoice_seriesstringRequired

installmentstringRequired

installment_due_datestring · dateRequired

installment_amountnumber · floatRequired

document_supplierstringRequired

anticipation_statusstring · enumOptionalPossible values:

idstring · uuidOptional

factoring_payable_idstring · uuidOptional

Responses

200

Acknowledged

post

HTTPcURLJavaScriptPython

POST /webhooks/invoice_installments_status_anticipation HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 826

{
  "invoice_installment": {
    "issue_date": "2025-07-01",
    "invoice_number": "12345",
    "invoice_series": "1",
    "installment": "1",
    "installment_due_date": "2025-08-01",
    "installment_amount": 5000,
    "document_supplier": "12345678000199",
    "anticipation_status": "Settled",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa7",
    "factoring_payable_id": "3fa85f64-5717-4562-b3fc-2c963f66afa8",
    "stages": [
      {
        "anticipation_status": "created",
        "timestamp": "2025-07-10T18:44:06.456370Z",
        "error_message": null,
        "error_code": null
      },
      {
        "anticipation_status": "Requested",
        "timestamp": "2025-07-12T18:44:06.456370Z",
        "error_message": null,
        "error_code": null
      },
      {
        "anticipation_status": "Approved",
        "timestamp": "2025-07-13T18:44:06.456370Z",
        "error_message": null,
        "error_code": null
      },
      {
        "anticipation_status": "Settled",
        "timestamp": "2025-07-14T18:44:06.456370Z",
        "error_message": null,
        "error_code": null
      }
    ]
  }
}

200

Acknowledged

No content

Webhook triggered on factoring payables status updates

post

The platform supports webhook notifications to inform clients of changes in the status of submitted factoring payables (Assignment of Receivables).

This webhook is triggered whenever a installment status is updated in the anticipation process.

To use this feature, you must implement an HTTPS POST endpoint on your system to receive event notifications. Once a webhook is triggered, our platform will send a POST request to the configured URL with the relevant payload.

Anticipation status:

• Created: Factoring payables submitted

• Updated: Factoring payables updated

• Deleted: Factoring payables deleted

• Settled: Factoring payables settled

Body

document_numberstringRequired

installmentstringRequired

installment_due_datestring · dateRequired

installment_amountnumber · floatRequired

document_supplierstringRequired

anticipation_statusstring · enumOptionalPossible values:

hash_brcodestringOptional

idstring · uuidOptional

invoice_installment_idstring · uuidOptional

Responses

200

Acknowledged

post

HTTPcURLJavaScriptPython

POST /webhooks/factoring_payables_status HTTP/1.1
Host: api.sandbox.trio.com.br
Content-Type: application/json
Accept: */*
Content-Length: 399

{
  "issue_date": "2025-07-01",
  "document_number": "12345",
  "installment": "1",
  "installment_due_date": "2025-08-01",
  "installment_amount": 5000,
  "document_supplier": "12345678000199",
  "anticipation_status": "Created",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa7",
  "hash_brcode": "3fa85f64-5717-4562-b3fc-2c963f66afa73fa85f64-5717-4562-b3fc-2c963f66afa7",
  "invoice_installment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa7"
}

200

Acknowledged

No content