KobanaInstall

Overview

This node enables interaction with the Kobana API specifically for managing TED transfer batches. The "Create" operation under the "Transfer > TED Batches" resource allows users to create new TED transfer batches by sending a JSON request body describing the batch details.

Typical use cases include automating the creation of multiple TED transfers grouped into batches for efficient processing, such as payroll disbursements, vendor payments, or bulk fund transfers between accounts.

For example, a finance team could use this node to programmatically create a batch of TED transfers to pay multiple suppliers in one API call, reducing manual effort and minimizing errors.

Properties

| Additional Fields | A JSON object containing any extra fields to include in the request (optional). |

Note: For this specific operation ("Create" on "Transfer > TED Batches"), the main required input is the Request Body JSON that defines the batch parameters.

Output

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

The output is structured as an array of JSON objects, each corresponding to an input item processed. Each object contains the full API response data under the json field.

No binary data output is indicated for 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.
• The API requests are authenticated using the provided Kobana API credentials.
• The user must supply valid JSON in the Request Body property matching the API's expected schema for TED batch creation.

Troubleshooting

• Invalid JSON in Request Body: If the JSON provided in the Request Body is malformed, the node will throw a parsing error. Ensure the JSON syntax is correct before running.
• API Authentication Errors: If the Kobana API credentials are missing, invalid, or lack necessary permissions, the node will fail with authentication errors. Verify the API key/token and permissions.
• Missing Required Fields: The API may reject requests missing mandatory fields in the batch definition. Consult the Kobana API documentation to ensure all required properties are included.
• Network or Endpoint Issues: Connection problems or incorrect environment settings can cause request failures. Confirm network connectivity and that the environment setting matches your intended API endpoint (production vs sandbox).
• Error Responses from API: The node returns error messages from the API in the output if the request fails. Review these messages to identify issues like invalid parameters or business logic errors.

Links and References

• Kobana API Documentation — Official API reference for detailed information on TED batch creation and other operations.
• TED Transfer Overview — General background on TED transfers in Brazil.
• n8n Documentation on Creating Custom Nodes for further customization guidance.