Conta Azul API icon

Conta Azul API

Allows making requests to the Conta Azul API

Create Service

AI-generated

Overview

This node operation allows users to create a new service in the Conta Azul system via the Conta Azul API. It is useful for automating the addition of service records with detailed attributes such as description, code, cost, price, service type, and status. For example, a business can use this node to programmatically add new service offerings to their Conta Azul account as part of their workflow automation.

Use Case Examples

  1. Creating a new service with a description, code, cost, price, and status to keep the service catalog up to date automatically.
  2. Automating service creation when onboarding new service types or updating service details in bulk.

Properties

Name Meaning
Description The description of the service to be created, which is a required field.
Code Optional service code to uniquely identify the service, e.g., SERV001.
Cost Optional cost associated with the service.
Price Optional price for the service.
Service Type Optional type of the service, e.g., PRESTADO.
Status Optional status of the service, either Active (ATIVO) or Inactive (INATIVO).

Output

JSON

  • id - Unique identifier of the created service.
  • descricao - Description of the created service.
  • codigo - Code of the created service.
  • custo - Cost of the created service.
  • preco - Price of the created service.
  • tipo_servico - Type of the created service.
  • status - Status of the created service.

Dependencies

  • Conta Azul API OAuth2 credentials

Troubleshooting

  • Common issues include missing required fields such as the service description, which will cause the API to reject the request.
  • Invalid or expired API credentials will result in authentication errors; ensure the OAuth2 token is valid and refreshed as needed.
  • Incorrect data types for fields like cost or price (should be numbers) may cause validation errors from the API.

Links

  • Conta Azul API Documentation - Official API documentation for Conta Azul, useful for understanding service creation endpoints and data requirements.

Discussion