Skip to main content

Repeated header per line (positions)

Same shape as the column-names variant, but the sender omits the header row. A new invoice starts on any change of col_1 (the invoice number). Use this when the sender's file has no header row.

Config item ID

generic-csv-repeated-header-positions

Pick this in the admin portal when creating a customer file format from a global template, or select the same config item ID via the API.

Parse settings

{ "delimiter": ",", "columns": false }

Row layout

Every row is a line item. Column 1 is the invoice number, which determines invoice boundaries. The rest of the header-level columns repeat across every row of the same invoice; line-level columns vary per row.

Loops

invoice loop ← recordType: header, condition: columnChange col_1
line loop ← recordType: line, condition: always

Fields

One record schema. Every row carries both header-level and line-level columns; header-level columns repeat across the invoice, line-level columns vary per row.

PositionFieldTypeDescription
col_1header.invoice_numbertextSender-issued invoice number.
col_2header.invoice_datedateDate the invoice was issued.
col_3header.due_datedateDate the full amount is due.
col_4header.delivery_datedateDate the goods or services were delivered.
col_5header.currency_codetextISO 4217 currency code (USD, EUR, GBP, …).
col_6header.order_number_1textBuyer purchase order number.
col_7header.contract_numbertextMaster or framework contract reference.
col_8header.customer_tax_idtextBuyer VAT / tax registration number.
col_9header.net_amountnumberInvoice-level net (pre-tax) total.
col_10header.tax_amountnumberInvoice-level total tax.
col_11header.gross_amountnumberInvoice-level total gross (net + tax).
col_12sender.supplier_nametextSupplier / vendor legal name.
col_13sender.supplier_tax_idtextSupplier VAT / tax registration number.
col_14receiver.customer_nametextBuyer / customer legal name.
col_15bill_to.address_nametextBill-to party name or department.
col_16bill_to.streettextBill-to street address.
col_17bill_to.citytextBill-to city.
col_18bill_to.postal_codetextBill-to postal / ZIP code.
col_19bill_to.statetextBill-to state or region.
col_20bill_to.countrytextBill-to country (ISO 3166-1 alpha-2).
col_21ship_to.address_nametextShip-to party name or department.
col_22ship_to.streettextShip-to street address.
col_23ship_to.citytextShip-to city.
col_24ship_to.postal_codetextShip-to postal / ZIP code.
col_25ship_to.statetextShip-to state or region.
col_26ship_to.countrytextShip-to country (ISO 3166-1 alpha-2).
col_27payment.reference_numbertextPayment reference the buyer should quote when remitting.
col_28payment.bank_accounttextSupplier bank account (IBAN or local format).
col_29payment.bank_nametextSupplier bank name.
col_30payment.payment_methodtextPreferred payment method (ACH, wire, cheque, …).
col_31line.product_code_1textSupplier product / SKU code.
col_32line.product_nametextProduct or service description.
col_33line.quantitynumberLine quantity.
col_34line.unit_pricenumberPrice per unit.
col_35line.unit_of_measuretextUnit of measure (EA, BX, KG, …).
col_36line.net_amountnumberLine net (pre-tax) amount.
col_37line.tax_ratenumberLine tax rate as a percentage.
col_38line.tax_amountnumberLine tax amount.
col_39line.gross_amountnumberLine gross amount (net + tax).

Sample file

Download generic-csv-repeated-header-positions.csv

INV-2025-0042,2026-07-15,2026-08-14,2026-07-12,USD,PO-88190,MSA-2024-11,US-849201,1250.00,112.50,1362.50,Northwind Manufacturing LLC,US-441290,Contoso Retail Group,Contoso Accounts Payable,"450 Market Street, Suite 200",San Francisco,94105,CA,US,Contoso Distribution Center,901 Airport Way,Reno,89502,NV,US,INV-2025-0042,US1234567890,First National Bank,ACH,SKU-4471,Stainless Bolt M6 x 20 (box of 100),5,85.00,BX,425.00,9.00,38.25,463.25
INV-2025-0042,2026-07-15,2026-08-14,2026-07-12,USD,PO-88190,MSA-2024-11,US-849201,1250.00,112.50,1362.50,Northwind Manufacturing LLC,US-441290,Contoso Retail Group,Contoso Accounts Payable,"450 Market Street, Suite 200",San Francisco,94105,CA,US,Contoso Distribution Center,901 Airport Way,Reno,89502,NV,US,INV-2025-0042,US1234567890,First National Bank,ACH,SKU-4472,Stainless Nut M6 (box of 200),3,55.00,BX,165.00,9.00,14.85,179.85
INV-2025-0042,2026-07-15,2026-08-14,2026-07-12,USD,PO-88190,MSA-2024-11,US-849201,1250.00,112.50,1362.50,Northwind Manufacturing LLC,US-441290,Contoso Retail Group,Contoso Accounts Payable,"450 Market Street, Suite 200",San Francisco,94105,CA,US,Contoso Distribution Center,901 Airport Way,Reno,89502,NV,US,INV-2025-0042,US1234567890,First National Bank,ACH,SKU-9013,Vibration Damper Kit,2,330.00,EA,660.00,9.00,59.40,719.40
INV-2025-0043,2026-07-15,2026-08-14,2026-07-14,USD,PO-88191,MSA-2024-11,US-849201,540.00,48.60,588.60,Northwind Manufacturing LLC,US-441290,Contoso Retail Group,Contoso Accounts Payable,"450 Market Street, Suite 200",San Francisco,94105,CA,US,Contoso Warehouse 7,2200 Industrial Blvd,Sparks,89434,NV,US,INV-2025-0043,US1234567890,First National Bank,ACH,SKU-4471,Stainless Bolt M6 x 20 (box of 100),4,85.00,BX,340.00,9.00,30.60,370.60
INV-2025-0043,2026-07-15,2026-08-14,2026-07-14,USD,PO-88191,MSA-2024-11,US-849201,540.00,48.60,588.60,Northwind Manufacturing LLC,US-441290,Contoso Retail Group,Contoso Accounts Payable,"450 Market Street, Suite 200",San Francisco,94105,CA,US,Contoso Warehouse 7,2200 Industrial Blvd,Sparks,89434,NV,US,INV-2025-0043,US1234567890,First National Bank,ACH,SKU-9014,Vibration Damper Refill Pack,1,200.00,EA,200.00,9.00,18.00,218.00

Expected extraction

Running the sample through this shape's seed extracts 2 invoices with fully populated header, sender, receiver, bill-to, ship-to, payment, and line records. Totals, dates, and identifiers round-trip without loss.