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 accounts. Specifically for the Order - Get operation, it retrieves detailed information about a single order by its unique ID.

Typical use cases include:

  • Fetching order details to display or process in workflows.
  • Integrating order data into other systems like CRMs or shipping platforms.
  • Automating order status checks or validations.

For example, you might use this node to get an order's full details after a customer places it on your e-commerce platform, enabling automated fulfillment or notification processes.

Properties

Name Meaning
ID The unique identifier of the order to retrieve. This is required to specify which order to fetch.

Output

The node outputs JSON data representing the order details as returned by the Tiny ERP API. The structure typically includes fields such as order ID, customer info, items ordered, quantities, prices, status, dates, and other metadata related to the order.

No binary data output is produced by this operation.

Example output JSON (simplified):

{
  "id": "12345",
  "customer": {
    "name": "John Doe",
    "email": "john@example.com"
  },
  "items": [
    {
      "productId": "987",
      "quantity": 2,
      "price": 50.0
    }
  ],
  "status": "approved",
  "createdAt": "2024-01-01T12:00:00Z"
}

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests against the Tiny ERP API.
  • Internet access to https://erp.tiny.com.br/public-api/v3 endpoint.
  • No additional external dependencies beyond the standard n8n environment.

Troubleshooting

  • Common issues:

    • Invalid or missing order ID will cause the API to return an error.
    • Authentication failures if the OAuth2 credentials are not set up correctly.
    • Network connectivity problems preventing access to the Tiny ERP API.

  • Error messages:

    • "Tiny ERP API request failed: <error message>" indicates an issue with the API call, such as invalid parameters or authentication errors.
    • "Unknown operation: get" would occur if the operation parameter is incorrectly set (unlikely here since it's fixed).

  • Resolutions:

    • Ensure the order ID is correct and exists in Tiny ERP.
    • Verify OAuth2 credentials are valid and have necessary permissions.
    • Check network connectivity and API availability.

Links and References

Discussion