Bankerize - E-Consignado icon

Bankerize - E-Consignado

Gerenciar operações E-Consignado da API Bankerize: vínculos empregatícios, simulações e propostas para consignado privado
Join our community

Actions5

Overview

This node integrates with the Bankerize E-Consignado API to manage various operations related to payroll-deductible loans (consignado) in Brazil. Specifically, the Send Query Authorization operation allows users to send an existing query authorization from their own system to Bankerize for E-Consignado operations.

This is useful when you already have a customer's authorization stored and want to inform Bankerize about it to proceed with further loan-related processes without requiring the customer to re-authorize.

Practical example:
A financial institution that has collected customer authorizations offline or through another system can use this node operation to submit those authorizations to Bankerize, enabling seamless integration and continuation of loan processing workflows.

Properties

Name Meaning
Informações da Autorização (sendAuthNotice) A notice field providing information about sending an existing query authorization. This is informational only and does not accept input.
CPF (sendCpf) The customer's CPF number (Brazilian individual taxpayer registry identification), digits only, exactly 11 digits required.
Código Da Evidência (evidenceCode) Unique identifier of the authorization in your system, used to reference the specific authorization being sent.

Output

The node outputs a JSON object representing the response from the Bankerize API after submitting the query authorization. The structure typically includes confirmation details or error messages returned by the API.

No binary data output is involved in this operation.

Example output JSON might look like:

{
  "status": "success",
  "message": "Authorization received successfully",
  "data": {
    "cpf": "12345678901",
    "evidence_code": "AUTH_123456"
  }
}

Or, in case of errors, an error message with status code and details.

Dependencies

  • Requires an API key credential configured in n8n for authenticating requests to the Bankerize API.
  • The node uses HTTP POST requests to Bankerize endpoints, so internet connectivity and proper API access are necessary.
  • No additional external libraries beyond what n8n provides are required.

Troubleshooting

  • Common issues:

    • Invalid or missing CPF: The CPF must be exactly 11 digits; otherwise, the node throws an error.
    • Missing or empty evidence code: This unique identifier is mandatory.
    • Authentication failures due to incorrect or expired API credentials.
    • Network or API endpoint unavailability.

  • Error messages and resolutions:

    • "CPF deve conter exatamente 11 dígitos": Ensure the CPF input contains only numbers and is exactly 11 digits long.
    • "Código da evidência é obrigatório": Provide a valid evidence code string.
    • Authentication errors: Verify that the API key credential is correctly set up and has not expired.
    • "Operação não retornou dados": Indicates no response data was received; check API availability and parameters.
    • For HTTP errors, inspect the status code and message returned in the output JSON for more details.

Links and References

Discussion