Conta Azul API icon

Conta Azul API

Allows making requests to the Conta Azul API

Actions16

Overview

This node integrates with the Conta Azul API to search for products using various filters. It allows users to query products by name or code, filter by product status (active, inactive, or all), and sort results by different fields such as name, code, sale value, or stock quantity. Pagination options enable retrieving specific pages of results with a defined number of items per page.

This node is beneficial in scenarios where you need to dynamically retrieve product information from Conta Azul based on flexible criteria, such as syncing product data, generating reports, or filtering products for further processing in an automation workflow.

Practical example:
You want to fetch all active products whose names contain "coffee" sorted by sale value in descending order, retrieving 20 products per page. This node can perform that filtered search and return the matching products for use in subsequent workflow steps.

Properties

Name Meaning
Search (Product) Search products by name or code (text input).
Status Product status filter: "Ativo" (Active), "Inativo" (Inactive), or "Todos" (All).
Sort Field Field to order results by: "Nome" (Name), "Código" (Code), "Valor De Venda" (Sale Value), or "Estoque" (Stock).
Sort Direction Sort direction: "Ascendente" (Ascending) or "Descendente" (Descending).
Page (Product) Page number to retrieve (pagination).
Page Size (Product) Number of items per page (pagination).

Output

The node outputs JSON data containing the list of products matching the specified filters. Each product item typically includes details such as product name, code, status, sale value, stock quantity, and other relevant attributes provided by the Conta Azul API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Conta Azul API.
  • The node depends on the Conta Azul API service being available and accessible.
  • No additional external dependencies are required beyond the Conta Azul API credentials.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Providing invalid filter values (e.g., unsupported status or sort field) may result in errors or empty results.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Operação não suportada" ("Operation not supported"): This error occurs if an unsupported operation is selected; ensure the operation is set to "Search Products By Filter".
    • Authentication errors usually indicate missing or incorrect API credentials; verify and update your API key/token.
    • Pagination parameters out of range might lead to empty responses; check that page numbers and sizes are valid positive integers.

Links and References

Discussion