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, allowing users to perform various operations on different resources such as products, customers, orders, invoices, stock, contacts, and accounts. Specifically for the Contact resource with the Get operation, the node retrieves detailed information about a single contact by its unique ID.

Typical use cases include:

  • Fetching contact details to synchronize customer or client data between Tiny ERP and other systems.
  • Automating workflows that require up-to-date contact information from Tiny ERP.
  • Integrating contact data retrieval into broader business process automations.

Example: You want to retrieve the full details of a specific contact in your ERP system by providing its ID, then use this data to update a CRM or send personalized communications.

Properties

Name Meaning
ID The unique identifier of the contact to retrieve. This is a required string input.

Output

The node outputs JSON data representing the contact's details as returned by the Tiny ERP API. The structure typically includes fields such as name, email, phone number, and any other contact-related information stored in Tiny ERP.

No binary data output is produced by this operation.

Example output JSON (simplified):

{
  "id": "12345",
  "nome": "John Doe",
  "email": "john.doe@example.com",
  "telefone": "+1234567890",
  ...
}

Dependencies

  • Requires an OAuth2 API credential configured in n8n to authenticate requests against the Tiny ERP API.
  • The node makes HTTP requests to https://erp.tiny.com.br/public-api/v3.
  • Proper permissions on the API key are necessary to access contact data.

Troubleshooting

  • Common issues:

    • Invalid or missing contact ID will cause the API to return an error.
    • Authentication failures if the OAuth2 credentials are not set up correctly.
    • Network or API downtime can cause request failures.

  • Error messages:

    • "Tiny ERP API request failed: <error message>" indicates an issue with the API call. Check the provided ID, network connectivity, and authentication credentials.
    • "Unknown operation: get" would indicate a misconfiguration but is unlikely here since "get" is supported.

  • Resolutions:

    • Verify the contact ID is correct and exists in Tiny ERP.
    • Ensure OAuth2 credentials are valid and have the necessary scopes.
    • Check internet connectivity and API status.

Links and References

Discussion