Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Actions76

Overview

This node integrates with the Pohoda accounting system to export address book records ("Adresy" resource) based on specified filters and parameters. It is useful for automating data retrieval from Pohoda, such as exporting contact details or company addresses for further processing, reporting, or synchronization with other systems.

Typical use cases include:

  • Exporting filtered address book entries by company name, person name, or identification numbers.
  • Retrieving recently changed address records since a given date.
  • Exporting a specific range of records starting from a minimum record ID.
  • Optionally receiving the output in XML format or as UTF-8 converted text.

For example, a user might export all address book entries updated after a certain date to sync contacts with a CRM system.

Properties

Name Meaning
Filter Collection of filter criteria to select which address book records to export. Options:
- ID: Select record by specific ID
- Company: Filter by company name
- Name: Filter by person's name
- IČO: Filter by company registration number (IČ)
- DIČ: Filter by tax identification number (DIČ)
- Last Changes: Export records changed since this date
Return Records Count (count) Number of records to return, range 1 to 10000 (default 10)
Start Record ID (idFrom) Minimum record ID from which to start export
XML Output (xmlOutput) Boolean flag to return raw XML output instead of parsed JSON (default false)
UTF8 Conversion (utfConvert) 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 address book records matching the filter criteria.

  • If XML Output is false (default), the output is parsed JSON objects representing the address book entries.
  • If XML Output is true, the output contains the raw XML string data under the json.data field.
  • The output items are paired with the input items for traceability.
  • No binary data output is produced for this operation.

The JSON structure corresponds to the Pohoda API's response schema for address book exports, typically including fields like company name, person name, IDs, and other address details.

Dependencies

  • Requires an API key credential for authenticating with the Pohoda API.
  • The node makes HTTP POST requests to the Pohoda XML API endpoint.
  • Uses internal utilities for generating XML requests and parsing XML responses.
  • Supports character encoding conversion from Windows-1250 to UTF-8 using an external library.

Troubleshooting

  • Authentication errors: Ensure the provided API credentials (username and password) are correct and have sufficient permissions.
  • Invalid filter values: Filters must be correctly formatted; dates should be ISO strings without time parts.
  • Response errors: If the Pohoda API returns a state other than "ok", the node throws an error with the message from the API response note.
  • Encoding issues: If the output appears garbled, verify the UTF8 Conversion setting matches the expected encoding of your environment.
  • Large exports: When exporting many records, adjust the Return Records Count and Start Record ID to paginate results properly.

Links and References

Discussion