add

新登记订单信息的API

订单受理

post

新增所有订单数据。（最多100件） 要求数据列表中成功接收的数据是接收信息， 失败的数据分别传达失败的原因。

Body

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

StockCheck3PLinteger · int32Optional

StockMode=3PL时请确认库存数量，无库存不予受理。
（0=未检查库存，1=未检查库存）要接收的数据列表

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

application/jsontext/jsonapplication/xmltext/xml

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
}