API Agences Partenaires — branchez n’importe quelle agence sur vos opérations

Intégrer une fois, servir tous les marchands COD Scale

La plupart des e-commerçants COD externalisent une partie du pipeline — la confirmation à un centre d’appels, l’emballage à un entrepôt, la livraison à un transporteur, les relances à une cellule de suivi. L’API Agences Partenaires en fait un simple branchement : le marchand émet une clé à permissions depuis son tableau de bord, et l’agence traite ses commandes via une API documentée et versionnée.

Pour les agences, l’équation est encore meilleure : construisez l’intégration une seule fois et chaque marchand COD Scale qui vous connecte devient un client servi dès le premier jour — sans intégration sur mesure par marchand.

Trois façons de se connecter pour une agence

• API — pour les agences avec développeurs (ou un agent IA de code) : API REST avec spécification OpenAPI, endpoints par métier, écritures idempotentes et cloisonnement strict par connexion.
• Google Sheets — pour les agences non techniques : la plateforme entretient une feuille vivante par métier. Les colonnes verrouillées portent la file de travail ; l’agence saisit ses résultats dans ses colonnes ✏️ avec des listes déroulantes ; tout se synchronise automatiquement environ toutes les 10 minutes, et une colonne Résultat montre exactement ce qui a été appliqué.
• Console Agence — un identifiant gratuit pour le responsable d’agence : tous les marchands connectés, les compteurs de travail par métier, les Google Sheets et la documentation API. Le marchand relie une agence en lui remettant un code d’invitation à usage unique.

Le modèle de permissions

Une connexion porte n’importe quelle combinaison de quatre permissions : confirm (appels de confirmation), fulfillment (emballage et remise), courier (livraison et tracking) et suivi (relances de livraison). Une agence hybride — un transporteur qui fait aussi du fulfillment — reçoit simplement les deux permissions et peut s’expédier les colis à elle-même.

Le marchand garde la main en permanence : les permissions se modifient en direct et s’appliquent dès la requête suivante, la clé se régénère en un clic (l’ancienne meurt instantanément), et une connexion peut être suspendue puis réactivée à tout moment.

Pour les développeurs et les agents IA de code

L’API est documentée par trois artefacts lisibles par machine, publics et toujours synchrones avec la production : la spécification OpenAPI 3 sur https://app.codscale.io/api/partner/openapi.json (générez votre client depuis celle-ci), le guide d’intégration complet en markdown brut sur https://app.codscale.io/api/partner/integration.md, et un index llms.txt sur https://app.codscale.io/api/partner/llms.txt.

Vous construisez avec un agent IA ? Collez-lui ceci : « Tu intègres mon agence avec l’API Agences Partenaires de COD Scale. Récupère https://app.codscale.io/api/partner/integration.md et https://app.codscale.io/api/partner/openapi.json, respecte les règles d’or et la checklist du guide, et construis l’intégration pour mon métier. » Le guide contient l’authentification, le démarrage rapide, les exemples par métier, le contrat d’erreurs et la logique de reprise — tout ce qu’il faut pour construire sans deviner.

Sûr par conception

• Une agence ne voit que le travail que le marchand lui a routé — les autres commandes et colis sont invisibles, pour toutes les agences, toujours.
• Les données partagées sont réduites au nécessaire : client, adresse, articles, montant COD — jamais vos coûts, marges ou finances.
• Aucun statut de commande n’est fixé directement par une agence ; il dérive de vos propres règles de transition, les mêmes que pour votre équipe interne.
• Écritures idempotentes (reprises sûres), limitation de débit, et chaque action s’inscrit dans la chronologie de la commande au nom de l’agence — auditabilité totale.

Comment un marchand connecte une agence

• Ouvrez Réglages → Connexions Agences dans le tableau de bord (plans OMS Pro).
• Créez la connexion, cochez les permissions voulues, remettez la clé (affichée une seule fois).
• Créez si besoin les Google Sheets par métier et invitez l’agence à la console avec un code à usage unique.
• Regardez le travail circuler : les affectations partent vers l’agence, les résultats reviennent par le même pipeline, et tout est auditable dans la chronologie.

Questions fréquentes