sfi-reference

name	sfi-reference
description	Structured Formats Import (SFI) reference for Rossum. Covers end-to-end setup of the SFI extension for processing XML, JSON, and e-invoice documents (ZUGFeRD, X-Rechnung UBL/CII). Includes MIME type configuration, hook setup with environment URLs, field mapping with XPath/JSONPath selectors, document splitting, PDF rendering, value transformation mappings, date parsing, address concatenation patterns, and complete production-ready configuration examples for German e-invoicing. Use when setting up, configuring, or debugging Structured Formats Import.
user-invocable	false

Structured Formats Import (SFI) Reference

This skill provides the complete setup and configuration reference for Structured Formats Import (SFI), Rossum's extension for processing non-visual structured documents (XML, JSON, EDI) and rendering them as PDFs for human review.

For the full configuration guide, selector syntax, feature reference, and production-ready examples, see reference.md.

Use this knowledge when:

• Setting up SFI for the first time on a queue (MIME types, hook creation, environment URLs)
• Writing field mappings with XPath selectors for XML documents
• Writing field mappings with JSONPath/JMESPath selectors for JSON documents
• Configuring German e-invoicing (ZUGFeRD, X-Rechnung) — both UBL and CII formats
• Building address concatenation selectors using XPath 1.0 patterns
• Setting up value transformation mappings (e.g., invoice type codes to enum values)
• Configuring date parsing with custom formats
• Setting up document splitting for multi-document files
• Configuring PDF rendering from embedded base64 content or generated from extracted data
• Handling non-existing schema IDs gracefully with skip_non_existing_schema_ids
• Debugging XPath selector issues or testing selectors locally
• Understanding trigger conditions and how multiple configurations are matched
• Upper/lower case conversions in XPath 1.0 and JSON selectors
• String concatenation in XPath and JMESPath selectors