adam/amazon-po-parser
Archived
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Coupa PO email parser and Payee Central scraper for Amazon site code resolution
This repository has been archived on 2026-08-04. You can view files and clone it, but cannot push or open issues or pull requests.
18 commits 1 branch 0 tags 104 KiB
JavaScript 78.7%
Python 21.3%
Find a file
Adam Moussa 114c743cf0 Add dependency-review caller workflow 
Add a pull_request-triggered caller that invokes the org-level
callable-dependency-review workflow to scan dependency changes and
fail on high-severity advisories.
2026-06-05 11:43:20 -04:00
.github Add dependency-review caller workflow 2026-06-05 11:43:20 -04:00
output Add reusable chunk scraper, LLM prompt, README; clean up one-off scripts 2026-05-01 19:52:07 -04:00
prompts Add reusable chunk scraper, LLM prompt, README; clean up one-off scripts 2026-05-01 19:52:07 -04:00
.gitignore Add reusable chunk scraper, LLM prompt, README; clean up one-off scripts 2026-05-01 19:52:07 -04:00
gen-po-list.mjs Initial commit: Coupa PO scraper and Payee Central site resolver 2026-04-29 19:44:46 -04:00
monitor.mjs Initial commit: Coupa PO scraper and Payee Central site resolver 2026-04-29 19:44:46 -04:00
package-lock.json Bump the minor-and-patch group with 2 updates (#14) 2026-05-30 17:43:59 +00:00
package.json Bump the minor-and-patch group with 2 updates (#14) 2026-05-30 17:43:59 +00:00
parse-mbox.py Add CI workflow and apply ruff formatting (#10) 2026-05-08 15:56:24 -04:00
README.md Add reusable chunk scraper, LLM prompt, README; clean up one-off scripts 2026-05-01 19:52:07 -04:00
scrape-fill-chunk.mjs Add reusable chunk scraper, LLM prompt, README; clean up one-off scripts 2026-05-01 19:52:07 -04:00
scrape-payee-chunk.mjs Initial commit: Coupa PO scraper and Payee Central site resolver 2026-04-29 19:44:46 -04:00
scrape.mjs Initial commit: Coupa PO scraper and Payee Central site resolver 2026-04-29 19:44:46 -04:00

README.md

amazon-po-parser

Tools for ingesting, scraping, and enriching Amazon purchase order data from Coupa emails and Payee Central.

Architecture

  • Data source: Coupa PO notification emails → parsed into structured JSON
  • Enrichment: Playwright scrapers hit Amazon Payee Central to resolve site codes, ship-to addresses, and line items
  • Storage: DynamoDB purchase-orders table (us-east-1) is the single source of truth
  • Mapping: output/site-state-extra-mapping.json — curated Amazon facility code → US state mapping (392 codes)

Scripts

Script Purpose
parse-mbox.py Parse Coupa PO emails from MBOX export into structured JSON
scrape.mjs Single-browser Payee Central scraper
scrape-payee-chunk.mjs Chunk-based concurrent scraper (run N instances in parallel)
scrape-fill-chunk.mjs Lightweight scraper for backfilling site codes and ship-to addresses
gen-po-list.mjs Generate PO lists from invoice spreadsheets
monitor.mjs Monitor scraper progress across chunks

DynamoDB Schema

Table: purchase-orders | Key: po_number (string)

Field Type Source
po_number string Email/Coupa
site_code string Payee Central scrape
state string Derived from site_code mapping
ship_to_raw string Payee Central scrape
line_items list Email parse + Payee Central
trade string Classified from descriptions
trades list All trades for multi-line POs
fiscal_year string Order date year
coupa_category string Coupa commodity category
source_system string "coupa"
data_source string "email+payee_scrape"
invoice_total string Downstream invoice matching
invoice_count number Downstream invoice matching
order_date string Email parse
po_status string Email parse
payment_terms string Email parse
requisition_number string Email parse

Prompt

prompts/po-email-parser.md contains the LLM prompt for parsing incoming Coupa PO emails. It includes site code extraction patterns, a skip list for non-site codes, trade classification rules, and ship-to address parsing guidance.

Setup

npm install          # playwright

Requires a Chrome profile logged into Amazon Payee Central at ./chrome-profile/.