본문 바로가기
역량 UP!/Business

2) nonos(No No Stress) NaverStore Api 분석 및 개발

by 태하팍 2025. 7. 21.
반응형

오늘은 NaverStore Api를 분석 해보겠습니다.
그런데! NaverStore Api를 사용하려면 액세스토큰이 필요합니다.

액세스토큰을 만들려면
client_id, client_secret_sign등이 필요한데

이 내용은 application을 등록을 해야 네이버스토어에서 제공을 해줍니다.
https://apicenter.commerce.naver.com/ko/member/home

API호출 IP는 허용IP 입니다.

https://apicenter.commerce.naver.com/docs/commerce-api/current/seller-get-product-order-ids-pay-order-seller

아래의 형태로 나오는데 원하는 결과의 api는 아니라 패스!

curl -L 'https://api.commerce.naver.com/external/v1/pay-order/seller/orders/2025071546970881/product-order-ids' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer accessToken'
{
  "timestamp" : "2025-07-15T15:41:02.647+09:00",
  "traceId" : "90a5jJeeQ0qTndMDNKyGxg^1752038007463^36100376",
  "data" : [ "2025071599866191" ]
}%

두번째 api는 https://apicenter.commerce.naver.com/docs/commerce-api/current/seller-get-product-orders-with-conditions-pay-order-seller

curl -L 'https://api.commerce.naver.com/external/v1/pay-order/seller/product-orders?from=2025-07-15T12:00:00.000%2B09:00&to=2025-07-15T19:00:00.000%2B09:00&rangeType=PAYED_DATETIME' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer accessToken:)'

from~to 사이의 주문건들을 조회하는 api 입니다.

주저리)
문제는 고객들이 발주처리를 하는데 있어서 편해야 스트레스를 받지 않는다는 것!
내가 사용하는 업자라고 했을 때..
우선 api를 호출해서 데이터를 가져오고 이 데이터를 일단 database에 저장! 송장까지 완료가 되면 해당 database에서 삭제!
혹은 혹시 모르니까 update로 처리! 송장까지 처리된 데이터를 나중에 활용도가 있어보이니 가격도 저장을 해야 좋을려나? 
아직 정산을 어떻게 하는지 몰라서 여기까진 모르겠음! 하지만 추후에 추가나 변경이 가능하도록 만들어야 함.

어떤 데이터를 불러와서 저장을 해야할까?

curl -L 'https://api.commerce.naver.com/external/v1/pay-order/seller/product-orders?from=2025-07-15T12:00:00.000%2B09:00&to=2025-07-15T19:00:00.000%2B09:00&rangeType=PAYED_DATETIME' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer 30ThMtBMY4rACETPEKR'
{
  "timestamp" : "2025-07-15T16:22:46.939+09:00",
  "traceId" : "JWfRlFa9R9CFVvZWV09vPA^1752038006233^37167030",
  "data" : {
    "contents" : [ {
      "productOrderId" : "2025071592580391",
      "content" : {
        "order" : {
          "orderId" : "2025071542207141",
          "orderDate" : "2025-07-15T12:15:46.442+09:00",
          "ordererId" : "dog****",
          "ordererNo" : "100087923",
          "ordererName" : "뭉치",
          "ordererTel" : "010-1111-2222",
          "isDeliveryMemoParticularInput" : "false",
          "paymentDate" : "2025-07-15T12:15:52.727+09:00",
          "paymentMeans" : "신용카드 간편결제",
          "payLocationType" : "MOBILE",
          "orderDiscountAmount" : 0,
          "generalPaymentAmount" : 41900,
          "naverMileagePaymentAmount" : 0,
          "chargeAmountPaymentAmount" : 0,
          "payLaterPaymentAmount" : 0
        },
        "productOrder" : {
          "productOrderId" : "2025071592580391",
          "quantity" : 1,
          "initialQuantity" : 1,
          "remainQuantity" : 1,
          "totalProductAmount" : 77000,
          "initialProductAmount" : 77000,
          "remainProductAmount" : 77000,
          "totalPaymentAmount" : 41900,
          "initialPaymentAmount" : 41900,
          "remainPaymentAmount" : 41900,
          "productOrderStatus" : "PAYED",
          "productId" : "7812055650",
          "productName" : "제주 구좌 자색 당근 유기농 친환경 흙당근 햇당근 3kg 5kg 10kg  쥬스용 주스용 생당근",
          "unitPrice" : 58000,
          "productClass" : "조합형옵션상품",
          "originalProductId" : "7774543868",
          "merchantChannelId" : "101671406",
          "expectedDeliveryCompany" : "CJGLS",
          "deliveryAttributeType" : "NORMAL",
          "placeOrderStatus" : "NOT_YET",
          "shippingDueDate" : "2025-07-18T23:59:59.000+09:00",
          "expectedDeliveryMethod" : "DELIVERY",
          "packageNumber" : "2025071555313659",
          "itemNo" : "49947141309",
          "productOption" : "제주농장 직송 당근 품목: \uD83E\uDD55제주구좌흙당근(농약불검출) / 귀한 당근 종류: 왕(주스공장납품-즙 많아서 휴롬주스용)10kg",
          "optionCode" : "49947141309",
          "optionPrice" : 19000,
          "mallId" : "ncp_1oh76l_01",
          "inflowPath" : "검색>쇼핑검색(네이버쇼핑)",
          "inflowPathAdd" : "null",
          "productDiscountAmount" : 35100,
          "initialProductDiscountAmount" : 35100,
          "remainProductDiscountAmount" : 35100,
          "sellerBurdenDiscountAmount" : 35100,
          "productImediateDiscountAmount" : 35100,
          "initialProductImmediateDiscountAmount" : 35100,
          "remainProductImmediateDiscountAmount" : 35100,
          "sellerBurdenImediateDiscountAmount" : 35100,
          "initialSellerBurdenImmediateDiscountAmount" : 35100,
          "remainSellerBurdenImmediateDiscountAmount" : 35100,
          "deliveryFeeAmount" : 0,
          "deliveryPolicyType" : "무료",
          "sectionDeliveryFee" : 0,
          "shippingFeeType" : "무료",
          "deliveryDiscountAmount" : 0,
          "shippingAddress" : {
            "name" : "뭉치",
            "tel1" : "010-1111-2222",
            "zipCode" : "01510",
            "baseAddress" : "서울특별시 송파구",
            "detailedAddress" : "101-1221",
            "isRoadNameAddress" : true,
            "addressType" : "DOMESTIC",
            "buildingManagementNo" : "1222",
            "longitude" : "127.1033332",
            "latitude" : "37.5227325"
          },
          "takingAddress" : {
            "name" : "상품출고지",
            "tel1" : "010-1111-2222",
            "tel2" : "",
            "zipCode" : "63032",
            "baseAddress" : "제주특별자치도 제주시 애월읍",
            "detailedAddress" : "",
            "isRoadNameAddress" : true,
            "addressType" : "DOMESTIC"
          },
          "commissionRatingType" : "결제수수료",
          "commissionPrePayStatus" : "GENERAL_PRD",
          "paymentCommission" : 829,
          "saleCommission" : 0,
          "knowledgeShoppingSellingInterlockCommission" : 1257,
          "channelCommission" : 0,
          "expectedSettlementAmount" : 39814
        }
      }
    },....
    .....
    .....
    ],
    "pagination" : {
      "page" : 1,
      "size" : 300,
      "hasNext" : false
    }
  }
}

응답은 아래처럼 다건의 json 포맷 데이터로 응답을 받게 된다.

다시 돌아와서 데이터에서 주문조회를 했을 때 어떤 데이터를 보여줘야할까?

네이버스토어를 참고하면

결제일 옵션정보 수량 최종 상품별 총 주문금액 수취인명 수취인연락처1 구매자연락처 통합배송지 배송메세지 상품주문번호 배송방법(구매자 요청) 상품종류 배송방법 택배사 송장번호 발송일 주문일시 상품번호 주문 유입경로 구매자ID 고객 등급 주문번호 3개월 주문건수 결제위치 판매자 상품코드 상품명 옵션관리코드


결제일, 옵션정보(상품명),  수량, 수취인명, 수취인연락처, 구매자명, 구매자연락처, 통합배송지, 배송메시지, 상품주문번호, 상품번호, 주문번호, 결제위치, 상품명, 3개월주문건수, 결제위치 등등 

주문

"order" : {
          "orderId" : "2025071542207141",
          "orderDate" : "2025-07-15T12:15:46.442+09:00",
          "ordererId" : "dog****",
          "ordererNo" : "100087923",
          "ordererName" : "뭉치",
          "ordererTel" : "010-2222-1111",
          "isDeliveryMemoParticularInput" : "false",
          "paymentDate" : "2025-07-15T12:15:52.727+09:00",
          "paymentMeans" : "신용카드 간편결제",
          "payLocationType" : "MOBILE",
          "orderDiscountAmount" : 0,
          "generalPaymentAmount" : 41900,
          "naverMileagePaymentAmount" : 0,
          "chargeAmountPaymentAmount" : 0,
          "payLaterPaymentAmount" : 0
        },

상품 주문


"productOrder" : {
          "productOrderId" : "2025071592580391",
          "quantity" : 1,
          "initialQuantity" : 1,
          "remainQuantity" : 1,
          "totalProductAmount" : 77000,
          "initialProductAmount" : 77000,
          "remainProductAmount" : 77000,
          "totalPaymentAmount" : 41900,
          "initialPaymentAmount" : 41900,
          "remainPaymentAmount" : 41900,
          "productOrderStatus" : "PAYED",
          "productId" : "7812055650",
          "productName" : "제주 단호박 무농약 밤호박 보우짱 못난이 구좌 친환경 이유식",
          "unitPrice" : 58000,
          "productClass" : "조합형옵션상품",
          "originalProductId" : "7774543868",
          "merchantChannelId" : "101671406",
          "expectedDeliveryCompany" : "CJGLS",
          "deliveryAttributeType" : "NORMAL",
          "placeOrderStatus" : "NOT_YET",
          "shippingDueDate" : "2025-07-18T23:59:59.000+09:00",
          "expectedDeliveryMethod" : "DELIVERY",
          "packageNumber" : "2025071555313659",
          "itemNo" : "49947141309",
          "productOption" : "제주 미네랄 단호박: 세일 특품3kg(실중량2.5kg)",
          "optionCode" : "49947141309",
          "optionPrice" : 19000,
          "mallId" : "ncp_1oh76l_01",
          "inflowPath" : "검색>쇼핑검색(네이버쇼핑)",
          "inflowPathAdd" : "null",
          "productDiscountAmount" : 35100,
          "initialProductDiscountAmount" : 35100,
          "remainProductDiscountAmount" : 35100,
          "sellerBurdenDiscountAmount" : 35100,
          "productImediateDiscountAmount" : 35100,
          "initialProductImmediateDiscountAmount" : 35100,
          "remainProductImmediateDiscountAmount" : 35100,
          "sellerBurdenImediateDiscountAmount" : 35100,
          "initialSellerBurdenImmediateDiscountAmount" : 35100,
          "remainSellerBurdenImmediateDiscountAmount" : 35100,
          "deliveryFeeAmount" : 0,
          "deliveryPolicyType" : "무료",
          "sectionDeliveryFee" : 0,
          "shippingFeeType" : "무료",
          "deliveryDiscountAmount" : 0,
          "shippingAddress" : {
            "name" : "뭉치",
            "tel1" : "010-2222-1111",
            "zipCode" : "05510",
            "baseAddress" : "서울특별시 송파구",
            "detailedAddress" : "101-2222",
            "isRoadNameAddress" : true,
            "addressType" : "DOMESTIC",
            "buildingManagementNo" : "11710102001242424008000001",
            "longitude" : "127.1043332",
            "latitude" : "37.5172335"
          },

필드매칭

결제일 : content > order > orderDate : "2025-07-16T13:12:21.344+09:00",
구매자연락처 : content > order > ordererTel : 010-2233-1112 
주문번호 : content > order > orderId : 2025071669708901
결제위치 : content > order > payLocationType : MOBILE
옵션정보 : content > productOrder > productOption : "제주 미네랄 단호박: 세일 특품3kg(실중량2.5kg)
옵션코드 : content > productOrder > optionCode : 49974891431

수량 : content > productOrder > quantity : 8
수취인명 : content > productOrder > shippingAddress > name :  태하팍
수취인연락처 : content > productOrder > shippingAddress > tel1 : 010-2333-1422
통합배송지 : content > productOrder > shippingAddress > baseAddress + detailedAddress : 제주시 애월아파트 102동
배송메시지 : content > productOrder > shippingMemo : 문앞에 놔두세용
상품주문번호 : content > productOrder > productOrderId : 2025071650255171
상품번호 : content > productOrder > productId : 7812055650
상품명 : content > productOrder > productName : 제주 단호박 무농약 밤호박 보우짱 못난이 구좌 친환경 이유식
3개월주문건수 : api에서 못찾음!

이제 api는 준비가 되었고 Front연동해서 데이터를 가져오는 작업을 해보겠습니다. 고고!       
        
       

 

반응형

'역량 UP! > Business' 카테고리의 다른 글

참고) ISO-8601란?  (1) 2025.07.26
1) nonos(No No Stress) project 시작 :D  (0) 2025.07.08
스타트업 창업자 특징  (0) 2025.07.03
17) ENS Project - 시놀리지 NAS에서 스케줄러 돌리기!  (0) 2025.02.13
16) ENS Project - Server 산정 및 배포!  (0) 2025.02.12

관련글

티스토리툴바