NegocieInstall

Overview

This node integrates with the Negocie API, a service likely focused on debt management and financial negotiations. Specifically, the "Autenticar devedor" operation under the "Autenticação" resource allows users to authenticate a debtor by providing their identification (CPF or CNPJ) along with application credentials.

Common scenarios for this node include:

• Validating debtor identity before performing further operations such as querying debts, payments, or agreements.
• Automating debtor authentication in workflows that manage financial negotiations or debt collections.
• Integrating debtor verification into CRM or financial systems to streamline client onboarding or credit checks.

For example, a user might input a debtor's CPF and application credentials to receive an authentication token or confirmation from the Negocie API, which can then be used in subsequent API calls.

Properties

Name	Meaning
Ambiente	Selects the environment for operations: "Homologação" (testing) or "Produção" (production).
App ID	Application ID provided by Negocie, used for authenticating API requests.
App Pass	Password for the application, provided by Negocie, used alongside App ID for authentication.
Usuário (CPF/CNPJ)	The debtor's CPF or CNPJ number (only digits), identifying the individual or company to authenticate.

Output

The node outputs JSON data representing the response from the Negocie API's authentication endpoint. This typically includes authentication tokens or status information confirming whether the debtor was successfully authenticated.

If an error occurs, the output JSON will contain an error flag set to true, a descriptive message, detailed error information, and context about the failure.

No binary data output is produced by this operation.

Dependencies

• Requires access to the Negocie API endpoints, with URLs depending on the selected environment:

  • Homologação (testing):
    • Base URL for login: https://hml-bpdigital-api.bellinatiperez.com.br
  • Produção (production):
    • Base URL for login: https://prd-digital-api.bellinatiperez.com.br

• Requires valid application credentials (App ID and App Pass) and the debtor's CPF or CNPJ.

• No additional external dependencies beyond standard HTTP requests.

Troubleshooting

Common Issues

• Invalid Credentials: If the App ID, App Pass, or Usuário are incorrect, authentication will fail.
• Incorrect Environment: Using production credentials in the testing environment or vice versa may cause errors.
• Malformed CPF/CNPJ: Providing non-numeric characters or invalid document numbers will result in API errors.
• Network or API Downtime: Temporary unavailability of the Negocie API can cause request failures.

Error Messages and Resolutions

• "Documento não encontrado na API Negocie. Verifique se o documento informado existe e está correto."
  Means the debtor's document was not found. Verify the CPF/CNPJ is correct and exists in the system.

• "Falha na autenticação. Verifique as credenciais (appId, appPass, usuario) no ambiente X."
  Indicates authentication failure due to invalid credentials or mismatched environment. Double-check all inputs.

• "Acesso negado. O usuário não tem permissão para acessar este recurso."
  The user lacks permission; ensure the credentials have appropriate rights.

• "Erro interno do servidor da API Negocie. Tente novamente mais tarde."
  Server-side error; retry after some time.

When using the node with "Continue On Fail" enabled, errors are returned as part of the output JSON instead of stopping execution.

Links and References

• Negocie API Documentation (Replace with actual URL if available)
• CPF and CNPJ Validation Rules
• n8n Documentation on Creating Custom Nodes