add
주문정보를 신규 등록하기 위한 API
신규 주문 데이터를 다건 추가합니다.(최대 100건) 요청 데이터 리스트중 접수에 성공한 데이터는 접수정보를, 실패한 데이터는 실패사유를 각각 전달합니다.
StockMode=3PL인 경우 재고수량을 체크하여 재고가 없으면 접수안함
(0=재고체크안함, 1=재고체크함)
ReceiverCheckr값이 false인 경우 주소오류 건 접수함. true일 경우 주소오류시 접수하지 않음(미지정시 true)
Accident false인 경우 주소오류시 사고건 설정하지 않음. true일 경우 주소오류시 사고건 설정함(미지정시 true)
APIKey Test KEY:7abd72462c794016849abe4be
sucess
Valid Fail
POST /api/v1/invoice/add HTTP/1.1
Host: api.etomars.com
Content-Type: application/json
Accept: */*
Content-Length: 2365
{
"StockCheck3PL": 1,
"ReceiverCheck": true,
"Accident": true,
"DataList": [
{
"NationCode": "JP",
"ShippingType": "A",
"OrderNo1": "TEST230921-001",
"OrderNo2": "",
"FirstMileNo": "",
"SenderName": "ETOMARS",
"SenderTelno": "07012345678",
"SenderAddr": "Seoul, Korea",
"ReceiverName": "エトマース",
"ReceiverNameYomigana": "",
"ReceiverNameExpEng": "",
"ReceiverTelNo1": "03-6260-7163",
"ReceiverTelNo2": "",
"ReceiverZipcode": "1010043",
"ReceiverState": "",
"ReceiverCity": "",
"ReceiverDistrict": "",
"ReceiverDetailAddr": "東京都千代田区神田富山町25番地 サンクス神田ビル 2階",
"ReceiverEmail": "",
"ReceiverSocialNo": "",
"RealWeight": 1,
"WeightUnit": "KG",
"BoxCount": 1,
"CurrencyUnit": "JPY",
"DelvMessage": "",
"UserData1": "",
"UserData2": "",
"UserData3": "",
"DimWidth": 0,
"DimLength": 0,
"DimHeight": 0,
"DimUnit": "",
"DelvNo": "",
"DelvCom": "",
"StockMode": "NOR",
"SalesSite": "",
"TotalGoodsPrice": 0,
"GoodsList": [
{
"GoodsName": "福神成人羽绒服M码",
"Qty": 10,
"UnitPrice": 200,
"BrandName": "NoBrand",
"GType": "N",
"StoreOrderNo": "",
"StoreCartNo": "",
"StoreOption": ""
}
]
},
{
"NationCode": "JP",
"ShippingType": "A",
"OrderNo1": "TEST230921-001",
"OrderNo2": "",
"SenderName": "ETOMARS",
"SenderTelno": "07012345678",
"SenderAddr": "Seoul, Korea",
"ReceiverName": "エトマース",
"ReceiverTelNo1": "03-6260-7163",
"ReceiverZipcode": "9999999",
"ReceiverDetailAddr": "東京都千代田区神田富山町25番地 サンクス神田ビル 2階",
"RealWeight": 1,
"WeightUnit": "KG",
"BoxCount": 1,
"CurrencyUnit": "JPY",
"DimWidth": 0,
"DimLength": 0,
"DimHeight": 0,
"DimUnit": "",
"StockMode": "NOR",
"TotalGoodsPrice": 0,
"GoodsList": [
{
"GoodsName": "福神成人羽绒服M码",
"Qty": 10,
"UnitPrice": 50,
"BrandName": "NoBrand",
"GType": "N",
"StoreOrderNo": "",
"StoreCartNo": "",
"StoreOption": ""
}
]
},
{
"NationCode": "JP4",
"ShippingType": "AB",
"OrderNo1": "TEST230921-003",
"OrderNo2": "",
"SenderTelno": "07076611030",
"SenderAddr": "Seoul, Korea",
"ReceiverDetailAddr": "東京都千代田区神田富山町25番地 サンクス神田ビル 2階",
"RealWeight": 1.7,
"WeightUnit": "WOW",
"BoxCount": 1,
"CurrencyUnit": "JPAY",
"DelvMessage": "This is Test",
"DimWidth": 0,
"DimLength": 0,
"DimHeight": 0,
"DimUnit": "kgm",
"DelvCom": "ETOMARS",
"StockMode": "NOR",
"TotalGoodsPrice": 0,
"GoodsList": [
{
"Qty": 2,
"UnitPrice": 0,
"BrandName": "NoBrand",
"HscodeExpEn": "456813685438543854413435",
"GType": "C",
"StoreOrderNo": "",
"StoreCartNo": "",
"StoreOption": ""
}
]
}
],
"ApiKey": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}{
"TotalCount": 1,
"SuccessCount": 1,
"FailCount": 1,
"Data": [
{
"RegNo": "text",
"CustomNo": "text",
"OrderNo1": "text",
"OrderNo2": "text",
"DelvNo": "text",
"DelvCom": "text",
"DelvComName": "text",
"Status": 1,
"BranchCode": "text",
"DelvData1": "text",
"DelvData2": "text",
"DelvData3": "text",
"DelvData4": "text",
"DelvData5": "text",
"DelvData6": "text",
"SagawaCode1": "text",
"SagawaCode2": "text",
"UPacketCode": "text",
"Exceptional": "text"
}
],
"Error": [
{
"DataNumber": 1,
"OrderNo1": "text",
"OrderNo2": "text",
"ErrorMessageList": [
{
"ErrorCode": 1,
"ErrorMessage": "text"
}
]
}
],
"Message": "text",
"Code": 1
}Responses
Code
0 : 성공
-9 : 업로드 기능 비활성화
-60 : Shipping Service, Shipping Type 중복 입력
-72 : 하루에 업로드 할 수 있는 갯수 초과
-73 : 예치금 부족
-80 : 접수번호 가져오기 실패
-81 : Database 오류
-230 : 잘못된 API KEY
-240 : 잘못된 입력값 (업로드 날짜)
-241 : 잘못된 입력값 (도착국가)
-242 : 잘못된 입력값 (도착국가 - 목록에 없음)
-244 : 재고관리 기능이 활성화 되지 않았습니다
-250 : 발송인 이름을 입력하세요
-260 : 발송인 전화번호를 입력하세요
-270 : 발송인 주소를 입력하세요
-273 : 발송인 이름은 영문으로 입력하세요
-274 : 발송인 주소는 영문으로 입력하세요
-280 : 이미 동일한 주문번호가 입력되어 있습니다 (ORDERNO1, ORDERNO2, STORE_ORDERNO, DELVNO 포함)
-290 : 수취인 이름을 입력하세요
-291 : 수취인 이름을 입력하세요 (YOMIGANA)
-300 : 수취인 전화번호를 입력하세요
-321 : 수취인 우편번호를 입력하세요
-330 : 수취인 주소를 입력하세요
-331 : 수취인 주소를 입력하세요 (STATE/CITY/DISTRICT 등 상세 정보)
-333 : 수취인 주소 입력 가능 글자수 초과 (50자)
-340 : 수취인 주소를 입력하세요 (주소2)
-342 : 수취인 우편번호를 입력하세요
-343 : 우편번호는 10자리 이내로 입력하세요
-351 : 신분증번호가 유효하지 않습니다
-352 : 수취인 신분증번호 : 필수입력이 누락되었습니다
-361 : 이메일 주소가 유효하지 않습니다
-400 : 유효하지 않은 입력값
-431 : 화폐단위 오류
-440 : 잘못된 입력값 (배송 타입) 배송 그룹 설정을 확인해 주세요
-441 : 배송 타입을 선택하세요
-442 : 잘못된 입력값 (배송 타입)
-443 : 잘못된 입력값 (운송조건 타입)
-460 : 이미 동일한 배송번호가 입력되어 있습니다
-461 : 배송번호를 입력하세요
-462 : 배송회사 ID를 입력하세요
-463 : 알수없는 배송회사 입니다.
-480 : 일본배송인 경우 박스갯수는 1로 입력해주세요
-490 : 전자상거래 수출신고 또는 간의수출신고 중 하나의 신고만 선택할 수 있습니다
-491 : 원산지는 국가코드 2자리를 입력하세요
-510 : 상품명을 입력하세요
-520 : 브랜드명을 입력하세요
-530 : 구매 URL을 입력하세요
-540 : 잘못된 입력값 (단가)
-550 : 잘못된 입력값 (수량)
-562 : 잘못된 입력값 (HSCODE)
-570 : 잘못된 입력값 (용량, 단위)
-571 : 잘못된 입력값 (SKU/BARCODE) / 수출신고용 HS CODE는 10자리로 입력해 주세요
-572 : 재고관리 필수입력이 누락되었습니다 (SKU)
-573 : 상품코드를 찾을 수 없습니다 / 등록되지 않은 상품정보입니다
-574 : 상품코드는 50글자를 초과할 수 없습니다 / 상품명은 영문으로 입력하세요 / 바코드를 입력하세요
-575 : 상품의 총중량이 등록되어 있지 않습니다
-576 : 재고관리 필수입력이 누락되었습니다 (BARCODE)
-577 : 잘못된 입력값 (BARCODE)
-580 : 수출신고 개수를 입력하세요
-581 : 수출신고 무게를 입력하세요
-582 : 동일한 수출신고번호가 DB에 저장되어 있습니다
-583 : HSCODE를 입력하지 않았습니다 / 수출신고번호는 15글자를 초과할 수 없습니다
-584 : 수출신고 대행 요청시 10자리 HSCODE는 필수 항목입니다
-600 : 상품 상세정보를 입력하세요
-601 : 상품정보가 너무 많습니다 (MAX 개수 초과)
-701 : 위험물 상품코드는 한 종류로 입력하세요
-702 : 위험물코드를 입력하세요
-703 : 위험물코드가 등록되어 있지 않습니다
Last updated