API et intégrations

1. Créez une clé d'API

Dans le portail, ouvrez Paramètres › API et webhooks et créez une clé en choisissant ses permissions (lecture des articles, création de factures…). La clé agit au nom de son créateur, sans jamais les droits d'administration ; elle peut expirer et se révoque à tout moment. Elle n'est affichée qu'une fois.

Transmettez-la dans l'en-tête X-Api-Key de chaque requête. Débit : 300 requêtes par minute.

2. Créez une facture par l'API

# 1. Client
curl -X POST https://gestio360.com/api/v1/app/referentiel/customers \
  -H "X-Api-Key: g360_…" -H "Content-Type: application/json" \
  -d '{"name":"Client API","type":"COMPANY"}'

# 2. Facture en brouillon
curl -X POST https://gestio360.com/api/v1/app/facturation/invoices \
  -H "X-Api-Key: g360_…" -H "Content-Type: application/json" \
  -d '{"type":"INVOICE","customerId":"<id du client>",
       "lines":[{"description":"Prestation","quantity":1,"unitPrice":50000}]}'

# 3. Émission (numéro définitif FAC-…)
curl -X POST https://gestio360.com/api/v1/app/facturation/invoices/<id>/issue \
  -H "X-Api-Key: g360_…" -H "Content-Type: application/json" -d '{}'

Les erreurs suivent le format RFC 9457 (application/problem+json) avec un code stable. Les écritures sensibles acceptent l'en-tête Idempotency-Key pour éviter les doublons.

3. Recevez les événements (webhooks)

Déclarez une adresse HTTPS et les événements voulus. Chaque envoi est un POST JSON {"id", "type", "createdAt", "data"} signé : X-Gestio360-Signature: t=<horodatage>,v1=<HMAC-SHA256(secret, horodatage + "." + corps)>. Répondez par un code 2xx ; sinon l'envoi est réessayé pendant 24 heures. Dédoublonnez sur id.

• invoice.issued — Facture, acompte ou avoir émis
• invoice.payment_received — Encaissement client enregistré
• sale.completed — Vente finalisée
• sale.payment_recorded — Règlement d’une vente
• sale.cancelled — Vente annulée
• sale.returned — Retour client
• purchase.receipt_validated — Réception fournisseur validée
• stock.adjusted — Correction ou stock initial
• production.completed — Production déclarée

Référence complète

Toutes les routes, leurs paramètres, les droits requis et les codes d'erreur : référence de l'API (OpenAPI). Une question d'intégration ? Écrivez-nous.