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 remittances, specifically allowing you to update existing remittance records. Bank billet remittances are used in financial operations involving collections and payments via bank slips (boletos), common in Brazil.

The Update operation for "V1 > Bank Billet Remittances" lets you modify details of a specific remittance by its ID, sending a JSON request body with the updated data.

Common scenarios:

  • Adjusting payment or collection details on an existing bank billet remittance.
  • Correcting or adding information after initial creation.
  • Automating updates to remittance records based on external triggers or workflows.

Practical example:
You have a remittance record that needs to be updated with new payment instructions or corrected customer data. Using this node, you provide the remittance ID and a JSON body with the changes, and the node sends the update request to Kobana.


Properties

Name Meaning
ID The unique identifier of the bank billet remittance to update.
Additional Fields A JSON object containing any extra fields to include in the request (optional).
Request Body The JSON-formatted body containing the data to update the remittance with (required).

Output

The node outputs the JSON response from the Kobana API after performing the update operation. This typically includes the updated remittance data reflecting the changes made.

  • The output is an array of JSON objects, each representing the updated remittance resource.
  • No binary data output is involved in 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.
  • Network access to https://api.kobana.com.br (production) or https://api-sandbox.kobana.com.br (sandbox) is required.

Troubleshooting

  • Invalid ID error: If the provided remittance ID does not exist or is malformed, the API will return an error. Verify the ID correctness.
  • Malformed JSON in Request Body: Ensure the JSON in the "Request Body" property is valid and correctly structured according to Kobana's API schema.
  • Authentication errors: Confirm that the API key credential is valid and has permission to update remittances.
  • API rate limits or network issues: Temporary failures may occur; retry or check network connectivity.
  • Unexpected errors: Enable "Continue On Fail" in the node settings to handle errors gracefully and inspect error messages returned in the output.

Links and References


If you need further details about other operations or resources, feel free to ask!

Discussion