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 orders and other resources. Specifically, the Order - Update Status operation allows users to update the status of an existing order in their Tiny ERP system. This is useful for automating order management workflows, such as marking orders as approved, shipped, delivered, or cancelled based on external triggers or business logic.

Practical examples include:

  • Automatically updating order status when a payment is confirmed.
  • Changing order status to "Shipped" once a shipping provider confirms dispatch.
  • Cancelling orders programmatically if stock runs out.

Properties

Name Meaning
Status The new status to set for the order. Options: Pending, Approved, In Production, Shipped, Delivered, Cancelled

Output

The node outputs JSON data representing the response from the Tiny ERP API after updating the order status. This typically includes confirmation details about the updated order status.

The output structure is:

{
  "json": {
    // API response fields confirming the status update
  }
}

No binary data output is produced 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:

    • Invalid or expired API credentials will cause authentication failures.
    • Providing an invalid order ID will result in errors from the API.
    • Network connectivity problems can prevent the node from reaching the Tiny ERP API.

  • Error messages:

    • "Tiny ERP API request failed: <error message>" indicates an issue with the API call, such as authentication failure, invalid parameters, or server errors.
    • "Unknown operation: updateStatus" would indicate a misconfiguration but is unlikely here since the operation is supported.

  • Resolutions:

    • Verify that the OAuth2 credentials are correctly set up and have not expired.
    • Confirm the order ID exists in Tiny ERP before attempting to update.
    • Check network connectivity and firewall settings.
    • Review the status value to ensure it matches one of the allowed options.

Links and References

Discussion