This article describes purchase invoice statuses and related actions in the Finago Procountor API.

Save
When an invoice is created with the POST /invoices endpoint, it is saved with the status Unfinished (UNFINISHED).

Send to circulation
PUT /invoices​/{invoiceId}​/sendToCirculation

Verify
PUT ​/invoices​/{invoiceId}​/verify - Verified (VERIFIED)

Approve
PUT /invoices​/{invoiceId}​/approve - Approved (APPROVED)

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 to the invoice has been updated automatically from the reference payments received from the bank.

Remove payment transaction
DELETE /invoices​/{invoiceId}​/paymentevents​/{paymentEventId}

Pay
POST /payments - Payment queued (PAYMENT_QUEUED), Payment sent to bank (PAYMENT_SENT_TO_BANK), Partly paid (PARTLY_PAID), Paid (PAID)

Mark as payment denied
PUT ​/invoices​/{invoiceId}​/reject - Payment denied (PAYMENT_DENIED)

Invalidate
PUT ​/invoices​/{invoiceId}​/invalidate - Invalidated (INVALIDATED)

Received
A purchase invoice is in the Received status (RECEIVED) when it has arrived in the system as an e-invoice or via the scanning service.
​

You can find more detailed descriptions of the different statuses on the Purchase invoice and order statuses page of the manual.