NegocieInstall

Overview

This node integrates with the Negocie API to perform various operations related to debt management, payments, agreements, and authentication. Specifically, for the Acordo resource with the Buscar acordos operation, it allows users to search for agreements associated with a given document identifier.

Common scenarios where this node is beneficial include:

• Retrieving existing agreements for a debtor based on their document ID.
• Automating workflows that require fetching agreement data from the Negocie platform.
• Integrating debt negotiation data into broader business processes or dashboards.

For example, a financial services company could use this node to automatically fetch all active agreements for a client when processing their account, enabling real-time decision-making or reporting.

Properties

Name	Meaning
Ambiente	Selects the environment to perform operations in: - Homologação (Testing environment) - Produção (Production environment)

Note: The property "Ambiente" determines which API endpoints are used (production or testing).

Output

The node outputs JSON data representing the response from the Negocie API for the requested operation. For the Buscar acordos operation under the Acordo resource, the output JSON contains the details of the agreements found for the specified document.

Each item in the output corresponds to one input item processed and includes either:

• The successful API response data structured as JSON.
• Or, in case of failure (if "Continue On Fail" is enabled), an error object with fields such as error, message, details (including resource, operation, environment, item index, timestamp, error type, status code, and original message), and context.

The node does not output binary data.

Dependencies

• Requires access to the Negocie API endpoints, which differ based on the selected environment ("homologacao" or "producao").
• Requires appropriate authentication tokens or credentials depending on the operation (not detailed here due to internal credential naming restrictions).
• No additional external dependencies beyond standard HTTP requests to the Negocie API.

Troubleshooting

Common Issues

• Document Not Found (404): If the provided document ID does not exist in the Negocie system, the node returns a 404 error with the message "Documento não encontrado na API Negocie. Verifique se o documento informado existe e está correto."
• Authentication Failure (401): Occurs if the authentication credentials (such as appId, appPass, usuario) are incorrect or missing for the selected environment. The error message advises verifying these credentials.
• Access Denied (403): Indicates the user does not have permission to access the requested resource.
• Internal Server Error (500): A server-side issue at Negocie API; retrying later is recommended.

Error Handling

• When "Continue On Fail" is enabled, the node captures errors per item and outputs them as JSON objects without stopping the entire workflow.
• Without "Continue On Fail," the node throws the error and halts execution.

Links and References

• Negocie API Documentation (URL inferred from code, verify with official source)
• n8n Documentation on Error Handling
• General information on debt management APIs and integrations.

---

If you need further details on other resources or operations, feel free to ask!