Nouveauté Contract Templates : application d'un modèle à plusieurs clients via l'API

Créez des brouillons de contrat pour un maximum de 100 clients en un seul appel API.

Dans la Console, appliquer un modèle de contrat à vos clients se fait en une seule action : choisissez le modèle, sélectionnez les clients, et un brouillon de contrat est créé pour chacun. Via l'API, c'était jusqu'ici une boucle : lire le modèle, copier ses règles de facturation, ses grilles tarifaires et ses lignes personnalisées dans le corps d'une requête de création de contrat, puis répéter l'opération pour chaque client.

L'API Contract Templates offre désormais les mêmes possibilités que la Console. Un simple POST /billing/v1/contract-templates/{templateID}/contracts crée un brouillon de contrat pour chaque client du lot. Les règles de facturation, grilles tarifaires et lignes personnalisées du modèle sont déjà en place.

• Application par lot : envoyez jusqu'à 100 clients par requête. Chaque client reçoit son propre résultat : un client inéligible ne bloque donc pas les autres.
• Dry run : ajoutez dryRun=true pour valider l'ensemble du lot sans rien créer. Commencez toujours par là : chaque appel réel crée de nouveaux brouillons, y compris pour les clients qui en possèdent déjà un issu du même modèle.
• Création pour un seul client : transmettez un templateId lors de la création d'un contrat via l'API Contracts pour appliquer un modèle en un seul appel. Les composants du modèle fonctionnent en tout ou rien : une requête qui contient aussi ses propres règles de facturation, grilles tarifaires ou lignes personnalisées est rejetée.

Chaque contrat est créé sous forme de brouillon. Vous les relisez et les activez exactement comme vous le faites aujourd'hui.

Pour commencer, consultez la référence de l'API pour l'endpoint et des exemples de requêtes, ainsi que le guide des modèles de contrat pour comprendre le fonctionnement des modèles. L'appel à l'API nécessite un accès External API et l'autorisation Contract Templates Admin.

Disponible pour les distributeurs et revendeurs utilisant PartnerOps Revenue Management.