Negocie icon

Negocie

Consume Negocie API
Join our community

Actions7

Overview

This node integrates with the Negocie API, a service designed to manage financial negotiations such as debts, payments, and agreements. It supports multiple resources including authentication, debt management, payment options, and agreements. The specific operation "Negociar dívida" (Negotiate Debt) allows users to interact with the API to negotiate outstanding debts with financial institutions.

Typical use cases include:

  • Automating debt negotiation workflows for financial services.
  • Retrieving available payment options and creditor information.
  • Managing agreements and payments programmatically.
  • Integrating debt negotiation processes into larger automation pipelines.

For example, a financial advisor could use this node to fetch a client's outstanding debts from various creditors and initiate negotiation offers automatically based on predefined rules.

Properties

Name Meaning
Ambiente Selects the environment for operations: "Homologação" (testing) or "Produção" (production).
Token Bearer token obtained from authentication, used for authorized API requests.
Financeira Name of the financial institution involved in the debt negotiation (e.g., BV, PAN, Casas Bahia).

Output

The node outputs JSON data representing the response from the Negocie API for the requested operation. The structure varies depending on the operation but generally includes:

  • For debt negotiation: details about the negotiated debt, status, and any relevant metadata.
  • For other operations: lists of creditors, payment options, agreements, or authentication tokens.

If an error occurs and "Continue On Fail" is enabled, the output will contain an error object with fields like error, message, details, and context describing the failure.

The node does not output binary data.

Dependencies

  • Requires access to the Negocie API endpoints, which differ based on the selected environment:
    • Production URLs: https://prd-digital-api.bellinatiperez.com.br and https://negocie-api.bellinatiperez.com.br
    • Homologation (test) URLs: https://hml-bpdigital-api.bellinatiperez.com.br and https://hml-negocie-api.bellinatiperez.com.br
  • Requires a valid Bearer token for authenticated requests.
  • No internal n8n credentials are specified; users must provide necessary tokens and parameters manually.

Troubleshooting

  • Common Issues:

    • Invalid or expired Bearer token leading to authentication failures.
    • Incorrect document or financial institution names causing "not found" errors.
    • Permission issues if the user lacks access rights to certain API resources.
    • Server-side errors from the Negocie API causing request failures.

  • Error Messages and Resolutions:

    • "Documento não encontrado na API Negocie. Verifique se o documento informado existe e está correto."
      Means the provided document ID was not found. Verify the document number is correct.
    • "Falha na autenticação. Verifique as credenciais (appId, appPass, usuario) no ambiente X."
      Indicates authentication failure. Check that the app ID, password, and user credentials are correct for the selected environment.
    • "Acesso negado. O usuário não tem permissão para acessar este recurso."
      User lacks permission. Confirm API user roles and permissions.
    • "Erro interno do servidor da API Negocie. Tente novamente mais tarde."
      Server error on Negocie side. Retry after some time.

Enabling "Continue On Fail" allows the workflow to proceed even if some items fail, returning detailed error info per item.

Links and References

Note: This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion