재고
재고를 읽고 통제된 수량 조정, 판매 한도, 수동 예약을 적용합니다.
작업
목록 조회 · 재고 — 재고제품 재고, 창고 및 내부 위치를 확인하세요.
GET
생성 · 재고 조정 — 재고실제 제품 수량과 판매 가능한 제품 수량을 변경합니다.
POST
조회 · 재고 — 재고제품 재고, 창고 및 내부 위치를 확인하세요.
GET
수정 · 재고 — 재고실제 제품 수량과 판매 가능한 제품 수량을 변경합니다.
PATCH
수정 · 수동 예약 — 재고수동 예약 변경. 외부 연동 작업에 적용됩니다.
PATCH
수정 · 판매 한도 — 재고판매 한도 변경. 외부 연동 작업에 적용됩니다.
PATCH
가져오기 생성최대 1000개 코드 또는 100개 파일의 초안을 만드세요. 아직 판매 가능한 재고는 늘어나지 않습니다.
POST
가져오기 취소미완료 초안을 폐기하세요. 이미 확정한 입고는 취소되지 않습니다.
DELETE
가져오기 조회상태, 버전, 검증 결과를 확인하세요. 초안은 생성한 API 키에 속합니다.
GET
입고 확정검증한 묶음으로 예정 또는 완료 상태의 입고를 만드세요. 예정된 재고는 아직 판매할 수 없습니다.
POST
예정된 입고 수령코드나 파일을 다시 가져오지 않고 기존 단위를 입고 처리하세요.
POST
가져오기 검증전체 묶음을 검증하세요. 중복 또는 잘못된 항목이 있으면 묶음을 거부하며 코드를 잘라내지 않습니다.
POST
입고 철회사용 가능한 단위만 철회하세요. 예약되거나 배정된 단위는 주문과의 연결을 유지합니다.
POST
디지털 재고 설정 조회변경 전에 설정과 수량을 조회하세요. 응답에는 코드나 파일 내용이 포함되지 않습니다.
GET
디지털 재고 설정 변경Professional 이상에서 개별 코드나 파일을 활성화하세요. 비활성화해도 이전 구매의 접근 권한은 유지됩니다.
PATCH
단위 목록 조회페이지당 최대 100개 단위를 조회하세요. 목록은 코드를 공개하지 않고 메타데이터를 보여 줍니다.
GET
배정 순서 변경필터링하지 않은 페이지 전체를 원하는 순서로 보내세요. 오래된 버전은 409를 반환합니다.
POST
사용 가능한 단위 내용 조회코드는 JSON, 파일은 바이너리로 반환됩니다. 모든 요청에는 Bearer와 reveal 권한이 필요합니다.
GET
사용 가능한 단위 접근 확인내용을 내려받지 않고 GET과 같은 권한을 확인하세요. 단위가 예약되지는 않습니다.
HEAD
사용 가능한 단위 제거사유를 명시해 미판매 코드나 파일을 제거하세요. 예약되거나 배정된 단위는 거부됩니다.
POST
사용 가능한 단위 교체순서를 바꾸지 않고 코드나 파일을 교체하세요. 변경 사항은 창고 이력에 남습니다.
POST
비공개 업로드 준비파일 공간을 예약하고 가져오기 또는 교체 대상 단위에 연결하세요.
POST
업로드 확인크기, 체크섬, 형식을 확인하세요. 업로드가 준비되어도 입고 완료를 뜻하지는 않습니다.
GET
파일 업로드HTTPS를 통해 multipart/form-data로 파일을 보내세요. Base64나 가져올 URL을 보내지 마세요.
PUT
작동 방식
재고 레코드는 실제 on_hand 수량, 주문 예약, 수동 예약 및 판매 가능 수량을 구분합니다. 반환된 재고 식별자와 버전을 사용하세요. 상품 재고와 옵션 상품 재고는 별개의 대상입니다.
sellable_limit 의 -1 은 무제한, 0 은 판매 불가를 의미합니다. 무제한 판매 가능 수량은 available 에 null 로 표시됩니다. null 을 0으로 취급하지 마세요. 재고 조정, 판매 한도, 수동 예약에는 별도의 작업과 권한이 있습니다.