THthredfi
Bills

Create bill

Create a new bill for a business with line items. Supports idempotency via external_id.

post/v1/platform/businesses/{business_id}/bills/

Request

  • Base URL
    https://docs.thredfi.com (the document declares no server; this is the origin it was published from)
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or HTTP basic
    • or HTTP bearer
    • or HTTP bearer

Path parameters

business_idstring required

Request body

external_idstring required

Your unique identifier for this bill (used for idempotency)

vendor_idstring uuid nullable

UUID of existing vendor (use this OR vendor_external_id, not both)

vendor_external_idstring

External vendor ID - will auto-create vendor if not found

bill_numberstring

Your internal bill tracking number

vendor_bill_numberstring

Vendor's invoice/bill number from their system

purchase_order_numberstring

Purchase order number if applicable

memostring

Description or notes for this bill

reference_numbersstring[]

Array of additional reference numbers for tracking

attachment_urlsstring[]

Array of URLs to bill documents/PDFs

bill_datestring date

Date bill was issued by vendor (ISO date: YYYY-MM-DD)

received_atstring date-time

Date/time bill was received (ISO 8601 format)

due_atstring date-time

Payment due date/time (ISO 8601 format)

approved_atstring date-time nullable

Date/time bill was approved (triggers journal entry creation)

currency'EUR' | 'GBP' | 'USD' | 'SEK' | 'NOK' | 'DKK' | 'ISK' | 'MYR' | 'SGD' | ''

Bill currency (e.g., GBP, EUR, USD)

  • EUR - Euro
  • GBP - British Pound
  • USD - US Dollar
  • SEK - Swedish Krona
  • NOK - Norwegian Krone
  • DKK - Danish Krone
  • ISK - Icelandic Króna
  • MYR - Malaysian Ringgit
  • SGD - Singapore Dollar

Response

typestring required

Always 'BillData' for type discrimination

idstring uuid required
business_idstring uuid required
external_idstring
statusstring required

Bill status: received, partially_paid, paid, voided

termsstring required

Payment terms (NET_30, NET_60, DUE_ON_RECEIPT, etc.)

issue_datestring date required

Date the bill was issued by vendor (from bill_date)

received_atstring date-time required

Date/time bill was received

due_atstring date-time required

Payment due date/time

paid_atstring date-time required

Full payment completion date/time

voided_atstring date-time required

Void action timestamp

is_overdueboolean required

True if bill is past due date and has outstanding balance

bill_numberstring
vendor_bill_numberstring
purchase_order_numberstring
memostring
reference_numbersunknown
attachment_urlsunknown
metadataunknown
currencystring required
additional_sales_taxes_totalinteger required

Total additional sales taxes in cents

subtotalinteger required

Subtotal amount in cents before taxes

total_amountinteger required

Total bill amount in cents including taxes

outstanding_balanceinteger required

Outstanding balance in cents

paid_by_bank_paymentsinteger required

Amount paid via bank payments in cents (completed only)

paid_by_creditsinteger required

Amount paid via vendor credit notes in cents

needs_reconciliationboolean required

True if has unreconciled bank payments

created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.