Generate XBRL XML

Who does this: XBRL Reviewer · Senior Accountant · Platform Admin When: Filing is at VALIDATION_PASSED and you want the XBRL XML instance document (for direct submission or downstream tooling). Result: An .xml artifact in S3 + a signed URL. XbrlOutputArtifact row inserted with kind = XBRL_XML.

The gate is identical to BizFinx export — see Generate BizFinx XLSX for the four blocking reasons. Defence in depth: the worker re-runs the gate.

Before you start

• [ ] Filing at VALIDATION_PASSED.
• [ ] Every mapping confirmed.
• [ ] You hold EXPORT_XBRL_XML.

Steps

1. Open the filing → Exports tab.
2. Click Generate XBRL XML. The handler enqueues generate-xbrl-xml. The UI shows a polling indicator.
3. The worker builds an XBRL instance document:
   • <xbrl> root with namespace declarations for the pinned taxonomyVersion
   • One <context> per (period, entity) — <instant> for period_type = instant elements (Balance Sheet), <startDate>/<endDate> for period_type = duration (P&L, Cash Flow)
   • One <unit> for SGD (<measure>iso4217:SGD</measure>)
   • One fact per confirmed XbrlTagMapping with contextRef + unitRef (for monetary types)
4. Persists to S3 at xbrl/<clientId>/<filingId>/xbrl-v<n>.xml.

How to know it worked

1. Download the XML from the Exports tab; open in an editor.
2. Spot-check: every element id in the file matches a confirmed mapping; SGD unit is correctly declared; contexts cover the period.
3. XbrlOutputArtifact row inserted with kind = XBRL_XML.
4. Activity log shows xbrl.export.generated.

Phase 4: arelle conformance

The XBRL XML produced is contract-correct per the rules + taxonomy, but a full XBRL schema-conformance check via arelle is a Phase 4 capability. Until then, ACRA's BizFinx Preparation Tool does its own validation on upload — that's the production check.

Related runbooks

• Generate BizFinx XLSX
• Mark a filing as filed with ACRA
• XBRL Filing SOP §6 / Step 5.0