This article describes the different sales invoice statuses in the Finago Procountor API and the available endpoints for processing sales invoices and moving between statuses.
Sales invoice statuses and endpoints
Save
When an invoice is created with the POST /invoices endpoint, it is saved with the status Unfinished (UNFINISHED).
Approve
PUT /invoices/{invoiceId}/approve - Not sent (NOT_SENT), Approved (APPROVED) when the invoice channel is No sending
Send
PUT /invoices/{invoiceId}/send - Sent (SENT)
Change status to unfinished
PUT /invoices/{invoiceId}/unfinished - Unfinished (UNFINISHED)
Mark as paid elsewhere (add payment transaction)
PUT /invoices/{invoiceId}/paymentevents/markpaid - Partly paid (PARTLY_PAID), Marked paid (MARKED_PAID)
The invoice cannot be set to the Paid (PAID) status through the API. The paid status is applied when the payment executed by the bank has been updated automatically by the electronic bank statement.
Invalidate
PUT /invoices/{invoiceId}/invalidate - Invalidated (INVALIDATED)
Other information
You can find more detailed descriptions of the different statuses on the Sales invoice and order statuses page of the manual.