Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Overview

This node integrates with the Pohoda accounting system, enabling users to perform various operations such as exporting data, creating entities, retrieving company information, and printing reports. Specifically for the Banka resource with the Create Entity operation, it allows creating new address book entries (entities) in Pohoda by sending structured XML requests.

Common scenarios include automating the creation of bank-related entities or contacts within Pohoda from external systems, streamlining bookkeeping workflows, or integrating Pohoda with other business applications.

Example use case: Automatically adding a new bank contact or entity into Pohoda when a new client is onboarded in a CRM system.

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 proper character display.

These properties control how the response from Pohoda is returned and encoded.

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.
  • If XML Output is enabled, the raw XML string is returned inside json.data.
  • In some cases (e.g., print operation), binary data such as PDF files may be returned under the binary property with appropriate metadata (mimeType, fileExtension, fileName).

For the Create Entity operation on the Banka resource, the output will primarily be the JSON representation of the created entity confirmation or error details if the operation fails.

Dependencies

  • Requires valid credentials for Pohoda API authentication (an API key or username/password).
  • The node uses HTTP POST requests to Pohoda's XML API endpoint.
  • Uses external libraries for XML building and encoding conversion.
  • Requires n8n environment configured with the necessary Pohoda API credentials.

Troubleshooting

  • Common issues:

    • Authentication failures due to incorrect or missing API credentials.
    • Encoding problems if UTF8 conversion is disabled but the response contains special characters.
    • Errors returned from Pohoda API indicating invalid request structure or missing required fields.
  • Error messages:

    • If the Pohoda API response state is not "ok", the node throws an error with the message from the API's note field.
    • Network or HTTP errors during the request will also cause the node to fail unless "Continue On Fail" is enabled.
  • Resolutions:

    • Verify API credentials and permissions.
    • Enable UTF8 conversion if you see garbled characters.
    • Ensure all required entity fields are provided correctly in the input.
    • Check the Pohoda API documentation for correct XML request formats.

Links and References


If you need further details about other operations or resources, feel free to ask!

Discussion