KobanaInstall

Overview

This node interacts with the Kobana API to manage PIX transfer batches, specifically allowing users to retrieve detailed information about a specific PIX transfer batch by its ID. It is useful in financial automation workflows where you need to track or verify the status and details of PIX transfer batches processed through Kobana.

For example, a user might use this node to:

• Retrieve the status and details of a PIX transfer batch after initiating it.
• Automate reconciliation processes by fetching batch data for reporting.
• Trigger downstream actions based on batch information, such as notifications or further processing.

Properties

Output

The node outputs JSON data representing the details of the requested PIX transfer batch. The structure corresponds to the response from the Kobana API endpoint for PIX transfer batches, typically including fields such as batch ID, status, creation date, list of transfers within the batch, amounts, and other metadata.

No binary data output is involved.

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

• Missing or invalid ID: If the ID property is not provided or incorrect, the API call will fail. Ensure the ID is correctly set and corresponds to an existing PIX transfer batch.
• Authentication errors: If the API key credential is missing, invalid, or lacks permissions, requests will be rejected. Verify that the API key is configured properly in n8n credentials.
• Network or API errors: Temporary network issues or API downtime can cause failures. Retrying or checking Kobana service status may help.
• JSON parsing errors: The node expects valid JSON input for some operations; malformed JSON in other operations' bodies could cause errors, but for this "get" operation, no body is sent.

Links and References

• Kobana API Documentation (general reference for API endpoints and data structures)
• PIX Payment System - Central Bank of Brazil (background on PIX transfers)

This summary focuses on the "Transfer > PIX Batches" resource with the "Get" operation, describing how the node retrieves a PIX transfer batch by its ID using the Kobana API.