Pohoda Node

Overview

This node integrates with the Stormware Pohoda accounting system, enabling users to perform various operations such as exporting data, creating entities, printing reports, and retrieving company information. Specifically, for the Objednávky (Orders) resource with the Company Info operation, the node fetches detailed information about the company associated with the authenticated account.

Common scenarios where this node is beneficial include automating data retrieval from Pohoda for accounting, invoicing, order management, or reporting purposes. For example, a user can automatically pull company details to verify account settings or synchronize company metadata with other systems.

Properties

Output

The output depends on the XML Output property:

• If XML Output is false (default), the node outputs a parsed JSON object representing the company information under the json field. The structure corresponds to the mServer part of the Pohoda API response, containing detailed company data.

• If XML Output is true, the node outputs the raw XML response as a string in the data field inside json.

No binary data output is produced by the Company Info operation.

Example output when XML Output is false (simplified):

{
  "mServer": {
    "companyName": "Example Company",
    "ico": "12345678",
    "address": {
      "city": "Prague",
      "street": "Main Street 1"
    },
    ...
  }
}

If XML Output is true:

{
  "data": "<?xml version=\"1.0\" encoding=\"Windows-1250\"?><rsp:responsePack>...</rsp:responsePack>"
}

Dependencies

• Requires an API authentication credential with access to the Pohoda system.
• The node makes HTTP requests to the Pohoda API endpoints using basic authentication.
• Uses external libraries for XML building/parsing and character encoding conversion.
• Requires proper configuration of the Pohoda API base URL and credentials in n8n.

Troubleshooting

• Authentication errors: Ensure that the API credentials (username and password) are correct and have sufficient permissions.
• Encoding issues: If the response contains garbled characters, try toggling the UTF8 Conversion property.
• API errors: If the Pohoda API returns an error state, the node throws an error with the message from the API's @note attribute. Check the message for details.
• Unsupported resources or operations: Using unsupported combinations will result in a "Not implemented" error.
• Network issues: Verify network connectivity to the Pohoda API endpoint.

Links and References

• Stormware Pohoda API Documentation
• n8n HTTP Request Node Documentation
• iconv-lite Library (for encoding conversions)
• xmlbuilder2 Library (for XML parsing and building)