Développeurs & agences web
Connectez votre site, votre boutique, votre application métier ou l'outil de votre client à SOGESTIO. Une API REST documentée, des clés d'API par société, des webhooks signés et les mêmes règles métier que l'application : numérotation, TVA, stock et comptabilité restent gérés par SOGESTIO.
Le propriétaire ou un administrateur crée une clé dans Intégrations, en lecture seule ou en écriture, avec une date d'expiration. Elle s'envoie dans l'en-tête Authorization: Bearer. Une clé est révocable à tout moment et cesse de fonctionner si son créateur est désactivé.
Chaque route est décrite, avec ses schémas générés depuis les validations du serveur : la documentation ne peut pas diverger du comportement réel. Montants en centimes (entiers), dates ISO, erreurs avec un code stable.
Recevez un appel HTTP quand une facture est validée, un règlement enregistré ou un client créé. Chaque envoi est signé (HMAC-SHA256 avec horodatage) et relancé automatiquement pendant environ 72 heures en cas d'échec.
Envoyez un en-tête Idempotency-Key sur vos créations : si votre appel est rejoué (coupure réseau, nouvel essai), SOGESTIO renvoie le même résultat sans créer de doublon.
Chaque clé n'accède qu'aux données de sa société. Les droits suivent le rôle choisi pour la clé. Les numéros légaux des factures sont attribués par le serveur à la validation, jamais par l'intégration.
Chaque refus porte un code lisible par programme (par exemple invalid_input, amount_mismatch, period_locked) et, pour les saisies, le champ concerné. Pagination par page et pageSize (200 au maximum).
Lister les clients, créer une facture depuis une commande de votre site, puis vérifier la signature d'un webhook côté serveur (PHP).
%22%2F%3E%3Cpath%20d%3D%22M5%2035v5.1l18%2010.4%2018-10.4v-3.7%22%20stroke%3D%22url(%23c)%22%2F%3E%3Cpath%20d%3D%22M5%2019.6%2041%2036.4%22%20stroke%3D%22url(%23b)%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E){kind=small}
curl https://sogestio.ma/api/customers?pageSize=50 \
-H "Authorization: Bearer sgk_xxxxxxxxxxxx_votre_secret"const res = await fetch("https://sogestio.ma/api/invoices", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.SOGESTIO_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": order.id, // safe to retry: never creates a duplicate
},
body: JSON.stringify({
kind: "invoice",
customerId: "c_123",
customerName: "Supérette Al Baraka",
issueDate: "2026-10-07",
currency: "MAD",
lines: [{ label: "Terminal de caisse", quantity: 1, unitPriceHt: 490000, vatRate: 20 }],
}),
});
const invoice = await res.json(); // amounts in centimes: 490000 = 4 900,00 DH$payload = file_get_contents('php://input');
$header = $_SERVER['HTTP_X_SOGESTIO_SIGNATURE']; // "t=1760000000,v1=ab12…"
parse_str(str_replace(',', '&', $header), $sig);
$expected = hash_hmac('sha256', $sig['t'] . '.' . $payload, getenv('SOGESTIO_WEBHOOK_SECRET'));
if (!hash_equals($expected, $sig['v1']) || abs(time() - (int)$sig['t']) > 300) {
http_response_code(400); exit;
}
$event = json_decode($payload, true); // $_SERVER['HTTP_X_SOGESTIO_EVENT'] = "invoice.validated"Abonnez une URL HTTPS à un ou plusieurs événements depuis Intégrations. Le corps contient l'objet concerné ; l'en-tête X-Sogestio-Event indique son type.