KobanaInstall

Overview

This node interacts with the Kobana API to manage bank billets (bank slips) and other related resources. Specifically, for the V1 > Bank Billets resource and the Duplicate operation, it duplicates an existing bank billet by its ID. This is useful when you want to quickly create a copy of a previously issued bank slip without manually re-entering all details.

Common scenarios include:

• Reissuing a bank slip for a customer who lost or did not receive the original.
• Creating a similar bank slip with minor modifications based on an existing one.
• Automating bulk duplication of bank slips for recurring billing or batch processing.

Example: You have a bank billet with ID 12345 that you want to duplicate to issue a new payment request with the same details.

Properties

The Additional Fields property allows passing extra parameters as a JSON object to the API call, enabling advanced customization if supported by the API.

Output

The node outputs the JSON response from the Kobana API after duplicating the bank billet. The output structure corresponds to the duplicated bank billet's data returned by the API, typically including:

• The new bank billet's ID.
• Details such as amount, due date, payer information, and status.
• Metadata about the duplication operation.

No binary data output is involved in this operation.

Dependencies

• Requires an active connection to the Kobana API via an API key credential configured in n8n.
• The node dynamically selects the API base URL depending on the environment (production or sandbox).
• No other external dependencies are required.

Troubleshooting

• Invalid or missing ID: If the provided bank billet ID does not exist or is invalid, the API will return an error. Ensure the ID is correct and exists in your Kobana account.
• Authentication errors: If the API key credential is missing, expired, or incorrect, authentication will fail. Verify your API credentials in n8n.
• Malformed Additional Fields JSON: If the JSON in Additional Fields is invalid, the request will fail. Use valid JSON syntax.
• API rate limits or downtime: Temporary failures may occur due to API limits or service issues. Retry later or check Kobana's status.

Error messages from the node will typically include the API error message. Review these messages to identify the cause.

Links and References

• Kobana API Documentation (general reference for API endpoints and parameters)
• n8n documentation on Creating Custom Nodes
• JSON validation tools for verifying Additional Fields input (e.g., https://jsonlint.com/)