KobanaInstall

Overview

This node interacts with the Kobana API to manage bank billet batches, specifically supporting operations such as retrieving batch information, creating new batches, listing batches, deleting batches, adding or removing bank billets from a batch, and exporting batches as ZIP or PDF files.

The Get operation for the V1 > Bank Billet Batches resource fetches detailed information about a specific bank billet batch by its ID. This is useful when you need to retrieve the current status, contents, or metadata of a particular batch of bank billets (payment slips).

Practical examples:

• Retrieve details of a batch to verify which bank billets it contains.
• Check the status or metadata of a batch before processing payments.
• Use the batch information to generate reports or trigger further workflows.

Properties

Output

The output is a JSON object representing the bank billet batch data returned by the Kobana API. It typically includes details such as batch ID, creation date, status, list of bank billets included in the batch, and other relevant metadata.

If the operation involves exporting (e.g., exportZip or exportPdf), the node may return binary data representing the exported file (ZIP or PDF). However, for the Get operation, the output is purely JSON data describing the batch.

Dependencies

• Requires an API key credential for authenticating with the Kobana API.
• The node dynamically selects the API base URL depending on the environment (production or sandbox).
• No additional external dependencies are needed beyond the Kobana API access.

Troubleshooting

• Common issues:

  • Invalid or missing batch ID will cause the API to return an error.
  • Authentication failures if the API key credential is incorrect or expired.
  • Network connectivity issues preventing access to the Kobana API endpoints.

• Error messages:

  • "Resource not found" or similar indicates the provided batch ID does not exist.
  • "Unauthorized" or "Authentication failed" means the API key credential is invalid.
  • "Bad Request" may indicate malformed input parameters.

• Resolutions:

  • Verify the batch ID is correct and exists in your Kobana account.
  • Ensure the API key credential is properly configured and has necessary permissions.
  • Check network connectivity and firewall settings.

Links and References

• Kobana API Documentation (official API docs for detailed endpoint info)
• n8n Documentation (for general usage of custom nodes and credentials)