Actions25
Overview
This node integrates with the Tiny ERP API v3 to manage various business resources, including invoices. Specifically, the Invoice - Create operation allows users to create new invoices in their Tiny ERP system by providing relevant invoice details.
Typical use cases include automating invoice creation after order fulfillment, generating invoices for accounting purposes, or integrating invoicing into broader workflows such as CRM or e-commerce platforms.
For example, after a sale is completed on an online store, this node can automatically create an invoice in Tiny ERP with customer and product details, streamlining financial record-keeping.
Properties
| Name | Meaning |
|---|---|
| Additional Fields | A collection of optional fields to specify invoice details: |
| - Name: Name of the item | |
| - Description: Description of the item | |
| - Price: Price of the item | |
| - SKU: SKU/Code of the product | |
| - Email: Email address | |
| - Phone: Phone number | |
| - Document: CPF or CNPJ document number | |
| - Address: Address | |
| - City: City | |
| - State: State (UF) | |
| - ZIP Code: ZIP Code (CEP) |
These fields allow detailed specification of the invoice content when creating it.
Output
The node outputs JSON data representing the response from the Tiny ERP API after creating the invoice. This typically includes the newly created invoice's details such as its ID, status, and any other metadata returned by the API.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token configured via OAuth2 credentials to access the Tiny ERP API.
- The node makes HTTP requests to
https://erp.tiny.com.br/public-api/v3endpoints. - Proper configuration of the OAuth2 credential within n8n is necessary for successful API communication.
Troubleshooting
Common issues:
- Authentication failures due to invalid or expired API tokens.
- Missing required fields in the additional fields collection may cause API errors.
- Network connectivity problems preventing access to the Tiny ERP API.
Error messages:
"Tiny ERP API request failed: <error message>"indicates an issue with the API call; check credentials and request parameters."Unknown operation: create"would indicate a misconfiguration of the operation parameter (unlikely if using the UI).
Resolutions:
- Verify that the OAuth2 credentials are correctly set up and authorized.
- Ensure all required invoice fields are provided according to Tiny ERP API documentation.
- Check network settings and firewall rules to allow outbound HTTPS requests.
Links and References
- Tiny ERP API Documentation (official API docs for more details on invoice creation and fields)
- n8n OAuth2 Credential Setup (guide on configuring OAuth2 credentials in n8n)