Tiny ERPInstall

Overview

This node integrates with the Tiny ERP API v3 to manage various business resources such as products, customers, orders, invoices, stock, contacts, and accounts. Specifically, for the Customer - Get All operation, it retrieves a list of customers from the Tiny ERP system.

This operation is useful when you want to fetch multiple customer records for reporting, synchronization, or further processing within an n8n workflow. For example, you might use this node to pull all customers matching a search term or paginate through customer data to update another system or generate reports.

Properties

These options allow controlling the volume and filtering of the returned customer list.

Output

The output is a JSON array where each item represents a customer object as returned by the Tiny ERP API. The structure corresponds directly to the API's customer resource representation, including fields like name, email, phone, document numbers, address, city, state, and ZIP code.

No binary data is output by this operation.

Example output snippet (simplified):

[
  {
    "id": "123",
    "nome": "John Doe",
    "email": "john@example.com",
    "telefone": "123456789",
    "cpf_cnpj": "00011122233",
    "endereco": "123 Main St",
    "cidade": "CityName",
    "uf": "ST",
    "cep": "12345-678"
  },
  ...
]

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

• API Request Failures: Errors like Tiny ERP API request failed: <message> indicate issues with connectivity, authentication, or invalid parameters. Verify your API credentials and network access.
• Invalid Pagination Parameters: Setting Limit outside 1-100 or Page less than 1 may cause errors or unexpected results. Ensure these values are within allowed ranges.
• Empty Results: If no customers match the search term or page requested, the output will be an empty array.
• Unknown Operation Error: This node only supports predefined operations; selecting an unsupported operation will throw an error.

Links and References

• Tiny ERP API Documentation (official API docs)
• n8n OAuth2 Credential Setup (for configuring OAuth2 credentials)

This summary focuses on the Customer - Get All operation as requested, describing its inputs, outputs, and usage context based on static analysis of the provided source code and property definitions.