Actions76
- Faktury Actions
- Příjemky Actions
- Prodejky Actions
- Objednávky Actions
- Výdejky Actions
- Pokladní doklady Actions
- Nabídky Actions
- Výroba Actions
- Interní doklady Actions
- Poptávky Actions
- Převod Actions
- Banka Actions
- Zakázky Actions
- Pohyby Actions
- Účetní deník (PÚ) Actions
- Adresy Actions
- Zásoby Actions
- Prodejní ceny Actions
Overview
This node integrates with the Stormware Pohoda accounting system, enabling users to export various types of financial and business data. Specifically for the Banka resource with the Export operation, it allows exporting bank-related records such as bank accounts and transactions from Pohoda.
Typical use cases include:
- Automating the retrieval of bank transaction data for reconciliation or reporting.
- Exporting bank account details for integration with other financial systems.
- Filtering bank data by date ranges, company identifiers, or custom filters to extract relevant subsets.
For example, a user might export all bank transactions from the last month filtered by a specific company name or ID, then process this data further in their workflow.
Properties
Name | Meaning |
---|---|
Filter | A collection of optional filters to narrow down exported bank records. Options include: |
- ID: Filter by document ID | |
- External ID: Filter by external ID | |
- Date From: Filter records starting from this date (ISO date format) | |
- Date Till: Filter records up to this date (ISO date format) | |
- Last Changes: Filter by last modification date | |
- Company Name: Filter by company name | |
- User Custom Filter Name: Apply a custom Pohoda filter | |
- IČO: Filter by company registration number | |
Return Records Count | Number of records to return, range 1 to 10,000 (default 10) |
Start Record ID | Minimum record ID from which to start export |
XML Output | Boolean flag to output raw XML response instead of parsed JSON |
UTF8 Conversion | Boolean flag to convert response encoding from Windows-1250 to UTF-8 (default true) |
Output
The node outputs an array of items corresponding to the exported bank records:
- If XML Output is enabled, the output contains a single item with a
json
field holding the raw XML string data. - Otherwise, the output contains parsed JSON objects representing individual bank records extracted from the Pohoda response.
- The output preserves pairing with input items for traceability.
- No binary data output is produced for the Banka export operation.
Dependencies
- Requires an API key credential for authenticating with the Pohoda API.
- Uses HTTP POST requests to the Pohoda XML endpoint.
- Converts character encoding from Windows-1250 to UTF-8 if enabled.
- Relies on internal utility functions to generate XML requests based on filters and parameters.
Troubleshooting
- Authentication errors: Ensure the provided API credentials are correct and have sufficient permissions.
- Invalid filter values: Date filters must be valid ISO dates; invalid formats may cause request failures.
- Response errors: If the Pohoda API returns a non-"ok" state, the node throws an error with the message from the API response.
- Encoding issues: If the output appears garbled, verify the UTF8 Conversion setting matches the expected encoding.
- Large exports: When requesting many records, consider pagination using the "Start Record ID" and "Return Records Count" properties to avoid timeouts or memory issues.
Links and References
- Stormware Pohoda API Documentation (official developer resources)
- n8n HTTP Request Node Documentation (for understanding underlying HTTP calls)
- Character Encoding in Node.js (relevant for UTF8 conversion)