Warranty Claim Agent - Aviation Invoice Automation Skill

Purpose

Automate warranty claim submission for aviation maintenance invoices by extracting data from PDF invoices and filling warranty portal forms automatically. Primary target: Collins Aerospace (Rockwell Collins) warranty portal, but designed to be adaptable to other vendors (Honeywell, Pratt & Whitney, etc.).

Project Goal

Build an agent that reduces warranty claim processing time from 60+ minutes to ~2 minutes by automating:

1. Invoice PDF data extraction
2. Warranty portal navigation and login
3. Multi-section form filling with dynamic row additions
4. Document upload and validation
5. Claim submission

---

CURRENT PROJECT STATE (Updated Feb 17, 2026)

Build Status: All 6 phases COMPLETE + LIVE PORTAL DEMO WORKING + DEMO SCRIPT READY

What Has Been Built

warranty-engineer-agent/
├── SKILL.md                         # This file (project spec + status + observations)
├── WARRANTY_CLAIM_AGENT_SKILL.md    # Original project spec (backup)
├── README.md                        # Project documentation
├── DEMO_SCRIPT.md                   # LinkedIn video recording script (6-act structure)
├── requirements.txt                 # Python dependencies
├── invoices/
│   └── sample_invoice_001.pdf       # Generated (3 pages, professional layout)
├── extracted_data/
│   ├── sample_invoice_001_data.json # Parsed and verified
│   └── rockwell_field_map.json      # Auto-discovered DDM field map from live portal
├── screenshots/                     # Demo screenshots (11 screenshots per run)
├── config/
│   └── field_mappings.json          # Invoice -> portal field mappings
└── scripts/
    ├── generate_invoice_pdf.py      # Phase 1: ReportLab PDF generator
    ├── invoice_parser.py            # Phase 2: pdfplumber + regex parser
    ├── portal_navigator.py          # Phase 3: Selenium browser automation
    ├── form_filler.py               # Phase 4: Configurable form filler
    ├── main.py                      # Phase 5: Main orchestrator (--parse-only works)
    ├── demo_portal.html             # Local demo portal (Collins-style warranty form)
    ├── demo_run.py                  # Demo script for local portal
    ├── demo_collins_portal.py       # Old Collins portal demo (deprecated)
    └── demo_rockwell_live.py        # LIVE Rockwell Collins portal demo (WORKING)

Dependencies Installed

• reportlab — PDF generation
• pdfplumber — PDF text extraction
• selenium — Browser automation
• webdriver-manager — Chrome WebDriver management

Verified Working Features

1. PDF Generation — generate_invoice_pdf.py creates professional 3-page MRO invoice
2. PDF Parsing — invoice_parser.py extracts all data with 95%+ accuracy:
   • 2 failed parts (P/N, S/N, dates, hours, cycles, failure descriptions)
   • 2 replacement parts (P/N, S/N, source, vendor PO)
   • 3 labor items (description, technician, A&P license, hours, rate, total)
   • 3 material items
   • Freight/shipping details
   • Full cost summary ($1,391.17 grand total)
   • Troubleshooting steps linked to failed parts
   • Warranty eligibility validated (both parts: ELIGIBLE)
3. Orchestrator — main.py --parse-only runs full parse pipeline end-to-end
4. Local Demo Portal — demo_portal.html is a Collins-style HTML warranty form with:
   • 6 tabbed sections (Claimant, Aircraft, Parts, Labor/Materials, Documents, Submit)
   • All form fields matching extracted invoice data structure
   • Professional Collins Aerospace branding
5. Demo Runner — demo_run.py opens the local portal and auto-fills with animation

---

LATEST SESSION OBSERVATIONS (Feb 17, 2026)

Dry Run Results (Feb 17)

• 29 fields filled, 0 failures, 175.6 seconds runtime
• 33 fields with values on page (includes pre-filled defaults)
• 11 screenshots captured
• Script confirmed WORKING on live Rockwell Collins portal

Chrome Split-Screen Fix (Feb 17)

• CHANGED demo_rockwell_live.py line ~584: replaced --start-maximized with:
  • --window-position=640,0 and --window-size=640,720
  • This positions Chrome on the RIGHT half of screen for split-screen demo recording
  • Left half = Claude Code terminal, Right half = Chrome browser
• Screen resolution: 1280x720 (user's primary display)

Browser Automation Observations (Feb 17 — Claude in Chrome session)

When manually filling the Collins portal form via Claude in Chrome MCP tools:

What worked:

• All text input fields filled successfully via click + type
• Page 1 → Page 2 wizard navigation via "Next" button click
• Cookie banner dismissed via ref_612 (Accept necessary cookies only)
• All 8 Page 0 fields, all 13 Page 1 text inputs, 3 textareas filled
• Form field refs: Page 0 refs (154-182), Page 1 refs (642-654, 733-883)

Date Picker Issue (KNOWN BUG — USE FOR DEMO FAILURE SCENE):

• Typing 02/08/2026 directly into date fields via browser automation does NOT trigger Liferay validation
• The visible input[ref="inputElement"] shows the typed value but the hidden input stays empty
• Portal shows "This field is required" validation error even though date text is visible
• JavaScript workaround: Using nativeInputValueSetter + dispatching input/change/blur events sets the display value but Liferay DDM may still not register it in the hidden field
• Root cause: Liferay DDM date fields have a paired hidden input that only updates when the datepicker calendar widget is used (click calendar icon → select date) or when the field receives a specific Liferay-internal event
• Possible fixes to implement:
  1. Click the calendar icon button (button with "Select date from a Datepicker" text), navigate month/year, click day
  2. Find the hidden input (paired with visible input, has Liferay $$DateOfFailure$hash$0$$en_US pattern name), set its value to YYYY-MM-DD format, dispatch change event
  3. Use Selenium ActionChains to interact with the datepicker widget natively

This date bug is the PLANNED FAILURE for the LinkedIn demo video — see DEMO_SCRIPT.md Act 4.

GIF Recording Attempt (Feb 17)

• Created a 50-frame GIF of form filling via Claude in Chrome
• File: C:\Users\delye\Downloads\warranty-claim-agent-demo.gif (7.2 MB)
• Included click indicators, action labels, progress bar, watermark
• User feedback: Not the right format for LinkedIn — user prefers to self-record video
• Lesson learned: Ask user before burning tokens on lengthy browser automation tasks

---

Live Portal Demo Results (Feb 15 + Feb 17)

demo_rockwell_live.py — FULLY WORKING on live Rockwell Collins portal

• 29 fields filled across 2 wizard pages, 0 failures
• 33 fields with values on page (includes some pre-filled defaults)
• 145-176 seconds runtime (includes animated typing for video recording)
• 11 screenshots captured at each stage

Rockwell Collins Portal Technical Notes

Correct URL: https://portal.rockwellcollins.com/web/support-self-service/business-and-regional-claim-form

• This is PUBLIC, no login required
• Do NOT use the old warranty URL (/warranty/-/warranty_claim/business-regional) — that lands on a different page

Portal Technology: Liferay DDM (Dynamic Data Mapping) form

• Fields use data-field-name attribute (e.g., DealerNameOEMName, ACType)
• Field IDs are very long Liferay-generated strings with $$FieldName$hash$0$$en_US pattern
• Form is a 2-page wizard — must click "Next" button (button.lfr-ddm-form-pagination-next) to advance
• Page 1 fields are hidden until wizard navigates to them

Cookie Banner: Uses <a> tags (NOT <button>) with onclick handlers

• Selector: a.gdpr-btn.btn-accept or a[onclick*='acceptNecessaryCookies']
• Must be dismissed before form fields are interactive
• GDPR div may have visibility: collapse — use JS click fallback

Page 0 Fields (8): DealerNameOEMName, DealerNumberCustomerNumber, City, State, Country, SubmitterName, Email, Phone

Page 1 Fields (21): ReferenceClaimNumberNonCollinsID, WorkOrderInvoiceReference, CASPContract, CustomerName, City1, State1, Country1, ACType, ACSerial, ACTail, ManufacturerSPart, OldRemovedSerial, NewInstalledSerial, LaborHours, LaborRate, FreightCASPOnly, DateOfFailure (date picker), DateOfRepair (date picker), Complaint (textarea), CorrectiveActionPartsUsed (textarea), Notes (textarea)

Date Fields: Use ref="inputElement" attribute — type value directly into the visible input, then click body to close datepicker. SEE DATE PICKER ISSUE ABOVE for known validation bug.

Special Characters Warning: Portal shows "Please avoid using special characters" — script uses re.sub(r'[^\w\s.,;:()/#\-]', '', text) to sanitize

Known Issues

• Date pickers (CRITICAL): Typing dates directly does NOT update the hidden Liferay field — portal still shows "This field is required". Need datepicker widget interaction or hidden field JS injection. See detailed notes in "Date Picker Issue" section above.
• Labor descriptions: pdfplumber truncates some multi-line table text (cosmetic only)
• Single part per claim: Real portal says "One Collins Part Number per claim" — for multiple parts, need separate claims

How to Run

# Navigate to project directory
cd C:\Users\delye\.claude\skills\warranty-engineer-agent

# Generate sample invoice PDF
python scripts/generate_invoice_pdf.py

# Parse invoice (no browser needed)
python scripts/main.py invoices/sample_invoice_001.pdf --parse-only

# Run LIVE Rockwell Collins portal demo (RECOMMENDED)
# Chrome opens on RIGHT half of screen for split-screen recording
python scripts/demo_rockwell_live.py

# Run local demo (offline, opens Chrome with local portal)
python scripts/demo_run.py

---

LINKEDIN DEMO VIDEO PLAN

Demo Script: DEMO_SCRIPT.md

Full 6-act recording script saved in project root. Summary:

| Act | Duration | What Happens | |-----|----------|-------------| | 1. Intro | 30s | User asks Claude to check invoice & file claim | | 2. Parse | 30-45s | Claude extracts data, user shows PDF on right side | | 3. Portal Fill | 60-90s | Agent auto-fills 29 fields on LIVE Collins portal | | 4. The Failure | 30s | User spots date picker validation error | | 5. The Learn | 30-45s | User tells Claude to update skill knowledge — agent improves | | 6. Closing | 15s | Show metrics: 60 min → 2 min, 97% reduction |

Recording Setup

• Screen layout: Claude Code (LEFT 50%) + Chrome (RIGHT 50%)
• Script auto-positions Chrome on right half (640x720 at position 640,0)
• Recording tool: OBS Studio or Windows Game Bar (Win+G)
• Total raw recording: ~3-4 minutes
• Edited video: ~2-2.5 minutes (speed up form filling)

The Planned Failure (Act 4)

The date picker validation error is REAL and REPRODUCIBLE:

• Dates type into visible fields but Liferay hidden fields don't update
• Portal shows "This field is required" — perfect for demo
• User asks agent to learn from this → agent updates SKILL.md
• Shows: AI agents that learn from real-world failures

---

SECRET KEYWORD DEMO TRIGGER

How It Works

When the user types the keyword "SKYLINE" in chat, Claude must immediately start the full demo workflow. No questions asked — just go.

Trigger Word: SKYLINE

What Claude Must Do When User Types "SKYLINE":

Step 1 — Acknowledge (instant, 1 line):

"Checking invoice INV-2026-001234... Extracting warranty data from 3-page MRO invoice."

Step 2 — Parse Invoice (show in terminal):

• Read extracted_data/sample_invoice_001_data.json
• Display a formatted summary:

  Invoice: INV-2026-001234 | Date: 2026-02-10
  Aircraft: N12345 | PC-12/47E | MSN 1845
  Failed Part: P/N 4077690-901 — Digital Flight Control Computer
    Serial: DFCC-45678 → Replacement: DFCC-56789
    Hours: 487.5 | Warranty: ELIGIBLE
  Labor: 4.5 hrs @ $125/hr | Freight: $156.00
  Grand Total: $1,391.17
  

Step 3 — Open Collins Portal & Fill Form (browser automation):

• Run: python scripts/demo_rockwell_live.py from the skill base directory
• This script:
  • Opens Chrome on RIGHT half of screen (640x720 at position 640,0)
  • Navigates to Collins portal
  • Dismisses cookie banner
  • Fills Page 0 (8 fields: dealer info)
  • Clicks "Next"
  • Fills Page 1 (21 fields: claim/parts/labor/dates)
  • Takes 11 screenshots along the way
  • Total runtime: ~145-176 seconds

Step 4 — Report Results:

"Done. 29 fields filled, 0 failures. Check the date picker fields — they may show validation errors (known Liferay DDM bug)."

Alternative Trigger Words (also valid):

• "file the claim" — same as SKYLINE
• "go" — same as SKYLINE
• "run it" — same as SKYLINE

Pre-Recording Checklist:

• [ ] Claude Code terminal on LEFT half of screen
• [ ] Chrome will auto-open on RIGHT half (script handles positioning)
• [ ] Close notifications, Slack, email
• [ ] OBS or Win+G ready to record full desktop
• [ ] Terminal font: 14-16pt for readability

---

NEXT STEPS

1. Record the LinkedIn demo video — Type "SKYLINE" to start demo
2. Fix date picker bug — Implement datepicker widget interaction or hidden field JS approach
3. Multi-part claims — Portal allows 1 part per claim; add loop to submit multiple claims
4. Optional: Add more invoice templates (Honeywell, different MRO formats)
5. Optional: Add Honeywell/Garmin portal support

---

Sample Invoice Data (for reference)

Invoice: INV-2026-001234 (Feb 10, 2026) Customer: Regional Air Services LLC Aircraft: N12345, PC-12/47E, MSN 1845 Failed Parts:

• P/N 4077690-901, S/N DFCC-45678 (Digital Flight Control Computer) — 487.5h, 542 days → ELIGIBLE
• P/N 822-1304-002, S/N AHRS-98234 (AHRS) — 198.3h, 443 days → ELIGIBLE Grand Total: $1,391.17

---

Technical Architecture

Invoice Parser (invoice_parser.py)

• Uses pdfplumber for text extraction
• Section-based parsing with regex patterns
• Handles multi-line pdfplumber table cell wrapping
• Auto-links troubleshooting steps to failed parts by serial number
• Validates warranty eligibility (2-year / 800 flight hour limits)
• Outputs structured JSON to extracted_data/

Portal Navigator (portal_navigator.py)

• Selenium WebDriver (Chrome)
• Form structure analysis (discovers inputs, selects, textareas, buttons)
• Login detection and handling (manual or automated)
• Claim type selection
• Screenshot capture

Form Filler (form_filler.py)

• Configurable via config/field_mappings.json
• Static sections: dot-notation source paths → target field names
• Dynamic sections: array iteration with "Add Row" button support
• Value formatting: dates, currency, phone numbers
• Pre-submission validation

Demo System

• demo_rockwell_live.py — PRIMARY DEMO — LIVE Rockwell Collins portal:
  • Navigates to real Collins Aerospace claim form (public, no login)
  • Handles GDPR cookie banner automatically (JS click on <a> tags)
  • Auto-discovers 29 Liferay DDM fields using data-field-name attribute
  • Fills Page 0 (dealer/submitter), clicks "Next", fills Page 1 (claim/parts/labor)
  • Handles date pickers, textareas, special character sanitization
  • Falls back to local demo HTML if real portal is unreachable
  • Character-by-character typing (0.022s/char)
  • Field highlighting (blue glow -> green on completion)
  • Agent banner + floating status overlay + progress bar
  • Auto-scroll review at end for recording
  • Chrome opens on RIGHT half of screen (640x720) for split-screen recording
  • 11 screenshots saved to screenshots/
  • 29 fields filled in ~145-176 seconds
• demo_portal.html — Local Collins-style HTML form (offline fallback)
• demo_run.py — Simpler demo for local portal only

---

Use Case

Small aviation operators and MROs spend significant time manually transcribing invoice data into vendor warranty portals. Each claim requires:

• Reading multi-page PDF invoices
• Copying part numbers, serial numbers, dates, costs
• Navigating complex multi-tab forms
• Adding multiple dynamic rows for parts, labor, materials
• Uploading supporting documents
• Validating all required fields

This agent automates the entire workflow.

---

Important Notes

• Always respect vendor terms of service
• Don't share login credentials in code
• Use for legitimate warranty claims only
• Test thoroughly before production use
• Keep sensitive data secure
• Token usage: Always ask user before running lengthy browser automation or multi-step tasks

Author

Emin Delyev - Aviation AMOS Expert @ Lufthansa