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 "Objednávky" (Orders) resource with the "Create Entity" operation, it allows creating new address book entries (entities) in Pohoda by sending structured XML requests.

Common scenarios include automating order management workflows where new customer or supplier addresses need to be created in Pohoda automatically from external systems or form inputs. For example, when a new order is received via an e-commerce platform, this node can create a corresponding address book entry in Pohoda to keep records synchronized.

Properties

Name Meaning
XML Output If enabled (true), the node returns 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 outputs the response from Pohoda's API.

Additional input relevant to the "Create Entity" operation on the "Objednávky" resource:

Name Meaning
createEntity A collection of fields describing the entity to create, including company name, contact details, address, notes, etc. This defines the data sent to Pohoda to create the new entity.

The createEntity fields include:

  • Company (company name)
  • Name (contact person)
  • City, Street, ZIP Code (address details)
  • ICO, DIC (company registration IDs)
  • Phone, Mobile, Email, Website (contact info)
  • Message, Note, Internal Note (additional textual information)

Output

The node outputs JSON data representing the response from Pohoda after the create request. The structure depends on whether XML output is enabled:

  • If XML Output is enabled, the raw XML string returned by Pohoda is provided under the json.data field.
  • Otherwise, the XML response is parsed into a JSON object reflecting the Pohoda response structure, typically containing status and any created entity details.

If the response includes printable documents (in other operations), the node can also output binary PDF data with appropriate metadata, but this is not applicable for the "Create Entity" operation.

Dependencies

  • Requires an API authentication credential with access to the Pohoda API.
  • Uses HTTP POST requests to Pohoda's /xml endpoint with Basic Authentication.
  • Converts XML responses using libraries for XML parsing and character encoding conversion.
  • The node expects the Pohoda API base URL and credentials to be configured in n8n credentials.

Troubleshooting

  • Authentication errors: Ensure the API credentials (username and password) are correct and have sufficient permissions.
  • Encoding issues: If special characters appear incorrectly, verify that UTF8 Conversion is enabled to properly decode Windows-1250 encoded responses.
  • Unsupported resource or operation: The node throws errors if an unsupported resource or operation is selected; confirm that "Objednávky" with "Create Entity" is supported.
  • API errors: Pohoda may return error states with messages in the response; these are surfaced as node errors with the message from Pohoda's response note.
  • Network issues: Verify network connectivity to the Pohoda API endpoint and that the base URL is correctly set.

Links and References

Discussion