KobanaInstall

Overview

This node integrates with the Kobana API to manage PIX transfer batches, specifically allowing users to create new PIX transfer batches. It is useful in scenarios where you need to automate or batch multiple PIX transfers for financial operations, such as payroll, vendor payments, or mass disbursements via PIX (a Brazilian instant payment system). For example, a company can use this node to create a batch of PIX transfers to pay multiple suppliers at once, streamlining the payment process.

Properties

Output

The node outputs the JSON response from the Kobana API after creating the PIX transfer batch. This typically includes details about the created batch such as its ID, status, creation timestamp, and any other metadata returned by the API.

If the API supports binary data output (e.g., export files), it would be handled accordingly, but for the "Create" operation on PIX Batches, the output is JSON data describing the newly created 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 other external dependencies are needed beyond the Kobana API access.

Troubleshooting

• Invalid JSON in Request Body: If the JSON provided in the "Request Body" or "Additional Fields" is malformed, the node will throw a parsing error. Ensure that the JSON syntax is correct.
• Missing Required Fields: The API may reject requests missing mandatory fields in the request body. Verify the Kobana API documentation for required fields when creating PIX batches.
• Authentication Errors: If the API key credential is invalid or missing, authentication errors will occur. Confirm that the API key is correctly configured in n8n credentials.
• API Endpoint Errors: Network issues or incorrect environment selection (sandbox vs production) can cause failures. Check the environment setting and network connectivity.
• Continue On Fail: If enabled, the node will continue processing subsequent items even if one fails, returning error details in the output JSON.

Links and References

• Kobana API Documentation (general reference for API endpoints and request formats)
• PIX Payment System - Central Bank of Brazil (background on PIX payments)

This summary focuses on the "Transfer > PIX Batches" resource with the "Create" operation, based on the provided properties and source code analysis.