Voalle icon

Voalle

Interact with Voalle API

Actions64

CRM Voalle → Incluir Servico No Contrato

AI-generated

Overview

This node operation "Incluir Servico No Contrato" under the resource "CRM Voalle" is designed to add new services to an existing contract in the Voalle CRM system. It is useful for scenarios where a user needs to update a contract by including additional services, specifying details such as service codes, quantities, prices, payment forms, and tagging options. For example, a telecom company could use this operation to add new service packages to a customer's contract dynamically.

Use Case Examples

  1. Adding multiple new services to a customer's contract with specific quantities and prices.
  2. Updating contract services with tagging options to manage service labels.
  3. Generating proportional billing for newly added services based on contract terms.

Properties

Name Meaning
Numero Do Contrato The contract number to which new services will be added. This is a required string input.
Campanha CRM The CRM campaign code associated with the services, selectable from a list or entered as an ID. This is required.
Lista De Preco CRM The CRM price list code related to the services, selectable from a list or entered as an ID. This is required.
Gerar Proporcionalidade Boolean flag to indicate whether to generate proportional billing for the added services.
Novos Servicos A collection of new service items to add to the contract. Each item includes service code, quantity, amount, price, payment form code, service tag options, existing tag, tag description, phone group ID, and optional phone number information in JSON format.

Output

JSON

  • json - The JSON response from the Voalle API after adding services to the contract, containing details of the operation result.

Dependencies

  • Voalle API authentication credentials

Troubleshooting

  • Ensure the contract number is valid and exists in the Voalle CRM system to avoid errors.
  • Verify that the campaign code and price list code are correctly selected or entered, as invalid codes will cause the operation to fail.
  • Check that the new services collection is properly formatted with all required fields, especially service codes and quantities.
  • If proportional billing is enabled, confirm that the contract supports this feature to prevent billing calculation errors.
  • Common error messages may include invalid parameter errors, authentication failures, or API request timeouts. Verify credentials and network connectivity.

Discussion