invoice-api.xhub icon

invoice-api.xhub

Generate, parse, convert, and validate e-invoices across 37 countries with 18+ formats

Actions6

Convert

AI-generated

Summary

Convert an e-invoice document to Factur-X, XRechnung, or ZUGFeRD. The source format and country are detected automatically, and fields that cannot be transferred may be reported as conversion warnings.

Inputs

  • Target Format (required) — Choose Factur-X, XRechnung, or ZUGFeRD; defaults to ZUGFeRD.
  • Input Type — Choose binary input (default) or a base64 string.
  • Binary Property (required) — For binary input, the incoming item's property containing the source document; defaults to data. Its filename is used as a detection hint if no Filename option is set.
  • Base64 Data (required) — For base64 input, the encoded source document, which may be XML or PDF.
  • Filename — Optional filename hint for detecting the source format.
  • Format Options — Optional format-specific settings as JSON. Invalid JSON causes an error.
  • Include Warnings — Defaults to true; when enabled, includes conversion warnings and other API warnings when present.
  • Output Binary — Defaults to true. Outputs the converted document as binary; when disabled, returned document data is included as base64 in JSON.
  • Output Binary Property — Property name for the binary output; defaults to data.

Output shape

One output item per input item, with conversion metadata in JSON and, by default, the converted document in binary data.

JSON includes success, sourceFormat, targetFormat, filename, mimeType, and hash; it may also include conversionWarnings, warnings, and embeddedXml when returned by the API. With binary output disabled, document data is returned as base64 in json.data. Conversion or input errors fail the operation unless Continue On Fail is enabled, in which case an error item is returned.

Links

Discussion