Exemples de code — API

Clients prêts à copier-coller pour les trois opérations de l’API (ERP en ligne) — certifier, lister et récupérer une facture — en cURL, PHP, Python, JavaScript (Node.js), Java et C#. Toutes les requêtes partagent la même authentification par en-tête X-API-Key et la même base d’URL.

Base URL : https://api.sfec.gouv.cg (production) · https://sandbox.api.sfec.gouv.cg (sandbox).
Authentification : en-tête X-API-Key: <votre_clé> sur chaque requête. Voir Authentification.
Les exemples lisent la clé depuis la variable d’environnement SFEC_API_KEY — ne codez jamais votre clé en dur.

Certifier une facture

POST /api/v1/invoices → 201 Created. Le corps est la facture au format JSON (le SFEC renvoie le numéro de certification, la signature et le QR code). Facture d’exemple cohérente utilisée dans tous les onglets :


{
  "invoice_id": "INV-2026-000123",
  "invoice_type": "salesInvoice",
  "recipient_type": "individual",
  "recipient_name": "Jean Dupont",
  "is_recipient_taxable": false,
  "subtotal": 10000,
  "total_tax_t_amount": 1800,
  "total_tax_r_amount": 0,
  "total_exempt_amount": 0,
  "total_tax_amount": 1800,
  "discount_amount": 0,
  "total_line_discount_amount": 0,
  "additional_cent_tax": 0,
  "electronic_stamp_duty": 0,
  "total_amount": 11800,
  "amount_due": 11800,
  "currency": "XAF",
  "payment_method": "cash",
  "items": [
    {
      "designation": "Service de conseil",
      "type": "service",
      "unit_price": 10000,
      "quantity": 1,
      "subtotal": 10000,
      "discount_amount": 0,
      "discount_type": "fixed",
      "net_amount": 10000,
      "tax_rate": "18",
      "tax_amount": 1800,
      "total_amount": 11800
    }
  ]
}

cURL


curl -X POST "https://api.sfec.gouv.cg/api/v1/invoices" \
  -H "X-API-Key: $SFEC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "invoice_id": "INV-2026-000123",
    "invoice_type": "salesInvoice",
    "recipient_type": "individual",
    "recipient_name": "Jean Dupont",
    "is_recipient_taxable": false,
    "subtotal": 10000, "total_tax_t_amount": 1800, "total_tax_r_amount": 0,
    "total_exempt_amount": 0, "total_tax_amount": 1800, "discount_amount": 0,
    "total_line_discount_amount": 0, "additional_cent_tax": 0, "electronic_stamp_duty": 0,
    "total_amount": 11800, "amount_due": 11800, "currency": "XAF", "payment_method": "cash",
    "items": [{
      "designation": "Service de conseil", "type": "service", "unit_price": 10000,
      "quantity": 1, "subtotal": 10000, "discount_amount": 0, "discount_type": "fixed",
      "net_amount": 10000, "tax_rate": "18", "tax_amount": 1800, "total_amount": 11800
    }]
  }'

PHP


<?php
$invoice = [
    'invoice_id' => 'INV-2026-000123',
    'invoice_type' => 'salesInvoice',
    'recipient_type' => 'individual',
    'recipient_name' => 'Jean Dupont',
    'is_recipient_taxable' => false,
    'subtotal' => 10000, 'total_tax_t_amount' => 1800, 'total_tax_r_amount' => 0,
    'total_exempt_amount' => 0, 'total_tax_amount' => 1800, 'discount_amount' => 0,
    'total_line_discount_amount' => 0, 'additional_cent_tax' => 0, 'electronic_stamp_duty' => 0,
    'total_amount' => 11800, 'amount_due' => 11800, 'currency' => 'XAF', 'payment_method' => 'cash',
    'items' => [[
        'designation' => 'Service de conseil', 'type' => 'service', 'unit_price' => 10000,
        'quantity' => 1, 'subtotal' => 10000, 'discount_amount' => 0, 'discount_type' => 'fixed',
        'net_amount' => 10000, 'tax_rate' => '18', 'tax_amount' => 1800, 'total_amount' => 11800,
    ]],
];
 
$ch = curl_init('https://api.sfec.gouv.cg/api/v1/invoices');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: ' . getenv('SFEC_API_KEY'),
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($invoice),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
 
if ($status === 201) {
    $data = json_decode($response, true);
    echo "Certifiée : {$data['certification_number']}\n";
} else {
    fwrite(STDERR, "Erreur $status : $response\n");
}

Python


import os
import requests
 
invoice = {
    "invoice_id": "INV-2026-000123",
    "invoice_type": "salesInvoice",
    "recipient_type": "individual",
    "recipient_name": "Jean Dupont",
    "is_recipient_taxable": False,
    "subtotal": 10000, "total_tax_t_amount": 1800, "total_tax_r_amount": 0,
    "total_exempt_amount": 0, "total_tax_amount": 1800, "discount_amount": 0,
    "total_line_discount_amount": 0, "additional_cent_tax": 0, "electronic_stamp_duty": 0,
    "total_amount": 11800, "amount_due": 11800, "currency": "XAF", "payment_method": "cash",
    "items": [{
        "designation": "Service de conseil", "type": "service", "unit_price": 10000,
        "quantity": 1, "subtotal": 10000, "discount_amount": 0, "discount_type": "fixed",
        "net_amount": 10000, "tax_rate": "18", "tax_amount": 1800, "total_amount": 11800,
    }],
}
 
resp = requests.post(
    "https://api.sfec.gouv.cg/api/v1/invoices",
    json=invoice,
    headers={"X-API-Key": os.environ["SFEC_API_KEY"], "Accept": "application/json"},
    timeout=30,
)
if resp.status_code == 201:
    print("Certifiée :", resp.json()["certification_number"])
else:
    print("Erreur", resp.status_code, resp.text)

JavaScript


// Node.js 18+ (contexte async / module ESM) — fetch est natif
const invoice = {
  invoice_id: "INV-2026-000123",
  invoice_type: "salesInvoice",
  recipient_type: "individual",
  recipient_name: "Jean Dupont",
  is_recipient_taxable: false,
  subtotal: 10000, total_tax_t_amount: 1800, total_tax_r_amount: 0,
  total_exempt_amount: 0, total_tax_amount: 1800, discount_amount: 0,
  total_line_discount_amount: 0, additional_cent_tax: 0, electronic_stamp_duty: 0,
  total_amount: 11800, amount_due: 11800, currency: "XAF", payment_method: "cash",
  items: [{
    designation: "Service de conseil", type: "service", unit_price: 10000,
    quantity: 1, subtotal: 10000, discount_amount: 0, discount_type: "fixed",
    net_amount: 10000, tax_rate: "18", tax_amount: 1800, total_amount: 11800,
  }],
};
 
const res = await fetch("https://api.sfec.gouv.cg/api/v1/invoices", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.SFEC_API_KEY,
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify(invoice),
});
 
if (res.status === 201) {
  const data = await res.json();
  console.log("Certifiée :", data.certification_number);
} else {
  console.error("Erreur", res.status, await res.text());
}

Java


// Java 11+ — java.net.http.HttpClient
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class CertifyInvoice {
    public static void main(String[] args) throws Exception {
        String body = """
            {
              "invoice_id": "INV-2026-000123",
              "invoice_type": "salesInvoice",
              "recipient_type": "individual",
              "recipient_name": "Jean Dupont",
              "is_recipient_taxable": false,
              "subtotal": 10000, "total_tax_t_amount": 1800, "total_tax_r_amount": 0,
              "total_exempt_amount": 0, "total_tax_amount": 1800, "discount_amount": 0,
              "total_line_discount_amount": 0, "additional_cent_tax": 0, "electronic_stamp_duty": 0,
              "total_amount": 11800, "amount_due": 11800, "currency": "XAF", "payment_method": "cash",
              "items": [{
                "designation": "Service de conseil", "type": "service", "unit_price": 10000,
                "quantity": 1, "subtotal": 10000, "discount_amount": 0, "discount_type": "fixed",
                "net_amount": 10000, "tax_rate": "18", "tax_amount": 1800, "total_amount": 11800
              }]
            }
            """;
 
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.sfec.gouv.cg/api/v1/invoices"))
                .header("X-API-Key", System.getenv("SFEC_API_KEY"))
                .header("Content-Type", "application/json")
                .header("Accept", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();
 
        HttpResponse<String> response = HttpClient.newHttpClient()
                .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

C#


// .NET 6+ — System.Net.Http.HttpClient
using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
 
class CertifyInvoice
{
    static async Task Main()
    {
        string json = """
            {
              "invoice_id": "INV-2026-000123",
              "invoice_type": "salesInvoice",
              "recipient_type": "individual",
              "recipient_name": "Jean Dupont",
              "is_recipient_taxable": false,
              "subtotal": 10000, "total_tax_t_amount": 1800, "total_tax_r_amount": 0,
              "total_exempt_amount": 0, "total_tax_amount": 1800, "discount_amount": 0,
              "total_line_discount_amount": 0, "additional_cent_tax": 0, "electronic_stamp_duty": 0,
              "total_amount": 11800, "amount_due": 11800, "currency": "XAF", "payment_method": "cash",
              "items": [{
                "designation": "Service de conseil", "type": "service", "unit_price": 10000,
                "quantity": 1, "subtotal": 10000, "discount_amount": 0, "discount_type": "fixed",
                "net_amount": 10000, "tax_rate": "18", "tax_amount": 1800, "total_amount": 11800
              }]
            }
            """;
 
        using var http = new HttpClient();
        http.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("SFEC_API_KEY"));
        http.DefaultRequestHeaders.Add("Accept", "application/json");
 
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        var response = await http.PostAsync("https://api.sfec.gouv.cg/api/v1/invoices", content);
        Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());
    }
}

Lister les factures

GET /api/v1/invoices → 200 OK. Pagination (page ≥ 1, pageSize 1–20) et filtres optionnels (invoice_type, date_start, date_end). Voir Lister les factures.

cURL


curl "https://api.sfec.gouv.cg/api/v1/invoices?page=1&pageSize=10&invoice_type=salesInvoice" \
  -H "X-API-Key: $SFEC_API_KEY" \
  -H "Accept: application/json"

PHP


<?php
$query = http_build_query([
    'page' => 1,
    'pageSize' => 10,
    'invoice_type' => 'salesInvoice',
]);
$ch = curl_init("https://api.sfec.gouv.cg/api/v1/invoices?$query");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: ' . getenv('SFEC_API_KEY'),
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "$status\n$response\n";

Python


import os
import requests
 
resp = requests.get(
    "https://api.sfec.gouv.cg/api/v1/invoices",
    params={"page": 1, "pageSize": 10, "invoice_type": "salesInvoice"},
    headers={"X-API-Key": os.environ["SFEC_API_KEY"], "Accept": "application/json"},
    timeout=30,
)
print(resp.status_code, resp.json())

JavaScript


const params = new URLSearchParams({ page: "1", pageSize: "10", invoice_type: "salesInvoice" });
const res = await fetch(`https://api.sfec.gouv.cg/api/v1/invoices?${params}`, {
  headers: { "X-API-Key": process.env.SFEC_API_KEY, "Accept": "application/json" },
});
console.log(res.status, await res.json());

Java


// Mêmes imports que l'exemple « Certifier »
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.sfec.gouv.cg/api/v1/invoices?page=1&pageSize=10&invoice_type=salesInvoice"))
        .header("X-API-Key", System.getenv("SFEC_API_KEY"))
        .header("Accept", "application/json")
        .GET()
        .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());

C#


using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("SFEC_API_KEY"));
http.DefaultRequestHeaders.Add("Accept", "application/json");
 
var url = "https://api.sfec.gouv.cg/api/v1/invoices?page=1&pageSize=10&invoice_type=salesInvoice";
var response = await http.GetAsync(url);
Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());

Récupérer une facture

GET /api/v1/invoices/{id} → 200 OK. {id} est l’identifiant unique (UUID) ou le invoice_number (ex. INV-2026-000123). Renvoie 404 si la facture est introuvable.

cURL


curl "https://api.sfec.gouv.cg/api/v1/invoices/INV-2026-000123" \
  -H "X-API-Key: $SFEC_API_KEY" \
  -H "Accept: application/json"

PHP


<?php
$id = 'INV-2026-000123'; // UUID ou invoice_number
$ch = curl_init('https://api.sfec.gouv.cg/api/v1/invoices/' . rawurlencode($id));
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: ' . getenv('SFEC_API_KEY'),
        'Accept: application/json',
    ],
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status === 200 ? $response : "Erreur $status\n";

Python


import os
import requests
 
invoice_id = "INV-2026-000123"  # UUID ou invoice_number
resp = requests.get(
    f"https://api.sfec.gouv.cg/api/v1/invoices/{invoice_id}",
    headers={"X-API-Key": os.environ["SFEC_API_KEY"], "Accept": "application/json"},
    timeout=30,
)
print(resp.status_code, resp.json() if resp.ok else resp.text)

JavaScript


const id = "INV-2026-000123"; // UUID ou invoice_number
const res = await fetch(`https://api.sfec.gouv.cg/api/v1/invoices/${encodeURIComponent(id)}`, {
  headers: { "X-API-Key": process.env.SFEC_API_KEY, "Accept": "application/json" },
});
console.log(res.status, res.ok ? await res.json() : await res.text());

Java


// Mêmes imports que l'exemple « Certifier »
String id = "INV-2026-000123"; // UUID ou invoice_number
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://api.sfec.gouv.cg/api/v1/invoices/" + id))
        .header("X-API-Key", System.getenv("SFEC_API_KEY"))
        .header("Accept", "application/json")
        .GET()
        .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());

C#


var id = "INV-2026-000123"; // UUID ou invoice_number
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-API-Key", Environment.GetEnvironmentVariable("SFEC_API_KEY"));
http.DefaultRequestHeaders.Add("Accept", "application/json");
 
var response = await http.GetAsync($"https://api.sfec.gouv.cg/api/v1/invoices/{id}");
Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());

Toutes les requêtes exigent l’en-tête X-API-Key. Une clé absente ou invalide renvoie 401 ; une pagination hors plage (pageSize > 20) renvoie 400. Voir les codes d’erreur et la FAQ.

Étape suivante → Référence OpenAPI