Skip to content

Bill programs: approve, pay

The Bill Verbs approve, pay as MCP do programs, with inputs, result, refusals and an example.

Reference for Bill, one group of Bill programs.

Bill.approve

Approve accepts a coded Bill for payment within the approver’s Mandate and schedules it for its due date. Verb page.

Text
do: return await $.Bill.approve(input)

Emits Bill.approved.

Inputs

InputTypeRequiredDescription
billBillrequiredThe coded Bill.

Returns

OutputTypeRequiredDescription
billBillrequiredThe approved Bill, scheduled for its due date.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Bill.approve({ bill: 'bill_Zorj7Zkbtc' })"
  }
}

Bill.pay

Pay sends an approved Bill’s amount to its Organization on the due date and reconciles the payment to Entries. Verb page.

Text
do: return await $.Bill.pay(input)

Emits Bill.paid.

Inputs

InputTypeRequiredDescription
billBillrequiredThe approved Bill.

Returns

OutputTypeRequiredDescription
transactionTransactionrequiredThe payment Transaction.
billBillrequiredThe Bill, now paid.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

JSON
{
  "name": "do",
  "arguments": {
    "code": "return await $.Bill.pay({ bill: 'bill_Zorj7Zkbtc' })"
  }
}