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 API to manage E-Consignado operations related to employment relationships, loan simulations, and proposals for private payroll loans. Specifically, the Get Employment Details operation retrieves detailed information about a specific employment relationship previously obtained from the API.

Typical use cases include:

  • Fetching detailed employment data for a client’s payroll loan application.
  • Verifying employer and registration details linked to a client's employment.
  • Enriching client profiles with verified employment information before proceeding with loan proposals or simulations.

For example, after retrieving a list of employment relationships for a client, you can use this operation to get detailed info on one particular employment record by providing its request UUID, registration number, and employer CNPJ.

Properties

Name Meaning
Request UUID UUID of the employment relationships request obtained from a previous operation.
Registration Registration number (matrícula) of the specific employment relationship.
CNPJ Empregador Employer's CNPJ (Brazilian company identifier), numbers only, exactly 14 digits required.

Output

The output JSON contains detailed information about the specified employment relationship as returned by the Bankerize API. This typically includes fields such as employer details, employment status, contract dates, and other relevant employment metadata.

The node does not output binary data for this operation.

Example output structure (simplified):

{
  "request_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "registration": "MAT12345",
  "employer_document": "12345678000199",
  "employment_details": {
    "position": "Analyst",
    "start_date": "2020-01-01",
    "status": "Active",
    ...
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Bankerize API.
  • The node makes HTTP POST requests to the Bankerize API endpoint /proposals/econsignado/employment-relationship/details.
  • Proper configuration of the API credentials in n8n is necessary.
  • The CNPJ and UUID values must be valid and correctly formatted.

Troubleshooting

  • Missing or invalid parameters: The node validates that Request UUID, Registration, and CNPJ Empregador are provided and correctly formatted. Errors will be thrown if these are missing or malformed.
  • CNPJ length error: The CNPJ must contain exactly 14 digits; otherwise, an error is raised.
  • API authentication errors: If the API key is invalid or expired, authentication will fail. Ensure the API credentials are up to date.
  • No data returned: If the operation returns no data, the node throws an error indicating no results were found.
  • Network or API errors: These are caught and reported with status codes and messages when available. Use the error details to diagnose connectivity or permission issues.

Links and References

Discussion