Skip to content

MAP004 - Required Field Missing on Target

Description

The source payload cannot supply a field that the target shape requires. The migration output will fail target-side validation until the caller fills the field in.

Category

Mapping Errors

Severity

error

When emitted

Emitted by the UNTP ↔ CIRPASS shims via compat/_mapping_codes.py constant MAP_CODE_REQUIRED_FIELD_MISSING. This is the only MAP00X code at error severity — it always blocks unless --accept-warnings is set.

Common causes

  • Migrating a UNTP 0.7 payload to CIRPASS 1.3 without a productCategory value — CIRPASS requires it; UNTP does not.
  • Migrating a CIRPASS payload missing dppIdentifier to UNTP — the reverse projection has no donor.

How to fix

  • Populate the required source-side field, then re-run the migration.
  • If the missing field is genuinely unknowable at migration time, emit a fixup pass after the shim that sets the field from a database lookup or operator-supplied default.

See also