Negocie icon

Negocie

Consume Negocie API

Overview

This node integrates with the Negocie API to perform various operations related to debt management, authentication, payments, and agreements. Specifically, for the Dívida (Debt) resource and the Buscar credores (Search creditors) operation, it fetches a list of creditors from the Negocie system.

Typical use cases include:

  • Retrieving creditor information associated with debts for further processing or display.
  • Integrating debt data into workflows that require creditor details.
  • Automating debt-related processes by fetching up-to-date creditor lists.

For example, a financial service provider could use this node to automatically pull creditor data before initiating debt negotiations or payment arrangements.

Properties

Name Meaning
Ambiente Selects the environment to perform operations in:
- Homologação (Testing environment)
- Produção (Production environment)
Token Bearer token obtained during authentication, used to authorize API requests for debt, payment, and agreement operations

Output

The node outputs JSON data representing the response from the Negocie API for the requested operation. For the "Buscar credores" operation, the output JSON contains the list of creditors retrieved from the API.

If an error occurs and the node is configured to continue on failure, the output will include an error object with details such as the error message, status code, and context.

No binary data output is produced by this node.

Dependencies

  • Requires a valid Bearer token for authorization, which must be obtained via a prior authentication step.
  • The node connects to different base URLs depending on the selected environment:
    • Production: https://prd-digital-api.bellinatiperez.com.br and https://negocie-api.bellinatiperez.com.br
    • Homologation (testing): https://hml-bpdigital-api.bellinatiperez.com.br and https://hml-negocie-api.bellinatiperez.com.br
  • No additional external dependencies are required beyond access to the Negocie API and proper credentials.

Troubleshooting

Common issues and their resolutions:

  • 401 Unauthorized: Indicates authentication failure. Verify that the Bearer token is valid and has not expired. Ensure correct credentials were used to obtain the token.
  • 403 Forbidden: Access denied due to insufficient permissions. Check user roles and API access rights.
  • 404 Not Found: The requested document or resource was not found. Confirm that the input parameters (e.g., document identifiers) are correct.
  • 500 Internal Server Error: An issue occurred on the Negocie API server. Retry after some time or contact support if the problem persists.

When errors occur, the node logs detailed error information including the resource, operation, environment, item index, timestamp, and error context to assist debugging.

Links and References

Discussion