Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Overview

This node integrates with the Stormware Pohoda accounting system, specifically supporting operations related to various business document agendas including production ("Výroba"). For the "Create Entity" operation under the "Výroba" resource, it allows users to create new entities (records) in Pohoda by sending structured XML requests to the Pohoda API.

Typical use cases include automating the creation of production records or other related entities within Pohoda directly from n8n workflows. For example, a manufacturing company could automatically add new production orders or update production-related data as part of an automated process triggered by external events.

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 easier handling.

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:

  • When XML Output is enabled, the output contains a json field with a data property holding the raw XML response string.
  • Otherwise, the output contains a parsed JSON representation of the response from Pohoda, extracted from the XML response.
  • In case of print operations (not relevant here), binary PDF data may be returned.
  • On errors, if "Continue on Fail" is enabled, the output includes error details paired with the input item.

For the "Create Entity" operation, the output JSON typically contains the response status and any created entity details as returned by Pohoda.

Dependencies

  • Requires valid credentials for the Pohoda API, including base URL, username, and password.
  • Uses HTTP POST requests with XML payloads to communicate with the Pohoda API endpoint.
  • Depends on XML building and parsing libraries internally.
  • The node expects the Pohoda API to support Basic Authentication with provided credentials.

Troubleshooting

  • Authentication Errors: Ensure that the API credentials (username, password, base URL) are correctly configured and have sufficient permissions.
  • Encoding Issues: If response characters appear garbled, verify the UTF8 Conversion setting; enabling it converts Windows-1250 encoded responses to UTF-8.
  • Unsupported Resource or Operation: The node throws errors if the selected resource or operation is not implemented. Confirm that "Výroba" resource and "Create Entity" operation are supported.
  • API Response Errors: If the Pohoda API returns a non-"ok" state, the node throws an error with the message from the API's note field. Check the request data and API documentation for required fields and formats.
  • Network Issues: Verify network connectivity to the Pohoda API endpoint and that no firewall or proxy blocks the requests.

Links and References


This summary focuses on the "Výroba" resource with the "Create Entity" operation and the specified input properties.

Discussion