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 stock movements and inventory data. Specifically, the "Stock" resource with the "Get All" operation retrieves a paginated list of all stock movements recorded in the ERP system. This is useful for businesses that want to monitor inventory changes, track stock inflows and outflows, or audit stock movement history.

Practical examples include:

  • Fetching recent stock movements to update an internal dashboard.
  • Auditing stock changes over a specific period by combining with search filters.
  • Integrating stock movement data into other systems like accounting or reporting tools.

Properties

Name Meaning
Options Collection of optional parameters to filter and paginate results:
- Limit Maximum number of stock movement records 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 stock movements by relevant text fields (e.g., product name, code).

Output

The output is a JSON array where each item represents a stock movement record retrieved from the Tiny ERP system. Each record contains details about individual stock transactions such as product identifiers, quantities moved, dates, and related metadata.

No binary data is output by this operation.

Dependencies

  • Requires an API authentication token configured via OAuth2 credentials to access the Tiny ERP API.
  • The node makes HTTP requests to https://erp.tiny.com.br/public-api/v3.
  • Proper configuration of the OAuth2 credential within n8n is necessary for successful API calls.

Troubleshooting

  • Common issues:

    • Authentication failures due to invalid or expired API tokens.
    • Exceeding API rate limits imposed by Tiny ERP.
    • Providing invalid pagination parameters (e.g., page < 1 or limit outside 1-100).
    • Network connectivity problems.

  • Error messages:

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

  • Resolutions:

    • Verify and refresh API credentials.
    • Ensure pagination and search parameters are within allowed ranges.
    • Confirm network access to the Tiny ERP API endpoint.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch processing.

Links and References

Discussion