Actions10
Overview
This node integrates with the Corbee CRM API to update comprehensive customer data. It allows users to modify various details of an existing customer, including personal information, address, and bank account data. This operation is useful in scenarios where customer records need to be kept current, such as updating contact details, correcting personal information, or adding banking details for payment processing.
Practical examples include:
- Updating a customer's email and phone number after they provide new contact info.
- Correcting a customer's CPF/CNPJ (Brazilian tax ID) format.
- Adding or modifying the customer's address or bank account details for billing purposes.
Properties
| Name | Meaning |
|---|---|
| ID Do Cliente | The unique identifier of the customer to be updated (required). |
| Nome | Full name of the customer. |
| CPF/CNPJ | Customer's CPF or CNPJ number; only numeric characters will be sent. |
| Customer's email address. | |
| Data De Nascimento | Customer's birth date in DD/MM/YYYY format. |
| Gênero | Customer's gender; accepts "Masculino", "M", "Feminino", or "F" and converts automatically to "M" or "F". |
| Nome Da Mãe | Full name of the customer's mother. |
| 📍 Dados do Endereço (Notice section) | Section header indicating the following fields relate to the customer's address. |
| UF (Estado) | State abbreviation (2 letters). |
| Cidade | City name. |
| Bairro | Neighborhood name. |
| Rua | Street or road name. |
| Número | Address number. |
| Complemento | Optional address complement (e.g., apartment number). |
| CEP | Postal code (CEP), with or without mask. |
| 🏦 Dados Bancários (Notice section) | Section header indicating the following fields relate to the customer's bank account. |
| Número Do Banco | Bank number (use the "List Banks" operation to find valid numbers). |
| Tipo De Conta | Bank account type; accepts "Conta Corrente" or "c" for checking, "Poupança" or "p" for savings, converted automatically. |
| Agência | Bank agency number. |
| Conta | Bank account number. |
Output
The node outputs JSON data representing the updated customer record as returned by the Corbee CRM API. The structure includes all updated fields and any additional metadata provided by the API. Each input item results in one output item containing the corresponding response JSON.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Corbee CRM API.
- The node uses the CorbeeHelpers utility class internally to handle API requests and data normalization.
- Network access to the Corbee CRM API endpoint is necessary.
- Proper configuration of the API credentials within n8n is required.
Troubleshooting
- Invalid Customer ID: If the provided customer ID does not exist, the API may return an error. Verify the ID is correct.
- CPF/CNPJ Format Errors: The node normalizes CPF/CNPJ by removing non-numeric characters. Providing invalid formats may cause validation errors.
- Gender Field Issues: The gender field accepts several variants but must be convertible to "M" or "F". Invalid inputs may be rejected.
- Bank Number Validation: Use the "List Banks" operation to ensure the bank number is valid.
- API Authentication Failures: Ensure the API key credential is correctly set up and has sufficient permissions.
- Network Errors: Check network connectivity to the Corbee CRM API endpoint.
Common error messages typically indicate unsupported operations, missing required parameters (like customer ID), or API request failures. Reviewing the input parameters and API credentials usually resolves these issues.