Inventory Adjust

재고 증감 이력을 Vendor에서 쿠팡으로 전달하는 API 입니다.

• API 호출 방향 : Vendor -> Coupang
• URL : /v1/3pfl/inventory/adjust
  • 개발존 : https://api-gateway-dev.coupang.com/v2/providers/bifrost/apis/v1/3pfl/inventory/adjust
  • 운영존 : https://api-gateway.coupang.com/v2/providers/bifrost/apis/v1/3pfl/inventory/adjust
• Interface Style : Restful API
• HTTP Protocol : HTTPS
• Method : POST

Request Body

Request Example

[
  {
    "skuId": 10001234,
    "centerCode": "CENTER001",
    "uniqueKey": "273626354",
    "availableQuantity": 1373,
    "diff": -40,
    "reasonCode": "TRASH",
    "reasonMessage": null,
    "countedAt": "2020-12-01 15:03:39.836"
  },
  {
    "skuId": 10001235,
    "centerCode": "CENTER001",
    "uniqueKey": "273626355",
    "availableQuantity": 1413,
    "diff": 40,
    "reasonCode": "FIND",
    "reasonMessage": null,
    "countedAt": "2020-12-01 15:03:40.173"
  },
  {
    "skuId": 10001236,
    "centerCode": "CENTER001", 
    "uniqueKey": "273626356", 
    "availableQuantity": 1403, 
    "diff": -10, 
    "reasonCode": "ETC_ADJUST",
    "reasonMessage": "쿠팡 요청으로 인한 조정",
    "countedAt": "2020-12-01 15:03:40.364" 
  } 
]

Response

Response Example

{
  "code": "0",
  "message": null,
  "data": null
}

유의사항

• Vendor에서 발생한 재고에 대한 +/- 이력을 해당 API로 보내주시면 됩니다.
• 재고이력 데이터는 일간(Daily) / 월간(Monthly) 정산 목적에서 수집하는 log성 데이터입니다.
  • 재고스냅샷(InventorySnapshot) API 와는 차이점이 있습니다.
  • 재고스냅샷 API는 쿠팡에서 실제 재고를 고객에게 보여주기 위해 수집하는 데이터 입니다. 그리하여 쿠팡이 필요할 때 직접 Vendor 쪽에 API를 호출하여 재고를 가져올 수 있어야 합니다.
  • 재고이력 API는 해당 재고의 변경사항들을 모두 기록하기 위해 수집하는 데이터입니다.
• 재고이력 API는 다음 시나리오 중에 하나를 선택해서 호출해주시면 됩니다.
  • 재고에 대한 수량 변경 사항이 발생할 때마다 실시간으로 재고이력 API 호출
    • Ex) 재고에 대한 입고확정이 발생하여, 재고 수량이 변경되면 재고이력 API 호출
    • Ex) 재고에 대해 창고 내에서 수량조정이 발생하여, 재고 수량이 변경되면 재고이력 API 호출
  • 재고에 대한 수량 변경사항을 모두 기록해두었다가, 하루에 한 번 Batch로 재고이력 API 호출
    • Ex) 재고에 대한 변경사항을 모두 저장해두었다가, 새벽 1시마다 Batch로 재고이력 API 호출
• uniqueKey
  • 업체에서 해당 재고이력을 지칭할 수 있는 Key(PK / UniqueKey)를 넣어서 보내주시면 됩니다.
    • Ex) sequenceId
  • 되도록 재고이력을 지칭할 수 있는 Key를 만들어서 보내주시길 바라며, 만약 UniqueKey를 보낼 수 없다면, 꼭 쿠팡쪽에 문의 주시기 바랍니다.
  • 만약 재고조정 데이터의 diff를 잘못된 수량으로 보내셨다면, 수정된 수량만큼 새로운 uniqueKey를 발행하여 보내주시길 바랍니다.

    • ex. 
      # 기존 잘못보낸 request body (수량 10개)
      {
        ...
        "uniqueKey": "123456789",
        "diff": 10,
        ...
      }
      # 수량을 5개로 소급적용하려면, 수정된 수량(delta)만큼의 새로운 재고조정 데이터를 만들어서 요청
      # delta = 5 - 10 = -5
      {
        ...
        "uniqueKey": "3372635228",
        "diff": -5,
        ...
      }
      # 혹은 다음과 같이, -10개로 보내고 5개로 다시 보내주셔도 좋습니다.
      {
        ...
        "uniqueKey": "3372635229",
        "diff": -10,
        ...
      },
      {
        ...
        "uniqueKey": "4837326263",
        "diff": 5,
        ...
      }
      

• reasonCode
  • 재고 변동 사유에 대한 코드입니다.
  • 재고 변동 사유마다 다음 코드로 설정하여 보내주시면 됩니다.
  • 추가 조정 사유가 필요하거나, 조정 사유에 대해서 궁금한 점이 있으시면 쿠팡쪽으로 문의 부탁드립니다.

•  countedAt
  • Millisecond 단위까지 전송해주셔야 합니다.
    • Ex) 2020-12-01 18:03:48.372
  • 재고이력 API를 호출한 시간이 아닌, 해당 재고이력 이벤트가 실제로 발생했던 시간으로 보내주셔야 합니다.
    • Bad
      • 재고이력을 별도로 쌓아놓음
      • 이후 배치로 재고이력 API를 호출할 때, countedAt에 currentTimeMillies()로 설정하여 보냄
    • Good
      • 재고이력 발생할 때마다 countedAt에 발생시간을 각각 기록해둠
      • 이후 배치로 재고이력 API 호출할 때, 기록했던 countedAt을 그대로 보냄
    • Also Good
      • 재고이력이 발생할 때마다 재고이력 API 호출
      • 이 때, countedAt에 currentTimeMillis()를 설정하여 보냄