Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Actions76

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 Výdejky (Issues) resource and the Company Info operation, the node fetches detailed information about the company associated with the Pohoda account.

Common scenarios where this node is beneficial include:

  • Automating retrieval of company details for use in workflows that require up-to-date company metadata.
  • Integrating Pohoda's company info into other systems or reporting tools.
  • Using the node as part of a larger automation pipeline involving Pohoda data exports or document generation.

Example usage:

  • A workflow that triggers on a schedule to fetch the latest company info from Pohoda and updates a CRM system.
  • Retrieving company details before generating invoices or reports to ensure correct company data is used.

Properties

Name Meaning
XML Output If enabled (true), the node returns the raw XML response from Pohoda as a string.
UTF8 Conversion If enabled (true), converts the response encoding from Windows-1250 to UTF-8 format.

Output

The output depends on the XML Output property:

  • If XML Output is false (default), the node parses the XML response into a JSON object and outputs the company information under the mServer key. This JSON contains structured company details as provided by Pohoda's API.

  • If XML Output is true, the node outputs the raw XML response as a string in the data field inside the json output.

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

No binary data output is produced for the Company Info operation.

Dependencies

  • Requires an API authentication credential with access to the Pohoda API (username and password).
  • The node makes HTTP requests to the Pohoda API endpoints.
  • Uses external libraries for XML parsing and encoding conversion:
    • iconv-lite for character encoding conversion (Windows-1250 to UTF-8).
    • xmlbuilder2 for converting XML strings to JSON objects.

Troubleshooting

  • Encoding issues: If the company info appears garbled or contains incorrect characters, verify that the UTF8 Conversion option is enabled to properly convert from Windows-1250 encoding.

  • Authentication errors: Ensure that valid credentials are configured. Authentication failures will result in error messages from the Pohoda API.

  • API errors: If the API response state is not "ok", the node throws an error with the message returned by Pohoda. Check the message for details such as invalid parameters or service unavailability.

  • Network issues: Timeouts or connection errors may occur if the Pohoda API endpoint is unreachable. Verify network connectivity and base URL configuration.

Links and References

Discussion