Ingest Workflow Bill

post

https://connect.digits.com/v1/workflow/bills/ingest

Ingest one vendor bill document for asynchronous processing. Repeating an
equivalent request with the same external ID returns the existing bill and
attempt identities; a different request with that external ID is rejected.

Requires scope: bills:manage.

Body Params

IngestWorkflowBillRequest accepts exactly one vendor bill document for
asynchronous extraction and workflow creation.

entity

object

required

Client organization and entity that owns the bill.

userId

string

User's Digits-assigned ID.

userExternalId

string

User's caller-assigned ID, resolved on the backend.

externalId

string

required

Caller-assigned bill ID. Together with the resolved application data
source, this is the stable replay and conflict boundary.

vendor

object

Existing vendor selector or vendor definition. A new external ID creates
the vendor. For an existing external ID, stored profile fields remain
authoritative while new payment destinations may still be added. Omit to
use the vendor extracted from the document and best-effort data-source matching.

document

object

required

The single document to ingest.

invoiceNumber

string

Authoritative invoice number. Omit to use the extracted value.

referenceNumber

string

Authoritative reference number. Omit when the bill has no caller-assigned reference.

billDate

date-time

Authoritative bill date. Omit to use the extracted value.

dueDate

date-time

Authoritative due date. Omit to use the extracted value.

memo

string

Authoritative memo. Omit to use the extracted value.

approverUserId

string

Authoritative Digits-assigned approver user ID. Omit to use workflow defaults.

Responses

200OK

defaultDefault error response