Negocie icon

Negocie

Consume Negocie API
Join our community

Actions7

Overview

This node integrates with the Negocie API to perform various financial operations related to debts, payments, agreements, and authentication. Specifically, for the "Dívida" resource and the "Buscar dívidas" operation, it allows users to query outstanding debts associated with a particular financial institution ("financeira") and its CRMs (customer relationship management codes).

Common scenarios where this node is beneficial include:

  • Retrieving debt information from multiple financial institutions for debt collection or customer service.
  • Integrating debt data into workflows for automated follow-ups or payment negotiations.
  • Aggregating debt data across different CRMs of a financial company.

For example, a collections department could use this node to fetch all debts registered under a specific financial institution and then trigger further actions such as sending reminders or offering payment options.

Properties

Name Meaning
Ambiente Selects the environment to perform operations: "Homologação" (testing) or "Produção" (live).
Token Bearer token obtained from authentication, used for authorized API requests.
Financeira Name of the financial institution (e.g., BV, PAN, Casas Bahia) whose debts are being queried.
CRMs List of CRM codes associated with the financial institution; multiple CRM codes can be provided.

Output

The output is a JSON array where each item corresponds to the response from the Negocie API for the requested debts. The structure depends on the API's response but generally includes details about debts linked to the specified financial institution and CRMs.

If an error occurs during execution for any input item, the output will contain an object with:

  • error: true
  • message: a user-friendly error description
  • details: technical error information including resource, operation, status code, and timestamp
  • context: additional context from the API error response

No binary data output is produced by this operation.

Dependencies

  • Requires access to the Negocie API endpoints, which differ based on the selected environment ("Homologação" or "Produção").
  • Requires a valid Bearer token for authorization, which must be obtained via the authentication operation.
  • Network connectivity to the Negocie API URLs:
    • Homologação: https://hml-negocie-api.bellinatiperez.com.br
    • Produção: https://negocie-api.bellinatiperez.com.br

Troubleshooting

Common Issues

  • Invalid or expired token: If the Bearer token is invalid or expired, the API will return a 401 Unauthorized error.
  • Incorrect financial institution or CRM codes: Providing wrong or non-existent names/codes may result in empty responses or errors.
  • API downtime or server errors: The API might respond with 500 Internal Server Error during outages.

Error Messages and Resolutions

Error Message Cause Resolution
"Documento não encontrado na API Negocie. Verifique se o documento informado existe e está correto." The document identifier was not found (404). Verify that the document or identifiers used in the request are correct and exist in the system.
"Falha na autenticação. Verifique as credenciais (appId, appPass, usuario) no ambiente X." Authentication failure (401). Check and update the credentials and ensure the correct environment is selected.
"Acesso negado. O usuário não tem permissão para acessar este recurso." Permission denied (403). Confirm that the user has the necessary permissions for the requested operation.
"Erro interno do servidor da API Negocie. Tente novamente mais tarde." Server error (500). Retry after some time; if persistent, contact API support.

Links and References

Discussion