add

주문정보를 신규 등록하기 위한 API

Previousget Nextdelete

Last updated 18 days ago

주문 접수

post

신규 주문 데이터를 다건 추가합니다.(최대 100건) 요청 데이터 리스트중 접수에 성공한 데이터는 접수정보를, 실패한 데이터는 실패사유를 각각 전달합니다.

Body

StockCheck3PLinteger · int32Optional

StockMode=3PL인 경우 재고수량을 체크하여 재고가 없으면 접수안함
(0=재고체크안함, 1=재고체크함)

ReceiverCheckbooleanOptional

ReceiverCheckr값이 false인 경우 주소오류 건 접수함. true일 경우 주소오류시 접수하지 않음(미지정시 true)

AccidentbooleanOptional

Accident false인 경우 주소오류시 사고건 설정하지 않음. true일 경우 주소오류시 사고건 설정함(미지정시 true)

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

400

Valid Fail

post

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
}

주문 접수

post

Body

StockCheck3PLinteger · int32Optional

StockMode=3PL인 경우 재고수량을 체크하여 재고가 없으면 접수안함
(0=재고체크안함, 1=재고체크함)

ReceiverCheckbooleanOptional

ReceiverCheckr값이 false인 경우 주소오류 건 접수함. true일 경우 주소오류시 접수하지 않음(미지정시 true)

AccidentbooleanOptional

Accident false인 경우 주소오류시 사고건 설정하지 않음. true일 경우 주소오류시 사고건 설정함(미지정시 true)

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

400

Valid Fail

post

POST /api/v1/invoice/add HTTP/1.1
Host: localhost:44312
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
}