Pohoda Node

Overview

This node integrates with the Stormware Pohoda accounting system, enabling users to interact with various accounting and business data agendas. Specifically, for the "Účetní deník (PÚ)" resource and the "Company Info" operation, it retrieves detailed company information from the Pohoda system.

Common scenarios where this node is beneficial include:

• Fetching up-to-date company details for reporting or verification purposes.
• Integrating Pohoda company data into automated workflows for accounting or CRM systems.
• Exporting company metadata in XML format for archival or further processing.

For example, a user might use this node to automatically retrieve their company's current registration details before generating invoices or financial reports.

Properties

Output

The output depends on the XML Output property:

• If XML Output is true:
  The node outputs a single item with a JSON field data containing the full raw XML string of the company information as returned by the Pohoda API.

• If XML Output is false:
  The node outputs a parsed JSON object under the json field representing the company details extracted from the XML response. This JSON corresponds to the mServer element of the parsed response pack, which contains structured company information.

No binary data output is produced for this operation.

Dependencies

• Requires an API authentication credential with access to the Pohoda system (username and password).
• Uses HTTP POST/GET requests to communicate with the Pohoda API endpoints.
• Converts character encoding from Windows-1250 to UTF-8 using an encoding library if needed.
• Parses XML responses into JSON objects using an XML builder/converter library.

Troubleshooting

• Encoding Issues:
  If special characters appear garbled, ensure that the UTF8 Conversion property is enabled to properly convert Windows-1250 encoded responses to UTF-8.

• Authentication Errors:
  Errors related to authorization usually indicate invalid or missing API credentials. Verify that the provided username and password are correct and have sufficient permissions.

• API Response Errors:
  If the Pohoda API returns a state other than "ok", the node throws an error with the message from the API's note field. This can happen if the service is unavailable or the request parameters are incorrect.

• Network Issues:
  Connectivity problems or incorrect base URL configuration will cause HTTP request failures. Confirm network access and correct API endpoint URLs.

Links and References

• Stormware Pohoda API Documentation (official developer resources)
• n8n HTTP Request Node Documentation (for understanding HTTP communication)
• Character Encoding Concepts (background on Windows-1250 encoding)

This summary focuses exclusively on the "Účetní deník (PÚ)" resource with the "Company Info" operation as requested, based on static analysis of the provided source code and input properties.