Sign in
/billing_new
/billing_new/invoices

Preview selected orders

Selects matching uninvoiced ordinary charges, reports omitted items, and previews current taxes and billing dates without saving. Period dates do not filter charges. | authz: allowed_org_types=[provider], min_org_role=operator | (InvoiceCreateFromOrdersReq) -> (InvoicePreviewFromOrdersRes)

post/billing_new/invoices/preview_from_orders/v1

Request body

schema_version1 required
invoice_type'accounts_receivable' | 'accounts_payable' required
counterparty_org_idstring nullable

Must be a string starting with org_

counterparty_off_chrt_org_data_idstring nullable
counterparty_driver_idstring nullable
currency_code'USD' | 'CAD' | 'EUR' | 'GBP' | 'MXN' | 'AUD' | 'JPY' | 'CNY' | 'CHF' | 'INR' required
namestring nullable
descriptionstring nullable
export_ref__sage__department_idstring nullable
export_ref__sage__customer_idstring nullable
period_start_at_timestampstring date-time nullable

Supply both bounds or omit both to derive the period from delivery completion days in UTC.

period_end_at_timestampstring date-time nullable

When derived, the exclusive UTC midnight after the last delivery day. Explicit bounds are preserved.

order_idsstring[] required

Response

Successful Response

tax_configurations_by_line_item_idobject
already_invoiced_line_item_idsstring[]
finalized_line_item_idsstring[]
unmatched_line_item_idsstring[]
tax_line_item_idsstring[]
orders_without_selected_chargesstring[]

Changes

Changed in 2 of the 9 revisions of this API.14

  • 1a1e5a995fc913See the full diff
    • ▲

      removed the required property /// from the response with the status

      response-required-property-removed

    • ○

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

      response-optional-property-added

    • ○

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

      response-required-property-added

    • ○

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

      response-required-property-added

  • 9a30893d8db11See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog