Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Actions76

Overview

This node integrates with the Stormware Pohoda accounting system, specifically enabling export operations for various document types including sales receipts ("Prodejky"). The Export operation allows users to retrieve filtered lists of documents from Pohoda, such as invoices, bank records, vouchers, and sales receipts, in XML or JSON format.

For the "Prodejky" resource (sales receipts), this node is useful when you want to programmatically extract sales receipt data from Pohoda for reporting, synchronization, or further processing in workflows. For example, a business could use it to export all sales receipts within a date range to generate sales reports or feed data into another system.

Properties

Name Meaning
Filter A collection of optional filters to narrow down exported sales receipts. Options include:
- ID: Filter by document ID
- External ID: Filter by external ID
- Date From: Filter sales receipts from this date (inclusive)
- Date Till: Filter sales receipts up to this date (inclusive)
- Last Changes: Filter by last modification date
- Company Name: Filter by company name
- User Custom Filter Name: Apply a custom Pohoda filter
- IČO: Filter by company registration number
Return Records Count Number of records to return, between 1 and 10,000 (default 10)
Start Record ID Minimum record ID from which to start exporting
XML Output Boolean flag to output raw XML response instead of parsed JSON
UTF8 Conversion Boolean flag to convert Windows-1250 encoded response to UTF-8 (default true)

Output

The node outputs an array of items corresponding to the exported sales receipts matching the filter criteria.

  • If XML Output is enabled, the output contains a single item with a json field holding the raw XML string under the key data.
  • Otherwise, the XML response is parsed into JSON objects representing individual sales receipts.
  • Each output item has a json property containing the structured data of one sales receipt.
  • The node supports pairing output items with input items for traceability.
  • No binary output is produced for the export operation on "Prodejky".

Dependencies

  • Requires an API authentication credential with access to the Pohoda system (username and password).
  • The node makes HTTP POST requests to the Pohoda XML API endpoint.
  • Uses internal utilities for generating XML requests and parsing XML responses.
  • Converts character encoding from Windows-1250 to UTF-8 if enabled.
  • Requires n8n environment configured with the appropriate Pohoda API credentials.

Troubleshooting

  • Common issues:

    • Incorrect or missing API credentials will cause authentication failures.
    • Filters with invalid date formats may cause request errors.
    • Requesting unsupported resources or operations will throw "Not implemented" errors.
    • Large counts without pagination may lead to timeouts or performance issues.

  • Error messages:

    • Errors returned from Pohoda API are surfaced with their message notes.
    • If the response state is not "ok", the node throws an error with the provided note.
    • Network or HTTP errors during the request will also be thrown.

  • Resolutions:

    • Verify API credentials and permissions.
    • Use valid ISO date strings for date filters.
    • Limit the count parameter to reasonable values and paginate using Start Record ID.
    • Check that the selected resource and operation are supported.

Links and References

Discussion