Announcement
Esta página también está disponible en English, Deutsch, Français, Italiano, 日本語 y Português.
Novedad en Contract Templates: aplica una plantilla a varios clientes vía API
Crea borradores de contrato para hasta 100 clientes en una sola llamada a la API.
By Sam Clark
·Shipped by
En la Console, aplicar una plantilla de contrato a tus clientes es una sola acción: eliges la plantilla, seleccionas los clientes y obtienes un borrador de contrato para cada uno. A través de la API, hasta ahora era un proceso repetitivo: leer la plantilla, copiar sus reglas de facturación, price books y partidas personalizadas en el cuerpo de create-contract, y repetir con cada cliente.
La API de Contract Templates ahora hace lo mismo que la Console. Una sola llamada POST /billing/v1/contract-templates/{templateID}/contracts crea un borrador de contrato para cada cliente del lote, con las reglas de facturación, los price books y las partidas personalizadas de la plantilla ya aplicadas.
- Aplicación por lotes: Envía hasta 100 clientes por solicitud. Cada cliente obtiene su propio resultado, así que un cliente no elegible no bloquea al resto.
- Dry run: Agrega
dryRun=truepara validar todo el lote sin crear nada. Úsalo primero: cada llamada real crea borradores nuevos, incluso para clientes que ya tienen uno de la misma plantilla. - Creación para un solo cliente: Pasa un
templateIdal crear un contrato a través de la Contracts API para aplicar una plantilla en una sola llamada. Los componentes de la plantilla son todo o nada, por lo que se rechaza cualquier solicitud que además incluya sus propias reglas de facturación, price books o partidas personalizadas.
Todos los contratos se crean como borradores. Los revisas y los activas igual que hasta ahora.
Para comenzar, consulta la referencia de la API, donde encontrarás el endpoint y ejemplos de solicitudes, y la guía de plantillas de contrato para entender cómo funcionan las plantillas. Para llamar a la API se requiere acceso a la External API y el permiso Contract Templates Admin.
Disponible para distribuidores y resellers que usan PartnerOps Revenue Management.
Related documentation
