Webhooks

Webhook triggered on installment status updates

post
/webhooks/invoice_installments_status_anticipation

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

No content

post
/webhooks/invoice_installments_status_anticipation
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
/webhooks/factoring_payables_status

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

No content

post
/webhooks/factoring_payables_status
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

Last updated

Was this helpful?