Learn how to retrieve already processed invoices from Lucca Invoices to sync them with your ERP
Retrieving all invoices imported into Lucca Invoices to add them to the ERP requires some precautions, since invoices can be deleted.
For this, the API endpoint to use is the booked-documents
.
Where:
?createdAt.from=
filters out results to only return the ones that were created since your last sync attempt.?invoice.conformityStates
and creditNote.conformityStates=Confirmed
filter out results to only return approved invoices.?fields.root=count
query parameter will request the server to return the total number of items across all pages.purchase
node.Please note that this API retrieves all documents accounted for in the system, invoices and credit notes. Hence the creditNote.conformityState
query parameter in the API request.
Regarding amounts:
expectedAmount
: theoretically expected amount (the order amount).costAmount
: charge amount (case where VAT would not be recoverable).amountIncludingTaxes
: object grouping the excluding taxes amount and VAT. This is the amount I recommend you use.counter
part (converted amount) and a base
(original currency amount) in order to support foreign currencies.