RIrillet
Bills

Updates a bill

Changed on

IMPORTANT: This is a full-replace operation (PUT semantics). All fields must be included in the request body — omitting any field will set it to null, wiping existing data. Always call retrieve-a-bill first to fetch the current record, then include ALL existing fields in your update request along with your changes. Bills with line allocations return 422 BillHasSubsidiaryAllocations, even for a no-op update. These allocations cannot be sent through this API; edit the bill in Rillet instead.

put/bills/{bill_id}

Request

Path parameters

bill_idstring required

UUID of the bill to be used in this operation.

Request body

vendor_idstring uuid required
expense_numberstring required
bill_datestring date required
due_datestring date required
impact_datestring date
metadataInlineMetadataValues

Partial metadata update keyed by definition key. Omitting this property preserves all existing metadata. When supplied, omitted keys remain unchanged; null, empty, or whitespace-only values clear only the named key.

Example request

{
  "expense_number": "B123",
  "items": [
    {
      "description": "API Bill",
      "account_code": "11112",
      "amount": {
        "amount": "1.01",
        "currency": "USD"
      },
      "tax_rate": {
        "percentage": "0",
        "tax_amount": {
          "amount": "1.01",
          "currency": "USD"
        },
        "country": "US"
      }
    }
  ],
  "external_references": [
    {
      "type": "xyzSystemId",
      "id": "234",
      "url": "https://xyzsystempage.com/ids/234"
    }
  ],
  "exchange_rate": {
    "base": "USD",
    "target": "USD"
  }
}

Response

OK

vendor_idstring uuid required
expense_numberstring required
bill_datestring date required
due_datestring date required
impact_datestring date
subsidiary_idstring uuid
metadataobject

Values keyed by metadata definition key. Keys without a value are omitted.

idstring uuid required
status'DRAFT' | 'UNPAID' | 'PAID' | 'PARTIALLY_PAID' | 'CREDITED' | 'PARTIALLY_CREDITED' | 'APPLIED' required
updated_atstring date-time required

Timestamp when the bill was last modified

Example response

{
  "expense_number": "B123",
  "items": [
    {
      "description": "API Bill",
      "account_code": "11112",
      "amount": {
        "amount": "1.01",
        "currency": "USD"
      },
      "tax_rate": {
        "percentage": "0",
        "tax_amount": {
          "amount": "1.01",
          "currency": "USD"
        },
        "country": "US"
      }
    }
  ],
  "external_references": [
    {
      "type": "xyzSystemId",
      "id": "234",
      "url": "https://xyzsystempage.com/ids/234"
    }
  ],
  "exchange_rate": {
    "base": "USD",
    "target": "USD"
  }
}

Changes

  • c393d0102005Revision changes
    • breaking

      the /////////// request property type changed from number to string, and format from no format to number

    • breaking

      the /////////////// response's property type changed from number to string, and format from no format to number for status

    • breaking

      the //////////////// response's property type changed from number to string, and format from no format to number for status

    • warning

      added the new DRAFT enum value to the / response property for the response status

    • info

      added the new optional request property

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status