{"openapi":"3.1.0","info":{"title":"POST /api/v1/inventory/po-import/apply","version":"1.0.0","description":"Create purchase order from import"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/inventory/po-import/apply":{"post":{"tags":["inventory:po_import"],"summary":"Create purchase order from import","description":"Create a draft purchase order from confirmed line items and vendor. Unmatched SKUs require variant_id overrides or must be skipped.","operationId":"apply_po_import_api_v1_inventory_po_import_apply_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/POApplyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/POApplyResponse"}}}},"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":{"POApplyRequest":{"properties":{"file_id":{"type":"string","title":"File Id"},"vendor_id":{"type":"string","title":"Vendor Id"},"po_number":{"type":"string","title":"Po Number"},"name":{"type":"string","title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"line_decisions":{"items":{"$ref":"#/components/schemas/POLineDecision"},"type":"array","title":"Line Decisions"},"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","vendor_id","po_number","name","selected_sheets","sheet_mappings"],"title":"POApplyRequest"},"POApplyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Id"},"po_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Po Number"},"lines_created":{"type":"integer","title":"Lines Created","default":0},"lines_skipped":{"type":"integer","title":"Lines Skipped","default":0},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"}},"type":"object","title":"POApplyResponse"},"POLineDecision":{"properties":{"row_number":{"type":"integer","title":"Row Number"},"action":{"type":"string","enum":["include","skip"],"title":"Action","default":"include"},"variant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Id","description":"Override variant UUID for unmatched/ambiguous lines."}},"type":"object","required":["row_number"],"title":"POLineDecision"},"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":[]}]}