Kobana icon

Kobana

Interact with Kobana API - Quick access to common operations

Actions215

Overview

This node interacts with the Kobana API to manage bank billet registrations, specifically allowing you to create new bank billet registration entries. Bank billets (Boletos) are a popular payment method in Brazil, used for billing and payments.

The Create operation under the V1 > Bank Billet Registrations resource enables users to submit data to register a new bank billet in the system. This is useful in scenarios where you want to automate the generation of bank billets for customers or integrate billing processes into your workflows.

Practical examples:

  • Automatically creating a bank billet registration when a new order is placed in an e-commerce platform.
  • Generating bank billets for subscription payments in a recurring billing system.
  • Integrating with financial systems to register bank billets for manual or automated payment processing.

Properties

Name Meaning
Request Body The JSON object representing the request body containing all necessary fields to create the bank billet registration. This must be provided and should conform to the API's expected schema for bank billet registration creation.
Additional Fields Optional JSON object with additional fields for the request. Allows sending extra parameters supported by the API that are not explicitly defined in the main request body.

Output

The node outputs the JSON response returned by the Kobana API after creating the bank billet registration. This typically includes details about the newly created bank billet registration such as its ID, status, amounts, due dates, and other metadata returned by the API.

No binary data output is indicated for 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).
  • Proper permissions and valid API credentials are required to perform the create operation successfully.

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 the JSON syntax is correct.
  • Authentication Errors: If the API key credential is missing, invalid, or lacks permissions, the node will fail with authentication errors. Verify the API key and its permissions.
  • API Validation Errors: The API may reject requests if required fields are missing or contain invalid values. Review the API documentation for required fields and validate the JSON structure accordingly.
  • Network Issues: Connectivity problems to the Kobana API endpoints can cause timeouts or failures. Check network access and endpoint availability.
  • 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


If you need further details on specific fields required in the request body or example payloads, please refer to the official Kobana API documentation or provide sample input data for more tailored guidance.

Discussion