Introduction to Invoices

The Invoices module is the core integration point for submitting and managing sales invoices through the CFIS framework. Once a client has been onboarded, invoices can be submitted to the service for evaluation, distribution, and payment control — all within a single workflow.

The module covers the full lifecycle of an invoice, from initial submission through to distribution, agency case management, and payment tracking.

Invoice service process

Endpoints Overview

Create an invoice POST

Submits a new invoice to the service. The invoice payload includes all relevant parties, line items, payment terms, and processing instructions such as distribution method and payment control configuration.

Upon submission, the service evaluates and distributes the invoice to the buyer according to the specified settings.

Create an Invoice Action POST

Sends one or more actions to be performed against an existing invoice or agency case. Supported actions include adding comments, requesting due date extensions, withdrawing a case, registering direct payments, submitting objections, and more.

Actions are queued as pending and processed by the service accordingly.

Retrieve case details GET

Retrieves detailed information about an invoice and its associated agency case, including current balance, payment history, case events, and a timeline of invoice activity.

Retrieve distribution Information GET

Returns a list of distribution records for submitted invoices, including distribution status, method, timestamps, payment control status, and any associated agency case identifiers.

It is recommended to store the case identifier returned here, as it is required when querying case details.

Retrieve debtor balance GET

Returns the current balance of every debtor of the creditor in a single payload, including outstanding capital, interest and costs, payment status, the most advanced collection stage, and how much of the received payments has already been settled to the creditor.

With includeInvoices=true, each debtor also lists the invoices and cases behind the balance.

Invoice service process#

Endpoints Overview#

Invoice service process

Endpoints Overview