Conta Azul icon

Conta Azul

Allows interaction with Conta Azul API

Actions4

Overview

This node integrates with the Conta Azul API to manage contracts within the Conta Azul system. Specifically, the "Contract Create" operation allows users to create new contract records by sending detailed contract information such as contract number, emission date, status, associated customer, products, services, discounts, payment terms, and notes.

Common scenarios for this node include automating contract creation workflows in business processes, integrating contract management into CRM or ERP systems, and syncing contract data from other platforms into Conta Azul.

For example, a user can automate the creation of contracts when a new customer signs up or when a sales agreement is finalized, ensuring that all contract details are accurately recorded in Conta Azul without manual entry.

Properties

Name Meaning
Access Token The API authentication token required to authorize requests to the Conta Azul API.
Number The unique identifier or number assigned to the contract.
Emission Date The date when the contract was issued or created.
Status The current status of the contract (e.g., active, pending).
Customer ID Identifier of the customer associated with the contract.
Products JSON array representing the list of products included in the contract.
Services JSON array representing the list of services included in the contract.
Discount Measure Unit The unit type for the discount applied; options are "VALUE" (fixed amount) or "PERCENT" (percentage).
Discount Rate The numeric value of the discount rate applied to the contract.
Due Day The day of the month when payment is due.
Duration The length or duration of the contract, typically in months or another time unit.
Notes Additional textual notes or comments related to the contract.
Shipping Cost The cost associated with shipping related to the contract.

Output

The node outputs a JSON array where each element corresponds to the response from the Conta Azul API after creating a contract. Each JSON object contains the details of the newly created contract as returned by the API, including identifiers, status, and any other relevant metadata.

No binary data output is produced by this node.

Dependencies

  • Requires an active Conta Azul API access token for authentication.
  • The node makes HTTP requests to the Conta Azul API endpoints.
  • No additional external dependencies beyond standard HTTP request handling.
  • Users must configure the node with a valid API token to interact with the Conta Azul service.

Troubleshooting

  • API Request failed: This error indicates that the HTTP request to the Conta Azul API did not succeed. Common causes include invalid or expired access tokens, incorrect property values, or network issues. Verify the access token validity and ensure all required fields are correctly set.
  • Unsupported resource or operation: If the node configuration specifies a resource or operation not supported by the node, it will throw an error. Ensure that "Contract" is selected as the resource and "Create" as the operation.
  • JSON parsing errors: The properties products and services expect valid JSON arrays. Malformed JSON input will cause failures. Validate JSON syntax before inputting.
  • Missing required fields: Some fields like Access Token are mandatory. Omitting them will cause the node to fail.

Links and References

Discussion