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

The "Get Employment Relationships" operation of the Bankerize - E-Consignado node allows users to request employment relationships linked to a client identified by their CPF (Brazilian individual taxpayer registry identification). This operation queries the Bankerize API to retrieve employment data associated with the client, which can be useful for financial institutions or service providers that need to verify employment status or history as part of credit analysis, loan proposals, or other financial services.

Common scenarios:

  • A bank verifying a client's current and past employment relationships before approving a payroll-deductible loan.
  • Financial service providers checking employment data to assess creditworthiness.
  • Automating retrieval of employment information to streamline loan proposal processes.

Practical example:
A user inputs a client's CPF and selects the partner bank (e.g., BMP). The node sends a request to the Bankerize API and returns a list of employment relationships for that client, which can then be used in subsequent workflow steps such as detailed employment verification or loan simulation.

Properties

Name Meaning
CPF The client's CPF number (only digits, exactly 11 digits). Required.
Banco Partner bank for the operation. Currently supports option: BMP. Required.

Output

The output JSON contains the response from the Bankerize API endpoint /proposals/econsignado/employment-relationship. It typically includes an array of employment relationship objects related to the provided CPF and bank. Each object represents an employment link with details such as employer information, registration, and other relevant employment data.

If no employment relationships are found, the node outputs a JSON message indicating "Nenhum resultado encontrado." ("No results found.").

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Bankerize API.
  • The node uses the Bankerize API endpoints for E-Consignado operations.
  • Network access to https://auth.bankerize.com.br (or the development environment) for token authentication.
  • Network access to the Bankerize API base URL for requests.

Troubleshooting

  • CPF Validation Errors:
    The CPF must contain exactly 11 digits. If the input is invalid or missing, the node throws an error stating the CPF is mandatory or incorrectly formatted.

  • Bank Selection Errors:
    The bank parameter is required. If missing or empty, the node will throw an error.

  • API Authentication Failures:
    If the API key credential is invalid or expired, authentication will fail, resulting in errors. Ensure the API credentials are correctly configured in n8n.

  • Empty Results:
    If no employment relationships exist for the given CPF and bank, the node returns a message indicating no results were found rather than throwing an error.

  • Network or API Errors:
    Errors returned by the Bankerize API are captured and included in the output JSON if "Continue On Fail" is enabled; otherwise, they cause the node to fail with an error message.

Links and References

Discussion