Bulk create invoices

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Request body

Schema: InvoiceBulkRequest

s3_keystring

S3 key of the uploaded CSV file containing invoice data.

finalizeboolean

If true, immediately finalize all created invoices.

allow_duplicatesboolean

By default a row that matches an invoice a previous import already created (same customer, due date, total, description and line items) is skipped and reported under duplicates, so uploading the same file twice is safe. Set true to import those rows anyway — they are created without a fingerprint and will not be deduplicated against on future uploads.

historicalboolean

The file holds invoices that were already issued elsewhere — a books migration rather than new billing. Every row is written locally and none reach Stripe, even if the business has an account connected, so nothing can be sent to or charged to a customer. Past due dates are accepted, which they otherwise are not. Use the invoice_date and invoice_number columns to keep each invoice's original date and number.

Responses