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, retrieving company information, and printing reports. Specifically, for the "Create Entity" operation under the "Default" resource, it allows users to create new address book entries (contacts) in Pohoda by sending structured XML requests.

Common scenarios where this node is beneficial include automating the creation of customer or supplier records in Pohoda from external systems, synchronizing contact data, or batch importing address book entries. For example, a user could automate adding new clients collected from a CRM into Pohoda's address book without manual entry.

Properties

Name Meaning
XML Output If enabled (true), the node outputs the raw XML response from Pohoda instead of parsed JSON.
UTF8 Conversion If enabled (true), converts the response encoding from Windows-1250 to UTF-8 for proper character display.

These properties control how the node processes and returns the response from Pohoda when creating an entity.

Output

The node outputs an array of items corresponding to each input item processed. Each output item contains:

  • json: Parsed JSON object representing the response from Pohoda after creating the entity. This includes status information and any returned data.
  • binary (only for some operations like print): Contains binary data such as PDF files if applicable.

If "XML Output" is enabled, the raw XML string response is provided in the json.data field instead of parsed JSON.

Dependencies

  • Requires connection credentials to Pohoda API, including:
    • Base URL of the Pohoda server.
    • Username and password for basic HTTP authentication.
  • Uses HTTP POST requests with XML payloads to communicate with Pohoda.
  • Depends on external libraries bundled with the node for:
    • XML generation and parsing.
    • Character encoding conversion (Windows-1250 to UTF-8).
  • No additional environment variables are required beyond the configured credentials.

Troubleshooting

  • Authentication errors: Ensure that the provided username and password are correct and have sufficient permissions in Pohoda.
  • Encoding issues: If special characters appear garbled, verify that UTF8 Conversion is enabled to properly decode Windows-1250 encoded responses.
  • Unsupported resource or operation: The node currently supports creating entities only for the address book resource. Attempting to create other entity types will result in an error.
  • API errors from Pohoda: The node throws errors if the Pohoda response indicates failure, including messages returned in the response note. Check the message for details and verify the request data.
  • Malformed XML or missing required fields: Ensure that all mandatory fields for the entity creation are provided correctly in the input parameters.

Links and References

Discussion