An InvoiceReport represents the top level, header information attached to one of potentially many invoices for a particular order.
Invoices may be sent to the RepSpark API for orders not originating from the RepSpark web and mobile apps. For example, many brands want to provide their sales representatives and customers access to historical invoices from the past couple of years. Refer to Batch Types and Sync Modes to learn more about sending millions of invoices to the RepSpark API.
Delta syncs for InvoiceReports generally include InvoiceItems, but invoice headers and items can also be sent separately if desired - using the InvoiceReport sync for headers and InvoiceItemReport sync for the invoice line items. If any InvoiceItems are included at all in an InvoiceReport sync, then all InvoiceItems will be diffed - this can be used to delete specific InvoiceItems from invoices. If no InvoiceItems are included in the sync, then it is assumed that only Invoice report headers need to be updated.
Recommended sync cadence
Delta syncs should be run once per day and on-demand when needed.
Full syncs should only be necessary during initial setup or when an overall data refresh is needed.
Any Code/Description pair values typically found in Options data (e.g. Colors, Divisions) must have their Descriptions defined in Reports, as reporting data does NOT pull from the Options resource. This is because the report may have different description values from what is currently defined in the Option data. For example, the color code ABC may have been mapped to a different value in 2021 than what it is today.