certificate-of-origin

name	certificate-of-origin
description	Validates a VIN then fills a Manufacturer's Certificate of Origin (MCO) PDF with vehicle details. Accepts Issue Date, Invoice

Certificate of Origin PDF Filler

Purpose

This skill validates a VIN and then populates a Manufacturer's Certificate of Origin PDF template with vehicle information supplied by the user, returning the completed document as a downloadable PDF named MCO-<last5VIN>.pdf.

Inputs

Collect ALL six values from the user before running the script.

Argument	User Label	Example
--issue-date	Issue Date	2026-07-25
--invoice-number	Invoice #	INV-001234
--vin	VIN	1HGCM82633A123456
--model-year	Model Year	2026
--model	Model	Civic
--manufacturer	Manufacturer	Honda

If any value is missing, ask the user for it before proceeding.

Workflow

Step 1 — Validate the VIN

Always run VIN validation first, before filling the certificate.

python /app/skills/certificate-of-origin/scripts/validate_vin.py \
  --vin "<vin>"

Always display the validation result to the user before proceeding.

• If the output starts with SUCCESS:, continue to Step 2.
• If the output starts with FAILURE:, stop. Do not run the fill script. Inform the user the certificate was not generated and ask them to provide a corrected VIN.

Step 2 — Fill the Certificate (only on validation success)

python /app/skills/certificate-of-origin/scripts/fill_certificate.py \
  --issue-date "<issue_date>" \
  --invoice-number "<invoice_number>" \
  --vin "<vin>" \
  --model-year "<model_year>" \
  --model "<model>" \
  --manufacturer "<manufacturer>"

The script prints SUCCESS: Certificate written to /app/created/MCO-<last5VIN>.pdf on completion. Present that path to the user as their downloadable file.

Error Handling

• If VIN validation fails, do not generate the certificate. Show the full validation failure message to the user and ask them to correct the VIN.
• If the fill script exits non-zero, show the full stderr output to the user and ask them to correct the input values.
• Do not guess or substitute missing input values — always ask the user.