Submission Errors
Troubleshooting vaccination encounter submission failures and validation errors
Errors that occur when submitting or updating vaccination encounters to AIR.
Common Submission Issues
Missing Required Fields
Symptom: Form won't submit or error indicates missing data.
Solution: Check that all fields marked with an asterisk (*) are completed. Required fields may change dynamically based on the selected vaccine — see Understanding Required Fields.
Invalid Vaccine Code
Symptom: Error related to vaccine code or "vaccine not valid for date".
Solution: Ensure you're selecting from the dropdown (not typing manually). If the vaccine doesn't appear, check the Date of Service is correct — vaccines are filtered by date validity.
Duplicate Encounter
Symptom: Warning about a similar vaccination already recorded.
Solution: Check the immunisation history for an existing record with the same vaccine and date. If the duplicate is genuine, use Accept and Confirm. If it was submitted in error, do not resubmit.
Encounter Pended
Symptom: Encounter submitted but shows "PENDED" or "Action Required" status.
Solution: This is normal in some cases (e.g., first encounter for a new patient). Review the warning details and use Accept and Confirm to resubmit with confirmation.
Encounter-Level Errors
Symptom: An error message appears on the encounter form after submission, with specific details about what AIR rejected.
Solution: Light surfaces the exact error information returned by AIR at the encounter level. Read the error message carefully — it will indicate the specific field or value that caused the rejection. Common causes include:
- Field values exceeding AIR's maximum length (Light automatically trims these where possible)
- Address details that don't match AIR's expected format
- Invalid or mismatched reference data
If the error message isn't clear, contact the Light Support Team with the details shown.
Network or Server Error
Symptom: "Failed to record encounter" or "Failed to communicate with the server".
Solution:
- Check your internet connection
- Verify your PRODA connection is still active (Settings > Integrations > AIR Integration)
- Wait a moment and try again
- Contact the Light Support Team if the issue persists