Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Actions76

Overview

This node integrates with the Stormware Pohoda accounting system, enabling various operations such as exporting data, creating entities, retrieving company info, and printing reports. Specifically for the "Příjemky" (Receipts) resource with the "Print" operation, the node allows users to print a specific receipt report by providing the record ID and report ID. It generates a print request, sends it to the Pohoda API, and handles the response, which can include saving a PDF file of the printed report.

Common scenarios where this node is beneficial include automating document printing workflows within Pohoda, such as generating physical or digital copies of receipts, invoices, or other accounting documents directly from n8n workflows. For example, after processing a new receipt in Pohoda, you could automatically trigger this node to print the receipt report and save it as a PDF file.

Properties

Name Meaning
ID záznamu Item Row ID — the unique identifier of the receipt record to print.
ID sestavy Report ID — identifier of the report template to use for printing; found in report properties.
Název/cesta k souboru File name/path — path and filename where the printed report PDF will be saved (default: "n8n.pdf").
XML Output Boolean flag indicating whether to output raw XML response instead of parsed data.
UTF8 Conversion Boolean flag to convert response encoding from Windows-1250 to UTF-8 (default: true).
Delete File After Print Boolean flag indicating whether to delete the generated file after printing (default: true).

Output

The node outputs JSON data representing the response from the Pohoda API print request. If the XML Output property is enabled, the raw XML response string is returned in the json.data field.

If the response includes printable content (a PDF), the node outputs a binary attachment containing the PDF data with metadata:

  • mimeType: "application/pdf"
  • fileExtension: "pdf"
  • fileName: The original filename from the response

This allows downstream nodes to access the printed report as a PDF file.

Dependencies

  • Requires an API authentication credential for the Pohoda API (username and password).
  • Uses HTTP requests to communicate with the Pohoda API endpoint.
  • Depends on external libraries bundled with the node for XML building/parsing and character encoding conversion.
  • No additional environment variables are required beyond the API credentials.

Troubleshooting

  • Authentication errors: Ensure the provided API credentials are correct and have sufficient permissions.
  • Invalid report or record IDs: Verify that the recordId and reportId correspond to existing entries in Pohoda.
  • Encoding issues: If the output contains garbled characters, try toggling the UTF8 Conversion option.
  • File handling: If the file is deleted unexpectedly, check the Delete File After Print setting.
  • API errors: The node throws errors if the Pohoda API response state is not "ok", including messages from the API note field. Review these messages for details on what went wrong.

Links and References

Discussion