How It Works

Certificate to graph to recall response

Loamy connects three technical layers that food operations need but rarely have: automated certificate parsing, a structured lot-level graph, and a query engine built for FDA recall response.

Step 01

Ingest supplier certificates

Suppliers submit Certificate of Analysis PDFs to a dedicated Loamy email address or upload directly through a supplier portal link. Loamy also accepts API-delivered documents from WMS and ERP systems. No supplier-side software required.

Certificate Inbox
3 new certificates received
COA-SV-20260412-003.pdf Parsed
COA-WP-20260413-001.pdf Parsed
cert-missing-lot.pdf Review
Step 02

Parse Key Data Elements automatically

Loamy's document model extracts lot codes, harvest and pack dates, commodity descriptions, pesticide residue results, and supplier identifiers from unstructured PDFs, even when certificate layouts vary by supplier.

Extracted KDEs
traceability_lot_code: "LOT-2026-SV-0412"
commodity: "Romaine Lettuce, Head"
quantity: 240 cases
unit_of_measure: "case/24ct"
harvest_date: "2026-04-11"
grower_id: "SVF-CA-0088"
pesticide_residue: PASS
Step 03

Nodes connect into a supply-chain graph

Loamy links each parsed record to existing nodes in your supply chain graph using lot code matching and supplier identifiers. A grower lot becomes a node; its downstream packing run becomes a connected node; the retail distribution becomes another. Every CTE is stored on the edge.

Step 04

Query the graph during a recall

When a recall is issued, operations teams enter an ingredient, lot code, or supplier name. Loamy traverses the graph and returns every affected downstream lot, associated certificate, and physical location, formatted for an FDA records request response.

Recall Query
recall_scope("LOT-2026-SV-0412")
affected_lots: 4
downstream_locations: 3
certs_linked: 7
fda_package: READY
query_ms: 820

Supported Certificates

Certificate types Loamy ingests

Certificate Type Key Fields Extracted FSMA 204 Relevant Typical Source
Certificate of Analysis (COA) Lot code, test results, commodity, pass/fail status Grower, packer lab
Phytosanitary Certificate Consignment lot, origin, commodity, treatment type National plant protection org
Good Agricultural Practices (GAP) Audit Supplier ID, audit date, pass score, water test results Third-party auditor
Bill of Lading / Shipping Record Lot code, quantity, origin, destination, ship date Carrier, shipper
Organic Certificate Certifier, operation ID, commodity scope, expiry USDA-accredited certifier
Country of Origin (COOL) Documentation Origin country, commodity, lot identifier Supplier, importer

Integrations

Connects to your existing systems

Loamy ingests certificates via email forward, direct API, or WMS/ERP connector. No rip-and-replace required.

Email Forward
Zero-setup ingestion
REST API
Programmatic upload
WMS Connector
Warehouse management
ERP Bridge
Enterprise data sync
API Example
POST https://api.inloamy.com/v1/certificates
Authorization: Bearer <token>
Content-Type: multipart/form-data

file=@COA-SV-20260412-003.pdf
supplier_id=SVF-CA-0088

// Response
{
  "certificate_id": "cert_01JK9QRXP4HB",
  "lot_code": "LOT-2026-SV-0412",
  "status": "parsed",
  "graph_node": "node_grower_svf_0412"
}

See it running on your certificates

Bring one of your existing COA PDFs to a 30-minute pilot scoping call. We will run it through Loamy live and show you what the extracted graph looks like for your specific supply chain.