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 Poptávky (Enquiries) resource and the Company Info operation, the node fetches detailed information about the company associated with the connected Pohoda account.

Common scenarios where this node is beneficial include:

• Automating retrieval of company details from Pohoda for use in workflows.
• Exporting or creating accounting documents like invoices, orders, or enquiries.
• Printing reports directly from Pohoda.
• Integrating Pohoda data into other systems or processes without manual export/import.

For example, a user might want to automatically fetch their company's info to populate a CRM system or verify company details before processing transactions.

Properties

These properties control the format and encoding of the output when fetching company info.

Output

The node outputs data in the following ways depending on the XML Output property:

• If XML Output is false (default), the node returns a JSON object representing the company information under the mServer key extracted from the Pohoda API response. This JSON contains structured company details such as name, address, identification numbers, and other metadata.

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

The output is paired with the input item index for traceability.

No binary data is produced by the Company Info operation.

Dependencies

• Requires an active connection to the Pohoda API via credentials that include:

  • Base URL of the Pohoda server.
  • Username and password for basic HTTP authentication.

• The node uses HTTP requests with Basic Auth headers to communicate with the Pohoda API.

• It depends on internal utilities for XML generation and parsing, and optionally converts character encoding from Windows-1250 to UTF-8.

• No additional external services or environment variables are required beyond the configured Pohoda API credentials.

Troubleshooting

• Authentication errors: If the node fails with authorization errors, verify that the provided API credentials (username and password) are correct and have sufficient permissions.

• Encoding issues: If special characters appear garbled, ensure that UTF8 Conversion is enabled to properly decode Windows-1250 encoded responses.

• Unexpected response structure: If the node throws errors about response state not being "ok," it indicates the Pohoda API returned an error message. Check the message for details and confirm the API endpoint and parameters are correct.

• Network connectivity: Ensure the Pohoda API base URL is reachable from the n8n instance and no firewall or proxy blocks the requests.

• Operation not implemented: Using unsupported resources or operations will throw an error indicating the feature is not implemented.

Links and References

• Stormware Pohoda Official Website
• Pohoda XML API Documentation (for understanding request/response formats)
• n8n Documentation (general usage and credential setup)

This summary focuses on the Poptávky resource and Company Info operation as requested, describing how the node fetches and outputs company details from Pohoda.