Pohoda Node

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 "Výdejky" (Issues agenda) resource with the "Create Entity" operation, the node allows creating new records in the Pohoda address book by sending properly formatted XML requests to the Pohoda API.

Common scenarios where this node is beneficial include automating the creation of new business contacts or issue records in Pohoda directly from workflows, synchronizing external CRM or ERP systems with Pohoda, or batch-creating multiple entries based on input data.

For example, a user can create a new "Výdejky" entity by providing details like company name, address, and contact info, which the node converts into an XML request and sends to Pohoda, then returns the response for further processing.

Properties

These properties control how the node processes and outputs the response from the Pohoda API when creating entities.

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.
• If XML Output is enabled, the raw XML string response is provided under json.data.
• In some cases (e.g., print operation), binary data such as PDF files may be included, but this does not apply to the "Create Entity" operation.

The output structure allows downstream nodes to access either the structured response or the raw XML depending on user preference.

Dependencies

• Requires an API authentication credential with username and password to access the Pohoda API.
• The node makes HTTP POST requests to the Pohoda XML endpoint using basic authentication.
• Uses external libraries for XML building and encoding conversion.
• No additional environment variables are required beyond the configured credentials.

Troubleshooting

• Authentication errors: Ensure the API credentials (username and password) are correct and have sufficient permissions.
• Encoding issues: If response characters appear garbled, try toggling the UTF8 Conversion property.
• Unsupported resource or operation: The node throws errors if the selected resource or operation is not implemented; verify that "Výdejky" with "Create Entity" is supported.
• API errors: Pohoda API responses with error states will cause the node to throw errors containing the message from Pohoda; check the message for details.
• Malformed input data: Ensure all required fields for creating an entity are provided correctly in the input parameters.

Links and References

• Stormware Pohoda API Documentation (official API docs)
• n8n HTTP Request Node Documentation (for understanding HTTP calls)
• XMLBuilder2 Library (used internally for XML generation)

This summary focuses on the "Výdejky" resource with the "Create Entity" operation and the two specified properties controlling XML output and encoding conversion.