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 account information. Specifically for the Invoice - Get operation, it retrieves detailed information about a single invoice by its ID.

Typical use cases include:

  • Fetching invoice details for review or processing in workflows.
  • Automating invoice retrieval to sync with other systems like accounting or CRM.
  • Using invoice data to trigger further actions such as notifications or reporting.

Example: You can use this node to get an invoice by its ID and then send the invoice data to another system for payment processing or archival.

Properties

Name Meaning
ID The unique identifier of the invoice to retrieve. This is required for the "Get" operation on the Invoice resource.

Output

The node outputs JSON data representing the invoice object retrieved from the Tiny ERP API. The structure corresponds to the invoice details as returned by the API endpoint /notas-fiscais/{id}. This typically includes fields such as invoice number, date, customer info, line items, totals, status, and other metadata related to the invoice.

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 is necessary.
  • The node uses the tinyOAuth2Api credential type (an API key or OAuth2 token) for authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing invoice ID will cause the API request to fail.
    • Authentication errors if the OAuth2 credentials are not set up correctly or expired.
    • Network connectivity problems preventing access to the Tiny ERP API.

  • Error messages:

    • "Tiny ERP API request failed: <error message>" indicates a failure in the HTTP request to the API. Check the error message for specifics such as unauthorized access, not found, or bad request.
    • "Unknown operation: get" would occur if the operation parameter is incorrect, but this should not happen if using the provided UI options.

  • Resolutions:

    • Ensure the invoice ID is correct and exists in Tiny ERP.
    • Verify that the OAuth2 credentials are valid and have the necessary permissions.
    • Confirm network connectivity and API endpoint availability.

Links and References

Discussion