Track and maintain per-SKU cost of goods sold (COGS) including purchase price, freight, duty, and landed cost. Use this skill when recording new supplier invoices, updating product costs, calculating margins for pricing decisions, or when any skill needs accurate COGS data. This is the foundation for all profitability analysis.
Maintain accurate per-SKU cost data in the products table so every other skill (pricing, margin reporting, channel profitability) has reliable cost information to work with.
Total landed cost per unit = Purchase Price + Freight + Duty + Processing
landed_cost = purchase_price_usd + freight_per_unit + (purchase_price_usd * duty_rate) + processing_per_unit
products.cogs_confirmed (validated) or products.cogs_estimated (fallback)supplier_payments tableproducts.freight_per_unitproducts.duty_rate (decimal, e.g., 0.05 for 5%)products.duty_hs_codeEvery product has a cogs_confidence enum:
| Level | Meaning | Action |
|---|---|---|
| confirmed | COGS validated from actual supplier invoices + freight records | Use for all calculations |
| estimated | COGS estimated from category averages or similar products | Flag in reports, use for estimates |
| unknown | No cost data available | Cannot calculate margins — escalate |
Phase 1 target: Move all products from "estimated" (category averages) to "confirmed" (actual invoices) within first 90 days. The operations-manager's Nepal team provides invoice data; ceo validates.
Until SKU-level COGS are confirmed, use these category averages from the financial model:
| Category | Avg COGS % of Revenue | Confidence |
|---|---|---|
| Incense | 22.5% | Medium |
| Prayer Flags | 17.5% | Medium |
| Malas / Jewelry | 22.5% | Medium |
| Singing Bowls | 30% | Low |
| Statues | 35% | Low |
| Thangkas (painted) | 42.5% | Low |
| Thangkas (prints) | 12.5% | High |
| Offering Sets | 30% | Medium |
Low-confidence categories (singing bowls, statues, painted thangkas) have wide variance — individual items can range ±15% from the average. Prioritize getting confirmed COGS for these categories.
supplier_payments table with NPR amount, exchange rate, USD equivalenttotal_usd / total_unitsproducts.cogs_confirmed for each SKU on the invoiceproducts.cogs_confidence to "confirmed"products.freight_per_unit if this invoice includes freight costsskill_invocations with full contextRun monthly (1st of month). For each product:
cogs_confidence is still "confirmed" — has anything changed?margin_floor_by_channelNepal supplier payments are in NPR. The NPR/USD rate fluctuates.
{
"sku": "TS-INC-NADO-HAPPINESS",
"cogs_components": {
"purchase_price_usd": 2.15,
"freight_per_unit": 0.45,
"duty_amount": 0.00,
"processing": 0.00,
"total_landed_cost": 2.60
},
"confidence": "confirmed",
"last_updated": "2026-03-15",
"margin_at_current_price": {
"shopify": 0.74,
"etsy": 0.68,
"amazon": 0.58
}
}