VA Form 21P-527EZ ยท v4.2 draft
Veterans Pension application
Long income and asset sections. The draft adds bank statement reading to pre-fill income, with every value held for confirmation.
2 fields have no downstream target
Those answers are captured on the intake record but are not sent anywhere yet. A person has to choose the mapping before they can flow downstream.
6 fields in v4.2 draft
Each field records where it came from on the paper form, so a reviewer can always trace a digital answer back to the box it replaced.
| Type | Required | On the paper form | Maps to | |
|---|---|---|---|---|
| veteran_full_nameVeteran's full name | Text | Yes | Page 1, Section I, box 1 | claimant.fullName |
| service_startService start date | Date | Yes | Page 2, Section IV, box 12a | service.startedOn |
| monthly_incomeMonthly income | Currency | Yes | Page 5, Section VII, box 30 | income.monthlyTotal |
| net_worthTotal net worth | Currency | Yes | Page 6, Section VIII, box 34 | assets.netWorth |
| unreimbursed_medicalUnreimbursed medical expenses | Currency | No | Page 6, Section VIII, box 36 | Unmapped |
| care_facility_nameCare facility name | Text | No | Page 7, Section IX, box 41 | Unmapped |
Field schema for VA Form 21P-527EZ
- Field
- veteran_full_nameVeteran's full name
- Type
- Text
- Required
- Yes
- On the paper form
- Page 1, Section I, box 1
- Maps to
- claimant.fullName
- Field
- service_startService start date
- Type
- Date
- Required
- Yes
- On the paper form
- Page 2, Section IV, box 12a
- Maps to
- service.startedOn
- Field
- monthly_incomeMonthly income
- Type
- Currency
- Required
- Yes
- On the paper form
- Page 5, Section VII, box 30
- Maps to
- income.monthlyTotal
- Field
- net_worthTotal net worth
- Type
- Currency
- Required
- Yes
- On the paper form
- Page 6, Section VIII, box 34
- Maps to
- assets.netWorth
- Field
- unreimbursed_medicalUnreimbursed medical expenses
- Type
- Currency
- Required
- No
- On the paper form
- Page 6, Section VIII, box 36
- Maps to
- Unmapped
- Field
- care_facility_nameCare facility name
- Type
- Text
- Required
- No
- On the paper form
- Page 7, Section IX, box 41
- Maps to
- Unmapped
Validation rules
A rule can block a submission, warn the person filling it out, or flag the record for a person to review. No rule approves, denies, or prices anything.
| Field | Rule | When it fires | Effect |
|---|---|---|---|
| monthly_income | Extracted amounts are never submitted without confirmation | On the income step | Blocks submission |
| net_worth | Amounts over the annual limit are flagged, never rejected | On submission | Flags for review |
| service_start | Must precede the service end date | As the Veteran answers | Blocks submission |
Validation rules for VA Form 21P-527EZ
- Field
- monthly_income
- Rule
- Extracted amounts are never submitted without confirmation
- When it fires
- On the income step
- Effect
- Blocks submission
- Field
- net_worth
- Rule
- Amounts over the annual limit are flagged, never rejected
- When it fires
- On submission
- Effect
- Flags for review
- Field
- service_start
- Rule
- Must precede the service end date
- When it fires
- As the Veteran answers
- Effect
- Blocks submission
Downstream mapping
Where each answer lands: VBMS - Pension claim package.
Mapped (4)
- veteran_full_nameclaimant.fullName
- service_startservice.startedOn
- monthly_incomeincome.monthlyTotal
- net_worthassets.netWorth
Not mapped (2)
- unreimbursed_medical
Captured on the intake record. Waiting for someone to choose a downstream target.
- care_facility_name
Captured on the intake record. Waiting for someone to choose a downstream target.
Test submissions
Synthetic payloads run against the current schema. A failed test means a rule caught something, which is usually the point.
Run a test submission
Sends a synthetic payload through validation and the downstream mapping. Nothing reaches a real system of record.
| Test case | Run on | Result | What happened |
|---|---|---|---|
| Bank statement pre-fill, confirmed by the filer | August 3, 2026 | Passed | Draft schema. Two fields still unmapped. |
| Net worth above the limit | August 2, 2026 | Passed | Flagged for review rather than blocked, as required. |
Test submissions for VA Form 21P-527EZ
- Test case
- Bank statement pre-fill, confirmed by the filer
- Run on
- August 3, 2026
- Result
- Passed
- What happened
- Draft schema. Two fields still unmapped.
- Test case
- Net worth above the limit
- Run on
- August 2, 2026
- Result
- Passed
- What happened
- Flagged for review rather than blocked, as required.