{"openapi":"3.1.0","info":{"title":"POST /api/v1/inventory/import/preview","version":"1.0.0","description":"Preview import"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/inventory/import/preview":{"post":{"tags":["inventory:import"],"summary":"Preview import","description":"After reviewing the AI analysis, confirm column mappings and sheet selections. Returns a full preview of locations, products, and inventory levels to be created.","operationId":"preview_import_api_v1_inventory_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/PreviewRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewResponse"}}}},"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":{"LocationDecision":{"properties":{"detected_name":{"type":"string","title":"Detected Name"},"action":{"type":"string","enum":["create","match","skip"],"title":"Action","default":"create"},"existing_location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Existing Location Id"},"location_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Name"},"location_type":{"type":"string","title":"Location Type","default":"warehouse"}},"type":"object","required":["detected_name"],"title":"LocationDecision","description":"User decision for a detected location."},"PreviewInventoryLevel":{"properties":{"variant_name":{"type":"string","title":"Variant Name"},"variant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Variant Id"},"location_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Name"},"location_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Id"},"on_hand":{"type":"number","title":"On Hand","default":0},"match_confidence":{"type":"number","title":"Match Confidence","default":0.0},"is_new":{"type":"boolean","title":"Is New","default":true}},"type":"object","required":["variant_name"],"title":"PreviewInventoryLevel"},"PreviewLocation":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type","default":"warehouse"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},"type":"object","required":["name"],"title":"PreviewLocation"},"PreviewProduct":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type","default":"manual"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"variants":{"items":{"$ref":"#/components/schemas/PreviewVariant"},"type":"array","title":"Variants"}},"type":"object","required":["name"],"title":"PreviewProduct"},"PreviewRequest":{"properties":{"file_id":{"type":"string","title":"File Id"},"selected_sheets":{"items":{"type":"string"},"type":"array","title":"Selected Sheets"},"sheet_mappings":{"items":{"$ref":"#/components/schemas/SheetMappingConfirmation"},"type":"array","title":"Sheet Mappings"},"location_decisions":{"items":{"$ref":"#/components/schemas/LocationDecision"},"type":"array","title":"Location Decisions"}},"type":"object","required":["file_id","selected_sheets","sheet_mappings"],"title":"PreviewRequest","description":"Request body for POST /inventory/import/preview."},"PreviewResponse":{"properties":{"file_id":{"type":"string","title":"File Id"},"to_create":{"$ref":"#/components/schemas/PreviewToCreate"},"to_update":{"$ref":"#/components/schemas/PreviewToUpdate"},"summary":{"$ref":"#/components/schemas/PreviewSummary"}},"type":"object","required":["file_id"],"title":"PreviewResponse","description":"Response from POST /inventory/import/preview."},"PreviewSummary":{"properties":{"locations_to_create":{"type":"integer","title":"Locations To Create","default":0},"products_to_create":{"type":"integer","title":"Products To Create","default":0},"variants_to_create":{"type":"integer","title":"Variants To Create","default":0},"levels_to_set":{"type":"integer","title":"Levels To Set","default":0},"existing_matched":{"type":"integer","title":"Existing Matched","default":0},"skipped_rows":{"type":"integer","title":"Skipped Rows","default":0}},"type":"object","title":"PreviewSummary"},"PreviewToCreate":{"properties":{"locations":{"items":{"$ref":"#/components/schemas/PreviewLocation"},"type":"array","title":"Locations"},"products":{"items":{"$ref":"#/components/schemas/PreviewProduct"},"type":"array","title":"Products"}},"type":"object","title":"PreviewToCreate"},"PreviewToUpdate":{"properties":{"inventory_levels":{"items":{"$ref":"#/components/schemas/PreviewInventoryLevel"},"type":"array","title":"Inventory Levels"}},"type":"object","title":"PreviewToUpdate"},"PreviewVariant":{"properties":{"name":{"type":"string","title":"Name"},"sku":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sku"},"unit_cost_cents":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unit Cost Cents"},"unit_cost_precise":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Unit Cost Precise"},"uom":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uom"}},"type":"object","required":["name"],"title":"PreviewVariant"},"SheetMappingConfirmation":{"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":"SheetMappingConfirmation","description":"User-confirmed column mapping for a single sheet."}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}