Record an externally-observed fact about an assignment set
Records a fact the operator confirms and moves the set accordingly. offer_sent confirms the authorized offer file was delivered to the fund’s administrator, and requires an authorized file to exist. paid, transferred and accepted are per-receivable and follow one another in that order over a set whose endorsement term is already signed; each names where it came from, and each applies either to named receivables or to the whole surviving composition. accepted is the flip: the contract leaves this portfolio and its write-off is enqueued in the SAME transaction, or neither happens. A repeated confirmation is inert and reported as replayed rather than recording a second send or a second write-off. Re-stating paid is also the way to re-issue a title transfer the registradora refused: the fact writes nothing the second time, while the registry command is reached again through its own deterministic reference. Only a transferred fact whose provenance is registry_provider settles that command — the acceptance’s proof of a moved title is the registradora’s own statement and nobody else’s.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Canonical idempotency request ID. Required: this request moves money, and without a key a retry cannot be told apart from a second instruction.
Path Parameters
Assignment set identifier.
Body
The externally-observed fact being confirmed. offer_sent is the operator confirming the authorized offer file was delivered to the fund's administrator, and requires an authorized file to exist. paid, transferred and accepted are per-receivable progress facts and follow one another in that order; accepted is the administrator accepting the title transfer, which takes the receivable out of this portfolio and writes it off. term_signed is NOT here: it is derived from the signed endorsement instrument itself.
offer_sent, paid, transferred, accepted The administrator's acceptance document, in the pinned shape. Required when factType is accepted and provenance is administrator_file.
Where the fact came from. REQUIRED for paid, transferred and accepted; ignored for offer_sent, which is by construction an operator's own confirmation about a file we generated. On a transferred fact it also decides whether the registradora's title-transfer command is settled: only registry_provider does that, because the acceptance guard treats a settled command as proof the title moved, and a desk's or an administrator's own statement is not the registradora's acatamento. Where the fund reaches no registradora the guard does not apply at all.
administrator_file, registry_provider, operator Narrows a per-receivable fact to exactly these receivables. Omit it to mean the WHOLE surviving composition — the honest reading of an administrator stating that a portfolio was paid. A reference the set does not carry, or carries as cut or removed, is refused. It must be EMPTY when an acceptance document is present: the document already names what was accepted, and two lists are two answers.
5000Response
OK
The set the fact was recorded against.
The fact that was confirmed.
The lifecycle state the set was in.
Validated actor identity that confirmed the fact.
True when nothing was written: the set was already in the resulting state, or every receivable named already carried the fact. A repeated confirmation never records a second send and never enqueues a second write-off.
The lifecycle state the fact moved it to. It advances only once EVERY surviving receivable carries the fact.
The receivables this call wrote off the balance sheet: contracts that left this portfolio with their write-off enqueued in the same transaction.
Where the fact came from, echoed back for the audit trail.
The receivables this call actually recorded the fact for, excluding the ones that already carried it.