Pohoda Node

Stormware Pohoda Integration Node

Actions76

Overview

The Pohoda node integrates with the Stormware Pohoda accounting system, enabling users to export various types of financial and business data, including invoices. Specifically, for the "Faktury" (Invoices) resource with the "Export" operation, this node allows exporting invoice data filtered by multiple criteria such as date ranges, company name, or document IDs.

This node is beneficial in scenarios where automated extraction of invoice data from Pohoda is required for further processing, reporting, or integration with other systems. For example, a user might export all issued invoices within a specific date range to generate financial reports or synchronize invoice data with an external CRM or ERP system.

Properties

Name	Meaning
Invoice Type	Type of invoice to export. Options: Issued Invoice, Issued Advance Invoice, Received Invoice, Received Advance Invoice.
Filter	Collection of filters to narrow down exported invoices. Includes:
	- ID: Filter by document ID
	- External ID: Filter by external ID
	- Date From: Filter invoices starting from this date
	- Date Till: Filter invoices up to this date
	- Last Changes: Filter invoices changed since this date
	- Company Name: Filter by company name
	- User Custom Filter Name: Apply a custom Pohoda filter
	- IČO: Filter by company registration number (IČO)
Return Records Count	Number of records to return, range 1 to 10,000
Start Record ID	Minimum record ID from which to start the export
XML Output	Boolean flag to output raw XML response instead of parsed JSON
UTF8 Conversion	Boolean flag to convert response encoding from Windows-1250 to UTF-8

Output

The node outputs data in the following ways depending on configuration:

Parsed JSON: By default, the node parses the XML response from Pohoda into JSON objects representing the requested invoices or other entities.
Raw XML: If the "XML Output" property is enabled, the node outputs the raw XML response as a string in the json.data field.
Binary Data: In some cases (e.g., print operations), the node can output binary PDF data attached to the response, provided as a binary property with appropriate MIME type and file extension.

Each output item is paired with the corresponding input item for traceability.

Dependencies

Requires an API authentication credential with access to the Pohoda API (username and password).
The node makes HTTP POST requests to the Pohoda API endpoint /xml with XML payloads.
Uses internal utilities for generating XML requests and parsing XML responses.
Supports character encoding conversion from Windows-1250 to UTF-8 using an encoding library.

Troubleshooting

Authentication Errors: If the API credentials are incorrect or missing, the node will fail to authenticate. Ensure valid credentials are configured.
Invalid Filters or Parameters: Providing unsupported or malformed filter values may cause the API to return errors. Validate filter inputs carefully.
Encoding Issues: If the response contains unexpected characters, verify the "UTF8 Conversion" setting; disabling it may help if your environment expects Windows-1250 encoding.
API Response Errors: The node checks the response state and throws errors with messages returned by the Pohoda API. Review these messages to understand issues like invalid requests or server errors.
Not Implemented Resource: Attempting to export resources not supported by the node will result in an error indicating the resource is not implemented.

Links and References

Stormware Pohoda API Documentation (official API docs)
n8n Documentation (for general usage of nodes and credentials)

This summary focuses on the "Faktury" resource with the "Export" operation as requested.