{"openapi":"3.1.0","info":{"title":"Superfid External API","version":"0.0.1","description":"Workspace developer key 기반 고객용 read-only API. 위치, 재고현황, SKU 상세·이력, 위치별 이벤트, 이벤트 수량 라인과 확정된 실사 조회를 제공합니다."},"servers":[{"url":"/","description":"current origin"}],"components":{"schemas":{"BillingAccessStatus":{"type":"object","properties":{"state":{"type":"string","enum":["inactive","active","warning","restricted","held","ended"]},"businessAllowed":{"type":"boolean"},"revision":{"type":"integer"},"validUntil":{"type":["string","null"]},"serverTime":{"type":"string"},"dueAt":{"type":["string","null"]}},"required":["state","businessAllowed","revision","validUntil","serverTime","dueAt"]},"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{}},"required":["code","message"]}},"required":["error"]},"HealthResponse":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"uptimeSeconds":{"type":"number"}},"required":["status","uptimeSeconds"]},"ReadyResponse":{"type":"object","properties":{"status":{"type":"string","enum":["ready"]},"environment":{"type":"string","enum":["local","development","staging","prod"]},"releaseSha":{"type":"string"},"epcGuardMode":{"type":"string","enum":["dual","guard"]},"schemaVersion":{"type":"integer","exclusiveMinimum":0}},"required":["status","environment","releaseSha","epcGuardMode","schemaVersion"]},"NotReadyResponse":{"type":"object","properties":{"status":{"type":"string","enum":["not_ready"]}},"required":["status"]},"ResourceReadinessResponse":{"type":"object","properties":{"status":{"type":"string","enum":["ok"]},"environment":{"type":"string","enum":["local","development","staging","prod"]},"resources":{"type":"object","properties":{"database":{"type":"object","properties":{"status":{"type":"string","enum":["ready","error"]}},"required":["status"]},"storage":{"type":"object","properties":{"status":{"type":"string","enum":["ready","error"]}},"required":["status"]},"inngest":{"type":"object","properties":{"status":{"type":"string","enum":["ready","error"]}},"required":["status"]},"worker":{"type":"object","properties":{"status":{"type":"string","enum":["ready","error"]}},"required":["status"]}},"required":["database","storage","inngest","worker"]}},"required":["status","environment","resources"]},"ScanSessionResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"status":{"$ref":"#/components/schemas/ScanSessionStatus"},"clientSessionId":{"type":"string"},"deviceId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"clientDeviceId":{"type":["string","null"]},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"scanSessionType":{"$ref":"#/components/schemas/ScanSessionType"},"eventTypeCode":{"$ref":"#/components/schemas/EventTypeCode"},"eventTypeName":{"type":["string","null"]},"eventTypeDirection":{"$ref":"#/components/schemas/InventoryEventDirection"},"setTypeCode":{"$ref":"#/components/schemas/EventTypeCode"},"setTypeName":{"type":["string","null"]},"setScope":{"$ref":"#/components/schemas/InventorySetScope"},"inputMode":{"$ref":"#/components/schemas/ScanSessionInputMode"},"expectedUploadedTagCount":{"type":["integer","null"]},"uploadedTagCount":{"type":"integer","minimum":0},"matchedSkuTagCount":{"type":"integer","minimum":0},"unmatchedTagCount":{"type":"integer","minimum":0},"totalUploadBatches":{"type":["integer","null"]},"scanStartedAt":{"type":["string","null"],"format":"date-time"},"occurredAt":{"type":["string","null"],"format":"date-time"},"setNote":{"type":["string","null"]},"confirmStatus":{"$ref":"#/components/schemas/ScanSessionConfirmStatus"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"processingRequestedAt":{"type":["string","null"],"format":"date-time"},"processingStartedAt":{"type":["string","null"],"format":"date-time"},"processingFinishedAt":{"type":["string","null"],"format":"date-time"},"processingQueueDelayMs":{"type":["integer","null"],"minimum":0},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["id","status","clientSessionId","deviceId","clientDeviceId","locationId","scanSessionType","eventTypeCode","eventTypeName","eventTypeDirection","setTypeCode","setTypeName","setScope","inputMode","expectedUploadedTagCount","uploadedTagCount","matchedSkuTagCount","unmatchedTagCount","totalUploadBatches","scanStartedAt","occurredAt","setNote","confirmStatus","confirmedAt","completedAt","processingRequestedAt","processingStartedAt","processingFinishedAt","processingQueueDelayMs","createdAt","updatedAt"]},"ScanSessionStatus":{"type":"string","enum":["creating","uploading","ready","processing","done","processing_failed"]},"ScanSessionType":{"type":"string","enum":["inventory_event","inventory_set"]},"EventTypeCode":{"type":["string","null"],"minLength":1,"maxLength":96,"pattern":"^[A-Z0-9_]+$"},"InventoryEventDirection":{"type":["string","null"],"enum":["in","out",null]},"InventorySetScope":{"type":"string","enum":["selected_skus","full_location"]},"ScanSessionInputMode":{"type":"string","enum":["rfid","barcode","manual","csv"]},"ScanSessionConfirmStatus":{"type":["string","null"],"enum":["open","confirmed","cancelled",null]},"ScanSessionCreateRequest":{"type":"object","properties":{"clientSessionId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","example":"550e8400-e29b-41d4-a716-446655440000"},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"scanSessionType":{"$ref":"#/components/schemas/ScanSessionType"},"eventTypeCode":{"allOf":[{"$ref":"#/components/schemas/EventTypeCode"},{"description":"Required for inventory_event sessions. Public inventory event type code."}]},"setTypeCode":{"allOf":[{"$ref":"#/components/schemas/EventTypeCode"},{"description":"Required for inventory_set sessions. Public inventory set type code."}]},"setScope":{"$ref":"#/components/schemas/InventorySetScope"},"inputMode":{"$ref":"#/components/schemas/ScanSessionInputMode"},"expectedUploadedTagCount":{"type":"integer","minimum":0},"totalUploadBatches":{"type":"integer","exclusiveMinimum":0},"scanStartedAt":{"type":"string","format":"date-time"},"occurredAt":{"type":"string","format":"date-time"},"setNote":{"type":"string","maxLength":2000},"metadata":{"type":"object","additionalProperties":{}}},"required":["clientSessionId","locationId","scanSessionType"]},"ScanSessionHistoryListResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ScanSessionHistorySession"}},"nextCursor":{"type":["string","null"]}},"required":["items","nextCursor"]},"ScanSessionHistorySession":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"clientSessionId":{"type":"string"},"status":{"$ref":"#/components/schemas/ScanSessionHistoryStatus"},"approvalStatus":{"$ref":"#/components/schemas/ScanSessionHistoryApprovalStatus"},"approvalCheck":{"type":"object","properties":{"canApprove":{"type":"boolean"},"reasons":{"type":"array","items":{"type":"string"}}},"required":["canApprove","reasons"]},"confirmStatus":{"$ref":"#/components/schemas/ScanSessionHistoryConfirmStatus"},"appliedAt":{"type":["string","null"],"format":"date-time"},"scanSessionType":{"$ref":"#/components/schemas/ScanSessionHistoryType"},"inputMode":{"$ref":"#/components/schemas/ScanSessionHistoryInputMode"},"location":{"$ref":"#/components/schemas/ScanSessionHistoryLocation"},"eventType":{"$ref":"#/components/schemas/ScanSessionHistoryEventType"},"setType":{"$ref":"#/components/schemas/ScanSessionHistorySetType"},"setScope":{"type":"string","enum":["selected_skus","full_location"]},"setNote":{"type":["string","null"]},"expectedUploadedTagCount":{"type":["integer","null"],"minimum":0},"scanStartedAt":{"type":["string","null"],"format":"date-time"},"occurredAt":{"type":["string","null"],"format":"date-time"},"completedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"counts":{"$ref":"#/components/schemas/ScanSessionHistoryCounts"},"batches":{"$ref":"#/components/schemas/ScanSessionHistoryBatchSummary"}},"required":["id","clientSessionId","status","approvalStatus","confirmStatus","appliedAt","scanSessionType","inputMode","location","eventType","setType","setScope","setNote","expectedUploadedTagCount","scanStartedAt","occurredAt","completedAt","createdAt","updatedAt","counts","batches"]},"ScanSessionHistoryStatus":{"type":"string","enum":["creating","uploading","ready","processing","done","processing_failed"]},"ScanSessionHistoryApprovalStatus":{"type":"string","enum":["pending","blocked","approved","applied"]},"ScanSessionHistoryConfirmStatus":{"type":["string","null"],"enum":["open","confirmed","cancelled",null]},"ScanSessionHistoryType":{"type":"string","enum":["inventory_event","inventory_set"]},"ScanSessionHistoryInputMode":{"type":"string","enum":["rfid","barcode","manual","csv"]},"ScanSessionHistoryLocation":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":["string","null"]},"code":{"type":["string","null"]}},"required":["id","name","code"]},"ScanSessionHistoryEventType":{"type":["object","null"],"properties":{"code":{"type":"string"},"name":{"type":"string"},"direction":{"type":"string","enum":["in","out"]}},"required":["code","name","direction"]},"ScanSessionHistorySetType":{"type":["object","null"],"properties":{"code":{"type":"string"},"name":{"type":"string"}},"required":["code","name"]},"ScanSessionHistoryCounts":{"type":"object","properties":{"uploadedTagCount":{"type":"integer","minimum":0},"matchedSkuTagCount":{"type":"integer","minimum":0},"unmatchedTagCount":{"type":"integer","minimum":0},"quantityInputCount":{"type":"integer","minimum":0},"quantityTotal":{"type":"integer","minimum":0}},"required":["uploadedTagCount","matchedSkuTagCount","unmatchedTagCount","quantityInputCount","quantityTotal"]},"ScanSessionHistoryBatchSummary":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"done":{"type":"integer","minimum":0},"processing":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0}},"required":["total","done","processing","failed"]},"ScanUploadBatchResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"sessionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"batchIndex":{"type":"integer","minimum":0},"checksum":{"type":"string"},"observationCount":{"type":"integer","minimum":0},"processingStatus":{"type":"string","enum":["pending","processing","done","failed"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","sessionId","batchIndex","checksum","observationCount","processingStatus","createdAt"]},"ScanUploadBatchCreateRequest":{"type":"object","properties":{"batchIndex":{"type":"integer","minimum":0},"checksum":{"type":"string","minLength":1,"example":"sha256:..."},"observations":{"type":"array","items":{"$ref":"#/components/schemas/ScanUploadedTagObservation"},"minItems":1,"maxItems":1000,"description":"RFID EPC observations in this upload batch. Android should default to 500 observations per batch; the server rejects more than 1000."}},"required":["batchIndex","checksum","observations"]},"ScanUploadedTagObservation":{"type":"object","properties":{"epc":{"type":"string","minLength":1,"example":"300833B2DDD9014035050001"},"rssi":{"type":"integer"},"readCount":{"type":"integer","exclusiveMinimum":0},"scannedAt":{"type":"string","format":"date-time"}},"required":["epc","scannedAt"]},"ScanSessionQuantityInputListResponse":{"type":"object","properties":{"inputs":{"type":"array","items":{"$ref":"#/components/schemas/ScanSessionQuantityInputResponse"}}},"required":["inputs"]},"ScanSessionQuantityInputResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"sessionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"clientInputId":{"type":"string"},"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer","minimum":0},"quantityMode":{"$ref":"#/components/schemas/ScanSessionQuantityMode"},"captureMethod":{"$ref":"#/components/schemas/ScanSessionCaptureMethod"},"scannedAt":{"type":"string","format":"date-time"},"lineNo":{"type":"integer","minimum":0},"createdAt":{"type":"string","format":"date-time"}},"required":["id","sessionId","clientInputId","skuId","quantity","quantityMode","captureMethod","scannedAt","lineNo","createdAt"]},"ScanSessionQuantityMode":{"type":"string","enum":["increment","absolute"]},"ScanSessionCaptureMethod":{"type":"string","enum":["barcode","manual","csv"]},"ScanSessionQuantityInputCreateRequest":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"clientInputId":{"type":"string","minLength":1},"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer","minimum":0},"quantityMode":{"$ref":"#/components/schemas/ScanSessionQuantityMode"},"captureMethod":{"$ref":"#/components/schemas/ScanSessionCaptureMethod"},"scannedAt":{"type":"string","format":"date-time"},"lineNo":{"type":"integer","minimum":0}},"required":["clientInputId","skuId","quantity","quantityMode","captureMethod","scannedAt"]},"minItems":1,"maxItems":1000}},"required":["items"]},"ScanSessionCompleteRequest":{"type":"object","properties":{"actualUploadBatches":{"type":"integer","minimum":0},"clientChecksum":{"type":"string"}},"required":["actualUploadBatches"]},"ScanSessionConfirmSetRequest":{"type":"object","properties":{"setNote":{"type":"string","maxLength":2000},"note":{"type":"string","maxLength":2000}}},"ScanSessionHistoryDetailResponse":{"type":"object","properties":{"session":{"$ref":"#/components/schemas/ScanSessionHistorySession"},"batches":{"type":"array","items":{"$ref":"#/components/schemas/ScanSessionHistoryBatch"}},"uploadedTags":{"$ref":"#/components/schemas/ScanSessionHistoryUploadedTags"},"quantityInputs":{"$ref":"#/components/schemas/ScanSessionHistoryQuantityInputs"}},"required":["session","batches","uploadedTags","quantityInputs"]},"ScanSessionHistoryBatch":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"sessionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"batchIndex":{"type":"integer","minimum":0},"checksum":{"type":"string"},"observationCount":{"type":"integer","minimum":0},"processingStatus":{"type":"string","enum":["pending","processing","done","failed"]},"createdAt":{"type":"string","format":"date-time"}},"required":["id","sessionId","batchIndex","checksum","observationCount","processingStatus","createdAt"]},"ScanSessionHistoryUploadedTags":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ScanSessionHistoryUploadedTag"}},"totalCount":{"type":"integer","minimum":0},"page":{"type":"integer","exclusiveMinimum":0},"pageSize":{"type":"integer","exclusiveMinimum":0},"search":{"type":"string"},"filter":{"type":"string","enum":["all","unmatched"]},"sortBy":{"type":"string","enum":["epc","sku","readCount","status","rssi","scannedAt"]},"sortOrder":{"type":"string","enum":["asc","desc"]}},"required":["items","totalCount","page","pageSize","search","filter","sortBy","sortOrder"]},"ScanSessionHistoryUploadedTag":{"type":"object","properties":{"epc":{"type":"string"},"referenceSku":{"$ref":"#/components/schemas/ScanSessionHistoryReferenceSku"},"sku":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":["string","null"]},"name":{"type":"string"}},"required":["id","code","name"]},"readCount":{"type":["integer","null"],"exclusiveMinimum":0},"rssi":{"type":["integer","null"]},"tagStatus":{"type":["string","null"],"enum":["in_stock","out","sold","missing",null]},"scannedAt":{"type":"string","format":"date-time"}},"required":["epc","sku","readCount","rssi","tagStatus","scannedAt"]},"ScanSessionHistoryReferenceSku":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"productId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}},"imageObjectKey":{"type":["string","null"]},"imageUpdatedAt":{"type":["string","null"],"format":"date-time"},"imageUrl":{"type":["string","null"]},"updatedAt":{"type":["string","null"],"format":"date-time"},"deletedAt":{"type":["string","null"],"format":"date-time"},"isActive":{"type":"boolean"}},"required":["id","productId","name","code","options","optionItems","imageObjectKey","imageUpdatedAt","imageUrl","updatedAt","deletedAt","isActive"]},"ScanSessionHistoryQuantityInputs":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ScanSessionHistoryQuantityInput"}},"totalCount":{"type":"integer","minimum":0},"page":{"type":"integer","exclusiveMinimum":0},"pageSize":{"type":"integer","exclusiveMinimum":0}},"required":["items","totalCount","page","pageSize"]},"ScanSessionHistoryQuantityInput":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"sessionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"clientInputId":{"type":"string"},"sku":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":["string","null"]},"name":{"type":"string"}},"required":["id","code","name"]},"quantity":{"type":"integer","minimum":0},"quantityMode":{"type":"string","enum":["increment","absolute"]},"captureMethod":{"type":"string","enum":["barcode","manual","csv"]},"scannedAt":{"type":"string","format":"date-time"},"lineNo":{"type":"integer","minimum":0}},"required":["id","sessionId","clientInputId","sku","quantity","quantityMode","captureMethod","scannedAt","lineNo"]},"InventoryEventTypeListResponse":{"type":"object","properties":{"eventTypes":{"type":"array","items":{"$ref":"#/components/schemas/InventoryEventTypeResponse"}}},"required":["eventTypes"]},"InventoryEventTypeResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"$ref":"#/components/schemas/EventTypeCode"},"name":{"type":"string"},"direction":{"$ref":"#/components/schemas/InventoryEventDirection"},"scope":{"type":"string","enum":["system","organization"]},"isDefault":{"type":"boolean"}},"required":["id","code","name","direction","scope","isDefault"]},"InventorySetTypeListResponse":{"type":"object","properties":{"setTypes":{"type":"array","items":{"$ref":"#/components/schemas/InventorySetTypeResponse"}}},"required":["setTypes"]},"InventorySetTypeResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"$ref":"#/components/schemas/EventTypeCode"},"name":{"type":"string"},"scope":{"type":"string","enum":["system","organization"]},"isDefault":{"type":"boolean"}},"required":["id","code","name","scope","isDefault"]},"InventoryEventResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"originEventKey":{"type":"string"},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"eventTypeCode":{"$ref":"#/components/schemas/EventTypeCode"},"eventTypeName":{"type":"string"},"eventTypeDirection":{"$ref":"#/components/schemas/InventoryEventDirection"},"skuQtyLineCount":{"type":"integer","minimum":0},"createdAt":{"type":"string","format":"date-time"}},"required":["id","originEventKey","locationId","eventTypeCode","eventTypeName","eventTypeDirection","skuQtyLineCount","createdAt"]},"InventoryEventCreateRequest":{"type":"object","properties":{"originEventKey":{"type":"string","minLength":1,"example":"device-2026-06-13-0001"},"eventTypeCode":{"allOf":[{"$ref":"#/components/schemas/EventTypeCode"},{"description":"Public inventory event type code. Built-ins use IN_/OUT_ prefixes; custom organization types use IN_C_/OUT_C_ prefixes."}]},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"occurredAt":{"type":"string","format":"date-time"},"metadata":{"$ref":"#/components/schemas/InventoryEventMetadata"},"items":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer","exclusiveMinimum":0,"description":"event type direction은 in/out이며 quantity는 1 이상."}},"required":["skuId","quantity"]},"minItems":1}},"required":["originEventKey","eventTypeCode","locationId","items"]},"InventoryEventMetadata":{"type":"object","properties":{"captureMethod":{"type":"string","enum":["rfid","barcode","manual","csv"]},"reason":{"type":"string"},"note":{"type":"string"},"externalRef":{"type":"string"},"sourceFile":{"type":"object","properties":{"name":{"type":"string"},"rowNumber":{"type":"integer","exclusiveMinimum":0}}},"reader":{"type":"object","properties":{"model":{"type":"string"},"connection":{"type":"string"}}},"extra":{"type":"object","additionalProperties":{}}},"additionalProperties":{}},"InventoryStatusResponse":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"childCount":{"type":"integer","minimum":0},"leafLocationIds":{"type":"array","items":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"}},"skuCount":{"type":"integer","minimum":0},"totalQuantity":{"type":"integer"},"averageQuantityPerSku":{"type":"number"}},"required":["id","name","code","childCount","leafLocationIds","skuCount","totalQuantity","averageQuantityPerSku"]}},"summary":{"type":"object","properties":{"skuCount":{"type":"integer","minimum":0},"totalQuantity":{"type":"integer"},"averageQuantityPerSku":{"type":"number"}},"required":["skuCount","totalQuantity","averageQuantityPerSku"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"name":{"type":"string"},"barcode":{"type":["string","null"]},"unit":{"type":["string","null"]},"product":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"brand":{"type":["string","null"]}},"required":["id","name","brand"]},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}},"totalQuantity":{"type":"integer"},"locationQuantities":{"type":"object","additionalProperties":{"type":"integer"}}},"required":["id","code","skuCode","name","barcode","unit","product","options","optionItems","totalQuantity","locationQuantities"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["locations","summary","items","page"]},"InventoryStatusSkuDetailResponse":{"type":"object","properties":{"sku":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"name":{"type":"string"},"barcode":{"type":["string","null"]},"unit":{"type":["string","null"]},"product":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"brand":{"type":["string","null"]}},"required":["id","name","brand"]},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}}},"required":["id","code","skuCode","name","barcode","unit","product","options","optionItems"]},"selectedQuantity":{"type":"integer"},"totalQuantity":{"type":"integer"},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"parentId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer"},"freshness":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["clean","dirty","rebuilding","failed"]},"lastReplayedAt":{"type":["string","null"],"format":"date-time"},"lastSourceKind":{"type":"string","enum":["event","set_item","initial","rebuild"]}},"required":["status","lastReplayedAt","lastSourceKind"]}},"required":["id","name","code","parentId","quantity","freshness"]}}},"required":["sku","selectedQuantity","totalQuantity","locations"]},"InventoryStatusSkuHistoryResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["movement","set"]},"occurredAt":{"type":"string","format":"date-time"},"direction":{"type":"string","enum":["in","out","none"]},"quantity":{"type":"integer","minimum":0},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"locationName":{"type":["string","null"]},"locationCode":{"type":["string","null"]},"eventId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"eventTypeCode":{"type":["string","null"]},"eventTypeName":{"type":["string","null"]},"setSessionId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"setTypeCode":{"type":["string","null"]},"observedQuantity":{"type":["integer","null"],"minimum":0},"note":{"type":["string","null"]}},"required":["kind","occurredAt","direction","quantity","locationId","locationName","locationCode","eventId","eventTypeCode","eventTypeName","setSessionId","setTypeCode","observedQuantity","note"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["items","page"]},"CreateStockRequestResponse":{"type":"object","properties":{"submissionGroupId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"items":{"type":"array","items":{"$ref":"#/components/schemas/StockRequestItem"}},"meta":{"type":"object","properties":{"serverTime":{"type":"string","format":"date-time"},"organizationTimeZone":{"type":"string"}},"required":["serverTime","organizationTimeZone"]}},"required":["submissionGroupId","items","meta"]},"StockRequestItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"submissionGroupId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"sku":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"productName":{"type":"string"},"variantText":{"type":["string","null"]}},"required":["id","code","productName","variantText"]},"quantity":{"type":"integer","minimum":1,"maximum":9999},"location":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"label":{"type":"string"}},"required":["id","label"]},"requestedBy":{"type":"object","properties":{"id":{"type":["string","null"],"minLength":1},"name":{"type":"string"}},"required":["id","name"]},"requestedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["pending","planned","reviewing","sent","not_sent","cancelled"]},"requesterMemo":{"type":["string","null"]},"canCancel":{"type":"boolean"},"adminMemo":{"type":["string","null"]},"statusChangedAt":{"type":"string","format":"date-time"},"lastStatusChange":{"type":["object","null"],"properties":{"actorId":{"type":["string","null"]},"actorName":{"type":["string","null"]},"at":{"type":"string","format":"date-time"}},"required":["actorId","actorName","at"]},"closedAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"version":{"type":"integer","exclusiveMinimum":0},"mine":{"type":"boolean"}},"required":["id","submissionGroupId","sku","quantity","location","requestedBy","requestedAt","status","requesterMemo","adminMemo","statusChangedAt","lastStatusChange","closedAt","updatedAt","version","mine"]},"CreateStockRequestBody":{"type":"object","properties":{"clientRequestId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","example":"550e8400-e29b-41d4-a716-446655440000"},"submissionKey":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","example":"550e8400-e29b-41d4-a716-446655440000"},"requesterMemo":{"type":["string","null"]},"workLocationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"items":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer","minimum":1,"maximum":9999}},"required":["skuId","quantity"]},"minItems":1,"maxItems":50}},"required":["workLocationId","items"]},"StockRequestListResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/StockRequestItem"}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]},"totalCount":{"type":"integer","minimum":0}},"required":["nextCursor","totalCount"]},"meta":{"type":"object","properties":{"serverTime":{"type":"string","format":"date-time"},"organizationTimeZone":{"type":"string"},"activeOldCutoff":{"type":"string","format":"date-time"},"closedRetentionCutoff":{"type":"string","format":"date-time"},"counts":{"type":"object","properties":{"olderActive":{"type":"integer","minimum":0}},"required":["olderActive"]}},"required":["serverTime","organizationTimeZone","activeOldCutoff","closedRetentionCutoff","counts"]}},"required":["items","page","meta"]},"StockRequestActiveDuplicatesResponse":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"activeCount":{"type":"integer","minimum":0},"latest":{"type":["object","null"],"properties":{"requesterName":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":9999},"requestedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["pending","planned","reviewing","sent","not_sent","cancelled"]}},"required":["requesterName","quantity","requestedAt","status"]}},"required":["skuId","activeCount","latest"]}}},"required":["results"]},"StockRequestActiveDuplicatesBody":{"type":"object","properties":{"workLocationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"skuIds":{"type":"array","items":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"minItems":1,"maxItems":100}},"required":["workLocationId","skuIds"]},"StockRequestQuantityCommandBody":{"type":"object","properties":{"clientCommandId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","example":"550e8400-e29b-41d4-a716-446655440000"},"expectedVersion":{"type":"integer","exclusiveMinimum":0},"quantity":{"type":"integer","minimum":1,"maximum":9999}},"required":["clientCommandId","expectedVersion","quantity"]},"StockRequestCancelCommandBody":{"type":"object","properties":{"clientCommandId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i","example":"550e8400-e29b-41d4-a716-446655440000"},"expectedVersion":{"type":"integer","exclusiveMinimum":0}},"required":["clientCommandId","expectedVersion"]},"SkuListResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/SkuListItemResponse"}},"page":{"$ref":"#/components/schemas/SkuListPageResponse"}},"required":["items","page"]},"SkuListItemResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"rfidNo":{"type":"integer","exclusiveMinimum":0},"name":{"type":"string"},"barcode":{"type":["string","null"]},"unit":{"type":["string","null"]},"isActive":{"type":"boolean"},"imageUrl":{"type":["string","null"]},"product":{"$ref":"#/components/schemas/SkuProductResponse"},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}},"inventory":{"$ref":"#/components/schemas/SkuInventoryResponse"}},"required":["id","code","skuCode","rfidNo","name","barcode","unit","isActive","imageUrl","product","options","optionItems","inventory"]},"SkuProductResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"brand":{"type":["string","null"]}},"required":["id","name","brand"]},"SkuInventoryResponse":{"type":["object","null"],"properties":{"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer"}},"required":["locationId","quantity"]},"SkuListPageResponse":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]},"SkuIdentityCatalogResponse":{"type":"object","properties":{"organizationNamespace":{"type":"integer","minimum":1,"maximum":65535},"environmentPrefix":{"type":"string","pattern":"^[0-9A-F]{4}$"},"catalogRevision":{"type":"string"},"snapshotRevision":{"type":"string"},"items":{"type":"array","items":{"$ref":"#/components/schemas/SkuIdentityCatalogItemResponse"}},"page":{"$ref":"#/components/schemas/SkuListPageResponse"}},"required":["organizationNamespace","environmentPrefix","catalogRevision","snapshotRevision","items","page"]},"SkuIdentityCatalogItemResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"rfidNo":{"type":"integer","exclusiveMinimum":0},"name":{"type":"string"},"barcode":{"type":["string","null"]},"unit":{"type":["string","null"]},"isActive":{"type":"boolean"},"imageUrl":{"type":["string","null"]},"product":{"$ref":"#/components/schemas/SkuProductResponse"},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}}},"required":["id","code","skuCode","rfidNo","name","barcode","unit","isActive","imageUrl","product","options","optionItems"]},"EpcCatalogManifest":{"type":"object","properties":{"schemaVersion":{"type":"number","enum":[1]},"interpreterVersion":{"type":"number","enum":[1]},"bundleRevision":{"type":"string","maxLength":80,"pattern":"^epc-bundle-[1-9]\\d{0,18}$"},"environmentPrefix":{"type":"string"},"organizationNamespace":{"type":"integer","exclusiveMinimum":0},"allowedFormatIds":{"type":"array","items":{"type":"string"},"maxItems":64},"identityCount":{"type":"integer","minimum":0},"formatCount":{"type":"integer","minimum":1,"maximum":64},"capabilities":{"type":"array","items":{"type":"string"}}},"required":["schemaVersion","interpreterVersion","bundleRevision","environmentPrefix","organizationNamespace","allowedFormatIds","identityCount","formatCount","capabilities"]},"EpcCatalogFormats":{"type":"object","properties":{"bundleRevision":{"type":"string","maxLength":80,"pattern":"^epc-bundle-[1-9]\\d{0,18}$"},"formats":{"type":"array","items":{"$ref":"#/components/schemas/EpcFormatDefinition"},"maxItems":64}},"required":["bundleRevision","formats"]},"EpcFormatDefinition":{"type":"object","properties":{"formatId":{"type":"string"},"version":{"type":"integer","exclusiveMinimum":0},"displayName":{"type":"string"},"rule":{"type":"object","properties":{"interpreterVersion":{"type":"number","enum":[1]},"predicates":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"op":{"type":"string","enum":["bit_length"]},"value":{"type":"integer","minimum":8,"maximum":1024}},"required":["op","value"]},{"type":"object","properties":{"op":{"type":"string","enum":["equals"]},"offsetBits":{"type":"integer","minimum":0,"maximum":1023},"lengthBits":{"type":"integer","minimum":1,"maximum":128},"value":{"type":"string","pattern":"^[0-9A-F]+$"}},"required":["op","offsetBits","lengthBits","value"]},{"type":"object","properties":{"op":{"type":"string","enum":["context"]},"offsetBits":{"type":"integer","minimum":0,"maximum":1023},"lengthBits":{"type":"integer","minimum":1,"maximum":128},"field":{"type":"string","enum":["environmentPrefix","organizationNamespace"]}},"required":["op","offsetBits","lengthBits","field"]},{"type":"object","properties":{"op":{"type":"string","enum":["decimal_digits"]},"offsetBits":{"type":"integer","minimum":0,"maximum":1023},"lengthBits":{"type":"integer","minimum":1,"maximum":128}},"required":["op","offsetBits","lengthBits"]},{"type":"object","properties":{"op":{"type":"string","enum":["nonzero"]},"offsetBits":{"type":"integer","minimum":0,"maximum":1023},"lengthBits":{"type":"integer","minimum":1,"maximum":128}},"required":["op","offsetBits","lengthBits"]},{"type":"object","properties":{"op":{"type":"string","enum":["not_reserved"]}},"required":["op"]}]},"minItems":1,"maxItems":16},"identity":{"type":"object","properties":{"offsetBits":{"type":"integer","minimum":0,"maximum":1023},"lengthBits":{"type":"integer","minimum":1,"maximum":128},"encoding":{"type":"string","enum":["uint_be","decimal_digits","hex_upper"]},"minValue":{"type":"string"},"maxValue":{"type":"string"}},"required":["offsetBits","lengthBits","encoding"]}},"required":["interpreterVersion","predicates","identity"]}},"required":["formatId","version","displayName","rule"]},"EpcCatalogIdentities":{"type":"object","properties":{"bundleRevision":{"type":"string","maxLength":80,"pattern":"^epc-bundle-[1-9]\\d{0,18}$"},"items":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","format":"uuid"},"skuCode":{"type":"string"},"name":{"type":"string"},"isActive":{"type":"boolean","enum":[true]},"rfidIdentities":{"type":"array","items":{"type":"object","properties":{"formatId":{"type":"string"},"value":{"type":"string"}},"required":["formatId","value"]}}},"required":["skuId","skuCode","name","isActive","rfidIdentities"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["bundleRevision","items","page"]},"LocationListResponse":{"type":"object","properties":{"locations":{"type":"array","items":{"$ref":"#/components/schemas/LocationResponse"}}},"required":["locations"]},"LocationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"type":{"$ref":"#/components/schemas/LocationType"},"trackingMode":{"$ref":"#/components/schemas/LocationTrackingMode"},"parentId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"parentName":{"type":["string","null"]},"nodeKind":{"$ref":"#/components/schemas/LocationNodeKind"},"systemRole":{"$ref":"#/components/schemas/LocationSystemRole"},"sortOrder":{"type":"integer"},"depth":{"type":"integer","minimum":0},"pathIds":{"type":"array","items":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"}},"pathNames":{"type":"array","items":{"type":"string"}},"displayPath":{"type":"string"},"isLeaf":{"type":"boolean"},"childCount":{"type":"integer","minimum":0},"selectable":{"type":"boolean"},"isPopupTemp":{"type":"boolean"},"address":{"type":["string","null"]},"addressDetail":{"type":["string","null"]},"zonecode":{"type":["string","null"]},"roadAddress":{"type":["string","null"]},"jibunAddress":{"type":["string","null"]},"latitude":{"type":["number","null"]},"longitude":{"type":["number","null"]},"phone":{"type":["string","null"]},"contactName":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/LocationStatus"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","code","type","trackingMode","parentId","parentName","nodeKind","systemRole","sortOrder","depth","pathIds","pathNames","displayPath","isLeaf","childCount","selectable","isPopupTemp","address","addressDetail","zonecode","roadAddress","jibunAddress","latitude","longitude","phone","contactName","status","updatedAt"]},"LocationType":{"type":"string","enum":["warehouse","store"]},"LocationTrackingMode":{"type":"string","enum":["epc","quantity"]},"LocationNodeKind":{"type":"string","enum":["location","section"]},"LocationSystemRole":{"type":["string","null"],"enum":["default","unclassified",null]},"LocationStatus":{"type":"string","enum":["active","inactive"]},"RfidTagSkuBulkResolveResponse":{"type":"object","properties":{"summary":{"type":"object","properties":{"requestedEpcCount":{"type":"integer","exclusiveMinimum":0},"uniqueEpcCount":{"type":"integer","exclusiveMinimum":0},"matchedEpcCount":{"type":"integer","minimum":0},"unmatchedEpcCount":{"type":"integer","minimum":0},"skuGroupCount":{"type":"integer","minimum":0}},"required":["requestedEpcCount","uniqueEpcCount","matchedEpcCount","unmatchedEpcCount","skuGroupCount"]},"skuGroups":{"type":"array","items":{"$ref":"#/components/schemas/RfidTagSkuGroup"}},"unmatchedEpcs":{"type":"array","items":{"type":"string"}}},"required":["summary","skuGroups","unmatchedEpcs"]},"RfidTagSkuGroup":{"type":"object","properties":{"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"skuCode":{"type":["string","null"]},"skuName":{"type":"string"},"productName":{"type":"string"},"brand":{"type":["string","null"]},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}},"uniqueEpcCount":{"type":"integer","exclusiveMinimum":0},"epcs":{"type":"array","items":{"type":"string"}}},"required":["skuId","skuCode","skuName","productName","brand","options","optionItems","uniqueEpcCount","epcs"]},"RfidTagSkuBulkResolveRequest":{"type":"object","properties":{"epcs":{"type":"array","items":{"type":"string","maxLength":256},"minItems":1,"maxItems":500}},"required":["epcs"]},"RfidTagSkuListResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"epc":{"type":"string"},"tid":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/RfidTagStatus"},"provisionMethod":{"$ref":"#/components/schemas/RfidTagProvisionMethod"},"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"currentLocationId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"locationName":{"type":["string","null"]},"locationCode":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"],"format":"date-time"},"conflictFlag":{"type":"boolean"},"mappedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","epc","tid","status","provisionMethod","skuId","currentLocationId","locationName","locationCode","lastSeenAt","conflictFlag","mappedAt","createdAt","updatedAt"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["items","page"]},"RfidTagStatus":{"type":"string","enum":["in_stock","out","sold","missing"]},"RfidTagProvisionMethod":{"type":"string","enum":["pre_mapped","unmapped","self_printed","discovered"]},"RfidTagDetailResponse":{"type":"object","properties":{"epc":{"type":"string"},"tag":{"$ref":"#/components/schemas/RfidTagDetailMaster"},"history":{"type":"array","items":{"$ref":"#/components/schemas/RfidTagScanHistoryItem"}}},"required":["epc","tag","history"]},"RfidTagDetailMaster":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"epc":{"type":"string"},"tid":{"type":["string","null"]},"status":{"$ref":"#/components/schemas/RfidTagStatus"},"provisionMethod":{"$ref":"#/components/schemas/RfidTagProvisionMethod"},"skuId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"skuCode":{"type":["string","null"]},"skuName":{"type":["string","null"]},"currentLocationId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"locationName":{"type":["string","null"]},"lastSeenAt":{"type":["string","null"],"format":"date-time"},"mappedAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":["string","null"],"format":"date-time"},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","epc","tid","status","provisionMethod","skuId","skuCode","skuName","currentLocationId","locationName","lastSeenAt","mappedAt","createdAt","updatedAt"]},"RfidTagScanHistoryItem":{"type":"object","properties":{"uploadedTagId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"sessionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"epc":{"type":"string"},"scannedAt":{"type":"string","format":"date-time"},"readCount":{"type":["integer","null"]},"rssi":{"type":["integer","null"]},"sessionStatus":{"$ref":"#/components/schemas/RfidTagHistorySessionStatus"},"approvalStatus":{"$ref":"#/components/schemas/RfidTagHistoryApprovalStatus"},"eventTypeName":{"type":["string","null"]},"eventTypeCode":{"type":["string","null"]},"eventTypeDirection":{"$ref":"#/components/schemas/RfidTagHistoryDirection"},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"locationName":{"type":["string","null"]},"locationCode":{"type":["string","null"]}},"required":["uploadedTagId","sessionId","epc","scannedAt","readCount","rssi","sessionStatus","approvalStatus","eventTypeName","eventTypeCode","eventTypeDirection","locationId","locationName","locationCode"]},"RfidTagHistorySessionStatus":{"type":"string","enum":["creating","uploading","ready","processing","done","processing_failed"]},"RfidTagHistoryApprovalStatus":{"type":"string","enum":["pending","blocked","approved","applied"]},"RfidTagHistoryDirection":{"type":["string","null"],"enum":["in","out",null]},"EpcSerialReservationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"environmentPrefix":{"type":"string","pattern":"^[0-9A-F]{4}$"},"organizationNamespace":{"type":"integer","minimum":1,"maximum":65535},"skuId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"rfidNo":{"type":["integer","null"],"exclusiveMinimum":0},"serialStart":{"type":"integer","exclusiveMinimum":0},"serialEnd":{"type":"integer","exclusiveMinimum":0},"clientId":{"type":"string"},"idempotencyKey":{"type":"string"},"expiresAt":{"type":["string","null"],"format":"date-time"},"createdAt":{"type":"string","format":"date-time"}},"required":["id","environmentPrefix","organizationNamespace","skuId","rfidNo","serialStart","serialEnd","clientId","idempotencyKey","expiresAt","createdAt"]},"CreateEpcSerialReservationRequest":{"type":"object","properties":{"clientId":{"type":"string","minLength":1,"maxLength":100},"idempotencyKey":{"type":"string","minLength":1,"maxLength":200},"quantity":{"type":"integer","minimum":1,"maximum":1000000},"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"expiresInSeconds":{"type":"integer","minimum":60,"maximum":2592000}},"required":["clientId","idempotencyKey","quantity"]},"TagPrintOrderCreateRequest":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","properties":{"skuId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer","exclusiveMinimum":0},"layoutKey":{"$ref":"#/components/schemas/TagPrintLayoutKey"},"layoutVersion":{"type":"integer","exclusiveMinimum":0},"layoutHash":{"type":"string","minLength":1},"tagSize":{"$ref":"#/components/schemas/TagPrintLabelSize"},"lot":{"type":["string","null"],"minLength":1},"labelFields":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["skuId","quantity"]},"minItems":1}},"required":["lines"]},"TagPrintLayoutKey":{"type":"string","enum":["73x20_default","50x40_default","33x19_default","54x33_price","54x33_no_price","54x33_black_price"]},"TagPrintLabelSize":{"type":"string","enum":["73x20mm","50x40mm","33x19mm","54x33mm"]},"PushInstallationResponse":{"type":"object","properties":{"installationId":{"type":"string"},"recipientBindingId":{"type":["string","null"],"format":"uuid"},"installationRevision":{"type":"integer","minimum":0},"enabled":{"type":"boolean"},"updatedAt":{"type":"string","format":"date-time"}},"required":["installationId","recipientBindingId","installationRevision","enabled","updatedAt"]},"PushInstallationBody":{"type":"object","properties":{"installationId":{"type":"string","minLength":1,"maxLength":256},"targetType":{"type":"string","enum":["fid","fcm_registration_token"]},"target":{"type":"string","minLength":1,"maxLength":4096},"appIdOrBundleId":{"type":"string","minLength":1,"maxLength":256},"appVersion":{"type":["string","null"],"minLength":1,"maxLength":64},"locale":{"type":["string","null"],"minLength":2,"maxLength":32},"enabled":{"type":"boolean","default":true},"recipientBindingId":{"type":"string","format":"uuid"},"installationRevision":{"type":"integer","exclusiveMinimum":0}},"required":["installationId","targetType","target","appIdOrBundleId"]},"NotificationInboxListResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/NotificationInboxItem"}},"nextCursor":{"type":["string","null"]},"unreadCount":{"type":"integer","minimum":0},"inboxRevision":{"type":"integer","minimum":0},"serverTime":{"type":"string","format":"date-time"}},"required":["items","nextCursor","unreadCount","inboxRevision","serverTime"]},"NotificationInboxItem":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"eventId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"organizationId":{"type":"string","minLength":1},"requestId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"requestVersion":{"type":"integer","exclusiveMinimum":0},"organizationName":{"type":"string"},"productName":{"type":"string"},"locationLabel":{"type":"string"},"visibleStatus":{"type":"string"},"transitionKind":{"type":"string","enum":["sent"]},"occurredAt":{"type":"string","format":"date-time"},"deliveryExpiresAt":{"type":"string","format":"date-time"},"read":{"type":"boolean"}},"required":["id","eventId","organizationId","requestId","requestVersion","organizationName","productName","locationLabel","visibleStatus","occurredAt","deliveryExpiresAt","read"]},"NotificationInboxUnreadCountResponse":{"type":"object","properties":{"unreadCount":{"type":"integer","minimum":0},"inboxRevision":{"type":"integer","minimum":0},"serverTime":{"type":"string","format":"date-time"}},"required":["unreadCount","inboxRevision","serverTime"]},"NotificationInboxSyncResponse":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/NotificationInboxItem"}},"replaceAll":{"type":"boolean","enum":[true]},"retentionCutoff":{"type":"string","format":"date-time"},"unreadCount":{"type":"integer","minimum":0},"inboxRevision":{"type":"integer","minimum":0},"serverTime":{"type":"string","format":"date-time"}},"required":["items","replaceAll","retentionCutoff","unreadCount","inboxRevision","serverTime"]},"NotificationInboxTargetResponse":{"type":"object","properties":{"notification":{"$ref":"#/components/schemas/NotificationInboxItem"},"request":{"allOf":[{"$ref":"#/components/schemas/StockRequestItem"},{"type":["object","null"]}]},"unavailable":{"type":"boolean"},"serverTime":{"type":"string","format":"date-time"}},"required":["notification","request","unavailable","serverTime"]},"NotificationInboxReadThroughResponse":{"type":"object","properties":{"appliedThroughVersion":{"type":"integer","minimum":0},"unreadCount":{"type":"integer","minimum":0},"inboxRevision":{"type":"integer","minimum":0},"serverTime":{"type":"string","format":"date-time"}},"required":["appliedThroughVersion","unreadCount","inboxRevision","serverTime"]},"NotificationInboxReadThroughBody":{"type":"object","properties":{"throughVersion":{"type":"integer","exclusiveMinimum":0}},"required":["throughVersion"]},"ExternalWorkspaceResponse":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"scope":{"type":"string","enum":["read"]}},"required":["workspace","scope"]},"ExternalLocationListResponse":{"type":"object","properties":{"locations":{"type":"array","items":{"$ref":"#/components/schemas/ExternalLocationResponse"}}},"required":["locations"]},"ExternalLocationResponse":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"parentId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"parentName":{"type":["string","null"]},"nodeKind":{"type":"string","enum":["location","section"]},"depth":{"type":"integer","minimum":0},"pathIds":{"type":"array","items":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"}},"pathNames":{"type":"array","items":{"type":"string"}},"displayPath":{"type":"string"},"isLeaf":{"type":"boolean"},"childCount":{"type":"integer","minimum":0},"selectable":{"type":"boolean"},"status":{"type":"string","enum":["active","inactive"]},"updatedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","code","parentId","parentName","nodeKind","depth","pathIds","pathNames","displayPath","isLeaf","childCount","selectable","status","updatedAt"]},"ExternalInventoryStatusResponse":{"type":"object","properties":{"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"childCount":{"type":"integer","minimum":0},"leafLocationIds":{"type":"array","items":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"}},"skuCount":{"type":"integer","minimum":0},"totalQuantity":{"type":"integer"},"averageQuantityPerSku":{"type":"number"}},"required":["id","name","code","childCount","leafLocationIds","skuCount","totalQuantity","averageQuantityPerSku"]}},"summary":{"type":"object","properties":{"skuCount":{"type":"integer","minimum":0},"totalQuantity":{"type":"integer"},"averageQuantityPerSku":{"type":"number"}},"required":["skuCount","totalQuantity","averageQuantityPerSku"]},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"name":{"type":"string"},"barcode":{"type":["string","null"]},"unit":{"type":["string","null"]},"product":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"brand":{"type":["string","null"]}},"required":["id","name","brand"]},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}},"totalQuantity":{"type":"integer"},"locationQuantities":{"type":"object","additionalProperties":{"type":"integer"}}},"required":["id","code","skuCode","name","barcode","unit","product","options","optionItems","totalQuantity","locationQuantities"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["locations","summary","items","page"]},"ExternalInventoryStatusSkuHistoryResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"kind":{"type":"string","enum":["movement","set"]},"occurredAt":{"type":"string","format":"date-time"},"direction":{"type":"string","enum":["in","out","none"]},"quantity":{"type":"integer","minimum":0},"locationId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"locationName":{"type":["string","null"]},"locationCode":{"type":["string","null"]},"eventId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"eventTypeCode":{"type":["string","null"]},"eventTypeName":{"type":["string","null"]},"setSessionId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"setTypeCode":{"type":["string","null"]},"observedQuantity":{"type":["integer","null"],"minimum":0},"note":{"type":["string","null"]}},"required":["kind","occurredAt","direction","quantity","locationId","locationName","locationCode","eventId","eventTypeCode","eventTypeName","setSessionId","setTypeCode","observedQuantity","note"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["items","page"]},"ExternalInventoryStatusSkuDetailResponse":{"type":"object","properties":{"sku":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"name":{"type":"string"},"barcode":{"type":["string","null"]},"unit":{"type":["string","null"]},"product":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"brand":{"type":["string","null"]}},"required":["id","name","brand"]},"options":{"type":"object","additionalProperties":{"type":"string"}},"optionItems":{"type":"array","items":{"type":"object","properties":{"definitionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"value":{"type":"string"},"position":{"type":"integer"}},"required":["definitionId","name","value","position"]}}},"required":["id","code","skuCode","name","barcode","unit","product","options","optionItems"]},"selectedQuantity":{"type":"integer"},"totalQuantity":{"type":"integer"},"locations":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"parentId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"quantity":{"type":"integer"},"freshness":{"type":["object","null"],"properties":{"status":{"type":"string","enum":["clean","dirty","rebuilding","failed"]},"lastReplayedAt":{"type":["string","null"],"format":"date-time"},"lastSourceKind":{"type":"string","enum":["event","set_item","initial","rebuild"]}},"required":["status","lastReplayedAt","lastSourceKind"]}},"required":["id","name","code","parentId","quantity","freshness"]}}},"required":["sku","selectedQuantity","totalQuantity","locations"]},"ExternalInventoryEventsResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"eventType":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"},"direction":{"type":"string","enum":["in","out"]},"isCustom":{"type":"boolean"}},"required":["code","name","direction","isCustom"]},"location":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"deletedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","code","deletedAt"]},"occurredAt":{"type":"string","format":"date-time"},"recordedAt":{"type":"string","format":"date-time"},"actorUserId":{"type":["string","null"]},"scanSessionId":{"type":["string","null"],"format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"device":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"model":{"type":["string","null"]}},"required":["id","name","model"]},"lineMode":{"type":"string","enum":["epc","sku_quantity"]},"lineCount":{"type":"integer","minimum":0},"totalQuantity":{"type":"integer","minimum":0}},"required":["id","eventType","location","occurredAt","recordedAt","actorUserId","scanSessionId","device","lineMode","lineCount","totalQuantity"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["items","page"]},"ExternalInventoryEventLinesResponse":{"type":"object","properties":{"eventId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"lineMode":{"type":"string","enum":["epc","sku_quantity"]},"items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"name":{"type":"string"}},"required":["id","code","name"]},"quantity":{"type":"integer","minimum":0}},"required":["sku","quantity"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["eventId","lineMode","items","page"]},"ExternalInventoryCountsResponse":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"scanSessionId":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"countType":{"type":"object","properties":{"code":{"type":"string"},"name":{"type":"string"}},"required":["code","name"]},"scope":{"type":"string","enum":["selected_skus","full_location"]},"inputMode":{"type":"string","enum":["rfid","barcode","manual","csv"]},"location":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"code":{"type":["string","null"]},"deletedAt":{"type":["string","null"],"format":"date-time"}},"required":["id","name","code","deletedAt"]},"sku":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"code":{"type":"string"},"skuCode":{"type":["string","null"]},"name":{"type":"string"}},"required":["id","code","skuCode","name"]},"observedQuantity":{"type":"integer","minimum":0},"bookQuantityBefore":{"type":"integer"},"varianceQuantity":{"type":"integer"},"varianceDirection":{"type":"string","enum":["in","out","none"]},"note":{"type":["string","null"]},"occurredAt":{"type":"string","format":"date-time"},"confirmedAt":{"type":["string","null"],"format":"date-time"},"recordedAt":{"type":"string","format":"date-time"},"actorUserId":{"type":"string"},"approvedByUserId":{"type":["string","null"]},"device":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"name":{"type":"string"},"model":{"type":["string","null"]}},"required":["id","name","model"]}},"required":["id","scanSessionId","countType","scope","inputMode","location","sku","observedQuantity","bookQuantityBefore","varianceQuantity","varianceDirection","note","occurredAt","confirmedAt","recordedAt","actorUserId","approvedByUserId","device"]}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}},"required":["nextCursor"]}},"required":["items","page"]}},"parameters":{},"securitySchemes":{"workspaceBearerAuth":{"type":"http","scheme":"bearer","description":"Superfid workspace developer key"}}},"tags":[{"name":"external-inventory","description":"workspace developer key 기반 고객 외부 API 계약"}],"paths":{"/v1/external/workspace":{"get":{"tags":["external-inventory"],"summary":"외부 연동 workspace 연결 확인","responses":{"200":{"description":"workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalWorkspaceResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace token service unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/locations":{"get":{"tags":["external-inventory"],"summary":"외부 연동 workspace 위치 목록","responses":{"200":{"description":"locations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalLocationListResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace API unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/inventory-status":{"get":{"tags":["external-inventory"],"summary":"외부 연동 workspace 재고현황","parameters":[{"schema":{"type":"string"},"required":false,"name":"scopeLocationId","in":"query"},{"schema":{"type":"string"},"required":false,"name":"q","in":"query"},{"schema":{"type":"string","enum":["all","in_stock","empty"]},"required":false,"name":"stockState","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"inventory status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInventoryStatusResponse"}}}},"400":{"description":"invalid query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"location scope not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace inventory unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/inventory-status/{skuId}/history":{"get":{"tags":["external-inventory"],"summary":"외부 연동 SKU 재고 변동 이력","description":"특정 SKU의 movement와 확정된 SET을 occurredAt 기준 내림차순으로 반환합니다. SET row의 quantity는 관측된 절대 수량이 아니라 직전 projection 대비 파생된 delta이며 observedQuantity가 실사 관측 수량입니다.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"skuId","in":"path"},{"schema":{"type":"string"},"required":false,"name":"scopeLocationId","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string"},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"SKU inventory history","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInventoryStatusSkuHistoryResponse"}}}},"400":{"description":"invalid query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"SKU or location scope not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace inventory history unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/inventory-status/{skuId}":{"get":{"tags":["external-inventory"],"summary":"외부 연동 SKU 재고 상세","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"skuId","in":"path"},{"schema":{"type":"string"},"required":false,"name":"scopeLocationId","in":"query"}],"responses":{"200":{"description":"SKU inventory detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInventoryStatusSkuDetailResponse"}}}},"400":{"description":"invalid query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"SKU or location scope not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace inventory unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/events":{"get":{"tags":["external-inventory"],"summary":"위치별 inventory event 목록","description":"이동 이벤트를 transaction ID 기반 cursor로 순회합니다. lineCount와 totalQuantity는 각 이벤트 내부에 한정됩니다.","parameters":[{"schema":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"required":false,"name":"scopeLocationId","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"occurredFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"occurredTo","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":96},"required":false,"name":"eventTypeCode","in":"query"},{"schema":{"type":"string","enum":["in","out"]},"required":false,"name":"direction","in":"query"}],"responses":{"200":{"description":"inventory events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInventoryEventsResponse"}}}},"400":{"description":"invalid query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"location scope not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace event feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/events/{eventId}/lines":{"get":{"tags":["external-inventory"],"summary":"이벤트의 SKU별 수량 라인","description":"EPC 이벤트는 SKU별 태그 수로, 수량 이벤트는 SKU별 수량 합계로 반환합니다. 미매핑 EPC는 sku가 null인 행에 묶으며 원시 EPC는 반환하지 않습니다.","parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"eventId","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":2048},"required":false,"name":"cursor","in":"query"}],"responses":{"200":{"description":"event lines","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInventoryEventLinesResponse"}}}},"400":{"description":"invalid query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"event not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace event lines unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}},"/v1/external/counts":{"get":{"tags":["external-inventory"],"summary":"확정된 재고 실사 항목 목록","description":"확정된 실사만 한 session·location·SKU 항목으로 반환합니다. occurredAt은 business time이며 cursor는 별도의 transaction ID 순서입니다.","parameters":[{"schema":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"required":false,"name":"scopeLocationId","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"occurredFrom","in":"query"},{"schema":{"type":"string","format":"date-time"},"required":false,"name":"occurredTo","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100},"required":false,"name":"limit","in":"query"},{"schema":{"type":"string","maxLength":2048},"required":false,"name":"cursor","in":"query"},{"schema":{"type":"string","format":"uuid","example":"550e8400-e29b-41d4-a716-446655440000"},"required":false,"name":"skuId","in":"query"},{"schema":{"type":"string","minLength":1,"maxLength":96},"required":false,"name":"countTypeCode","in":"query"}],"responses":{"200":{"description":"confirmed inventory counts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInventoryCountsResponse"}}}},"400":{"description":"invalid query or cursor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"invalid workspace token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"workspace access suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"location scope not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"},"required":true}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"workspace counts feed unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"workspaceBearerAuth":[]}]}}},"webhooks":{}}