API Reference (Endpoints)

This section details the endpoints of the Fiscalis API. All requests must be authenticated via a Bearer Token and use the application/json format.

The base URL for all your billing requests is: http://87.106.10.40/api/v1

1. Submit an Invoice for Certification

This is the main endpoint of the API. It allows you to transmit the data of an invoice from your ERP (e.g., Dolibarr) so that Fiscalis can handle the communication with the MCF or the DGI Web API in the background (merging the calculation request and the finalization request).

Endpoint: POST /Invoice

Required Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body (JSON Payload)

The payload reflects the requirements of the DGI. Note that your company's identification information (such as the seller's NIF or ISF) is automatically injected by Fiscalis based on your API key.

Multi-currency Management

If your source system is in dollars (USD), send the amounts in CDF specifying the curCode, curDate, and curRate fields. Fiscalis will transmit these values to allow the display of both currencies on the final document. Set the values according to whether the invoice is in Congolese Francs (CDF) "curCode":"CDF" and "curRate":-1.

{
    "nif": "A0905435T",
    "rn": "FC0002",
    "mode": "ht",
    "isF": "TEST_SFE",
    "type": "FV",
    "curCode": "USD",
    "curDate" : "2026-02-28T17:05:06.568Z",
    "curRate": "2500",
    "items": [
        {
            "code": "LR 1515",
            "name": "STYLO BIC",
            "type": "BIE",
            "price": "600.00",
            "quantity": "2.0",
            "taxGroup": "B",
            "taxSpecificValue": "0.00%",
            "taxSpecificAmount": "0.00",
            "origìnaÎPříče": "600.00",
            "priceModification": ""
        },
        {
            "code": " ---DEEE",
            "name": "MAIN D'OEUVRE",
            "type": "SER",
            "price": "30.00",
            "quantity": "1.0",
            "taxGroup": "B",
            "taxSpecificValue": "0.00%",
            "taxSpecificAmount": "0.0",
            "originalPrice": "30.00",
            "priceModification": ""
        }
    ],
    "client": {
        "nif": "A000000A",
        "type": "PM",
        "typeDesc": "Personne morale",
        "name": "DUPONT",
        "contact": "+330562380000",
        "address": "25 rue du taur 31850 MONTRABE"
    },
    "payments": [
        {
            "name": "CHEQUES",
            "amount": "1476.0",
            "curCode": "USD",
            "curRate": "2500"
        }
    ],
    "operator": {
        "id": "01",
        "name": "ADMIN"
    }
}

Key Field Details

rn: The invoice number generated by your SFE (Enterprise Billing System).
type: Invoice type. Use:
- FV: Sales invoice
- FT: Down payment or advance invoice
- FA: Credit note
- EV: Export sales invoice
- ET: Export down payment invoice
- EA: Export credit note
mode: Unit price mode. Must be ttc or ht.
taxGroup (Items): Letter from A to N identifying the tax category of the item.

Tax Group	Name	Description
A	Exempt	Transaction not subject to VAT carried out by a company subject to VAT (see the provisions of Articles 15 to 18 and 20 of Ordinance-Law No. 10/001 of August 20, 2010 establishing the value added tax). NB: VAT is not charged.
B	Taxable 16%	Transaction subject to VAT carried out by a company subject to VAT at the rate of 16% (see the provisions of Articles 3 to 12 and 35 of Ordinance-Law No. 10/001 of August 20, 2010 establishing the value added tax). NB: VAT is charged at 16%.
C	Taxable 5%	Transaction subject to VAT carried out by a company subject to VAT at the reduced rate of 5% (see the provisions of Articles 3 to 12 and 35 of Ordinance-Law No. 10/001 of August 20, 2010 establishing the value added tax). NB: VAT is charged at 5%.
D	Derogatory VAT regimes	Taxable transaction carried out by a company subject to VAT, for which the State bears the VAT on behalf of the beneficiary (case of diplomatic missions, consulates and international organizations). The use of this group must be justified by the documents issued by the DGI attesting to the exemption. (see the provisions of Article 19 of Ordinance-Law No. 10/001 of August 20, 2010). NB: VAT is not charged.
E	Export and similar operations	Export sales transaction of taxable or non-taxable goods and services carried out by a company (see the provisions of Article 35 of Ordinance-Law No. 10/001 of August 20, 2010). NB: VAT charged at 0%.
F	Public market VAT with external financing (16%)	Taxable transaction at the rate of 16% carried out by a company subject to VAT, for which the State bears part or all of the VAT in the form of a tax credit (see the provisions of Articles 14 to 16 of Ministerial Order No. 076 of January 13, 2012). NB: VAT charged at 16%, but paid by tax credit.
G	Public market VAT with external financing (5%)	Taxable transaction at the rate of 5% carried out by a company subject to VAT, for which the State bears part or all of the VAT in the form of a tax credit (see the provisions of Articles 14 to 16 of Ministerial Order No. 076 of January 13, 2012). NB: VAT charged at 5%, but paid by tax credit.
H	Consignment / deconsolidation of packaging	Transaction relating to sums collected as a deposit upon delivery of identifiable, recoverable and reusable packaging (see Article 29 of Ordinance-Law No. 10/001 of August 20, 2010). NB: VAT is not charged.
I	Guarantee and deposit	Transactions related to sums deposited as a guarantee for an operation; they do not constitute turnover (see Article 29 of Ordinance-Law No. 10/001 of August 20, 2010). NB: VAT is not charged.
J	Disbursements	Transaction relating to the reimbursement of expenses invoiced for their exact amount to the customer (see Article 29 of Ordinance-Law No. 10/001 of August 20, 2010). NB: VAT is not charged.
K	Transactions carried out by non-taxable persons	Transactions carried out by categories not having the quality of a person liable for VAT (e.g., companies under the synthetic tax regime, etc.). NB: VAT is not charged.
L	Levies on sales	Taxes and levies applied to sales (parafiscal taxes, provincial taxes, excise duties, etc.) which are not included in the VAT tax base. NB: VAT is not charged.
M	Regulated sales with specific VAT	Transactions carried out by a person liable for VAT at a specific rate, in application of a particular regulation applicable to his sector of activity (e.g., hydrocarbons whose VAT is regulated by the price structure). NB: Only the amount excluding taxes is invoiced.
N	Specific VAT	This group traces the specific VAT related to regulated sales invoiced under tax group M. NB: Only the amount of the specific VAT is invoiced.
O	Taxable 1%	Transaction subject to VAT carried out by a company subject to VAT at the reduced rate of 1%. NB: VAT is charged at 1%.
P	Public market VAT with external financing (1%)	Taxable transaction at the rate of 1% carried out by a company subject to VAT, for which the State bears part or all of the VAT in the form of a tax credit . NB: VAT charged at 1%, but paid by tax credit.

payment.name: Payment method. Values accepted by the DGI: ESPECES, VIREMENT, CARTEBANCAIRE, MOBILEMONEY, CHEQUES, CREDIT, or AUTRE.

1. Submit an Invoice for Certification​

Required Headers​

Request Body (JSON Payload)​

Key Field Details​

1. Submit an Invoice for Certification

Required Headers

Request Body (JSON Payload)

Key Field Details