Orders

Purpose

Orders is where you monitor Shopify → NetSuite order processing, including:

• Raw inbound payloads
• Normalized/parsed orders
• Sync results, retries, and diagnostics

Key UI pages

• Orders hub
• Raw orders
• Normalized orders
• Results
• Shipping
• Diagnostics

Related API routes

These are implemented under app/api/orders/...:

• GET /api/orders/recent: list recent orders
• GET /api/orders/raw: view raw inbound payloads
• GET /api/orders/normalized: view normalized orders
• GET /api/orders/results: view sync results
• POST /api/orders/results/retry/[shopify_order_id]: retry a failed order
• GET /api/orders/results/[shopify_order_id]/history: attempt history
• GET /api/orders/diagnostics: diagnostics summary
• GET /api/orders/diagnostics/item-lookup: item lookup tool
• GET /api/orders/diagnostics/validate: validation endpoint
• GET /api/orders/shipping: shipping-related diagnostics/data

Troubleshooting

• Order stuck retrying: check attempt history and the retry endpoint response.
• Mismatch between raw and normalized: compare the raw payload with the normalized output; the normalization step is the place to fix parsing assumptions.