Actions29
- Cliente Actions
- Antecipação Actions
- Assinatura Actions
- Cobrança Actions
- Link De Pagamento Actions
- Webhook Actions
Overview
This node integrates with the Asaas API to manage anticipation (early request) of receivables. The "Solicitar" operation under the "Antecipação" resource allows users to request an anticipation of payments, either automatically based on history or manually by specifying particular charges and amounts.
Common scenarios include:
- Businesses wanting to receive funds earlier than scheduled payment dates.
- Financial teams managing cash flow by selectively anticipating certain payments.
- Automating anticipation requests based on predefined rules or manual selections.
Practical example:
- A company has multiple pending payments and wants to request anticipation for specific invoices to improve liquidity. They can specify the payment IDs and choose between automatic or manual anticipation types, optionally adding observations about the request.
Properties
| Name | Meaning |
|---|---|
| Cobranças * | IDs of the charges/payments to anticipate. Can be a comma-separated string or JSON array. |
| Tipo De Antecipação | Type of anticipation: - Automática: Automatic anticipation based on history - Manual: Manual anticipation with specific selection |
| Valor Total | Total amount to anticipate (only applicable for manual anticipation). Must be a positive number. |
| Observações | Optional notes or comments about the anticipation request. |
Output
The node outputs the JSON response from the Asaas API related to the anticipation request. This typically includes details such as the status of the anticipation, the payments involved, amounts, and any messages returned by the API.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Asaas API.
- The node uses the Asaas API endpoints, switching between sandbox and production URLs based on the environment setting in credentials.
- No additional external services are required beyond the Asaas API.
Troubleshooting
- Invalid Payment IDs: If the provided payment IDs are incorrect or do not exist, the API will return an error. Ensure that payment IDs are valid and correctly formatted (either as a JSON array or comma-separated string).
- Missing Required Fields: The "Cobranças *" field is mandatory. Omitting it or providing empty values will cause errors.
- Incorrect Anticipation Type or Value: For manual anticipation, ensure that the "Valor Total" is greater than zero; otherwise, the request may fail.
- API Authentication Errors: Verify that the API key credential is correctly configured and has the necessary permissions.
- Network Issues: Timeouts or connectivity problems with the Asaas API endpoint can cause failures. Check network access and retry if needed.
Common error messages:
- "Este pacote foi removido do npm e não está mais disponível." — Indicates the node package is no longer available; remove or update the node accordingly.
- Validation errors from the API regarding missing or invalid parameters.
Links and References
- Asaas API Documentation (official API docs for anticipations and payments)
- n8n Documentation (for general usage of custom nodes and credentials)