Pohoda Node

Overview

This node integrates with the Stormware Pohoda accounting system, enabling users to perform various operations such as exporting data, creating entities, retrieving company information, and printing reports. It is particularly useful for automating interactions with Pohoda's XML-based API, allowing seamless data exchange and document management within workflows.

Common scenarios include:

• Exporting invoices, bank transactions, stock items, or other accounting-related data from Pohoda.
• Creating new address book entries or other entities in Pohoda.
• Retrieving detailed company information.
• Generating and printing reports directly from Pohoda.

For example, a user can automate the export of issued invoices filtered by date range, or create new contact entries in the Pohoda address book based on incoming CRM data.

Properties

Output

The node outputs an array of items corresponding to each input item processed. Each output item contains:

• json: Parsed JSON object representing the response data from Pohoda. This varies depending on the operation and resource selected.
• binary (optional): For print operations, the node may output binary PDF data representing generated reports. The binary data includes:
  • data: The PDF file content.
  • mimeType: Always "application/pdf".
  • fileExtension: "pdf".
  • fileName: The name of the generated PDF file.

If "XML Output" is enabled, the raw XML string response is returned inside the json.data field instead of parsed JSON.

Dependencies

• Requires an API authentication credential with Pohoda (username, password, base URL).
• Uses HTTP requests to communicate with Pohoda's XML API endpoints.
• Utilizes external libraries for XML building and parsing, and for character encoding conversion (Windows-1250 to UTF-8).

Troubleshooting

• Encoding issues: If special characters appear incorrectly, ensure "UTF8 Conversion" is enabled to convert from Windows-1250 encoding.
• API errors: The node throws errors if Pohoda responds with a non-"ok" state. The error message from Pohoda is included and should be reviewed for details.
• Unsupported resources or operations: Attempting to use unsupported resource-operation combinations will result in an error indicating "Not implemented".
• Credential problems: Ensure valid credentials are configured; otherwise, authentication failures will occur.
• Large data exports: When exporting large datasets, adjust the "Return Records Count" property accordingly (range 1 to 10000) to avoid timeouts or incomplete data.

Links and References

• Stormware Pohoda API Documentation
• n8n HTTP Request Node Documentation
• iconv-lite Encoding Library
• xmlbuilder2 Library