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 products, customers, orders, invoices, stock, contacts, and account information. Specifically, for the Product - Update operation, it updates an existing product's details in the Tiny ERP system by sending a PUT request with the specified product ID and updated fields.

Typical use cases include:

  • Updating product information such as name, description, price, SKU, or contact details.
  • Synchronizing product data from other systems into Tiny ERP.
  • Automating product catalog maintenance workflows.

Example: You have a product whose price or description changed, and you want to update this information automatically in Tiny ERP without manual entry.

Properties

Name Meaning
ID The unique identifier of the product to update.
Additional Fields Optional fields to update on the product. These include:
- Name: Name of the product
- Description: Description of the product
- Price: Price of the product (number)
- SKU: Stock Keeping Unit or product code
- Email: Contact email address
- Phone: Contact phone number
- Document: CPF or CNPJ document number
- Address: Address related to the product or supplier
- City: City
- State: State (UF)
- ZIP Code: Postal code (CEP)

Output

The node outputs JSON data representing the updated product resource as returned by the Tiny ERP API. This typically includes all product fields after the update, confirming the new state of the product.

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.
  • Network access to https://erp.tiny.com.br/public-api/v3 is required.
  • The node uses the tinyOAuth2Api credential type for authentication (configured externally in n8n).

Troubleshooting

  • Common issues:

    • Invalid or missing product ID will cause the API to fail.
    • Providing invalid field values (e.g., negative price) may result in API errors.
    • Authentication failures if the OAuth2 token is expired or misconfigured.
    • Network connectivity issues to the Tiny ERP API endpoint.

  • Error messages:

    • "Tiny ERP API request failed: <message>": Indicates an error response from the API or network failure. Check credentials, product ID validity, and API status.
    • "Unknown operation: update": Should not occur if the operation is correctly set; indicates internal misconfiguration.

  • Resolution tips:

    • Verify the product ID exists in Tiny ERP before updating.
    • Ensure all required credentials are valid and refreshed.
    • Validate input fields conform to expected formats and types.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion