Pohoda Node

Overview

This node integrates with the Pohoda accounting system, enabling users to perform various operations such as exporting data, creating entities, retrieving company information, and printing reports. Specifically, for the "Převod" resource with the "Create Entity" operation, the node allows creating new transfer records (transfers between accounts) in Pohoda by sending structured XML requests to the Pohoda API.

Common scenarios where this node is beneficial include automating financial workflows, synchronizing accounting data from other systems into Pohoda, or programmatically managing transfers without manual entry. For example, a user can automate the creation of bank transfer documents based on external triggers or batch processes.

Properties

These properties control how the node formats and encodes its output when communicating with the Pohoda API.

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 the requested operation.
  • For "Create Entity" on the "Převod" resource, this will be the confirmation or details of the created transfer entity.
• binary (optional): If the operation involves printing, the node may output binary PDF data representing generated reports.

If XML Output is enabled, the raw XML string response is returned inside the json.data field instead of parsed JSON.

Dependencies

• Requires valid credentials for Pohoda API access, including base URL, username, and password.
• Uses HTTP POST requests with Basic Authentication to communicate with Pohoda's XML API endpoint.
• Depends on external libraries for XML building and encoding conversion:
  • iconv-lite for character encoding conversions.
  • xmlbuilder2 for XML parsing and conversion.
• The node expects the Pohoda API to support specific XML request formats for different resources and operations.

Troubleshooting

• Authentication errors: Ensure that the provided API credentials are correct and have sufficient permissions.
• Encoding issues: If the response contains garbled characters, try toggling the UTF8 Conversion property.
• Unsupported resource or operation: The node throws errors if the selected resource-operation combination is not implemented. Verify that "Převod" with "Create Entity" is supported.
• API errors: Pohoda responses with error states include messages in the @note attribute; these are surfaced as node errors. Check the message for details.
• Network issues: Confirm network connectivity to the Pohoda API endpoint and that the base URL is correctly configured.

Links and References

• Pohoda XML API Documentation (official documentation for Pohoda XML interface)
• iconv-lite GitHub — for encoding conversions
• xmlbuilder2 GitHub — for XML parsing and building