KORAIL_STORE

판매 처리 데이터 보내야 하는 경우

1. 수령완료일 때 : SS04

2. 수령완료였다가 매장취소(환불)로 변경되었을 때 : SS04 -> SS11

3. 자동확정일 때 : SS06

4. 자동확정이었다가 매장취소(환불)로 변경되었을 때 : SS06 -> SS11

해당 이슈 처리 예정 순서입니다.

1. 개발 내용 수정 및 신규 개발

- 판매 처리 데이터 (자동) 발송 유형 4가지 반영

- 에이전트에서 상태값 변경 시 판매 처리 데이터 발송 반영

- 판매 처리 데이터 (수동) 발송 API 개발

*수동 발송의 경우 관리자 페이지에 추가될 필요는 없다고 합니다.

**개발에서의 판매 처리 데이터를 보내지 않아도 될지는 확인 요청드렸습니다.

2. 코레일유통 쪽에 12월 수신 데이터 엑셀 파일 재요청

- 해당 시점의 데이터를 받은 후, 발송되지 않은 데이터만 추가로 수동 발송하려고 합니다.

*주문번호는 제가 xlsx 또는 txt 형태로 전달드리겠습니다.

유선상으로 전달드린 내용 함께 기록합니다.

1. 수령완료일 때 : SS04 = 결제

2. 수령완료였다가 매장취소(환불)로 변경되었을 때 : SS04 -> SS11 = 결제취소

3. 자동확정일 때 : SS06 = 결제

4. 자동확정이었다가 매장취소(환불)로 변경되었을 때 : SS06 -> SS11 = 결제취소

에이전트에서 상태값 변경되는 경우에도 관리자 페이지에서 변동되는 경우와 동일하게 적용합니다.

[ADMIN]

1.StoreOrderController.save()

  1) change logic
    a) isReceiveOrderProduct
      (!"SS04".equals(currentSmartOrderStatus) && "SS04".equals(newSmartOrderStatus)) ||
      (!"SS06".equals(currentSmartOrderStatus) && "SS06".equals(newSmartOrderStatus))
    b) isCancelOrderProduct
      ("SS04".equals(currentSmartOrderStatus) && "SS11".equals(newSmartOrderStatus)) ||
      ("SS06".equals(currentSmartOrderStatus) && "SS11".equals(newSmartOrderStatus))

2.ProductApiService.insertOrCancelSaleInfo()

  1) after API is done
    a) INSERT DB (st_krs_sale_proc) (NEW)
    - prod_id: UUID
    - order_no/mall_code: param
    - smart_order_status: newSmartOrderStatus
    - send_date: API proc datetime
    - result_cd/result_msg: API return values

[API]

1.AgentController.storeOrderStatusNew()

  1) add logic
    a) isReceiveOrderProduct / isCancelOrderProduct
      - same with [ADMIN] No 1

2.ProductApiService.insertOrCancelSaleInfo()

  1) after API is done : same with [ADMIN] No 2

[API] POST /api/order_krs_sale_proc (주문 수동 KRS 판매 처리) - NEW

1.RequestBody
  1) file : txt file with order_no

2.Process
  1) read txt file
  2) check if read order_no exists
    - if not exists, SKIP
  3) check order_no's smart_order_status
    - if smart_order_status is not 'SS04','SS06','SS11', SKIP
  4) call krs sales API
    a) isReceiveOrderProduct
      - smart_order_status: 'SS04','SS06'
    b) isCancelOrderProduct
      - smart_order_status: 'SS11'
    c) call API
      - same logic with ProductApiService.insertOrCancelSaleInfo()
  5) response
    - "total_count" : read count
    - "proc_count" : proc count
    - "skip_count" : skip count
    - "skip_order_no" : skip order_no (ex: "1,2,3")

기존에 개발과 운영 API가 동일했는데,

코레일유통 쪽에는 개발 서버가 따로 없기 때문에

우리 개발 쪽의 데이터는 판매 처리 API를 통해 넘기지 말아달라고 전달 받았습니다.

[ADMIN/API] 

1.properties
  1) dev
    #KRS sales proc flag
    KRS.sale.proc=N
  2) prod
    #KRS sales proc flag
    KRS.sale.proc=Y

2.logic
  1) if KRS.sale.proc=Y
    - call ProductApiService.insertOrCancelSaleInfo()
    - if N, don't call

[ADMIN/API] ProductApiService.insertOrCancelSaleInfo()

1.buildSaleInfo()
  1) setSaleDate / setSaleTime
    - set by st_order.reg_date

[error]

2023-12-26 12:37:55,470 ERROR [com.stoneitgt.user.controller.AgentController] null
java.lang.NullPointerException: null
        at com.stoneitgt.user.services.ProductApiService.buildSaleInfo(ProductApiService.java:129) ~[classes/:?]
        at com.stoneitgt.user.services.ProductApiService.insertOrCancelSaleInfo(ProductApiService.java:55) ~[classes/:?]