Novità nei Contract Templates: applicare un template a più clienti via API

Crei bozze di contratto per un massimo di 100 clienti con una sola chiamata API.

Nella Console, applicare un template di contratto ai clienti è un'unica azione: si sceglie il template, si selezionano i clienti e si ottiene una bozza di contratto per ciascuno. Via API, invece, finora era necessario un ciclo: leggere il template, copiarne le regole di fatturazione, i price book e le voci personalizzate nel body di una richiesta di creazione contratto, e ripetere l'operazione per ogni cliente.

L'API Contract Templates ora fa ciò che fa la Console. Una singola chiamata POST /billing/v1/contract-templates/{templateID}/contracts crea una bozza di contratto per ogni cliente del batch. Le regole di fatturazione, i price book e le voci personalizzate del template sono già configurati.

• Applicazione in batch: invii fino a 100 clienti per richiesta. Ogni cliente riceve un risultato dedicato, quindi un cliente non idoneo non blocca gli altri.
• Dry run: aggiunga dryRun=true per validare l'intero batch senza creare nulla. Lo usi come primo passo: ogni chiamata reale crea nuove bozze, anche per i clienti che ne hanno già una generata dallo stesso template.
• Creazione per singolo cliente: passi un templateId nella creazione di un contratto tramite la Contracts API per applicare un template in un'unica chiamata. I componenti del template funzionano in modalità tutto o niente: una richiesta che include anche regole di fatturazione, price book o voci personalizzate proprie viene rifiutata.

Ogni contratto viene creato come bozza: la revisione e l'attivazione avvengono esattamente come oggi.

Per iniziare, consulti l'API reference per l'endpoint e gli esempi di richiesta, e la guida ai Contract templates per scoprire come funzionano i template. Per chiamare l'API sono necessari l'accesso External API e il permesso Contract Templates Admin.

Disponibile per distributori e reseller che utilizzano PartnerOps Revenue Management.