Tiny ERP icon

Tiny ERP

Consumir API do Tiny ERP
Join our community

Actions3

Overview

This node integrates with the Tiny ERP system to retrieve detailed information about a specific order based on its order number. It is useful in scenarios where you need to automate workflows involving order data retrieval, such as verifying order status, extracting order details for reporting, or syncing order information with other systems.

For example, you can use this node to fetch all details of an order placed by a customer, then trigger subsequent actions like sending confirmation emails, updating inventory, or generating invoices.

Properties

Name Meaning
Número do Pedido The unique identifier (order number) of the order to be retrieved. This property is required and must be provided to query the specific order data.

Output

The node outputs JSON data representing the order details returned by the Tiny ERP API. The structure corresponds to the pedido object from the API response, containing all relevant fields describing the order.

If the order is not found, the output JSON will contain a message indicating that the order was not found.

In case of errors during the API request, the node throws an error with a descriptive message.

No binary data output is produced for this operation.

Dependencies

  • Requires an API authentication token credential for Tiny ERP.
  • Makes HTTP GET requests to the Tiny ERP API endpoint: https://api.tiny.com.br/api2/pedido.obter.php.
  • The node expects the environment to have internet access to reach the Tiny ERP API.

Troubleshooting

  • Common issues:

    • Invalid or missing order number: Ensure the "Número do Pedido" property is correctly set and corresponds to an existing order.
    • Authentication failure: Verify that the API token credential is valid and has necessary permissions.
    • Network connectivity problems: Confirm that the n8n instance can access the Tiny ERP API endpoint.

  • Error messages:

    • "Erro na API do Tiny: <error message>": Indicates an error returned by the Tiny ERP API. Check the error message for specifics, such as invalid parameters or server issues.
    • "Pedido não encontrado": Means the specified order number does not exist in the system.
    • Other unexpected errors are caught and returned with stack traces in the output JSON under the error field.

To resolve errors, verify input parameters, credentials, and network connectivity. Consult Tiny ERP API documentation for error codes and meanings.

Links and References

Discussion