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 - Create operation, it allows users to create a new product in their Tiny ERP system by providing various product details.

Typical use cases include automating product catalog management by programmatically adding new products from other systems or workflows, such as e-commerce platforms or inventory management tools.

For example, you could use this node to automatically add newly sourced products into your ERP system whenever they are added to an external database or spreadsheet, ensuring your ERP product list stays up-to-date without manual entry.

Properties

Name Meaning
Additional Fields A collection of optional fields to define the product's attributes:
- Name The name of the product item.
- Description A textual description of the product.
- Price The price of the product (number).
- SKU The SKU or code identifying the product.
- Email An email address associated with the product (if applicable).
- Phone A phone number related to the product (if applicable).
- Document CPF or CNPJ document number (Brazilian tax IDs, if relevant).
- Address Address related to the product (if applicable).
- City City related to the product (if applicable).
- State State (UF) related to the product (if applicable).
- ZIP Code ZIP Code (CEP) related to the product (if applicable).

These fields allow flexible input of product data when creating a new product record.

Output

The node outputs JSON data representing the response from the Tiny ERP API after creating the product. This typically includes the newly created product's details such as its ID, name, description, price, SKU, and any other fields accepted by the API.

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 endpoints.
  • Proper configuration of the OAuth2 credential within n8n is necessary for successful API communication.

Troubleshooting

  • Common issues:

    • Missing or invalid API credentials will cause authentication failures.
    • Providing incomplete or incorrectly typed fields may result in API errors.
    • Network connectivity problems can prevent reaching the Tiny ERP API endpoint.

  • Error messages:

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

  • Resolutions:

    • Verify that the OAuth2 credentials are correctly set up and authorized.
    • Ensure all required fields are provided and valid.
    • Test network connectivity to the Tiny ERP API URL.
    • Use the "Continue on Fail" option in n8n to handle errors gracefully in workflows.

Links and References

Discussion