Actions215
- V1 > Bank Billets Actions
- V1 > Bank Billet Accounts Actions
- V1 > Bank Billet Batches Actions
- V1 > Bank Billet Batch Exports Actions
- V1 > Bank Billet Discharges Actions
- V1 > Bank Billet Payments Actions
- V1 > Bank Billet Registrations Actions
- V1 > Bank Billet Remittances Actions
- V1 > Customers Actions
- V1 > Customer Subscriptions Actions
- V1 > Discharges Actions
- V1 > Email Deliveries Actions
- V1 > Events Actions
- V1 > Imports Actions
- V1 > Installments Actions
- V1 > Remittances Actions
- V1 > Reports Actions
- V1 > SMS Deliveries Actions
- V1 > User Info Actions
- V1 > Webhook Deliveries Actions
- V1 > Webhooks Actions
- Admin > Users Actions
- Admin > Connections Actions
- Admin > Certificates Actions
- Admin > Subaccounts Actions
- Charge > PIX Actions
- Charge > PIX Accounts Actions
- Data > Bank Billet Queries Actions
- EDI > EDI Boxes Actions
- Financial > Accounts Actions
- Financial > Balances Actions
- Financial > Commands Actions
- Financial > Statement Transactions Actions
- Financial > Transaction Imports Actions
- Financial > Providers Actions
- Payment > Bank Billets Actions
- Payment > Bank Billet Batches Actions
- Payment > Batches Actions
- Payment > DARFs Actions
- Payment > DARF Batches Actions
- Payment > PIX Actions
- Payment > PIX Batches Actions
- Payment > Utilities Actions
- Payment > Utility Batches Actions
- Transfer > Batches Actions
- Transfer > Internal Actions
- Transfer > Internal Batches Actions
- Transfer > PIX Actions
- Transfer > PIX Batches Actions
- Transfer > TED Actions
- Transfer > TED Batches Actions
Overview
This node integrates with the Kobana API to manage utility payments under the "Payment > Utilities" resource, specifically supporting the "Get Many" operation. It allows users to retrieve multiple utility payment records from Kobana, either returning all available results or a limited subset based on user-defined parameters.
Typical use cases include:
- Fetching a list of utility payments for reporting or reconciliation.
- Automating workflows that require batch processing or analysis of utility payment data.
- Integrating Kobana utility payment data into other systems or dashboards.
For example, a finance team could use this node to pull all utility payments made in the last month to verify expenses or generate financial reports.
Properties
| Name | Meaning |
|---|---|
| Return All | Boolean flag indicating whether to return all utility payment records or limit the results. |
| Limit | Maximum number of utility payment records to return when "Return All" is false (1-100). |
| Additional Fields | JSON object allowing specification of extra fields to include in the request payload. |
| Query Parameters | JSON object containing additional query parameters to filter or modify the retrieval request. |
Output
The node outputs an array of JSON objects representing utility payment records retrieved from the Kobana API. Each item corresponds to one utility payment entry with its associated details as provided by the API.
If binary data were involved (not indicated here), it would typically represent files or attachments related to the payments, but this operation focuses on JSON data only.
Dependencies
- Requires an active Kobana API credential configured in n8n with appropriate permissions.
- The node dynamically selects the API base URL depending on the environment (production or sandbox).
- No additional external dependencies are required beyond the Kobana API access.
Troubleshooting
Common Issues:
- Incorrect or missing API credentials will cause authentication failures.
- Providing malformed JSON in "Additional Fields" or "Query Parameters" can lead to request errors.
- Exceeding the maximum allowed "Limit" value (over 100) will be rejected by the API.
Error Messages:
- Authentication errors indicate invalid or expired API keys; reconfigure credentials.
- JSON parsing errors suggest invalid JSON syntax in input fields; validate JSON format.
- API rate limits or server errors may occur; retry after some time or check API status.
Links and References
- Kobana API Documentation (general reference for API endpoints and usage)
- n8n documentation on Using Credentials
- JSON validation tools such as JSONLint for verifying JSON inputs
