Tiny ERP icon

Tiny ERP

Interact with Tiny ERP API v3
Join our community

Actions25

Overview

The node integrates with the Tiny ERP API v3 to manage various business resources, including Contacts. Specifically, the Contact - Update operation allows users to update existing contact records in their Tiny ERP system by specifying the contact's ID and providing new or modified details.

This node is beneficial for automating updates to contact information such as names, emails, phone numbers, and addresses without manual entry in the ERP system. For example, it can be used to synchronize updated customer contact details from a CRM or form submission directly into Tiny ERP.

Properties

Name Meaning
ID The unique identifier of the contact to update (required).
Additional Fields Optional fields to update on the contact record. These include:
- Name: Contact's name
- Email: Contact's email address
- Phone: Contact's phone number
- Document: CPF or CNPJ document number
- Address: Contact's address
- City: City
- State: State (UF)
- ZIP Code: Postal code (CEP)

Output

The node outputs JSON data representing the updated contact object returned by the Tiny ERP API after a successful update operation. This JSON includes all the contact's properties as stored in the ERP system post-update.

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

Troubleshooting

  • Common Issues:

    • Invalid or missing contact ID will cause the API request to fail.
    • Providing invalid field values (e.g., malformed email or incorrect document format) may result in API errors.
    • Authentication failures if the OAuth2 token is expired or misconfigured.
    • Network connectivity issues preventing access to the Tiny ERP API endpoint.

  • Error Messages:

    • "Tiny ERP API request failed: <error message>": Indicates a failure response from the API. Check the error message for specifics such as invalid parameters or authentication issues.
    • "Unknown operation: update": If the operation parameter is incorrectly set, ensure "update" is selected for the Contact resource.

  • Resolutions:

    • Verify that the contact ID exists in Tiny ERP before attempting an update.
    • Validate input fields conform to expected formats.
    • Re-authenticate or refresh the OAuth2 credentials in n8n.
    • Confirm network connectivity and API endpoint accessibility.

Links and References

Discussion