STstuut
integrations

Push a batch of invoice / credit-memo records from Boomi

Documents with debit_credit_indicator == "H" are routed to the CreditMemo model; "S" lands as an Invoice. Max 100 per request.

post/v2/integrations/providers/boomi/invoices

Request

  • Base URL
    https://api.stuut.ai (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

document_numberstring required

BKPF-BELNR (payment doc for DZ, invoice doc for RX) or VBRK-VBELN. Maps to Invoice.remote_id / CreditMemo.remote_id / Payment.remote_id depending on the row's routing.

document_typestring nullable

BKPF-BLART. Routes the row: 'DZ' = customer payment posting; 'DG' = credit memo; 'DR' / 'RX' = invoice.

invoice_doc_typestring nullable

VBRK-FKART

fiscal_yearstring nullable

BKPF-GJAHR

company_codestring required

BKPF-BUKRS. Tenant routing is done via the inbound Bearer key, not by this field — but Stuut stores it as a custom field for audit and downstream filtering.

customer_codestring required

BSEG-KUNNR / VBRK-KUNRG (payer)

document_datestring date required

VBRK-FKDAT or BKPF-BLDAT; maps to Invoice.issued_at

posting_datestring date nullable

BKPF-BUDAT

net_due_datestring date nullable

Derived from BSEG-ZTERM + ZFBDT. Required for invoices (SHKZG=S); omitted on payment postings (document_type=DZ etc.) which have no due date.

currencystring required

BKPF-WAERS; ISO 4217

exchange_ratestring nullable

BKPF-KURSF

referencestring nullable

BKPF-XBLNR; maps to purchase_order_number

assignmentstring nullable

BSEG-ZUONR

debit_credit_indicator'S' | 'H' required

BSEG-SHKZG; S=debit/invoice, H=credit memo

textstring nullable

BSEG-SGTXT; max 50 chars; maps to Invoice.memo

reason_codestring nullable

BSEG-RSTGR; 3-char code

clearing_document_numberstring nullable

BSEG-AUGBL

clearing_datestring date nullable

BSEG-AUGCP; sets Invoice.paid_at

status_openboolean nullable

Optional. True if the document came from BSID (open); False if from BSAD (cleared). When omitted, Stuut derives status from clearing_date — a row with a clearing date is treated as cleared (PAID), otherwise OPEN.

billing_documentstring nullable

Original SD billing document number (VBRK-VBELN). Identifies the invoice on the SD side when the FI accounting doc differs.

invoice_referencestring nullable

BSEG-REBZG — accounting document number of the original invoice this clearing/payment line points at. Populated on payment & credit-memo lines that reference an invoice.

payment_referencestring nullable

Payment-side correlation token (e.g. BSEG-KIDNO, XREF1/2/3). Used to pair lockbox / EFT / ISO 20022 payments with the invoice they clear when assignment/reference are not specific enough.

Response

Successful Response

received_atstring date-time required

Changes

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