{"openapi":"3.1.0","info":{"title":"POST /api/v1/inventory/po-import/preview","version":"1.0.0","description":"Preview PO import with SKU matching"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/inventory/po-import/preview":{"post":{"tags":["inventory:po_import"],"summary":"Preview PO import with SKU matching","description":"After reviewing AI column mappings, returns line items with SKU match status against the product catalog.","operationId":"preview_po_import_api_v1_inventory_po_import_preview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-business-id","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Business-Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/POPreviewRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/POPreviewResponse"}}}},"400":{"description":"Bad Request - Invalid input","content":{"application/json":{"example":{"detail":"Invalid request parameters"}}}},"401":{"description":"Unauthorized - Authentication required","content":{"application/json":{"example":{"detail":"Not authenticated"}}}},"403":{"description":"Forbidden - Insufficient permissions","content":{"application/json":{"example":{"detail":"Not enough permissions"}}}},"422":{"description":"Validation Error - Invalid data format","content":{"application/json":{"example":{"detail":[{"loc":["body","field"],"msg":"field required","type":"value_error.missing"}]}}}}}}}},"components":{"schemas":{"POMetadata":{"properties":{"suggested_po_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Po Name"},"suggested_vendor_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Vendor Name"},"suggested_po_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Suggested Po Number"}},"type":"object","title":"POMetadata","description":"AI-detected purchase order metadata."},"POPreviewLineItem":{"properties":{"row_number":{"type":"integer","title":"Row Number"},"sku":{"type":"string","title":"Sku"},"item_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Item Name"},"quantity":{"type":"integer","title":"Quantity"},"unit_price_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unit Price Cents"},"match_status":{"type":"string","enum":["matched","unmatched","ambiguous"],"title":"Match Status","default":"unmatched"},"matched_variant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Variant Id"},"matched_variant_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Variant Name"},"matched_sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Matched Sku"},"match_confidence":{"type":"number","title":"Match Confidence","default":0.0},"candidates":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Candidates"}},"type":"object","required":["row_number","sku","quantity"],"title":"POPreviewLineItem"},"POPreviewRequest":{"properties":{"file_id":{"type":"string","title":"File Id"},"selected_sheets":{"items":{"type":"string"},"type":"array","title":"Selected Sheets"},"sheet_mappings":{"items":{"$ref":"#/components/schemas/POSheetMappingConfirmation"},"type":"array","title":"Sheet Mappings"}},"type":"object","required":["file_id","selected_sheets","sheet_mappings"],"title":"POPreviewRequest"},"POPreviewResponse":{"properties":{"file_id":{"type":"string","title":"File Id"},"line_items":{"items":{"$ref":"#/components/schemas/POPreviewLineItem"},"type":"array","title":"Line Items"},"summary":{"$ref":"#/components/schemas/POPreviewSummary"},"metadata":{"$ref":"#/components/schemas/POMetadata"}},"type":"object","required":["file_id"],"title":"POPreviewResponse"},"POPreviewSummary":{"properties":{"total_lines":{"type":"integer","title":"Total Lines","default":0},"matched_lines":{"type":"integer","title":"Matched Lines","default":0},"unmatched_lines":{"type":"integer","title":"Unmatched Lines","default":0},"ambiguous_lines":{"type":"integer","title":"Ambiguous Lines","default":0},"total_quantity":{"type":"integer","title":"Total Quantity","default":0},"total_cents":{"type":"integer","title":"Total Cents","default":0},"skipped_rows":{"type":"integer","title":"Skipped Rows","default":0}},"type":"object","title":"POPreviewSummary"},"POSheetMappingConfirmation":{"properties":{"sheet_name":{"type":"string","title":"Sheet Name"},"mapping":{"additionalProperties":{"type":"integer"},"type":"object","title":"Mapping","description":"Map of standard field name → 0-based column index."},"data_start_row":{"type":"integer","title":"Data Start Row","default":2},"exclude_rows":{"items":{"type":"integer"},"type":"array","title":"Exclude Rows"}},"type":"object","required":["sheet_name","mapping"],"title":"POSheetMappingConfirmation"}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}