API Facturation Nouveau

🔑 Authentification

Toutes les requêtes exigent une clé API. Envoyez-la dans l’en-tête :

Authorization: Bearer elo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# ou alternativement :
X-API-Key: elo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Les clés API sont créées dans l’atelier EL OUATINE (onglet « API Facturation ») et affichées une seule fois.

1. Créer une facture

POST /api/invoices/v1/create — renvoie le numéro, l’URL du PDF et l’URL de vérification.

customer_name · customer_email? · customer_phone? · lang: fr|en · items: [{description, qty, unit_price}] · notes? · status: paid|pending|proforma

curl -X POST https://securecelleouatine.com/api/invoices/v1/create \
  -H "Authorization: Bearer elo_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "customer_name": "Ahmed Benali",
    "customer_phone": "+213600000000",
    "lang": "fr",
    "items": [
      { "description": "iCloud removal - iPhone 14", "qty": 1, "unit_price": 45.00 },
      { "description": "Screen protector", "qty": 2, "unit_price": 3.50 }
    ],
    "notes": "Paid in cash"
  }'

{
  "ok": true,
  "data": {
    "id": 128,
    "number": "INV-2026-0042",
    "total": 52.00,
    "currency": "USD",
    "status": "paid",
    "pdf_url": "https://securecelleouatine.com/api/invoices/v1/128/pdf",
    "verify_url": "https://securecelleouatine.com/verify-invoice?inv=INV-2026-0042&code=A1B2C3D4",
    "verify_code": "A1B2C3D4",
    "warnings": [],
    "quota": { "limit": 50, "used": 7, "month": "2026-10" }
  }
}

2. Lister les factures

GET /api/invoices/v1 — vos factures uniquement, avec pagination.

curl https://securecelleouatine.com/api/invoices/v1?limit=20 \
  -H "Authorization: Bearer elo_YOUR_KEY_HERE"

3. Télécharger le PDF

GET /api/invoices/v1/:id/pdf — le même design « comme le contrat », en français et anglais.

curl -o INV-2026-0042.pdf \
  https://securecelleouatine.com/api/invoices/v1/128/pdf \
  -H "Authorization: Bearer elo_YOUR_KEY_HERE"

Note : les PDF ne supportent que les caractères latins — les noms arabes s’impriment avec « ? ».

⚠️ Erreurs

400 = données invalides · 401 = clé manquante ou invalide · 404 = facture introuvable · 429 = quota mensuel ou limite de débit dépassé

🎫 Obtenir une clé

Les clés API sont créées dans l’atelier EL OUATINE (onglet « API Facturation ») et affichées une seule fois.