Vendor — Invoices

Push an invoice

Submit an ERP-generated invoice. Zobrx maps it to the PO, validates quantities, computes the GST tax split, and submits to Amazon. Idempotent on externalInvoiceId (and the Idempotency-Key header). Scope vendor:invoices:write.

post/vendor/invoices

Request

  • Base URL: https://app.zobrx.com/api/v1
  • URL: https://app.zobrx.com/api/v1/vendor/invoices
  • Auth: HTTP bearer

Headers

X-Zobrx-Integration-Idstring

Selects which connected Vendor Central account to act on (its integration id OR Amazon vendor id). Optional when only one is connected.

Idempotency-Keystring

Request body

poNumberstring required

The PO this invoice settles.

externalInvoiceIdstring required

Your ERP's invoice number (dedupe key).

invoiceDatestring date

Response

Replay (same externalInvoiceId already ingested).

invoiceIdstring
externalInvoiceIdstring nullable
poNumberstring nullable
source'zobrx-generated' | 'erp-api' | 'erp-pull' | 'upload'
intakeStatus'received' | 'mapped' | 'validated' | 'submitted' | 'failed' | 'rejected'
status'submitted' | 'failed'
validationErrorsstring[]
amazonTransactionIdstring nullable
amazonProcessingStatus'Processing' | 'Success' | 'Failure' nullable

Confirmed outcome from the Amazon Vendor Transaction Status API. null until polled (typically minutes after submit). Success = Amazon accepted; Failure = rejected (see amazonProcessingErrors).

submittedAtstring date-time nullable

Changes

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