GIR XSD Data Toolkit

A practical implementation pack for the GloBE Information Return (GIR): a tax-friendly data dictionary, code lists, repeatability mapping, and a rules-ready validation library designed for corporate tax teams, advisory firms, and software vendors.

📘 Data Dictionary (Excel)
🧩 Code Lists + Dropdown-ready
✅ Repeatability + Scope
🧠 OECD Validation Rules (JSON/CSV)
🌍 Jurisdiction Profiles (v0)

1) GIR Data Dictionary

A practical element-by-element reference for tax and engineering teams.

  • OECD guidance summaries + tax-friendly labels
  • Input vs container identification
  • Required/optional + repeatability
  • XSD types + XPaths for implementation
  • Code lists + dropdown-ready codes

2) OECD Validation Intelligence

Rules-ready OECD error codes mapped to fields and XPaths.

  • Target & reference field mapping
  • Inferred rule types (required_if, not_equal, etc.)
  • Fix hints for implementation / UI guidance
  • Index files for fast API lookup

3) Jurisdiction Packaging Profiles

A configuration layer for jurisdiction wrapper requirements.

  • Export packaging rules (e.g., Japan Summary per subgroup)
  • Portal constraints (encoding, file splits)
  • Extensible as more jurisdictions publish guidance

For Vendors / API Users: Validation Response Format

The Toolkit is designed for API-driven workflows. Validation responses return machine-readable rule IDs and field pointers (XPaths), making it easy to highlight the exact fields that need attention.

{ "submission_id": "subm_123", "profile": "OECD", "status": "invalid", "summary": { "errors": 3, "warnings": 1, "passed_rules": 247 }, "issues": [ { "severity": "error", "error_code": "70106", "rule_id": "…", "rule_type": "not_equal", "scope": "same_container_instance", "target": { "xpath": "/…/OtherTIN", "instance_id": "summary:subgroup:GIR1101:JP-TIN-AAA", "value": "JP123456789" }, "reference": { "xpath": "/…/TIN", "instance_id": "summary:subgroup:GIR1101:JP-TIN-AAA", "value": "JP123456789" }, "message": "OtherTIN must not equal TIN.", "fix_hint": "Ensure OtherTIN is different from TIN." } ] }
How vendors typically use this: map the returned XPath + instance_id to your internal model, surface the message inline, and include the fix hint in UI or logs.
GIR Data Toolkit

Buy now for instant access

Unlock the GIR XSD Data Toolkit — including a tax-friendly data dictionary, code lists, repeatability mapping, and a rules-ready validation library.

  • Excel & JSON formats
  • Implementation-ready structure for system builds
  • Designed for Pillar Two tax & compliance teams

Access & Downloads

Purchased This? Download the GIR XSD Toolkit Below

📘 GIR Data Toolkit — Data Dictionary (Excel)
Tax-friendly reference + XPaths, repeatability & code lists.
Download Excel
🧠 OECD Validation Rules Pack (Curated JSON)
High-confidence mappings for immediate implementation.
Download Curated JSON
🧠 OECD Validation Rules Pack (Full JSON)
Reference pack; includes items flagged for review.
Download Full JSON
🌍 Jurisdiction Profiles (JSON)
OECD default + JP Summary per subgroup (v0).
Download Profiles