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 and the newest one to cover the lines still in the lot and, when the confirmation names the file sent (offerFileId), to be that file (LENDER-1505); once a later download replaced a file, the confirmation must name it. paid, transferred and accepted are per-receivable and follow one another in that order once the set’s payment is open: for a fund whose administrator generates the term, as soon as the fund’s return file is accepted; for a fund the Lender emits for, once that term is 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. paid states amountPaid, what the bank shows the fund sent for the lot; while it differs, net of the desk’s refunds for lines taken out, from the frozen prices of the paid lines still in the lot by more than the lot’s tolerance, the title transfer waits and the acceptance is held (LENDER-0511). Settling the payment commands no title for a line under an open dead-line case. accepted is refused while a line still in the lot is not paid (LENDER-0516). Once a line of the lot is accepted, a paid that states a new amount is refused (LENDER-0515): money the fund sends after is settled at the exception desk.
Autorizaciones
JWT bearer token issued by the identity provider.
Encabezados
Canonical idempotency request ID. Required: this request moves money, and without a key a retry cannot be told apart from a second instruction.
Parámetros de ruta
Assignment set identifier.
Cuerpo
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.
What the fund sent for the lot in all, as the bank shows it, less only what the desk refunded it for an over-payment. Never subtract refundToFund: the Lender keeps what the desk settles for lines taken out through their case apart and nets it itself. Decimal string in the lot's currency, above zero, at most 2 decimal places. REQUIRED on paid and refused on any other fact (LENDER-0510). The latest statement wins until a line of the lot is accepted; after that it stands (LENDER-0515). While it differs, net of those refunds, from the frozen prices of the paid lines still in the lot by more than the tolerance the lot froze from its fund, a fund_payment_divergence case is open, the title transfer waits and the acceptance is held (LENDER-0511).
The X-Offer-File-Id of the offer file that was sent. On offer_sent, when present, it must be the newest file authorized for the lot, or nothing is recorded (LENDER-1505): a file another download replaced is not the offer the Lender serves as sent, and a repeated confirmation naming it is refused too. Required on offer_sent once the lot holds more than one authorized file, which happens when a line left the lot and a later download replaced the file. Ignored on any other fact.
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.
5001 - 128\SRespuesta
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.