Skip to main content

Negativation events (negativation.*)

Registration of the debtor with the credit bureaus. Every negativation triggered by the collection rule goes through mandatory human review before taking effect. data is always a lean reference object.

bureau values: serasa · spc · boa_vista.

negativation.review_required​

Fires when a collection rule step requests a negativation: the record is created as pending and a review task goes to the review queue. Useful for plugging the approval into internal tools (Slack, service desk).

{
  "event": "negativation.review_required",
  "timestamp": "2026-07-23T06:10:00.000Z",
  "organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "data": {
    "chargeId": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "personId": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "negativationRecordId": "5c7e9a1b-3d5f-4b7d-8f0a-1c3e5a7b9d1f",
    "amount": "1512.50"
  }
}

negativation.registered​

Fires when the negativation takes effect at the bureau (after approval). The charge moves to negatived.

{
  "event": "negativation.registered",
  "timestamp": "2026-07-24T11:05:00.000Z",
  "organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "data": {
    "negativationId": "5c7e9a1b-3d5f-4b7d-8f0a-1c3e5a7b9d1f",
    "chargeId": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "personId": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "bureau": "serasa",
    "amount": "1512.50"
  }
}

negativation.removed​

Fires when the negativation is cleared at the bureau (e.g. debt settled — removal is automatic after charge.paid).

{
  "event": "negativation.removed",
  "timestamp": "2026-07-30T15:22:00.000Z",
  "organizationId": "0f7a3c1e-2b4d-4e6f-8a9b-1c2d3e4f5a6b",
  "data": {
    "negativationId": "5c7e9a1b-3d5f-4b7d-8f0a-1c3e5a7b9d1f",
    "chargeId": "4a2b6c8d-1e3f-4a5b-9c7d-2e4f6a8b0c1d",
    "personId": "7c1e9f2a-3b4d-4c5e-8f6a-1b2c3d4e5f60",
    "bureau": "serasa"
  }
}