Issue, assert, or answer an obligation
record_obligationRecord one act in an obligation exchange—issue, assert, or respond—to move a committed agreement through performance, acceptance, and settlement.
Instructions
Record one act in the obligation exchange. Three acts, in this order, each signed by a different party, and each carrying that party's own allow decision from verify_mandate.
act=issue: the obligee derives an obligation from a committed agreement and activates it. Needs agreement_id, obligor, obligee, term_path, quantity, unit_code, due_condition, and a decision the obligee obtained for {"action_type": "obligation.activated", "transaction_id": ..., "counterparty_organization_id": <the obligor's org>, "proposed_terms": {"core": {"quantity": ..., "unit_code": ..., "total": }}, "agreement_id": ...}. The transaction moves to in_performance.
act=assert: the obligor asserts it performed. Needs obligation_id, obligor, obligee, asserted_quantity, at least one evidence entry, and a decision the obligor obtained for action_type performance.declared naming the obligee as counterparty, the asserted quantity and unit as proposed_terms, and the obligation_id. An assertion with no evidence is refused with A202-OBLIGATION-ASSERTION-UNEVIDENCED. The transaction moves to acceptance_pending.
act=respond: the obligee accepts or rejects, bound to the exact assertion hash. Needs assertion_id, responder, counterparty, response_type, and a decision the responder obtained for action_type acceptance.granted or acceptance.rejected naming the counterparty and the assertion_id. A response signed by anyone but the obligee is refused with A202-OBLIGATION-RESPONSE-UNAUTHORIZED; accepting less than is owed without naming a remainder obligation is refused with A202-OBLIGATION-REMAINDER-MISSING. Accept moves the transaction to settlement_pending, reject back to in_performance, where the obligor may assert again.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| act | Yes | Which act to record. Which other fields are required depends on it. | |
| obligee | No | act=issue and act=assert. The party owed to. | |
| obligor | No | act=issue and act=assert. The party that owes. | |
| decision | Yes | The result verify_mandate returned for this exact act, passed through unchanged. It must be an allow, made under this party's own mandate, over the act document this tool builds, and made within the last 60 seconds. Where it does not match, the refusal detail states the exact proposed_action to verify. The acting party is the obligee for issue, the obligor for assert, and the responder for respond. | |
| evidence | No | act=assert. At least one entry. Each becomes a signed evidence object the assertion references by hash. | |
| quantity | No | act=issue. Base-10 string of how much is owed. | |
| responder | No | act=respond. Must be the obligee named on the obligation. | |
| term_path | No | act=issue. The owed term, addressed under $.terms.core or $.terms.profile_terms. The obligation points at the agreement's terms and never restates them, so drift shows up as a hash mismatch. | |
| unit_code | No | act=issue. UN/ECE Recommendation 20 common code, matching the terms. | |
| reason_code | No | act=respond with reject. The list is closed and anything else is refused. | |
| agreement_id | No | act=issue. The committed agreement the obligation derives from, prefixed agr_. | |
| assertion_id | No | act=respond. The assertion being answered, prefixed prf_. | |
| counterparty | No | act=respond. The other party, which countersigns the event. | |
| commitment_id | No | act=issue. Optional. Defaults to the agreement's first commitment. | |
| consideration | No | act=issue. The money attached to this obligation as currency and amount, or null. | |
| due_condition | No | act=issue. One of due_at_time with at, due_on_event with act_ref or evidence_type, due_on_discharge with obligation_id, or all_of with at least two of those. Anything else is refused with A202-OBLIGATION-CONDITION-UNKNOWN. | |
| obligation_id | No | act=assert. The obligation being performed, prefixed obl_. | |
| response_type | No | act=respond. | |
| rules_version | No | The rule set version the record is written under. Defaults to 1.3. | |
| accepted_quantity | No | act=respond with accept. Defaults to the asserted quantity. Below what is owed, a remainder_obligation_id is required. | |
| asserted_quantity | No | act=assert. Base-10 string of how much was performed. | |
| remainder_obligation_id | No | act=respond with a short acceptance. The obligation carrying the shortfall, so it stays in the record. |