Inventory

Vendor의 재고 스냅샷을 쿠팡에서 조회하는 API 입니다.

• API 호출 방향 : Coupang -> Vendor
• URL : /v1/3pfl/inventory/sku/inventorySnapshot
• Interface Style : Restful API
• HTTP Protocol : HTTPS
• Method : POST

Request Body

Request Example

{
  "skuId": 10001234
}

Response

Response Example

{ 
  "errorCode": null, 
  "errorDescription": null, 
  "skuId": 10001234, 
  "inventorySnapshot": 
    [ 
      { 
        "centerCode": "CENTER001", 
        "availableQuantity": 27, 
        "breakageQuantity": 0, 
        "reservedQuantity": 3,
        "releasableQuantity": 5
      }, 
      { 
        "centerCode": "CENTER002", 
        "availableQuantity": 28, 
        "breakageQuantity": 0, 
        "reservedQuantity": 2,
        "releasableQuantity": 5
      } 
    ], 
  "expiredAt": null, 
  "lastCountingDate": "2019-12-06 16:52:56" 
}

유의사항

• 재고 조회는 전체 센터의 스냅샷 재고 정보 (재고 0인 모든 센터 포함)를 리턴해주시면 됩니다.
• availableQuantity, breakageQuantity, reservedQuantity는 다음 중 하나의 방법으로 쿠팡 측과 협의 후 보내주시면 됩니다.
  • 계산 전 재고 방법
    • availableQuantity: 해당 센터에 있는 모든 SKU 수량
    • breakageQuantity: 해당 센터에 파손되어 못 파는 SKU 수량
    • reservedQuantity: 해당 센터에 예약 처리되어 판매 예정인 SKU 수량
    • 쿠팡에서는 다음 정보들을 이용하여 쿠팡에서 주문할 수 있는 수량을 계산합니다.

      • availableQuantity - breakageQuantity - reservedQuantity

  • 계산 후 재고 방법
    • availableQuantity: 해당 센터에 있는 가용 SKU 수량

      • availableQuantity = totalQuantity - breakageQuantity - reservedQuantity

      • 업체에서 계산하여 API 결과로 전송해주시면 됩니다.
    • breakageQuantity: 해당 센터에 파손되어 못 파는 SKU 수량 (참고용)
    • reservedQuantity: 해당 센터에 예약 처리되어 판매 예정인 SKU 수량 (참고용)
    • 쿠팡에서는 availableQuantity만 보고 재고 수량을 측정하게 됩니다.