Pohoda Node icon

Pohoda Node

Stormware Pohoda Integration Node

Actions76

Poptávky → Create Entity

AI-generated

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 "Poptávky" (Enquiries) resource with the "Create Entity" operation, it allows users to create new enquiry records in the Pohoda system by sending structured XML requests.

Common scenarios include automating the creation of customer enquiries or leads directly from other systems or workflows into Pohoda, streamlining data entry and ensuring consistency. For example, a sales automation workflow could use this node to add new enquiries received via a web form into Pohoda automatically.

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 creating the entity.
  • 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 "Poptávky" resource, the output JSON contains the response details confirming the creation status or any error messages.

Dependencies

  • Requires an API authentication credential with username, password, and base URL for the Pohoda API.
  • Uses HTTP POST requests to communicate with the Pohoda XML endpoint.
  • Utilizes external libraries for XML building and decoding (e.g., iconv-lite for encoding conversion, xmlbuilder2 for XML parsing).
  • The node expects the Pohoda API to support XML-based requests and responses.

Troubleshooting

  • Encoding Issues: If special characters appear garbled, ensure that UTF8 Conversion is enabled to convert from Windows-1250 encoding.
  • Authentication Errors: Incorrect or missing API credentials will cause authorization failures. Verify the API key/username/password and base URL are correctly configured.
  • Unsupported Resource or Operation: Attempting to create entities for unsupported resources will throw errors indicating "Not implemented for [resource]".
  • API Response Errors: If Pohoda returns a non-"ok" state, the node throws an error with the message from the API's @note field. Check the request payload and API documentation for required fields.
  • Network Issues: Ensure the Pohoda API endpoint is reachable from the n8n environment.

Links and References

Discussion