Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Overview

This node integrates with the Stormware Pohoda accounting system, enabling users to perform various operations such as exporting data, creating entities, printing reports, and retrieving company information. Specifically, for the "Interní doklady" (Internal Documents) resource and the "Company Info" operation, the node fetches detailed company information from the Pohoda system.

Common scenarios where this node is beneficial include automating data retrieval from Pohoda for internal documents, synchronizing company details into other systems, or generating reports based on Pohoda data. For example, a user might use this node to automatically pull updated company info for internal auditing or compliance purposes.

Properties

Name Meaning
XML Output If enabled (true), the output will be raw XML data as a string. If disabled (false), the output will be parsed JSON object form of the response.
UTF8 Conversion If enabled (true), converts the response encoding from Windows-1250 to UTF-8 for proper character representation. If disabled (false), returns raw response encoding.

Output

The output depends on the XML Output property:

  • If XML Output is true, the node outputs a JSON object with a single field data containing the raw XML response as a UTF-8 string (if UTF8 Conversion is enabled) or in its original encoding.

  • If XML Output is false, the node parses the XML response into a JSON object and outputs the mServer part of the response, which contains detailed company information structured as JSON.

The output is paired with the input item index for traceability.

No binary data output is produced by the "Company Info" operation.

Dependencies

  • Requires an API authentication credential with access to the Pohoda system (username and password).
  • The node makes HTTP requests to the Pohoda API endpoints.
  • Uses external libraries for XML building and parsing, and for encoding conversion (Windows-1250 to UTF-8).
  • Requires n8n credentials configured with the necessary Pohoda API access details.

Troubleshooting

  • Encoding Issues: If the company info contains special Czech characters that appear garbled, ensure that UTF8 Conversion is enabled to properly convert from Windows-1250 encoding.
  • Authentication Errors: If the node throws authorization errors, verify that the provided API credentials are correct and have sufficient permissions.
  • API Endpoint Errors: Network issues or incorrect base URL configuration in credentials can cause request failures. Confirm the base URL is accurate and reachable.
  • Unexpected Response Structure: If the node fails parsing the response, check if the Pohoda API version or response format has changed.
  • NodeApiError with message from Pohoda: This indicates the Pohoda API returned an error state; review the message for specific issues like invalid parameters or server-side problems.

Links and References


This summary focuses on the "Interní doklady" resource and the "Company Info" operation, describing how the node retrieves and outputs company information from the Pohoda system with options for XML/raw or parsed JSON output.

Discussion