Actions25
Overview
This node integrates with the Tiny ERP API v3 to manage orders within the Tiny ERP system. Specifically, the Order - Update operation allows users to update existing order records by specifying the order ID and providing new or modified fields.
Typical use cases include:
- Modifying customer details or shipping information on an existing order.
- Adjusting order attributes such as price, description, or contact info after creation.
- Automating updates to orders based on external triggers or workflows.
For example, you might use this node to update the shipping address of an order when a customer provides new information, or to correct product details associated with an order.
Properties
| Name | Meaning |
|---|---|
| ID | The unique identifier of the order to update (required). |
| Additional Fields | A collection of optional fields to update on the order. These include: |
| - Name: Name of the item | |
| - Description: Description of the item | |
| - Price: Price of the item (number) | |
| - SKU: SKU or code of the product | |
| - Email: Email address | |
| - Phone: Phone number | |
| - Document: CPF or CNPJ document number | |
| - Address: Address | |
| - City: City | |
| - State: State (UF) | |
| - ZIP Code: ZIP Code (CEP) |
These additional fields allow flexible updating of various order attributes in one request.
Output
The node outputs JSON data representing the updated order object returned from the Tiny ERP API. This JSON contains all the current properties of the order after the update has been applied.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 API credential configured for authenticating with the Tiny ERP API.
- The node makes HTTP requests to
https://erp.tiny.com.br/public-api/v3endpoints. - Proper permissions on the API key are necessary to perform order updates.
Troubleshooting
Common issues:
- Invalid or missing order ID will cause the API to reject the update.
- Providing invalid field values (e.g., wrong data types) may result in errors.
- Network or authentication failures can prevent successful API calls.
Error messages:
"Tiny ERP API request failed: <message>"indicates an issue communicating with the API or a rejected request. Check credentials and network connectivity."Unknown operation: update"would indicate a misconfiguration of the operation parameter but should not occur if using the provided UI options.
Resolution tips:
- Verify the order ID exists in Tiny ERP before attempting an update.
- Ensure all required credentials are correctly set up and valid.
- Validate input data types and formats according to Tiny ERP API expectations.
Links and References
- Tiny ERP API Documentation (official API docs for reference)
- n8n documentation on creating custom nodes for further customization guidance