Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Overview

The Pohoda Node integrates with the Stormware Pohoda accounting system, enabling users to export various types of data records from Pohoda. Specifically, for the "Zásoby" (Stock) resource and the "Export" operation, this node allows exporting stock inventory records with filtering and pagination options.

This node is beneficial in scenarios where automated workflows require synchronization or backup of stock data from Pohoda, such as:

  • Exporting current stock levels for reporting or analytics.
  • Integrating stock data into other ERP or inventory management systems.
  • Automating periodic exports of stock information for auditing or compliance.

For example, a user can configure the node to export up to 1000 stock records starting from a specific record ID, optionally receiving the output as XML or JSON.

Properties

Name Meaning
Return Records Count (count) Number of records to export, ranging from 1 to 10,000. Controls batch size of export.
Start Record ID (idFrom) Minimum record ID from which to start the export. Allows incremental exports starting at a specific record.
XML Output (xmlOutput) Boolean flag indicating if the output should be returned as raw XML string instead of parsed JSON.
UTF8 Conversion (utfConvert) Boolean flag to convert response encoding from Windows-1250 to UTF-8. Useful for proper character encoding handling.

Output

The node outputs an array of items corresponding to the exported records:

  • If XML Output is enabled, each item contains a json field with a data property holding the raw XML string of the response.
  • Otherwise, the XML response is parsed into a JSON object representing the Pohoda response package, and individual records are extracted and output as separate JSON objects.
  • The output JSON structure corresponds to the Pohoda API's response format for stock records, including metadata about the request state and the list of stock items.
  • No binary data output is produced for the export operation.

Dependencies

  • Requires valid credentials for the Pohoda API, including base URL, username, and password.
  • Uses HTTP POST requests with Basic Authentication to communicate with the Pohoda XML API endpoint.
  • Depends on external libraries bundled with the node for XML building/parsing and character encoding conversion.
  • The node expects the Pohoda API to support version 2.0 of the stock listing request.

Troubleshooting

  • Common issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Invalid filter parameters or unsupported resource names will result in errors.
    • Encoding issues may arise if UTF8 Conversion is disabled but the response contains Windows-1250 encoded characters.
    • Requesting more than 10,000 records may not be supported by the API.
  • Error messages:

    • Errors with messages from the Pohoda API response note field indicate issues like invalid requests or server-side problems.
    • Network or HTTP errors during the request will throw standard HTTP error messages.
    • If the node throws "Not implemented for [resource]" error, it means the selected resource is not supported for export in this node version.
  • Resolutions:

    • Verify and re-enter API credentials.
    • Use valid resource and filter parameters according to Pohoda API documentation.
    • Enable UTF8 Conversion if you see garbled characters.
    • Limit the count parameter within allowed ranges.

Links and References

Discussion