Tiny ERP icon

Tiny ERP

Interact with Tiny ERP API v3
Join our community

Actions25

Overview

This node integrates with the Tiny ERP API v3 to manage various business resources such as products, customers, orders, invoices, stock, contacts, and account information. Specifically, for the Order resource with the Get All operation, it retrieves a list of orders from the Tiny ERP system.

This functionality is useful in scenarios where you want to automate order management workflows, synchronize order data with other systems, or generate reports based on order information. For example, you could use this node to fetch all recent orders placed within a certain period or filter orders by search terms to find specific transactions.

Properties

Name Meaning
Options A collection of optional parameters to customize the retrieval of orders:
- Limit Maximum number of orders to return (1 to 100). Default is 50.
- Page Page number of results to retrieve, starting at 1. Default is 1.
- Search Search term to filter orders by matching text.

These options allow controlling pagination and filtering of the returned order list.

Output

The output is an array of JSON objects, each representing an order retrieved from Tiny ERP. The structure corresponds directly to the order data returned by the Tiny ERP API endpoint /pedidos. Each item contains fields describing the order details such as order ID, customer info, status, items, dates, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests against the Tiny ERP API.
  • The node makes HTTP requests to https://erp.tiny.com.br/public-api/v3 endpoints.
  • Proper network access and valid credentials are necessary for successful API communication.

Troubleshooting

  • Common issues:

    • Invalid or expired API credentials will cause authentication failures.
    • Network connectivity problems can prevent reaching the Tiny ERP API.
    • Requesting pages beyond available data may return empty results.
    • Using invalid search terms or unsupported filters might yield no matches.

  • Error messages:

    • "Tiny ERP API request failed: <error message>" indicates an issue during the API call. Check your credentials, network, and parameter values.
    • "Unknown operation: getAll" would indicate a misconfiguration of the operation parameter, but this should not occur if using the provided UI options.

  • Resolutions:

    • Verify and refresh API credentials if authentication errors occur.
    • Ensure the Tiny ERP service is reachable from your environment.
    • Adjust pagination and search parameters to valid ranges and formats.

Links and References

Discussion