Référence

Tout ce que l'API accepte et renvoie. Schémas détaillés dans la référence interactive.

Toutes les routes

Lister les factures d'une entreprise, les plus récentes d'abord :

curl "https://sandbox.otampa.com/invoices?taxpayer_id=3f1c2a8e-5b7d-4c1e-9a2f-6d8e0b4c7a19&limit=20" \
  -H "Authorization: Bearer $TAMPA_API_KEY"

import os

import requests

response = requests.get(
    "https://sandbox.otampa.com/invoices",
    headers={
        "Authorization": f"Bearer {os.environ['TAMPA_API_KEY']}",
    },
    params={"taxpayer_id": "3f1c2a8e-5b7d-4c1e-9a2f-6d8e0b4c7a19", "limit": "20"},
    timeout=120,
)
print(response.status_code, response.json())

const response = await fetch("https://sandbox.otampa.com/invoices?taxpayer_id=3f1c2a8e-5b7d-4c1e-9a2f-6d8e0b4c7a19&limit=20", {
  headers: {
    Authorization: `Bearer ${process.env.TAMPA_API_KEY}`,
  },
});
console.log(response.status, await response.json());

<?php
$ch = curl_init("https://sandbox.otampa.com/invoices?taxpayer_id=3f1c2a8e-5b7d-4c1e-9a2f-6d8e0b4c7a19&limit=20");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer " . getenv("TAMPA_API_KEY"),
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $body, "\n";

Le détail de chaque champ est dans la référence interactive.

Champs d'une facture

L'IFU du vendeur n'est pas à envoyer : Tampa le prend dans l'entreprise désignée par taxpayer_id.

Codes DGI

Types de facture

Groupes de taxe (taxGroup)

Le choix du groupe dépend de la situation fiscale du vendeur et du produit : en cas de doute, demandez à son comptable.

Moyens de paiement (payment[].name)

ESPECES, VIREMENT, CARTEBANCAIRE, MOBILEMONEY, CHEQUES, CREDIT, AUTRE.

Erreurs

Chaque erreur renvoie un detail en français et un request_id. Citez ce request_id si vous écrivez au support.

{
  "detail": "Clé API invalide ou révoquée.",
  "request_id": "5c2e9f0a7b1d4e38"
}

Quand la DGI refuse une facture, detail donne son code et son message :

{
  "detail": {
    "code": "11",
    "description": "(texte de la DGI, en français)"
  },
  "request_id": "8a1f3c5e7d9b2046"
}

Avant la production

La production Tampa ouvrira après la validation de la DGI. Pour être prêt le jour venu :

• La clé API est stockée côté serveur (variable d'environnement, coffre de secrets), jamais dans une application mobile, une page web ou un dépôt Git.
• Chaque facture a sa propre clé d'idempotence, stable : votre numéro de commande ou de ticket.
• Les réponses 409 et 503 sont réessayées avec la même clé ; la réponse 502 arrête l'automate et prévient quelqu'un.
• Le délai d'attente de POST /invoices est d'au moins 120 secondes.
• Votre logiciel garde l'id Tampa, le code MECeF/DGI et les compteurs de chaque facture.
• Le client reçoit le PDF, ou au minimum le code MECeF/DGI et le QR code.
• Un avoir a été testé de bout en bout sur le bac à sable.
• Les groupes de taxe de chaque produit ont été validés par le comptable de l'entreprise.

Changements

Une question ? contact@otampa.com