Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Pokladní doklady → Create Entity

AI-generated

Overview

This node integrates with the Stormware Pohoda accounting system, enabling automation of various operations such as exporting data, creating entities, retrieving company info, and printing reports. Specifically, for the "Pokladní doklady" (Cash Register Documents) resource with the "Create Entity" operation, it allows users to create new cash register document entries in Pohoda by sending structured XML requests.

Common scenarios include automating bookkeeping tasks, synchronizing financial documents from other systems into Pohoda, or programmatically managing cash register records without manual entry. For example, a business could use this node to automatically add daily cash register transactions collected from a point-of-sale system into Pohoda.

Properties

Name Meaning
XML Output If enabled (true), the node returns the raw XML response from Pohoda instead of parsed JSON.
UTF8 Conversion If enabled (true), converts the response encoding from Windows-1250 to UTF-8 for easier handling.

These properties control how the response from Pohoda is processed and returned by the node.

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 from Pohoda after the create entity request. This includes status information and any returned data.
  • binary (optional): If the operation involves printing, the node may output binary PDF data representing generated reports or documents, including metadata like file name and MIME type.
  • json.data (if XML Output is enabled): The raw XML string response from Pohoda.

The structure depends on the operation and resource but generally reflects the success state and details of the created entity or requested data.

Dependencies

  • Requires valid credentials for Pohoda API access, including base URL, username, and password.
  • Uses HTTP POST requests with XML payloads to communicate with Pohoda's API endpoint.
  • Depends on external libraries for XML building and decoding character encodings (e.g., iconv-lite for Windows-1250 to UTF-8 conversion).
  • Requires n8n environment configured with these credentials and network access to the Pohoda API.

Troubleshooting

  • Authentication errors: Ensure that the provided API credentials are correct and have sufficient permissions.
  • Encoding issues: If the response contains garbled characters, verify the UTF8 Conversion property; toggling it may resolve encoding mismatches.
  • Unsupported resource or operation: The node throws errors if the selected resource or operation is not implemented. Confirm that "Pokladní doklady" with "Create Entity" is supported.
  • API errors from Pohoda: The node surfaces error messages returned by Pohoda in the response's @note field. Review these messages for specific issues like invalid data or missing required fields.
  • Network connectivity: Verify that the n8n instance can reach the Pohoda API endpoint URL.

Links and References

Discussion