get

订单查询

post

查询符合查询条件的订单信息。

Body

TypestringOptional

订单编号格式 regno:受理编号（默认） ordno:订单编号 delvno:快递号

IsUnpackagebooleanOptional

显示包装内的商品列表

IsTrackingInfobooleanOptional

导入配送信息

RegNoListstring[]Required

订单编号列表

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

400

Valid Fail

post

/api/v1/invoice/get

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

{
  "Type": "ordno",
  "IsUnpackage": true,
  "IsTrackingInfo": true,
  "RegNoList": [
    "TEST230106-001",
    "TEST230106-002",
    "TEST230106-003",
    "PACKAGE10B-007"
  ],
  "ApiKey": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}

{
  "Data": [
    {
      "RegNo": "SN215424615JP",
      "Status": 20,
      "RegDate": "20240403",
      "SaleSite": "Qoo10",
      "StatusDesc": "출발국가 창고 입고",
      "OrderNo1": "TEST230106-001",
      "OrderNo2": "",
      "DelvNo": "362952877604",
      "DelvCom": "JP_SAGAWA",
      "DelvComName": "Sagawa",
      "NationCode": "JP",
      "ShippingType": "A",
      "SenderName": "ETOMARS",
      "SenderTelno": "07076611030",
      "SenderAddr": "Seoul, Korea",
      "ReceiverName": "横内 真奈美",
      "ReceiverNameYomigana": "ヨコウチ マナミ",
      "ReceiverTelNo1": "09016150000",
      "ReceiverTelNo2": "",
      "ReceiverZipcode": "1880004",
      "ReceiverState": "",
      "ReceiverCity": "",
      "ReceiverDistrict": "",
      "ReceiverDetailAddr": "東京都 西東京市 西原町11-22-33",
      "ReceiverEmail": "",
      "ReceiverSocialNo": "",
      "RealWeight": 0.8,
      "WeightUnit": "KG",
      "BoxCount": 1,
      "CurrencyUnit": "JPY",
      "DelvMessage": "",
      "UserData1": "",
      "UserData2": "",
      "UserData3": "",
      "DimWidth": 0,
      "DimLength": 0,
      "DimHeight": 0,
      "DimUnit": "cm",
      "ExpLicenceNo": "",
      "VolumeWeight": 0,
      "ChargeableWeight": 1,
      "ShippingFee": 0,
      "ShippingFeeCurrency": "KRW",
      "InvtDeductDate": "20240403",
      "GoodsList": [
        {
          "GoodsName": "SKIN",
          "Qty": 1,
          "UnitPrice": 1200,
          "BrandName": "Nivea",
          "PkgCode": "",
          "SKU": "SAMPLE-SKU001",
          "SkuList": [],
          "HSCODE": "",
          "PurchaseUrl": "www.gmarket.co.kr",
          "GTYPE": "N"
        }
      ],
      "TrackingList": [
        {
          "Status": 20,
          "StatusDesc": "출발국가 창고 입고",
          "IssueDateTime": "2023-01-06 16:39:48",
          "IssueDetail": "SHIPNERGY",
          "Location": "Republic of Korea(대한민국)"
        },
        {
          "Status": 10,
          "StatusDesc": "배송 신청",
          "IssueDateTime": "2023-01-06 16:11:43",
          "IssueDetail": "배좋날03",
          "Location": "Republic of Korea(대한민국)"
        }
      ]
    },
    {
      "RegNo": "SN215424616JP",
      "Status": 20,
      "RegDate": "20240403",
      "SaleSite": "Qoo10",
      "StatusDesc": "출발국가 창고 입고",
      "OrderNo1": "TEST230106-002",
      "OrderNo2": "",
      "DelvNo": "E20230106001",
      "DelvCom": "KR_EMS",
      "DelvComName": "KoreaPost EMS",
      "NationCode": "JP",
      "ShippingType": "C",
      "SenderName": "ETOMARS",
      "SenderTelno": "07076611030",
      "SenderAddr": "Seoul, Korea",
      "ReceiverName": "児島 有香",
      "ReceiverNameYomigana": "コジマ ユカ",
      "ReceiverTelNo1": "08079530000",
      "ReceiverTelNo2": "",
      "ReceiverZipcode": "9813621",
      "ReceiverState": "",
      "ReceiverCity": "",
      "ReceiverDistrict": "",
      "ReceiverDetailAddr": "宮城県 黒川郡大和町 吉岡字石神沢11-22-33",
      "ReceiverEmail": "",
      "ReceiverSocialNo": "",
      "RealWeight": 0.9,
      "WeightUnit": "KG",
      "BoxCount": 1,
      "CurrencyUnit": "JPY",
      "DelvMessage": "",
      "UserData1": "",
      "UserData2": "",
      "UserData3": "",
      "DimWidth": 0,
      "DimLength": 0,
      "DimHeight": 0,
      "DimUnit": "cm",
      "ExpLicenceNo": "",
      "VolumeWeight": 0,
      "ChargeableWeight": 1,
      "ShippingFee": 0,
      "ShippingFeeCurrency": "KRW",
      "InvtDeductDate": "20240403",
      "GoodsList": [
        {
          "GoodsName": "LOTION",
          "Qty": 2,
          "UnitPrice": 1500,
          "BrandName": "SKINFOOD",
          "PkgCode": "",
          "SKU": "SAMPLE-SKU002",
          "SkuList": [],
          "HSCODE": "",
          "PurchaseUrl": "www.gmarket.co.kr",
          "GTYPE": "G"
        }
      ],
      "TrackingList": null
    },
    {
      "RegNo": "SN215424617CA",
      "Status": 20,
      "RegDate": "20240403",
      "SaleSite": "Qoo10",
      "StatusDesc": "출발국가 창고 입고",
      "OrderNo1": "TEST230106-003",
      "OrderNo2": "",
      "DelvNo": "E20230106002",
      "DelvCom": "KR_EMS",
      "DelvComName": "KoreaPost EMS",
      "NationCode": "CA",
      "ShippingType": "C",
      "SenderName": "ETOMARS",
      "SenderTelno": "07076611030",
      "SenderAddr": "Seoul, Korea",
      "ReceiverName": "David",
      "ReceiverNameYomigana": "",
      "ReceiverTelNo1": "01012345678",
      "ReceiverTelNo2": "",
      "ReceiverZipcode": "822",
      "ReceiverState": "Quebec",
      "ReceiverCity": "Quebec",
      "ReceiverDistrict": "",
      "ReceiverDetailAddr": "12345 Boulevard Saint-René Ouest Gatineau Quebec",
      "ReceiverEmail": "",
      "ReceiverSocialNo": "",
      "RealWeight": 1,
      "WeightUnit": "KG",
      "BoxCount": 1,
      "CurrencyUnit": "USD",
      "DelvMessage": "",
      "UserData1": "",
      "UserData2": "",
      "UserData3": "",
      "DimWidth": 0,
      "DimLength": 0,
      "DimHeight": 0,
      "DimUnit": "cm",
      "ExpLicenceNo": "",
      "VolumeWeight": 0,
      "ChargeableWeight": 1,
      "ShippingFee": 0,
      "ShippingFeeCurrency": "KRW",
      "InvtDeductDate": "",
      "GoodsList": [
        {
          "GoodsName": "MASK PACK",
          "Qty": 3,
          "UnitPrice": 36,
          "BrandName": "SKINFOOD",
          "PkgCode": "",
          "SKU": "SAMPLE-SKU003",
          "SkuList": [],
          "HSCODE": "",
          "PurchaseUrl": "www.gmarket.co.kr",
          "GTYPE": "N"
        }
      ],
      "TrackingList": null
    },
    {
      "RegNo": "SN215424617CA",
      "Status": 20,
      "RegDate": "20240403",
      "SaleSite": "Qoo10",
      "StatusDesc": "출발국가 창고 입고",
      "OrderNo1": "PACKAGE10B-007",
      "OrderNo2": "",
      "DelvNo": "E20230106002",
      "DelvCom": "KR_EMS",
      "DelvComName": "KoreaPost EMS",
      "NationCode": "CA",
      "ShippingType": "C",
      "SenderName": "ETOMARS",
      "SenderTelno": "07076611030",
      "SenderAddr": "Seoul, Korea",
      "ReceiverName": "David",
      "ReceiverNameYomigana": "",
      "ReceiverTelNo1": "01012345678",
      "ReceiverTelNo2": "",
      "ReceiverZipcode": "822",
      "ReceiverState": "Quebec",
      "ReceiverCity": "Quebec",
      "ReceiverDistrict": "",
      "ReceiverDetailAddr": "12345 Boulevard Saint-René Ouest Gatineau Quebec",
      "ReceiverEmail": "",
      "ReceiverSocialNo": "",
      "RealWeight": 1,
      "WeightUnit": "KG",
      "BoxCount": 1,
      "CurrencyUnit": "USD",
      "DelvMessage": "",
      "UserData1": "",
      "UserData2": "",
      "UserData3": "",
      "DimWidth": 0,
      "DimLength": 0,
      "DimHeight": 0,
      "DimUnit": "cm",
      "ExpLicenceNo": "",
      "VolumeWeight": 0,
      "ChargeableWeight": 1,
      "ShippingFee": 0,
      "ShippingFeeCurrency": "KRW",
      "InvtDeductDate": "",
      "GoodsList": [
        {
          "GoodsName": "MASK PACK Set A B",
          "Qty": 3,
          "UnitPrice": 36,
          "BrandName": "SKINFOOD",
          "PkgCode": "PKGMASK002AB",
          "SKU": "",
          "SkuList": [
            {
              "Sku": "PKG-ITEM001",
              "Qty": 2
            },
            {
              "Sku": "PKG-ITEM002",
              "Qty": 4
            },
            {
              "Sku": "PKG-ITEM003",
              "Qty": 1
            }
          ],
          "HSCODE": "",
          "PurchaseUrl": "www.gmarket.co.kr",
          "GTYPE": "N"
        }
      ],
      "TrackingList": null
    }
  ],
  "Message": "성공",
  "Code": 0
}

订单编号目录查询

post

查询符合查询条件的订单号。（最长90天）

Body

TypestringOptional

要收回的编号类型 regno:受理编号（默认） ordno:订单编号 delvno:快递号

SalesSitestring · max: 30Optional

판매처

DateTypeinteger · int32Optional

日期搜索类型 0:受理日期 1:库存抵扣日

StartDateTimestringRequired

搜索起始日期 yyyy-MM-dd, yyyyMMdd

EndDateTimestringRequired

搜索结束日期 yyyy-MM-dd, yyyyMMdd

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

400

Valid Fail

post

/api/v1/invoice/get/numbers

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

{
  "Type": "ordno",
  "DateType": 0,
  "StartDateTime": "20230101",
  "EndDateTime": "20230202",
  "ApiKey": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}

{
  "Data": [
    "TEST230106-001",
    "TEST230106-002",
    "TEST230106-003",
    "TEST230106-005",
    "TEST230106-006",
    "TEST230106-008"
  ],
  "Message": "성공",
  "Code": 0
}

订单-配送信息查询

post

查询符合查询条件的订单配送信息。

Body

TypestringOptional

订单编号格式 regno:受理编号（默认） ordno:订单编号 delvno:快递号

IsUnpackagebooleanOptional

显示包装内的商品列表

RegNoListstring[]Required

订单编号列表

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

400

Valid Fail

post

/api/v1/invoice/get/tracking

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

{
  "Type": "ordno",
  "RegNoList": [
    "TEST230106-003",
    "TEST230106-999"
  ],
  "ApiKey": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}

{
  "Data": [
    {
      "RegNo": "SN215424617CA",
      "CustomNo": "",
      "Status": 20,
      "StatusDesc": "출발국가 창고 입고",
      "OrderNo1": "TEST230106-003",
      "OrderNo2": "",
      "DelvNo": "E20230106002",
      "DelvCom": "KR_EMS",
      "DelvComName": "KoreaPost EMS",
      "DepCountryCode": "KR",
      "DepCountryName": "Republic of Korea(대한민국)",
      "ArrCountryCode": "CA",
      "ArrCountryName": "CANADA(캐나다)",
      "SenderName": "ETOMARS",
      "RecipientName": "D****",
      "RecipientTelno": "0101*******",
      "RecipientAddr": "****************************uest Gatineau Quebec 822 CA",
      "ProductNames": [
        "MAS***"
      ],
      "TrackingList": [
        {
          "Status": 20,
          "StatusDesc": "출발국가 창고 입고",
          "IssueDateTime": "2023-01-06 16:39:48",
          "IssueDetail": "SHIPNERGY",
          "Location": "Republic of Korea(대한민국)"
        },
        {
          "Status": 10,
          "StatusDesc": "배송 신청",
          "IssueDateTime": "2023-01-06 16:11:43",
          "IssueDetail": "배좋날03",
          "Location": "Republic of Korea(대한민국)"
        }
      ]
    },
    {
      "RegNo": "TEST230106-999",
      "CustomNo": null,
      "Status": -22,
      "StatusDesc": "데이터가 없습니다.",
      "OrderNo1": null,
      "OrderNo2": null,
      "DelvNo": null,
      "DelvCom": null,
      "DelvComName": null,
      "DepCountryCode": null,
      "DepCountryName": null,
      "ArrCountryCode": null,
      "ArrCountryName": null,
      "SenderName": null,
      "RecipientName": null,
      "RecipientTelno": null,
      "RecipientAddr": null,
      "ProductNames": null,
      "TrackingList": null
    }
  ],
  "Message": "성공",
  "Code": 0
}

订单-配送状态查询

post

查询符合查询条件的订单的配送状态。

Body

RegNoListstring[]Required

受理编号列表（最多100件）。

TypestringOptional

订单编号格式 regno:受理编号（默认） ordno:订单编号 delvno:快递号

IsUnpackagebooleanOptional

显示包装内的商品列表

ApiKeystringRequired

APIKey Test KEY:7abd72462c794016849abe4be

Responses

200

sucess

400

Valid Fail

post

/api/v1/invoice/get/shipping-status

POST /api/v1/invoice/get/shipping-status HTTP/1.1
Host: api.etomars.com
Content-Type: application/json
Accept: */*
Content-Length: 101

{
  "RegNoList": [
    "TEST230106-003",
    "TEST230106-999"
  ],
  "Type": "ordno",
  "ApiKey": "XXXXXXXXXXXXXXXXXXXXXXXXX"
}

{
  "Data": [
    {
      "RequestNo": "TEST230106-003",
      "RegNo": "SN215424617CA",
      "CustomNo": "",
      "OrderNo1": "TEST230106-003",
      "OrderNo2": "",
      "DelvNo": "E20230106002",
      "DelvCom": "KR_EMS",
      "DelvComName": "KoreaPost EMS",
      "Status": 20,
      "StatusDesc": "출발국가 창고 입고",
      "CompletionTime": "",
      "SagawaCode1": "7151",
      "SagawaCode2": "608",
      "UPacketCode": null
    },
    {
      "RequestNo": "TEST230106-999",
      "RegNo": null,
      "CustomNo": null,
      "OrderNo1": null,
      "OrderNo2": null,
      "DelvNo": null,
      "DelvCom": null,
      "DelvComName": null,
      "Status": -22,
      "StatusDesc": "데이터가 없습니다.",
      "CompletionTime": null,
      "SagawaCode1": null,
      "SagawaCode2": null,
      "UPacketCode": null
    }
  ],
  "Message": "성공",
  "Code": 0
}

订货查询

订单查询

/Number : 订单编号目录查询

订单编号目录查询

/Tracking : 配送信息查询

订单-配送信息查询

/Shipping status : 配送状态查询

订单-配送状态查询

hashtag订货查询

hashtag订单查询

hashtag/Number : 订单编号目录查询

hashtag订单编号目录查询

hashtag/Tracking : 配送信息查询

hashtag订单-配送信息查询

hashtag/Shipping status : 配送状态查询

hashtag订单-配送状态查询

订货查询

订单查询

/Number : 订单编号目录查询

订单编号目录查询

/Tracking : 配送信息查询

订单-配送信息查询

/Shipping status : 配送状态查询

订单-配送状态查询