Actions14
- Barcode Actions
- CNPJ Lookup Actions
- Currency Actions
- Email Validator Actions
- FIPE Actions
- Holiday Actions
- IP Lookup Actions
- Number to Word Actions
- QR Code Actions
- Validator Actions
- ZIP Code Actions
Overview
This node integrates with the Invertexto API to perform a CNPJ Lookup operation. It allows users to retrieve detailed company information by providing a valid 14-digit CNPJ number (Cadastro Nacional da Pessoa Jurídica), which is the Brazilian national registry identifier for legal entities.
Typical use cases include:
- Verifying company details during onboarding or compliance checks.
- Enriching customer data with official company information.
- Automating business workflows that require validation of Brazilian companies.
For example, a user can input a CNPJ number like 00.000.000/0000-00 and receive structured data about the corresponding company, such as its name, address, status, and other registration details.
Properties
| Name | Meaning |
|---|---|
| CNPJ | The 14-digit CNPJ number of the company to look up. It should be provided in numeric format, optionally including punctuation (dots, slashes, hyphens). The node will sanitize the input by removing non-numeric characters before querying the API. |
Output
The output is a JSON object containing the company information returned by the Invertexto API for the given CNPJ. This typically includes fields such as:
- Company name
- Registration status
- Address details
- Activity codes
- Date of establishment
- Other relevant official data associated with the CNPJ
The exact structure depends on the API response but is returned as a JSON array where each item corresponds to an input CNPJ lookup.
The node does not output binary data for this operation.
Dependencies
- Requires an active API key credential for the Invertexto API to authenticate requests.
- The node makes HTTP GET requests to
https://api.invertexto.com/v1/cnpj/{cnpj}endpoint. - Proper configuration of the API key credential within n8n is necessary for successful execution.
Troubleshooting
- Invalid CNPJ format: If the CNPJ is not 14 digits or contains invalid characters, the API may return an error or no data. Ensure the input is correctly formatted; the node strips non-numeric characters automatically.
- Authentication errors: If the API key is missing, invalid, or expired, the node will fail with an authorization error. Verify the API key credential setup.
- API rate limits or downtime: Temporary failures might occur if the API service is unavailable or rate-limited. Retry later or check the API provider's status.
- Network issues: Connectivity problems between n8n and the API endpoint can cause request failures.
If the node is set to continue on failure, errors will be included in the output JSON under an error field for easier debugging.
Links and References
- Invertexto API Documentation (general reference for available endpoints)
- Brazilian CNPJ Information (background on the CNPJ system)
This summary focuses exclusively on the "CNPJ Lookup" resource and "Lookup" operation as requested.