Invoices represent the core financial documents submitted by suppliers to initiate the invoice financing process. An invoice should include essential information such as the invoice number, the total amount owed by the buyer, the due date for payment, the currency, and a reference to the supplier and buyer company identifier.
The invoice object
Attribute
Type
Description
id
string
Unique identifier for the object
supplier
string
ID of the company created using our Companies API endpoint that represents the supplier.
An arbitrary string that references the readable invoice number presented on the invoice document for the buyer’s reference
client_reference_id
string
A unique string to reference the invoice in your database. This can be your internal system’s database invoice id that can be used to reconcile the invoice with your internal systems.
Total amount of invoice in decimal format (i.e. 123.53)
currency
string
Three-letter ISO 4217 currency code, in lowercase. Only usd, gbp or eur are accepted at this moment.
type_of_goods
string
Type of gooods in the invoice, can be commodities, perishables and other. Refer to Types of goods below.
due_date
date
Due date of invoice payment
financing
hash
Contains information related to the financing of the invoice. This information will be available when an invoice has completed a financing session.
status
string
The status of the financing application for this invoice. Can only be one of new, additional_info_required, declined, requesting_signatures, approved, financed or repaid. Refer to Invoice Statuses below.
Invoice statuses
Status
Description
draft
Invoice is created but not submitted yet
new
Newly submitted invoice
additional_info_required
Additional documents or information are requested for the invoice
declined
Invoice has been declined
requesting_signatures
Documents were sent to buyer and supplier for signing
approved
Invoice has been approved and ready for financing
financed
Invoice is financed
overdue
Buyer has not repaid the invoice in time
repaid
Invoice has been repaid by the buyer
Types of goods
Type of goods
Description
Commodities
Raw materials or primary agricultural products that are homogenous, interchangeable, and fungible. This means the same commodity type possesses uniform quality regardless of who produced it. Commodities can be broadly grouped into soft and hard commodities. Soft commodities are agricultural products grown and directly consumed or used as raw materials for producing goods. Soft commodities include grains, livestock, oilseeds, and other softs. Hard Commodities are extracted and not grown from the earth; hence, they tend to be non-renewable. They involved energy commodities, metals, and minerals.
Perishables
Typically food items, have a limited shelf life and deteriorate relatively quickly if not properly stored or consumed. These products are highly sensitive to temperature, humidity, and time. Categories of perishables are fresh food items, frozen food items, pharmaceuticals, plants and biological materials. They share similar attributes, such as having a short shelf life, will spoil if not stored and shipped at the right temperature and moisture levels and tend to require special shipping considerations. Examples of perishable foods include fresh fruits and vegetables, meat, fish, and dairy products.
