구매 단계

서비스 오픈 이후 소비자가 상품을 구매하여 생성된 주문 데이터를 브이리뷰에 전송하는 단계입니다.

주문 데이터 등록하기

주문 생성 API를 사용해서 주문 데이터를 브이리뷰에 등록합니다. 등록한 주문이 배송 완료 상태가 되면 브이리뷰 챗봇이 알림톡을 보내서 소비자가 리뷰를 작성할 수 있게 됩니다.

주문 데이터 등록 시점

배송 방식에 따라 주문을 생성하고 배송을 추적하는 방식이 다릅니다.

일반 배송 상품

흔히 볼 수 있는 일반적인 배송 상품의 경우, 주문별 송장번호가 생성되는 시점에 브이리뷰에 주문을 등록합니다.

items.shipment.companyCode: 택배사 코드를 입력합니다.
items.shipment.trackingNumber: 송장번호를 입력합니다.

주문 등록 시점부터 브이리뷰가 자동으로 송장을 추적하고, 배송 완료 상태가 되는 날의 오후 8시에 알림톡을 발송하게 됩니다.

{
  "originId": "주문 번호",
  "orderedAt": "2023-01-14T12:34:56Z",
  "recipient": {"name": "수령인 이름", "phone": "수령인 연락처"},
  "items": [
    {
      "originId": "주문 아이템 번호",
      "productOriginId": "주문 상품 코드",
      "shipment": {
        // highlight-start
        "companyCode": "택배사 코드",
        "trackingNumber": "송장번호"
        // highlight-end
      }
    }
  ]
}

직접 배송 상품

새벽배송, 자체 가구 배송, 직접 수령 등 쇼핑몰에서 직접 배송하는 상품의 경우 배송 완료 시점으로 판단될 때 주문을 등록합니다. 이는 브이리뷰 배송 추적 시스템에 의해 배송 상태를 추적할 수 없기 때문입니다.

items.status: 고정값으로 SHIPPED를 입력합니다.
items.shipment.companyCode: 고정값으로 self를 입력합니다.
items.shipment.trackingNumber: 다른 배송 건과 겹치지 않는 고유한 배송 추적 번호를 입력합니다. 별도의 배송 추적 번호가 없다면 주문 아이템 번호를 사용해도 무방합니다.
items.shipment.deliveredAt: 배송 완료 일시를 입력합니다.

브이리뷰에서는 별도로 배송 상태를 추적하지 않으며, API로 등록한 배송 완료 날짜의 오후 8시에 알림톡이 발송됩니다.

{
  "originId": "주문 번호",
  "orderedAt": "2023-01-14T12:34:56Z",
  "recipient": {"name": "수령인 이름", "phone": "수령인 연락처"},
  "items": [
    {
      "originId": "주문 아이템 번호",
      "productOriginId": "주문 상품 코드",
      // highlight-next-line
      "status": "SHIPPED",
      "shipment": {
        // highlight-start
        "companyCode": "self",
        "trackingNumber": "쇼핑몰에서 관리하는 배송 추적 번호",
        "deliveredAt": "배송 완료 일시"
        // highlight-end
      }
    }
  ]
}

배송 불필요 상품

여행, 숙박 상품 또는 온라인 콘텐츠 등의 경우에는 배송이 불필요합니다. 이 경우 소비자가 리뷰를 작성할 수 있는 시점에 주문을 등록합니다.

items.status: 고정값으로 SHIPPED를 입력합니다.
items.shipment.companyCode: 고정값으로 self를 입력합니다.
items.shipment.trackingNumber: 다른 배송 건과 겹치지 않는 고유한 번호를 입력합니다. 주문 아이템 번호를 사용할 수도 있습니다.
items.shipment.deliveredAt: 리뷰 작성 가능 일시를 입력합니다.

브이리뷰에서는 별도로 배송 상태를 추적하지 않으며, API로 등록한 배송 완료 날짜의 오후 8시에 알림톡이 발송됩니다.

{
  "originId": "주문 번호",
  "orderedAt": "2023-01-14T12:34:56Z",
  "recipient": {"name": "수령인 이름", "phone": "수령인 연락처"},
  "items": [
    {
      "originId": "주문 아이템 번호",
      "productOriginId": "주문 상품 코드",
      // highlight-next-line
      "status": "SHIPPED",
      "shipment": {
        // highlight-start
        "companyCode": "self",
        "trackingNumber": "고유한 번호",
        "deliveredAt": "배송 완료 일시"
        // highlight-end
      }
    }
  ]
}

구매 확정이 필요한 상품

구매 확정 시점 기능을 제공하는 경우 구매 확정을 해야만 리뷰를 작성할 수 있어야 합니다. 이 경우에는 주문 시점이 아니라 구매 확정 시점에 주문을 등록합니다.

단, 배송 완료일을 구매 확정 일시로 사용해야만 알림톡이 정상적으로 발송될 수 있습니다. 일반적으로 구매 확정일은 배송 완료일 이후이기 때문에, 배송 완료일을 그대로 사용할 경우 과거 주문건으로 인식되어 알림톡이 누락될 수 있습니다.

{
  "originId": "주문 번호",
  "orderedAt": "2023-01-14T12:34:56Z",
  "recipient": {"name": "수령인 이름", "phone": "수령인 연락처"},
  "items": [
    {
      "originId": "주문 아이템 번호",
      "productOriginId": "주문 상품 코드",
      // highlight-next-line
      "status": "SHIPPED",
      "shipment": {
        // highlight-start
        "companyCode": "self",
        "trackingNumber": "고유한 번호",
        "deliveredAt": "구매 확정 일시"
        // highlight-end
      }
    }
  ]
}