flexport-core-workflow-a

# Flexport Core Workflow A: Bookings & Purchase Orders ## Overview The primary Flexport integration path: create purchase orders, book shipments, and track cargo through the supply chain. The API v2 uses RESTful endpoints at `https://api.flexport.com` with JSON payloads. ## Prerequisites - Completed `flexport-install-auth` setup - Understanding of Flexport freight types (ocean FCL/LCL, air, trucking) - Valid shipper/consignee addresses configured in Flexport Portal ## Instructions ### Step 1: Create a Purchase Order ```typescript const BASE = 'https://api.flexport.com'; const headers = { 'Authorization': `Bearer ${process.env.FLEXPORT_API_KEY}`, 'Flexport-Version': '2', 'Content-Type': 'application/json', }; // POST /purchase_orders — create a PO to track inbound goods const po = await fetch(`${BASE}/purchase_orders`, { method: 'POST', headers, body: JSON.stringify({ name: 'PO-2025-001', status: 'open', buyer: { name: 'Acme Corp', address: { country: 'US' } }, seller: { name: 'Shanghai Supplier', address: { country: 'CN' } }, line_items: [ { sku: 'WIDGET-A', quantity: 500, unit_of_measure: 'pieces' }, { sku: 'WIDGET-B', quantity: 200, unit_of_measure: 'pieces' }, ], cargo_ready_date: '2025-04-15', must_arrive_by: '2025-05-20', }), }).then(r => r.json()); console.log(`PO created: ${po.data.id}`); ``` ### Step 2: Create a Booking ```typescript // POST /bookings — book freight against a purchase order const boo...