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 and business software, specifically enabling data export from various Pohoda agendas (resources). For the "Výroba" (Production) resource with the "Export" operation, it allows users to export production-related records filtered by various criteria. This is useful for automating data retrieval from Pohoda's production module, such as extracting production orders or manufacturing records for reporting, analysis, or further processing in workflows.
Practical examples include:
- Exporting recent production records within a date range.
- Filtering production data by company identification number (IČO) or document ID.
- Retrieving a specific number of production records starting from a given record ID.
- Optionally receiving the output as raw XML or converted UTF-8 text.
Properties
Name | Meaning |
---|---|
Filter | Collection of filters to narrow down exported production records. Options include: |
- ID | Filter by document ID |
- External ID | Filter by external ID |
- Date From | Filter records from this date (inclusive) |
- Date Till | Filter records up to this date (inclusive) |
- Last Changes | Filter records changed since this date |
- Company Name | Filter by company name |
- User Custom Filter Name | Apply a custom Pohoda filter by name |
- IČO | Filter by company identification number |
Return Records Count | Number of records to return (range 1 to 10000), default is 10 |
Start Record ID | Minimum record ID to start export from |
XML Output | Boolean flag to return raw XML response instead of parsed JSON |
UTF8 Conversion | Boolean flag to convert Windows-1250 encoded response to UTF-8 (default true) |
Output
The node outputs an array of items corresponding to the exported production records matching the filters.
- If XML Output is enabled, the output contains a single item with a
json
field holding the raw XML string under the keydata
. - Otherwise, the XML response is parsed into JSON objects representing individual production records, each emitted as a separate item.
- The output JSON structure corresponds to the Pohoda API's response schema for production data.
- No binary data output is produced for this resource-operation combination.
Dependencies
- Requires connection credentials to Pohoda API, including base URL, username, and password.
- Uses HTTP POST requests with Basic Authentication to communicate with Pohoda's XML API endpoint.
- Depends on internal utilities for generating XML requests and parsing XML responses.
- Uses character encoding conversion from Windows-1250 to UTF-8 if enabled.
Troubleshooting
Common issues:
- Incorrect or missing API credentials will cause authentication failures.
- Invalid filter parameters may result in empty or error responses.
- Setting an unsupported resource or operation will throw a "Not implemented" error.
- Network connectivity issues can cause request timeouts or failures.
Error messages:
- Errors returned by Pohoda API are surfaced with their message notes.
- If the response state is not "ok", the node throws an error with the provided note.
- Parsing errors may occur if the XML response format changes or is malformed.
Resolutions:
- Verify API credentials and permissions.
- Double-check filter values and date formats.
- Ensure the selected resource and operation are supported.
- Enable "Continue On Fail" in n8n to handle partial failures gracefully.