Kobana icon

Kobana

Interact with Kobana API - Quick access to common operations
Join our community

Actions215

Overview

This node integrates with the Kobana API to manage customer data, specifically allowing you to find a customer by their CNPJ or CPF (Brazilian company and individual taxpayer registry numbers). It performs a search query against the Kobana system to retrieve customer details associated with the provided document number.

Common scenarios where this node is useful include:

  • Verifying customer identity in financial or billing workflows.
  • Retrieving detailed customer information for CRM or support systems.
  • Automating customer lookups during onboarding or transaction processing.

For example, you can input a CNPJ/CPF number, and the node will return the matching customer record from Kobana, enabling downstream nodes to use that data for further automation.

Properties

Name Meaning
Query Parameters JSON object with additional query parameters to refine the search (optional)
CNPJ/CPF The Brazilian CNPJ (company ID) or CPF (individual ID) number to search for (required)

Output

The node outputs a JSON array of customer objects matching the given CNPJ or CPF. Each object contains the customer details as returned by the Kobana API.

The output structure corresponds directly to the API response for the /customers/cnpj_cpf endpoint, typically including fields such as customer name, document number, contact info, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an active Kobana API credential configured in n8n with appropriate permissions.
  • The node dynamically selects the API base URL depending on whether the environment is production or sandbox.
  • Network access to https://api.kobana.com.br (production) or https://api-sandbox.kobana.com.br (sandbox) is required.

Troubleshooting

  • Missing or invalid CNPJ/CPF: The node requires a valid CNPJ or CPF string. Ensure the input is correctly formatted and not empty.
  • Authentication errors: If the API key or credentials are incorrect or missing, the node will fail to authenticate. Verify your Kobana API credentials in n8n.
  • API rate limits or downtime: Temporary network issues or API limits may cause request failures. Retry after some time or check Kobana service status.
  • Malformed query parameters: If using the optional query parameters JSON, ensure it is valid JSON syntax to avoid parsing errors.

Common error messages usually come from the Kobana API and indicate issues like unauthorized access, resource not found, or bad requests. Review the error message details and adjust inputs or credentials accordingly.

Links and References

Discussion