{"openapi":"3.1.0","info":{"title":"POST /api/v1/inventory/import/apply","version":"1.0.0","description":"Apply import"},"servers":[{"url":"https://api.ondayzero.com","description":"Production"}],"paths":{"/api/v1/inventory/import/apply":{"post":{"tags":["inventory:import"],"summary":"Apply import","description":"Execute the confirmed import: create locations, products, variants, and set inventory levels. All changes happen in a single transaction.","operationId":"apply_import_api_v1_inventory_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/ApplyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplyResponse"}}}},"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":{"ApplyLevelDecision":{"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},"action":{"type":"string","enum":["set","skip"],"title":"Action","default":"set"}},"type":"object","required":["variant_name"],"title":"ApplyLevelDecision"},"ApplyLocationDecision":{"properties":{"name":{"type":"string","title":"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_type":{"type":"string","title":"Location Type","default":"warehouse"},"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},"type":"object","required":["name"],"title":"ApplyLocationDecision"},"ApplyProductDecision":{"properties":{"name":{"type":"string","title":"Name"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"},"action":{"type":"string","enum":["create","match","skip"],"title":"Action","default":"create"},"existing_product_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Existing Product Id"},"variants":{"items":{"$ref":"#/components/schemas/ApplyVariantDecision"},"type":"array","title":"Variants"}},"type":"object","required":["name"],"title":"ApplyProductDecision"},"ApplyRequest":{"properties":{"file_id":{"type":"string","title":"File Id"},"locations":{"items":{"$ref":"#/components/schemas/ApplyLocationDecision"},"type":"array","title":"Locations"},"products":{"items":{"$ref":"#/components/schemas/ApplyProductDecision"},"type":"array","title":"Products"},"levels":{"items":{"$ref":"#/components/schemas/ApplyLevelDecision"},"type":"array","title":"Levels"}},"type":"object","required":["file_id"],"title":"ApplyRequest","description":"Request body for POST /inventory/import/apply."},"ApplyResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"summary":{"$ref":"#/components/schemas/ApplyResultSummary"}},"type":"object","title":"ApplyResponse","description":"Response from POST /inventory/import/apply."},"ApplyResultSummary":{"properties":{"locations_created":{"type":"integer","title":"Locations Created","default":0},"products_created":{"type":"integer","title":"Products Created","default":0},"variants_created":{"type":"integer","title":"Variants Created","default":0},"levels_set":{"type":"integer","title":"Levels Set","default":0},"errors":{"items":{"type":"string"},"type":"array","title":"Errors"}},"type":"object","title":"ApplyResultSummary"},"ApplyVariantDecision":{"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"},"action":{"type":"string","enum":["create","match","skip"],"title":"Action","default":"create"},"existing_variant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Existing Variant Id"},"default_vendor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Default Vendor Id"}},"type":"object","required":["name"],"title":"ApplyVariantDecision","description":"Per-variant decision from the user for apply phase."}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Token","description":"API token authentication. Format: `Bearer dz_...`"}}},"security":[{"BearerAuth":[]}]}