add

API for registering new order information

/add : Order Registration

Order registration

post

Add multiple new order data (max 100 orders) Among the requested data list the data that was successfully registered is delivered with registration information and the data that failed is delivered with a reason for failure.

Body

application/jsontext/jsonapplication/xmltext/xmlapplication/x-www-form-urlencoded

StockCheck3PLinteger · int32Optional

For items with StockMode=3PL, check the stock level and do not accept the order if the item is out of stock. (0=No stock check, 1=Stock check)

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

application/jsontext/jsonapplication/xmltext/xml

Action 실행결과 상세를 서비스에서 컨트롤러로 리턴할때 사용 결과정보 : 총갯수, 성공수, 실패수, 성공데이터목록, 실패데이터목록

TotalCountinteger · int32Optional

SuccessCountinteger · int32Optional

FailCountinteger · int32Optional

MessagestringOptional

Codeinteger · int32Optional

400

Valid Fail

application/jsontext/jsonapplication/xmltext/xml

post

/api/v1/invoice/add

HTTPcURLJavaScriptPython

POST /api/v1/invoice/add HTTP/1.1
Host: api.etomars.com
Content-Type: application/json
Accept: */*
Content-Length: 2191

{
  "StockCheck3PL": 1,
  "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,
      "TwServiceType": "",
      "GoodsList": [
        {
          "GoodsName": "福神成人羽绒服M码",
          "Qty": 10,
          "UnitPrice": 200,
          "BrandName": "NoBrand",
          "GType": "N"
        }
      ]
    },
    {
      "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"
        }
      ]
    },
    {
      "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"
        }
      ]
    }
  ],
  "ApiKey": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}

application/jsontext/jsonapplication/xmltext/xmlapplication/x-www-form-urlencoded

{
  "TotalCount": 3,
  "SuccessCount": 1,
  "FailCount": 2,
  "Data": [
    {
      "RegNo": "SN222530447JP",
      "CustomNo": "",
      "OrderNo1": "TEST230921-001",
      "OrderNo2": "",
      "DelvNo": "",
      "DelvCom": "",
      "DelvComName": "",
      "Status": 10,
      "BranchCode": "00076",
      "DelvData1": null,
      "DelvData2": null,
      "DelvData3": null,
      "DelvData4": null,
      "DelvData5": null,
      "DelvData6": null,
      "SagawaCode1": null,
      "SagawaCode2": null,
      "UPacketCode": null
    }
  ],
  "Error": [
    {
      "DataNumber": 3,
      "OrderNo1": "TEST230921-003",
      "ErrorMessageList": [
        {
          "ErrorCode": -104,
          "ErrorMessage": "DataList[2].NationCode : NationCode은(는) 정확히 2 글자입니다."
        },
        {
          "ErrorCode": -105,
          "ErrorMessage": "DataList[2].ShippingType : ShippingType은(는) 정확히 1 글자입니다."
        },
        {
          "ErrorCode": -109,
          "ErrorMessage": "DataList[2].SenderName : 발송인 이름을 입력하세요."
        },
        {
          "ErrorCode": -112,
          "ErrorMessage": "DataList[2].ReceiverName : 수취인 이름을 입력하세요."
        },
        {
          "ErrorCode": -113,
          "ErrorMessage": "DataList[2].ReceiverNameYomigana : ReceiverNameYomigana의 글자수는 최대 50자 이하입니다."
        },
        {
          "ErrorCode": -115,
          "ErrorMessage": "DataList[2].ReceiverTelNo1 : 수취인 전화번호를 입력하세요."
        },
        {
          "ErrorCode": -117,
          "ErrorMessage": "DataList[2].ReceiverZipcode : 수취인 우편번호를 입력하세요."
        },
        {
          "ErrorCode": -124,
          "ErrorMessage": "DataList[2].WeightUnit : WeightUnit은(는) \"KG\", \"LB\", \"OZ\" 중에서만 선택 가능합니다."
        },
        {
          "ErrorCode": -125,
          "ErrorMessage": "DataList[2].CurrencyUnit : CurrencyUnit은(는) 정확히 3 글자입니다."
        },
        {
          "ErrorCode": -130,
          "ErrorMessage": "DataList[2].DimUnit : DimUnit은(는) \"cm\", \"inch\" 중에서만 선택 가능합니다."
        },
        {
          "ErrorCode": -131,
          "ErrorMessage": "DataList[2].DelvNo : DelvCom이(가) 입력된 경우, DelvNo은(는) 필수 항목입니다."
        },
        {
          "ErrorCode": -141,
          "ErrorMessage": "DataList[2].GoodsList[0].GoodsName : GoodsName은(는) 반드시 입력해야 합니다."
        },
        {
          "ErrorCode": -142,
          "ErrorMessage": "DataList[2].GoodsList[0].UnitPrice : UnitPrice은(는) 반드시 입력해야 합니다."
        },
        {
          "ErrorCode": -151,
          "ErrorMessage": "DataList[2].GoodsList[0].HscodeExpEn : HscodeExpEn의 글자수는 최대 10자 이하입니다."
        },
        {
          "ErrorCode": -152,
          "ErrorMessage": "DataList[2].GoodsList[0].GType : GType은(는) \"N\", \"G\" 중에서만 선택 가능합니다."
        }
      ]
    },
    {
      "DataNumber": 2,
      "OrderNo1": "TEST230921-002",
      "ErrorMessageList": [
        {
          "ErrorCode": -999,
          "ErrorMessage": "수취인 주소를 정확히 입력하세요. (9999999) 東京都千代田区神田富山町25番地 サンクス神田ビル 2階 → [오류] 우편번호가 정확하지 않습니다."
        }
      ]
    }
  ],
  "Message": "성공",
  "Code": 0
}