Actions4
- Customer Actions
- Contract Actions
- Sale Actions
Overview
This node integrates with the Conta Azul API to create sales records in the Conta Azul system. It is designed to automate the process of registering a sale, including details such as products, services, customer and seller information, payment terms, discounts, and shipping costs.
Common scenarios where this node is beneficial include:
- Automating sales data entry from e-commerce platforms or CRM systems into Conta Azul.
- Synchronizing offline sales transactions with Conta Azul for accounting and inventory management.
- Creating detailed sales records programmatically during business workflows.
For example, after a customer completes a purchase on an online store, this node can be used to automatically create a corresponding sale in Conta Azul, including all relevant details like purchased products, payment method, and discounts applied.
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 sale. |
| Emission Date | The date when the sale was issued or created. |
| Status | The current status of the sale. Options: PENDING, COMMITTED. |
| Customer ID | Identifier of the customer associated with the sale. |
| Seller ID | Identifier of the seller responsible for the sale. |
| Products | JSON array describing the products included in the sale. |
| Services | JSON array describing the services included in the sale. |
| Discount Measure Unit | Unit type for the discount applied. Options: VALUE (fixed amount), PERCENT (percentage). |
| Discount Rate | The rate or amount of discount applied to the sale. |
| Payment Type | The type of payment. Options: CASH, TIMES (installments). |
| Payment Method | Description or identifier of the payment method used. |
| Installments | JSON array detailing installment payments if applicable. |
| Financial Account ID | Identifier of the financial account related to the payment. |
| Notes | Additional notes or comments about the sale. |
| Shipping Cost | The cost of shipping associated with the sale. |
Output
The node outputs a JSON array containing the response from the Conta Azul API after creating the sale. This typically includes the full details of the newly created sale record as returned by the API, such as sale ID, status, timestamps, and any other metadata provided by Conta Azul.
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 are needed.
- Ensure that the access token has sufficient permissions to create sales in the Conta Azul account.
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 that the access token is valid and has not expired.
- Check that all required properties are correctly set and formatted, especially JSON fields like products, services, and installments.
- Confirm network connectivity and that the Conta Azul API endpoint is reachable.
- Unsupported resource or operation: If you see errors about unsupported resources or operations, ensure that the node's Resource is set to "Sale" and Operation to "Create" as expected.
- JSON parsing errors: Since some properties expect JSON input (e.g., products, services, installments), ensure the JSON syntax is correct and properly escaped.
Links and References
- Conta Azul API Documentation — Official API docs for understanding available endpoints and data formats.
- n8n Documentation — For general guidance on using n8n nodes and workflows.