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 perform various operations on different resources such as products, customers, orders, invoices, stock, contacts, and accounts. Specifically for the Customer - Get operation, it retrieves detailed information about a single customer by their unique ID.

Typical use cases include:

  • Fetching customer details to display or process in workflows.
  • Integrating customer data retrieval into automated business processes.
  • Synchronizing customer information between Tiny ERP and other systems.

Example: You want to retrieve a customer's full profile by their ID to verify their contact information before processing an order.

Properties

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

Output

The node outputs JSON data representing the customer object returned by the Tiny ERP API. The structure typically includes all customer fields available in Tiny ERP, such as name, email, phone, document number, address, city, state, and ZIP code.

Example output JSON (simplified):

{
  "id": "12345",
  "nome": "John Doe",
  "email": "john.doe@example.com",
  "telefone": "555-1234",
  "cpf_cnpj": "000.000.000-00",
  "endereco": "123 Main St",
  "cidade": "São Paulo",
  "uf": "SP",
  "cep": "01000-000"
}

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

Troubleshooting

  • Common issues:

    • Invalid or missing customer ID will cause the API to return an error.
    • Authentication failures if the OAuth2 token is expired or misconfigured.
    • Network connectivity problems preventing access to the Tiny ERP API endpoint.

  • Error messages:

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

  • Resolutions:

    • Ensure the customer ID is correct and exists in Tiny ERP.
    • Verify that the OAuth2 credentials are valid and refreshed.
    • Check network connectivity and firewall settings.
    • Review API limits or restrictions imposed by Tiny ERP.

Links and References

Discussion