1. 简介

2. 订单模块API

2.1. 创建订单接口

2.1.1. SERVICE_TYPE

GLINK_CREATE_ORDER_NOTIFY

2.1.2. 请求参数

创建订单请求

参数名	类型	列表	必填	备注
orderNumber	string	N	Y	订单编号
customerCode	string	N	Y	客户编码，保证唯一
warehouseCode	string	N	Y	仓库编码
extOrderNumber	string	N	N	客户销售平台编号（即客户单号）
poNumber	string	N	N	PO number
storeNumber	string	N	N	店铺
orderTime	string	N	Y	下单时间（格式yyyy-MM-dd'T'HH:mm:ssZ，如2017-05-01T16:00:00+0800）
latestShipDate	string	N	N	最晚发货时间
startShipDate	date	N	N	开始发货时间
originalOrderTime	string	N	N	原始orderTime
notes	string	N	N	仓库备注
signatureService	boolean	N	N	是否有【签名服务】
cashOnDelivery	boolean	N	N	代收货款服务
freightCollect	string	N	N	货到付款服务
collectingPaymentAmount	string	N	N	代收货款金额
shippingRate	string	N	N	运费
totalAmount	string	N	N	订单总金额
declaringValueAmount	string	N	N	保价金额
orderType	string	N	N	单据类型；可选值：B2C（普通2C出库，默认值）、B2B（普通2B出库）、RETURN_TO_SUPPLIER（退件入库）
salesChannel	string	N	N	销售渠道
currencyCode	string	N	N	货币单位，目前支持USD、CAD、CNY、THB，其他需要另外维护
priority	string	N	N	订单优先级；LOW：较低，NORMAL：普通，URGENT：紧急，CRITICAL：危急
extUserId	string	N	N
isCb	boolean	N	N	是否跨境店
externalPackageNumList	string	Y	N	外部包裹编码
orderTagList	long	Y	N	订单标签集合预售：1 、组包：4 、平台取消：8
addedServices	string	Y	N	签名服务集合；ADULT：成人签名，INDIRECT：间接签名，DIRECT：直接签名，ORDINARY：普通签名
supplier	string	N	N	供应商
cartonization	boolean	N	N	是否指定装箱 0：不装箱；1：需要指定装箱信息；不填默认为0
isSpecifyBatch	boolean	N	N	只是一个标记，方便后续在wms标记指定批次做筛选或者订单池做条件
addressType	int	N	N	地址类型；1：未知，2：商业地址，3：住宅地址
shippingInstructions	object	N	Y	装运说明
└ carrier	string	N	Y	承运商
└ carrierService	string	N	Y	承运商服务，无特殊要求都填STD
└ carrierBillingType	string	N	N	运费付款方式；SENDER 或 PREPAID/Prepaid：寄件方付款，3RDPARTY 或 BillThirdParty：第三方付款，RECEIVER 或 FreightCollect：收货方付款，OWNER：货主付款
└ shippingNotes	string	N	N	承运商备注
└ shippingLabelSource	string	N	Y	发货标签来源；ATTACHMENT：订单自带面单，通过附件方式提供，传此值时必须下发运单号和 carrier 信息，同时必须且只能下发一个 Shipping Label 面单附件；API：由仓库向快递系统取号；PRE_FILE：预生成面单文件；WMS_GEN：面单由仓库配置模板生成
└ trackingNumber	string	N	N	运单号
└ carrierAccount	string	N	N	承运商账户
└ carrierAccountZipcode	string	N	N	承运商账户邮编
└ externalCarrierCode	string	N	N	外部承运商编码
└ serviceLevel	string	N	N	服务级别；STD：Standard 标准服务，GND：Ground Service 地面运输，1DP：Next Day Air Saver 一日达航空件，2DA：2nd Day Air 二日达航空件，3DS：3 Day Select 三日达快递件，LTL：Freight 货运，DEFAULT：由百世海外仓系统选择合适承运商；FRT 等同于 LTL
└ actualLogistic	string	N	N	实际物流编码
shipTo	object	N	Y	收件人信息
└ name	string	N	Y	名称，主要用于B2B发货
└ company	string	N	N	所在公司名称
└ phoneNumber	string	N	N	电话，包括区号、电话号码及分机号，中间用"-"分隔
└ mobileNumber	string	N	Y	移动电话
└ email	string	N	N	邮件
└ streetLine1	string	N	Y	详细地址，目前限制在30个字符以内
└ streetLine2	string	N	N	详细地址，目前限制在30个字符以内
└ district	string	N	N	县（区），注意有些市下面是没有区的，如：义乌市
└ city	string	N	Y	所在市，如杭州市、上海市等
└ state	string	N	Y	所在省或州，如浙江省、北京、纽约、新泽西等
└ postalCode	string	N	Y	邮编（必传，下游系统有校验)
└ countryCode	string	N	Y	所在国家
└ companyName	string	N	N	公司名
└ streetLine3	string	N	N	详细地址，目前限制在30个字符以内
shipFrom	object	N	Y	寄件人信息
└ name	string	N	Y	名称，主要用于B2B发货
└ company	string	N	N	所在公司名称
└ phoneNumber	string	N	N	电话，包括区号、电话号码及分机号，中间用"-"分隔
└ mobileNumber	string	N	Y	移动电话
└ email	string	N	N	邮件
└ streetLine1	string	N	Y	详细地址，目前限制在30个字符以内
└ streetLine2	string	N	N	详细地址，目前限制在30个字符以内
└ district	string	N	N	县（区），注意有些市下面是没有区的，如：义乌市
└ city	string	N	Y	所在市，如杭州市、上海市等
└ state	string	N	Y	所在省或州，如浙江省、北京、纽约、新泽西等
└ postalCode	string	N	Y	邮编（必传，下游系统有校验)
└ countryCode	string	N	Y	所在国家
└ companyName	string	N	N	公司名
└ streetLine3	string	N	N	详细地址，目前限制在30个字符以内
items	object	Y	Y	订单商品信息
└ sku	string	N	Y	商品编码
└ name	string	N	N	订单项名称，与商品名称有可能不同
└ quantity	int	N	Y	商品数量
└ hsCode	string	N	N	海关申报编码
└ countryOfOrigin	string	N	N	原产国
└ boxCode	string	N	N	包材编码
└ retailSku	string	N	N	零售SKU
└ unitCost	double	N	N	成本价
└ retailDescription	string	N	N	零售描述
└ barCodeEA	string	N	N	EA 规格barCode
└ kitItemID	string	N	N	组合品ID，多个相同组合品，对应子品若拆行下发，需要给到不同ID，定义每行组合品唯一性
└ kitItemCode	string	N	N	组合品代码
└ kitItemDesc	string	N	N	组合品名称，如果下发组合品ID，组合品名称必填
└ kitItemQty	string	N	N	组合品数量，如果下发组合品ID，组合品数量必填
└ kitItemImage	string	N	N	组合品图片
└ ifDistributionItem	boolean	N	N	是否分销商品
└ ownerShipOfItem	string	N	N	货权归属
└ orderQuantity	int	N	N	订单量
└ lineNo	string	N	N	行号
└ stockStatus	string	N	N	库存状态；GOOD（良品）、DAMAGE（残品/破损）
└ unitPrice	string	N	N	单价
└ erpLineNo	string	N	N	erp行号
└ batchNo	string	N	N	批次号
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ originCountry	string	N	N	批次：生产国
└ udf1	string	N	N
└ udf2	string	N	N
└ udf3	string	N	N
└ udf4	string	N	N
└ udf5	string	N	N
└ udf6	string	N	N
└ udf7	string	N	N
└ udf8	string	N	N
└ udf9	string	N	N
└ udf10	string	N	N
└ udf11	string	N	N
└ udf12	string	N	N
files	object	Y	N	订单附件信息
└ fileType	string	N	N	文件类型；Shipping Label：面单，Commercial Invoice：发票，Bill of Lading：提货单，Product Label：商品标签，Carton Label：箱贴，Packing List：装箱单，Pallet Label：板贴，Other：其它
└ fileUrl	string	N	N	Url文件-推荐使用，暂不支持HTML
└ fileName	string	N	N	文件名称（整个文件的名称，例如：yywof.pdf）文件名必须包含文件格式
└ fileFormat	string	N	N	文件格式
└ isUpdate	string	N	N	文件是否二次更新
invoiceList	object	Y	N	外部下发发票信息
└ invoiceNo	string	N	N	发票号
└ taxCode	string	N	N	增值税税码
└ branchNo	string	N	N	税务部门代码
└ paymentMethod	string	N	N	付款方式
└ address	string	N	N	详细地址1
└ road	string	N	N	详细地址2
└ subDistrict	string	N	N	区县
└ district	string	N	N	城市
└ province	string	N	N	省/府
└ country	string	N	N	国家
└ zipCode	string	N	N	邮编
└ phone	string	N	N	电话号码
└ phone2	string	N	N	电话号码2
└ firstName	string	N	N	姓
└ lastName	string	N	N	名
└ invoiceDetailList	object	Y	N	发票详情
└ lineNo	int	N	N	行号
└ productSku	string	N	N	商品编码
└ productName	string	N	N	商品名称
└ shopSku	string	N	N	商品外部编码
└ qty	int	N	N	商品数量
└ shippingFee	double	N	N	运费
└ itemPrice	double	N	N	商品标价
└ taxAmount	double	N	N	税额
└ voucherPlatform	double	N	N	平台优惠
└ voucherSeller	double	N	N	卖方
└ paidPrice	double	N	N	商品售价
palletInfoList	object	Y	N	订单指定装托装箱信息
└ palletCode	string	N	N	指定托盘编号
└ boxCode	string	N	N	指定箱号
└ skuCode	string	N	N	sku编码
└ skuQty	string	N	N	SKU数量（EA）
udf5	string	N	N
udf6	string	N	N
udf7	string	N	N
udf8	string	N	N
udf9	string	N	N
udf10	string	N	N
udf11	string	N	N
udf12	string	N	N
udf13	string	N	N
udf14	string	N	N
udf15	string	N	N

2.1.3. 请求样例

JSON

{
  "orderNumber": "orderNumber_c9dac8c1f68e",
  "customerCode": "customerCode_dc6c0ddeec80",
  "warehouseCode": "warehouseCode_2f851a4e9e82",
  "extOrderNumber": "extOrderNumber_f6f61a722688",
  "extUserId": "extUserId_109a85cf74eb",
  "orderTime": "2025-08-21 15:56:39",
  "poNumber": "poNumber_346095b9dc0b",
  "notes": "notes_09316a020905",
  "orderType": "B2C",
  "signatureService": false,
  "addedServices": [
    "ORDINARY"
  ],
  "shippingInstructions": {
    "carrier": "carrier_22718bbec889",
    "carrierService": "carrierService_9f2c15c51e80",
    "carrierAccount": "carrierAccount_c1ede600f163",
    "carrierAccountZipcode": "carrierAccountZipcode_c5003fb70382",
    "serviceLevel": "STD",
    "carrierBillingType": "SENDER",
    "shippingNotes": "shippingNotes_a48b84fb2cd8",
    "trackingNumber": "trackingNumber_94bb2f1774cc",
    "shippingLabelSource": "API",
    "externalCarrierCode": "externalCarrierCode_d315011bb99b",
    "actualLogistic": "actualLogistic_6303ce4f6553"
  },
  "shipTo": {
    "name": "name_a037fa666057",
    "company": "company_cfd0bfcc9bbb",
    "companyName": "companyName_42089aff96f4",
    "phoneNumber": "phoneNumber_7fcaa1911a91",
    "mobileNumber": "mobileNumber_d168f5f79b99",
    "email": "email_70360681fbbf",
    "streetLine1": "streetLine1_6de30fad6773",
    "streetLine2": "streetLine2_d822c9121029",
    "streetLine3": "streetLine3_df1d609fe3cc",
    "district": "district_d3415bf42b53",
    "city": "city_a1ce8f5bdf24",
    "state": "state_893a0bc733f1",
    "postalCode": "postalCode_a66e9983b2ea",
    "countryCode": "countryCode_f28523e1379a",
    "houseNumber": "houseNumber_b2813a963d0a"
  },
  "shipFrom": {
    "name": "name_6b898c782081",
    "company": "company_b0ce6fa0bcb1",
    "companyName": "companyName_e458d120a5be",
    "phoneNumber": "phoneNumber_a1b2ae35a359",
    "mobileNumber": "mobileNumber_f613272692e5",
    "email": "email_673844d71e79",
    "streetLine1": "streetLine1_f39b7a12b188",
    "streetLine2": "streetLine2_164870f602b5",
    "streetLine3": "streetLine3_801872a0ea91",
    "district": "district_8089da1dda63",
    "city": "city_a8f082e1f599",
    "state": "state_1a114ad46d9d",
    "postalCode": "postalCode_b7be4d305970",
    "countryCode": "countryCode_c6d3b726b23d",
    "houseNumber": "houseNumber_5b1362665247"
  },
  "items": [
    {
      "sku": "sku_2d8952660609",
      "name": "name_9bbcc4a5ea0e",
      "quantity": 1,
      "orderQuantity": 1,
      "boxCode": "boxCode_5d207fdee5c4",
      "countryOfOrigin": "countryOfOrigin_951c04101889",
      "hsCode": "hsCode_9f46da6962f8",
      "lineNo": "lineNo_97fe21eb5059",
      "stockStatus": "GOOD",
      "retailSku": "retailSku_447b5063dda2",
      "retailDescription": "retailDescription_6c50dc2066de",
      "unitCost": 1.00,
      "unitPrice": 1.00,
      "erpLineNo": "erpLineNo_5dbfa5825cf7",
      "barCodeEA": "barCodeEA_dede313da8c9",
      "udf1": "udf1_0eb6a7f0ab0a",
      "udf2": "udf2_778265625c24",
      "udf3": "udf3_abcba7c4222c",
      "udf4": "udf4_b82241a920fd",
      "udf5": "udf5_2659bbabf7c1",
      "udf6": "udf6_395d24da1e34",
      "udf7": "udf7_3897d5ac2596",
      "udf8": "udf8_6aa39924d500",
      "udf9": "udf9_c2396f540959",
      "udf10": "udf10_ef32c23cd655",
      "udf11": "udf11_9d53f4572931",
      "udf12": "udf12_7762d50b4e21",
      "kitItemID": "kitItemID_0ba8e057d79e",
      "kitItemCode": "kitItemCode_b1c77bb92ef7",
      "kitItemDesc": "kitItemDesc_356a33768923",
      "kitItemQty": 1,
      "kitItemImage": "kitItemImage_d3cae8b83726",
      "ifDistributionItem": false,
      "ownerShipOfItem": "ownerShipOfItem_143bc685af29",
      "mfgDate": "mfgDate_d106948e803e",
      "expDate": "expDate_5fe1a4c99de9",
      "batchNo": "batchNo_1673fe828b31",
      "originCountry": "originCountry_6e09c0cecd68"
    }
  ],
  "totalAmount": 0.00,
  "collectingPaymentAmount": 0.00,
  "declaringValueAmount": 0.00,
  "shippingRate": 0.00,
  "freightCollect": false,
  "cashOnDelivery": false,
  "files": [
    {
      "fileType": "Shipping Label",
      "fileBase64": "fileBase64_7e3f0fb30006",
      "fileUrl": "fileUrl_06b61df15ce0",
      "fileName": "fileName_555334208839",
      "fileFormat": "fileFormat_e5a2d0625fe0",
      "isUpdate": false
    }
  ],
  "storeNumber": "storeNumber_134aa75c508b",
  "isCb": false,
  "currencyCode": "USD",
  "salesChannel": "salesChannel_fb44d16584b3",
  "invoiceList": [
    {
      "invoiceNo": "invoiceNo_db6c64696406",
      "taxCode": "taxCode_bef06039e383",
      "branchNo": "branchNo_1b4c552ecffa",
      "paymentMethod": "paymentMethod_bd5cf05a93f9",
      "address": "address_15678c2c6058",
      "road": "road_31224298f902",
      "subDistrict": "subDistrict_b087121f6cd7",
      "district": "district_ff534b0ad7c8",
      "province": "province_a2c39e1a3ff9",
      "country": "country_9a3213a081ec",
      "zipCode": "zipCode_6cb5c88e7c72",
      "phone": "phone_b8fee4a9f946",
      "phone2": "phone2_af5d9fbc59d2",
      "firstName": "firstName_0368c4d2bd27",
      "lastName": "lastName_2aa36fdf776f",
      "invoiceDetailList": [
        {
          "lineNo": 0,
          "productSku": "productSku_93db7f536874",
          "productName": "productName_6fcfd3d0b235",
          "shopSku": "shopSku_2c7e372d6cb5",
          "qty": 0,
          "shippingFee": 0.00,
          "itemPrice": 0.00,
          "paidPrice": 0.00,
          "taxAmount": 0.00,
          "voucherPlatform": 0.00,
          "voucherSeller": 0.00
        }
      ]
    }
  ],
  "startShipDate": "2025-08-21 15:56:39",
  "latestShipDate": "2025-08-21 15:56:39",
  "externalPackageNumList": [
    "externalPackageNumList_b61ffd7808c3"
  ],
  "originalOrderTime": "originalOrderTime_48dafc95ea95",
  "orderTagList": [
    0
  ],
  "addressType": 1,
  "supplier": "supplier_60bdecce269c",
  "udf5": "udf5_96f9c982e460",
  "udf6": "udf6_8c2486826872",
  "udf7": "udf7_8f6f37a05a3a",
  "udf8": "udf8_4024d35dbcba",
  "udf9": "udf9_8fa7b4a03c94",
  "udf10": "udf10_deeabf5ee023",
  "udf11": "udf11_7efa467249e5",
  "udf12": "udf12_6edcd8fa459b",
  "udf13": "udf13_3a0cf6aad151",
  "udf14": "udf14_7785170c3845",
  "udf15": "udf15_a33feb115abb",
  "cartonization": false,
  "palletInfoList": [
    {
      "palletCode": "palletCode_f92b009983af",
      "boxCode": "boxCode_0954543f7607",
      "skuCode": "skuCode_f2e028c41f04",
      "skuQty": 1
    }
  ],
  "platformOriginTrackingVos": [
    {
      "platformTrackingType": "platformTrackingType_fa021088eda4",
      "platformTrackingInfo": "platformTrackingInfo_615846c9ef27"
    }
  ],
  "isSpecifyBatch": false,
  "partnerId": "partnerId_f5f1566b795b"
}

2.1.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码，如果操作失败了，则提示错误类型
message	string	N	N	提示信息

2.1.5. 响应样例

JSON

{
  "success": false,
  "code": "code_074664f08113",
  "message": "message_5c9f9d220da5"
}

2.2. 取消订单接口

2.2.1. SERVICE_TYPE

GLINK_CANCEL_ORDER_NOTIFY

2.2.2. 请求参数

取消订单请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID；`cancelOrders` 会校验客户与 `partnerId` 是否匹配
customerCode	string	N	Y	客户编码；为空或订单号列表为空时返回 `INVALID_DATA`
orderNumbers	string	Y	Y	出库单号列表；单个订单会返回该订单取消结果，多个订单返回成功取消单号列表
extUserId	string	N	N	外部用户ID；参与订单匹配
orderTagList	long	Y	N	订单标签列表

2.2.3. 请求样例

JSON

{
  "customerCode": "customerCode_d6d6954c2d0b",
  "orderNumbers": [
    "orderNumbers_b2cbd98b5ffd"
  ],
  "extUserId": "extUserId_df7272d371ac",
  "orderTagList": [
    0
  ],
  "partnerId": "partnerId_fafdfc59583f"
}

2.2.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码，如果操作失败了，则提示错误类型
message	string	N	N	提示信息

2.2.5. 响应样例

JSON

{
  "success": false,
  "code": "code_074664f08113",
  "message": "message_5c9f9d220da5"
}

2.3. 查询订单接口

2.3.1. SERVICE_TYPE

GLINK_QUERY_ORDER_NOTIFY

2.3.2. 请求参数

查询出库单请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID；路由层按客户与 `partnerId` 选择处理方
customerCode	string	N	Y	客户编码；为空时报参数非法
orderNumbers	string	Y	Y	出库单号列表；一次最多查询100个
extUserId	string	N	N	外部用户ID；参与订单匹配
queryPackageContentsFromWms	boolean	N	N	是否从 WMS 查询包裹明细；查询V2会强制置为 `true`

请求示例

JSON

{
  "customerCode": "customerCode_6e3d9deb050c",
  "extUserId": "extUserId_56e517d15898",
  "orderNumbers": [
    "orderNumbers_c75a35d298fa"
  ],
  "queryPackageContentsFromWms": false,
  "partnerId": "partnerId_86e8efcd34ee"
}

响应参数

参数名	类型	列表	必填	备注
total	int	N	N	总记录数；当执行成功时有值
success	boolean	N	Y	成功标志
code	string	N	N	错误编码
message	string	N	N	错误消息
orderInfoList	object	Y	N	当前页出库单信息
└ orderNumber	string	N	Y	出库单号
└ customerCode	string	N	Y	客户编码
└ warehouseCode	string	N	Y	仓库编码
└ extOrderNumber	string	N	N	外部订单号
└ extUserId	string	N	N	外部用户ID
└ poNumber	string	N	N	PO号
└ orderTime	string	N	N	下单时间
└ shippingTime	string	N	N	发运时间
└ trackingNumber	string	N	N	物流主运单号
└ billOfLadingNumber	string	N	N	货运单号
└ carrier	string	N	N	承运商
└ carrierService	string	N	N	承运商服务
└ wmsOrderNumber	string	N	N	WMS订单号
└ status	string	N	N	订单状态；Creating（创建中）、Processing（处理中）、SendingToWms（发送仓库中）、Received（仓库已接收/待处理）、Shipped（已发货）、Error（异常）、OverAllocated（超分配）、Voided（已取消）、InsufficientInventory（库存不足）
└ storeNumber	string	N	N	店铺编号
└ salesChannel	string	N	N	销售渠道
└ endShipDate	string	N	N	最晚发货时间
└ dimensionUnit	string	N	N	尺寸单位；cm：厘米，inch：英寸
└ weightUnit	string	N	N	重量单位；kg：千克，lb：磅
└ packages	object	Y	N	包裹信息
└ orderNumber	string	N	N	订单编号
└ customerCode	string	N	N	客户编码
└ packageNumber	string	N	N	包裹编号
└ carrier	string	N	N	承运商
└ carrierService	string	N	N	承运商服务
└ trackingNumber	string	N	N	运单号
└ length	double	N	N	包裹长
└ width	double	N	N	包裹宽
└ height	double	N	N	包裹高
└ weight	double	N	N	包裹重量
└ packageContents	object	Y	N	包裹明细
└ sku	string	N	N	SKU编码
└ quantity	double	N	N	数量
└ retailSKU	string	N	N	零售SKU
└ retailDescription	string	N	N	零售名称
└ shipTo	object	N	N	收件人信息
└ name	string	N	N	名称
└ company	string	N	N	公司
└ phoneNumber	string	N	N	电话
└ email	string	N	N	邮件
└ streetLine1	string	N	N	地址1
└ streetLine2	string	N	N	地址2
└ district	string	N	N	区/县
└ city	string	N	N	城市
└ state	string	N	N	省/州
└ postalCode	string	N	N	邮编
└ countryCode	string	N	N	国家编码
└ shippingExceptionVO	object	N	N	发运异常
└ code	string	N	N	异常编码
└ message	string	N	N	异常信息

响应示例

{
  "total": null,
  "success": true,
  "code": "success",
  "message": null,
  "orderInfoList": [
    {
      "orderNumber": "SO202606050001",
      "customerCode": "CUSTOMER001",
      "warehouseCode": "WH001",
      "extOrderNumber": "EXT202606050001",
      "extUserId": "USER001",
      "poNumber": "PO202606050001",
      "orderTime": "2026-06-05 15:00:00",
      "shippingTime": "2026-06-05 16:00:00",
      "trackingNumber": "YT123456789CN",
      "billOfLadingNumber": "BOL202606050001",
      "carrier": "UPS",
      "carrierService": "GROUND",
      "wmsOrderNumber": "WMS202606050001",
      "status": "Shipped",
      "storeNumber": "STORE001",
      "salesChannel": "SHOPIFY",
      "endShipDate": "2026-06-06 23:59:59",
      "dimensionUnit": "cm",
      "weightUnit": "kg",
      "shipTo": {
        "name": "Tom",
        "phoneNumber": "1234567890",
        "streetLine1": "Address 1",
        "city": "LA",
        "state": "CA",
        "postalCode": "90001",
        "countryCode": "US"
      },
      "packages": [
        {
          "orderNumber": "SO202606050001",
          "customerCode": "CUSTOMER001",
          "packageNumber": "PKG001",
          "carrier": "UPS",
          "carrierService": "GROUND",
          "trackingNumber": "YT123456789CN",
          "length": 10.0,
          "width": 8.0,
          "height": 6.0,
          "weight": 1.2,
          "packageContents": [
            {
              "sku": "SKU001",
              "quantity": 1.0,
              "retailSKU": "RSKU001",
              "retailDescription": "商品1"
            }
          ]
        }
      ],
      "shippingExceptionVO": {
        "code": null,
        "message": null
      }
    }
  ]
}

2.4. 查询订单接口(V2)

2.4.1. SERVICE_TYPE

GLINK_BATCH_QUERY_ORDER_NOTIFY

2.4.2. 请求参数

查询出库单请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID
customerCode	string	N	Y	客户编码
warehouseCode	string	N	Y	仓库编码
extUserId	string	N	N	外部用户ID
orderNumbers	string	Y	N	出库单号列表；最多100个
extOrderNumbers	string	Y	N	外部订单号列表
shippingTimeFrom	string	N	条件	发运时间起，格式 yyyy-MM-dd HH:mm:ss
shippingTimeTo	string	N	条件	发运时间止，格式 yyyy-MM-dd HH:mm:ss
createdTimeFrom	string	N	条件	创建时间起，格式 yyyy-MM-dd HH:mm:ss
createdTimeTo	string	N	条件	创建时间止，格式 yyyy-MM-dd HH:mm:ss
orderedTimeFrom	string	N	条件	下单时间起，格式 yyyy-MM-dd HH:mm:ss
orderedTimeTo	string	N	条件	下单时间止，格式 yyyy-MM-dd HH:mm:ss
odoType	string	N	N	出库单类型
stage	string	N	N	订单阶段；常见值：CREATED（已创建）、REVIEW（审核中）、DUE_OUT（待出库）、ALLOCATED（已分配）、RELEASED（已释放）、PICK/PICKING/PICKED（拣货中/已拣货）、PACK/PACKING（打包中）、PACKED（已打包）、ROUTING（路由中）、SHIPPED（已发货）
status	string	N	N	订单状态；常见值：VALID（生效）、HELD（挂起）、CANCELLED（取消）
ifNeedBatchInfo	boolean	N	N	是否返回批次信息；默认 false
queryFile	boolean	N	N	是否返回附件信息
page	int	N	N	页号；默认 1
pageSize	int	N	N	每页记录数；默认 100，最大 200

当 orderNumbers 为空时，shippingTimeFrom/shippingTimeTo、createdTimeFrom/createdTimeTo、orderedTimeFrom/orderedTimeTo、extOrderNumbers 至少填写一组查询条件。

2.4.3. 请求示例

JSON

{
  "partnerId": "GLINK",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "extUserId": "EXT_USER_001",
  "orderNumbers": [
    "SO202606050001"
  ],
  "extOrderNumbers": [
    "EXT202606050001"
  ],
  "shippingTimeFrom": "2026-06-05 00:00:00",
  "shippingTimeTo": "2026-06-05 23:59:59",
  "stage": "SHIPPED",
  "status": "VALID",
  "ifNeedBatchInfo": true,
  "queryFile": true,
  "page": 1,
  "pageSize": 50
}

2.4.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	成功标志
code	string	N	N	错误编码
message	string	N	N	错误消息
total	long	N	N	总记录数
orderInfoList	object	Y	N	当前页出库单信息
└ partnerId	string	N	N	合作伙伴ID
└ orderNumber	string	N	Y	出库单号
└ customerCode	string	N	Y	客户编码
└ warehouseCode	string	N	Y	仓库编码
└ extOrderNumber	string	N	N	外部订单号
└ extUserId	string	N	N	外部用户ID
└ poNumber	string	N	N	PO号
└ orderTime	string	N	N	下单时间
└ shippingTime	string	N	N	发运时间
└ trackingNumber	string	N	N	主运单号
└ carrier	string	N	N	承运商
└ carrierService	string	N	N	承运商服务
└ wmsOrderNumber	string	N	N	WMS订单号
└ status	string	N	N	订单状态；常见值：VALID（生效）、HELD（挂起）、CANCELLED（取消）
└ stage	string	N	N	订单阶段；常见值：CREATED（已创建）、REVIEW（审核中）、DUE_OUT（待出库）、ALLOCATED（已分配）、RELEASED（已释放）、PICK/PICKING/PICKED（拣货中/已拣货）、PACK/PACKING（打包中）、PACKED（已打包）、ROUTING（路由中）、SHIPPED（已发货）
└ omsOrderStatus	string	N	N	OMS订单状态
└ orderType	string	N	N	订单类型；常见值：B2C（普通2C出库）、B2B（普通2B出库）
└ storeNumber	string	N	N	店铺编号
└ salesChannel	string	N	N	销售渠道
└ startShipDate	string	N	N	开始发货时间
└ endShipDate	string	N	N	最晚发货时间
└ dimensionUnit	string	N	N	尺寸单位；cm：厘米，inch：英寸
└ weightUnit	string	N	N	重量单位；kg：千克，lb：磅
└ createTime	date	N	N	创建时间
└ orderCreatedTime	string	N	N	订单创建时间
└ cashOnDelivery	boolean	N	N	是否代收货款
└ signatureService	boolean	N	N	是否签名服务
└ externalProviderId	string	N	N	外部服务商编码
└ externalWarehouseCode	string	N	N	外部仓库编码
└ externalCarrierCode	string	N	N	外部承运商编码
└ logisticsProvider	string	N	N	物流服务商
└ actualLogistic	string	N	N	实际物流
└ addressType	int	N	N	地址类型；1：未知，2：商业地址，3：住宅地址
└ theoreticalWeightEA	double	N	N	订单理论重量（EA）
└ theoreticalVolumeEA	double	N	N	订单理论体积（EA）
└ skuMaxLengthEA	double	N	N	商品最大长度（EA）
└ supplier	string	N	N	供应商
└ udf5	string	N	N	自定义字段5
└ udf6	string	N	N	自定义字段6
└ udf7	string	N	N	自定义字段7
└ udf8	string	N	N	自定义字段8
└ udf9	string	N	N	自定义字段9
└ udf10	string	N	N	自定义字段10
└ udf11	string	N	N	自定义字段11
└ udf12	string	N	N	自定义字段12
└ udf13	string	N	N	自定义字段13
└ udf14	string	N	N	自定义字段14
└ udf15	string	N	N	自定义字段15
└ snUrl	string	N	N	序列号文件URL
└ shipTo	object	N	N	收件人信息
└ name	string	N	N	姓名
└ company	string	N	N	公司
└ companyName	string	N	N	公司名
└ phoneNumber	string	N	N	电话
└ mobileNumber	string	N	N	手机
└ email	string	N	N	邮箱
└ streetLine1	string	N	N	地址1
└ streetLine2	string	N	N	地址2
└ district	string	N	N	区/县
└ city	string	N	N	城市
└ state	string	N	N	省/州
└ postalCode	string	N	N	邮编
└ countryCode	string	N	N	国家编码
└ shipFrom	object	N	N	寄件人信息
└ name	string	N	N	姓名
└ company	string	N	N	公司
└ phoneNumber	string	N	N	电话
└ email	string	N	N	邮箱
└ streetLine1	string	N	N	地址1
└ streetLine2	string	N	N	地址2
└ district	string	N	N	区/县
└ city	string	N	N	城市
└ state	string	N	N	省/州
└ postalCode	string	N	N	邮编
└ countryCode	string	N	N	国家编码
└ items	object	Y	N	商品明细
└ sku	string	N	N	SKU编码
└ lineNo	string	N	N	行号
└ quantity	int	N	N	发货数量
└ skuStatus	string	N	N	货物状态；GOOD（良品）、DAMAGE（残品/破损）
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ batchNo	string	N	N	批次号
└ originCountry	string	N	N	原产国
└ skuDescription	string	N	N	商品描述
└ skuCategory	string	N	N	商品分类
└ udf1	string	N	N	自定义字段1
└ udf2	string	N	N	自定义字段2
└ udf3	string	N	N	自定义字段3
└ udf4	string	N	N	自定义字段4
└ retailSKU	string	N	N	零售SKU
└ retailDescription	string	N	N	零售名称
└ exception	boolean	N	N	是否异常
└ exceptionMessage	string	N	N	异常信息
└ unitCost	double	N	N	单位成本
└ unitPrice	double	N	N	单价
└ handlings	object	N	N	订单操作/计费信息
└ standardPallets	int	N	N	标准托盘数
└ oversizedPallets	int	N	N	超规托盘数
└ preStandardPallets	int	N	N	预建标准托盘数
└ preOversizedPallets	int	N	N	预建超规托盘数
└ handlingDetails	object	Y	N	操作明细
└ chargeType	string	N	N	操作/计费活动类型
└ chargeUnit	string	N	N	操作/计费活动单位
└ chargeQty	float	N	N	操作数量
└ chargeManHour	float	N	N	操作工时
└ chargeNote	string	N	N	备注
└ packages	object	Y	N	包裹信息
└ packageNumber	string	N	N	包裹编号
└ trackingNumber	string	N	N	运单号
└ weight	float	N	N	包裹重量
└ length	float	N	N	包裹长
└ width	float	N	N	包裹宽
└ height	float	N	N	包裹高
└ volume	float	N	N	包裹体积
└ packageContents	object	Y	N	包裹商品明细
└ sku	string	N	N	SKU编码
└ quantity	double	N	N	数量
└ retailSKU	string	N	N	零售SKU
└ retailDescription	string	N	N	零售名称
└ skuStockStatus	string	N	N	货物状态
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ batchNo	string	N	N	批次号
└ originCountry	string	N	N	原产国
└ pallets	object	Y	N	托盘信息
└ palletCode	string	N	N	托盘号
└ preBuilt	boolean	N	N	是否预打板
└ weight	float	N	N	托盘重量
└ length	float	N	N	托盘长
└ width	float	N	N	托盘宽
└ height	float	N	N	托盘高
└ volume	float	N	N	托盘体积
└ snList	object	Y	N	序列号明细
└ skuCode	string	N	N	SKU编码
└ snList	string	Y	N	序列号列表
└ batchInfo	object	Y	N	批次信息，仅 `ifNeedBatchInfo=true` 时返回
└ lineNo	int	N	N	行号
└ sku	string	N	N	SKU编码
└ qty	int	N	N	批次数量
└ stockStatus	string	N	N	货物状态
└ batchNumber	string	N	N	批次号
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ retailSKU	string	N	N	零售SKU
└ coo	string	N	N	原产国
└ fileInfoList	object	Y	N	附件信息，仅 `queryFile=true` 时返回
└ fileName	string	N	N	文件名
└ fileUrl	string	N	N	文件URL
└ fileType	string	N	N	文件类型
└ fileFormat	string	N	N	文件格式
└ isUpdate	boolean	N	N	是否更新
└ additionalInfoList	object	Y	N	附加信息
└ infoType	string	N	N	附加信息类型名称
└ infoTypeCode	string	N	N	附加信息类型编码
└ content	string	N	N	信息内容
└ note	string	N	N	信息描述
└ uploadedTime	string	N	N	上传时间
└ orderAdditionalFiles	object	Y	N	附件列表
└ fileName	string	N	N	文件名
└ fileUrl	string	N	N	文件URL
└ fileType	string	N	N	文件类型
└ fileFormat	string	N	N	文件格式
└ isUpdate	boolean	N	N	是否更新
└ shippingExceptionVO	object	N	N	发运异常
└ code	string	N	N	异常编码
└ message	string	N	N	异常信息

2.4.5. 响应样例

JSON

{
  "success": true,
  "code": null,
  "message": null,
  "total": 1,
  "orderInfoList": [
    {
      "partnerId": "GLINK",
      "orderNumber": "SO202606050001",
      "customerCode": "CUSTOMER001",
      "warehouseCode": "WH001",
      "extOrderNumber": "EXT202606050001",
      "extUserId": "EXT_USER_001",
      "poNumber": "PO202606050001",
      "orderTime": "2026-06-05 15:00:00",
      "shippingTime": "2026-06-05 16:00:00",
      "trackingNumber": "YT123456789CN",
      "carrier": "UPS",
      "carrierService": "GROUND",
      "wmsOrderNumber": "WMS202606050001",
      "status": "VALID",
      "stage": "SHIPPED",
      "omsOrderStatus": "WMSShipped",
      "orderType": "B2C",
      "storeNumber": "STORE001",
      "salesChannel": "SHOPIFY",
      "startShipDate": "2026-06-05 00:00:00",
      "endShipDate": "2026-06-06 23:59:59",
      "dimensionUnit": "cm",
      "weightUnit": "kg",
      "actualLogistic": "UPS",
      "addressType": 3,
      "shipTo": {
        "name": "Tom",
        "phoneNumber": "1234567890",
        "streetLine1": "Address 1",
        "city": "LA",
        "state": "CA",
        "postalCode": "90001",
        "countryCode": "US"
      },
      "shipFrom": {
        "name": "BEST Warehouse",
        "phoneNumber": "1234567890",
        "streetLine1": "Warehouse Address",
        "city": "LA",
        "state": "CA",
        "postalCode": "90002",
        "countryCode": "US"
      },
      "items": [
        {
          "sku": "SKU001",
          "lineNo": "1",
          "quantity": 1,
          "skuStatus": "GOOD",
          "batchNo": "BATCH001",
          "originCountry": "CN",
          "skuDescription": "商品1",
          "retailSKU": "RSKU001",
          "retailDescription": "商品1"
        }
      ],
      "packages": [
        {
          "packageNumber": "PKG001",
          "trackingNumber": "YT123456789CN",
          "length": 10.0,
          "width": 8.0,
          "height": 6.0,
          "weight": 1.2,
          "packageContents": [
            {
              "sku": "SKU001",
              "quantity": 1.0,
              "retailSKU": "RSKU001",
              "retailDescription": "商品1",
              "skuStockStatus": "GOOD",
              "batchNo": "BATCH001",
              "originCountry": "CN"
            }
          ]
        }
      ],
      "batchInfo": [
        {
          "lineNo": 1,
          "sku": "SKU001",
          "qty": 1,
          "stockStatus": "GOOD",
          "batchNumber": "BATCH001",
          "coo": "CN"
        }
      ],
      "shippingExceptionVO": {
        "code": null,
        "message": null
      }
    }
  ]
}

2.5. 订单反馈接口

2.5.1. SERVICE_TYPE

GLINK_UPDATE_ORDER_STATUS

2.5.2. 接口说明

订单状态变更时，平台按配置向客户系统推送订单信息。客户系统需返回处理结果。

2.5.3. 请求参数

订单反馈请求

参数名	类型	列表	必填	备注
partnerId	string	N	Y	合作伙伴ID
orderNumber	string	N	Y	出库单号
customerCode	string	N	Y	客户编码
warehouseCode	string	N	Y	仓库编码
extOrderNumber	string	N	N	外部订单号
extUserId	string	N	N	外部用户ID
poNumber	string	N	N	PO号
orderTime	string	N	N	下单时间
shippingTime	string	N	N	发运时间
trackingNumber	string	N	N	主运单号
billOfLadingNumber	string	N	N	货运单号
carrier	string	N	N	承运商
carrierService	string	N	N	承运商服务
wmsOrderNumber	string	N	N	WMS订单号
status	string	N	N	订单状态；WMSReview（待审核）、WMSDueOut（待出库）、WMSReleased（已释放）、WMSPicking（拣货中）、WMSReceived（仓库已接收）、Packed（已包装）、Routing（路由中）、WMSShipped（已发货）
stage	string	N	N	订单阶段；常见值：CREATED（已创建）、REVIEW（审核中）、DUE_OUT（待出库）、ALLOCATED（已分配）、RELEASED（已释放）、PICK/PICKING/PICKED（拣货中/已拣货）、PACK/PACKING（打包中）、PACKED（已打包）、ROUTING（路由中）、SHIPPED（已发货）
storeNumber	string	N	N	店铺编号
salesChannel	string	N	N	销售渠道
orderType	string	N	N	订单类型；常见值：B2C（普通2C出库）、B2B（普通2B出库）
externalProviderId	string	N	N	外部服务商编码
externalWarehouseCode	string	N	N	外部仓库编码
externalWarehouseName	string	N	N	外部仓库名称
tcwWarehouseType	string	N	N	TCW仓库类型
externalCarrierCode	string	N	N	外部承运商编码
dimensionUnit	string	N	N	尺寸单位；cm：厘米，inch：英寸
weightUnit	string	N	N	重量单位；kg：千克，lb：磅
createTime	date	N	N	创建时间
actualLogistic	string	N	N	实际物流
logisticsProvider	string	N	N	物流服务商
addressType	int	N	N	地址类型；1：未知，2：商业地址，3：住宅地址
snUrl	string	N	N	序列号文件URL
shipTo	object	N	N	收件人信息
└ name	string	N	N	名称
└ company	string	N	N	公司
└ companyName	string	N	N	公司名
└ phoneNumber	string	N	N	电话
└ mobileNumber	string	N	N	移动电话
└ email	string	N	N	邮件
└ streetLine1	string	N	N	地址1
└ streetLine2	string	N	N	地址2
└ district	string	N	N	区/地址3
└ city	string	N	N	城市
└ state	string	N	N	省/州
└ postalCode	string	N	N	邮编
└ countryCode	string	N	N	国家
shipFrom	object	N	N	寄件人信息
└ name	string	N	N	名称
└ company	string	N	N	公司
└ companyName	string	N	N	公司名
└ phoneNumber	string	N	N	电话
└ mobileNumber	string	N	N	移动电话
└ email	string	N	N	邮件
└ streetLine1	string	N	N	地址1
└ streetLine2	string	N	N	地址2
└ district	string	N	N	区/地址3
└ city	string	N	N	城市
└ state	string	N	N	省/州
└ postalCode	string	N	N	邮编
└ countryCode	string	N	N	国家
items	object	Y	N	商品明细
└ sku	string	N	N	SKU编码
└ lineNo	string	N	N	行号
└ quantity	int	N	N	实发数量
└ skuStatus	string	N	N	货物状态；GOOD（良品）、DAMAGE（残品/破损）
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ batchNo	string	N	N	批次号
└ originCountry	string	N	N	原产国
└ skuDescription	string	N	N	货物描述
└ skuCategory	string	N	N	货物分类
└ udf1	string	N	N	自定义字段
└ udf2	string	N	N	自定义字段
└ udf3	string	N	N	自定义字段
└ udf4	string	N	N	自定义字段
└ retailSKU	string	N	N	零售SKU
└ retailDescription	string	N	N	零售描述
└ exception	boolean	N	N	是否异常
└ exceptionMessage	string	N	N	异常信息
packages	object	Y	N	包裹信息
└ packageType	string	N	N	包装类型
└ materialCode	string	N	N	包装材料代码
└ volume	double	N	N	包裹体积
└ height	double	N	N	包裹高
└ width	double	N	N	包裹宽
└ length	double	N	N	包裹长
└ weight	double	N	N	包裹重量
└ trackingNumber	string	N	N	运单号
└ packageNumber	string	N	N	包裹编号
└ externalPackageNumList	string	Y	N	外部包裹编码
└ logisticsProvider	string	N	N	物流服务商
└ actualLogistic	string	N	N	实际物流
└ packageContents	object	Y	N	包裹明细
└ sku	string	N	N	SKU编码
└ quantity	double	N	N	数量
└ retailSKU	string	N	N	零售SKU
└ retailDescription	string	N	N	零售名称
└ skuStockStatus	string	N	N	货物状态；GOOD（良品）、DAMAGE（残品/破损）
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ batchNo	string	N	N	批次号
└ originCountry	string	N	N	原产国
pallets	object	Y	N	托信息
└ palletCode	string	N	N	托盘编码
└ preBuilt	boolean	N	N	是否预制
└ weight	double	N	N	重量
└ length	double	N	N	长度
└ width	double	N	N	宽度
└ height	double	N	N	高度
└ volume	double	N	N	体积
snList	object	Y	N	序列号列表
└ skuCode	string	N	N	SKU
└ snList	string	Y	N	SN列表
batchInfo	object	Y	N	批次信息
└ lineNo	int	N	N	行号
└ sku	string	N	N	SKU
└ qty	int	N	N	数量
└ stockStatus	string	N	N	货物状态；GOOD（良品）、DAMAGE（残品/破损）
└ batchNumber	string	N	N	批次号
└ mfgDate	string	N	N	生产日期
└ expDate	string	N	N	失效日期
└ coo	string	N	N	原产国
└ retailSKU	string	N	N	零售SKU
└ udf1	string	N	N	自定义字段
└ udf2	string	N	N	自定义字段
└ udf3	string	N	N	自定义字段
└ udf4	string	N	N	自定义字段
└ udf5	string	N	N	自定义字段
└ udf6	string	N	N	自定义字段
└ udf7	string	N	N	自定义字段
└ udf8	string	N	N	自定义字段
└ udf9	string	N	N	自定义字段
└ udf10	string	N	N	自定义字段
└ udf11	string	N	N	自定义字段
└ udf12	string	N	N	自定义字段
└ wmsReceiptNo	string	N	N	WMS入库单号
└ receiptDate	date	N	N	入库日期
handlings	object	N	N	订单处理信息
└ standardPallets	int	N	N	标准托数
└ oversizedPallets	int	N	N	超规托数
└ preStandardPallets	int	N	N	预标准托数
└ preOversizedPallets	int	N	N	预超规托数
└ handlingDetails	object	Y	N	处理信息明细
└ chargeType	string	N	N	费用类型计费明细
└ chargeUnit	string	N	N	计费单位计费明细
└ chargeQty	double	N	N	计费数量
└ chargeManHour	double	N	N	工时
└ chargeNote	string	N	N	备注
shippingExceptionVO	object	N	N	发运异常信息
└ code	string	N	N	异常编码
└ message	string	N	N	异常信息
additionalInfoList	object	Y	N	出库单附加信息

2.5.4. 请求示例

JSON

{
  "partnerId": "QIANYI",
  "orderNumber": "SO202606050001",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "extUserId": "USER001",
  "wmsOrderNumber": "WMS202606050001",
  "status": "Shipped",
  "stage": "SHIPPED",
  "trackingNumber": "YT123456789CN",
  "carrier": "UPS",
  "carrierService": "GROUND",
  "shippingTime": "2026-06-05 15:30:00",
  "items": [
    {
      "sku": "SKU001",
      "lineNo": "1",
      "quantity": 1,
      "skuStatus": "GOOD"
    }
  ],
  "packages": [
    {
      "packageNumber": "PKG001",
      "trackingNumber": "YT123456789CN",
      "packageType": "Carton",
      "weight": 1.2,
      "packageContents": [
        {
          "sku": "SKU001",
          "quantity": 1
        }
      ]
    }
  ]
}

2.5.5. 响应参数

外部系统需按 MetaResponse 返回处理结果。

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码，失败时返回错误类型
message	string	N	N	提示信息

2.5.6. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "success"
}

2.6. 订单添加附件接口

2.6.1. SERVICE_TYPE

GLINK_CREATE_FILE_NOTIFY

2.6.2. 请求参数

订单添加附件请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID；路由层按客户与 `partnerId` 选择处理方
customerCode	string	N	Y	客户编码，保证唯一
orderNumber	string	N	Y	客户交易生成物流订单号，客户系统保证唯一
extUserId	string	N	N	外部用户ID；查询订单时参与匹配
files	object	Y	Y	订单附件信息；同一次请求内只能全部使用URL附件或全部使用Base64附件
└ fileType	string	N	Y	文件类型；Shipping Label：面单，Commercial Invoice：发票，Bill of Lading：提货单，Product Label：商品标签，Carton Label：箱贴，Packing List：装箱单，Pallet Label：板贴，Other：其它
└ fileUrl	string	N	C	URL文件地址；与fileBase64二选一，且同一次请求内不能混用URL附件和Base64附件
└ fileBase64	string	N	C	Base64文件内容；与fileUrl二选一，且同一次请求内不能混用URL附件和Base64附件；Base64文件大小不能超过系统订单附件大小限制
└ fileName	string	N	Y	文件名称，例如SO202606050001-label.pdf；用于识别文件后缀，文件名中的非ASCII字符会被移除
└ fileFormat	string	N	N	文件格式；传入时必须属于系统文件类型配置，未传时根据fileName、fileUrl或Base64内容识别
└ isUpdate	boolean	N	N	文件是否二次更新；不传默认false
shippingInstructions	object	N	N	装运说明
└ carrier	string	N	N	承运商
└ carrierService	string	N	N	承运商服务
└ trackingNumber	string	N	N	运单号
pickupCode	string	N	N	取件码

2.6.3. 请求样例

URL附件

{
  "partnerId": "GERP",
  "customerCode": "CUSTOMER001",
  "orderNumber": "SO202606050001",
  "extUserId": "USER001",
  "shippingInstructions": {
    "carrier": "UPS",
    "carrierService": "GROUND",
    "trackingNumber": "1Z999AA10123456784"
  },
  "pickupCode": "PK001",
  "files": [
    {
      "fileType": "Shipping Label",
      "fileUrl": "https://example.com/files/SO202606050001-label.pdf",
      "fileName": "SO202606050001-label.pdf",
      "fileFormat": "pdf",
      "isUpdate": false
    }
  ]
}

Base64附件

{
  "customerCode": "CUSTOMER001",
  "orderNumber": "SO202606050001",
  "files": [
    {
      "fileType": "Commercial Invoice",
      "fileBase64": "JVBERi0xLjQKJcfsj6IK",
      "fileName": "SO202606050001-invoice.pdf",
      "fileFormat": "pdf",
      "isUpdate": false
    }
  ]
}

2.6.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码；成功时当前实现未赋值，失败时返回错误类型
message	string	N	N	提示信息；成功时该接口实际返回为空字符串

2.6.5. 响应样例

JSON

{
  "success": true,
  "message": ""
}

2.7. 物流状态推送接口

2.7.1. SERVICE_TYPE

GLINK_UPDATE_LOGISTIC_STATUS_NOTIFY_V2

2.7.2. 请求参数

物流状态推送请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID
customerCode	string	N	N	客户编码；传入时按客户编码+ERP单号更新物流状态；未传时按WMS单号更新
warehouseCode	string	N	N	仓库编码；未传 customerCode 时必填
updateTrackNo	boolean	N	N	是否同步更新订单头、包裹上的运单号；true 表示更新
orderNumberList	object	Y	Y	订单物流状态明细；不能为空
└ orderNumber	string	N	N	ERP单号；传入 customerCode 时必填
└ wmsOrderNumber	string	N	N	WMS单号；未传 customerCode 时必填
└ trackingNumber	string	N	N	运单号
└ status	string	N	Y	物流状态；PENDING（待揽收）、SHIPPED（已揽收）、IN_TRANSIT（运输中）、DELIVERYING（投递中）、DELIVERED（已签收）、NOT_FOUND（未查到）、EXCEPTION（异常）、CANCELLED（已取消）
└ extUserId	string	N	N	外部用户ID
└ eventList	object	Y	N	物流事件列表
└ event	string	N	N	物流事件描述
└ eventDate	long	N	N	事件时间戳，Unix 时间戳（毫秒）

2.7.3. 请求样例

JSON

{
  "partnerId": "GERP",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "updateTrackNo": true,
  "orderNumberList": [
    {
      "orderNumber": "SO202606050001",
      "trackingNumber": "YT123456789CN",
      "status": "IN_TRANSIT",
      "extUserId": "EXT_USER_001",
      "eventList": [
        {
          "event": "Arrived at sorting center",
          "eventDate": 1780632000000
        }
      ]
    }
  ]
}

2.7.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true 表示处理成功，false 表示处理失败
code	string	N	N	操作状态码
message	string	N	N	提示信息
result	object	N	Y	物流状态推送结果
└ success	boolean	N	Y	业务处理结果；true 表示全部成功，false 表示存在失败明细
└ code	string	N	N	业务状态码；失败场景可能返回 INVALID_DATA
└ message	string	N	N	业务提示信息
└ warehouseCode	string	N	N	仓库编码；目标方法会从请求参数回填
└ orderNumberList	object	Y	N	失败明细列表；全部成功时可能不返回
└ orderNumber	string	N	N	ERP单号
└ wmsOrderNumber	string	N	N	WMS单号
└ trackingNumber	string	N	N	运单号
└ status	string	N	N	物流状态；PENDING：待揽收，SHIPPED：已揽收，IN_TRANSIT：运输中，DELIVERYING：投递中，DELIVERED：已签收，NOT_FOUND：未查到，EXCEPTION：异常，CANCELLED：已取消
└ extUserId	string	N	N	外部用户ID
└ errorMessage	string	N	N	单条明细失败原因

2.7.5. 响应样例

JSON

{
  "success": true,
  "result": {
    "success": true,
    "warehouseCode": "WH001"
  }
}

失败响应样例

{
  "success": true,
  "result": {
    "success": false,
    "code": "INVALID_DATA",
    "message": "orderNumberList doesn't empty",
    "warehouseCode": "WH001",
    "orderNumberList": [
      {
        "orderNumber": "",
        "trackingNumber": "YT123456789CN",
        "status": "IN_TRANSIT",
        "extUserId": "EXT_USER_001",
        "errorMessage": "orderNumber doesn't empty"
      }
    ]
  }
}

2.8. 线上订单状态更新接口

用于按 ERP 单号批量更新线上订单状态。

2.8.1. SERVICE_TYPE

GLINK_UPDATE_ORDER_ONLINE_STATUS_NOTIFY

2.8.2. 请求参数

线上订单状态更新请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID
customerCode	string	N	Y	客户编码
warehouseCode	string	N	N	仓库编码
orderNumberList	object	Y	Y	订单状态明细列表，不能为空
└ orderNumber	string	N	Y	ERP 单号
└ onlineStatus	string	N	Y	线上订单状态；不同渠道状态取值不同，按原值传递
└ extUserId	string	N	N	外部用户 ID

2.8.3. 请求样例

JSON

{
  "partnerId": "GERP",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "orderNumberList": [
    {
      "orderNumber": "SO202606050001",
      "onlineStatus": "PAID",
      "extUserId": "USER001"
    }
  ]
}

2.8.4. 响应参数

接口返回 GomsResponse<OrderOnlineStatusVo>。

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true 表示处理成功，false 表示处理失败
code	string	N	N	操作状态码
message	string	N	N	提示信息
result	object	N	Y	业务处理结果
└ success	boolean	N	Y	单条记录处理结果；处理失败时为 false
└ code	string	N	N	业务状态码；本接口明确设置的失败码为 `INVALID_DATA`
└ message	string	N	N	业务提示信息；如 `customer doesn't exist`、`warehouse doesn't exist`、`orderNumberList doesn't empty`
└ warehouseCode	string	N	N	仓库编码；按请求中的 `warehouseCode` 回填
└ orderNumberList	object	Y	N	错误明细列表；全部成功时不赋值，存在失败明细时返回
└ orderNumber	string	N	N	ERP 单号
└ onlineStatus	string	N	N	请求中的线上订单状态
└ extUserId	string	N	N	请求中的外部用户 ID
└ errorMessage	string	N	N	明细错误信息

2.8.5. 响应样例

JSON

{
  "success": true,
  "result": {
    "success": true,
    "warehouseCode": "WH001"
  }
}

失败响应样例（订单不存在）

{
  "success": true,
  "result": {
    "success": false,
    "code": "INVALID_DATA",
    "message": "orderNumberList doesn't empty",
    "warehouseCode": "WH001",
    "orderNumberList": [
      {
        "orderNumber": "SO202606050001",
        "onlineStatus": "PAID",
        "extUserId": "USER001",
        "errorMessage": "Order doesn't exist."
      }
    ]
  }
}

2.9. 调整单反馈接口

2.9.1. SERVICE_TYPE

GLINK_ADJUST_STOCK_PUSH

2.9.2. 接口说明

订单状态变更时，平台按配置向客户系统推送订单信息。客户系统需返回处理结果。

2.9.3. 请求参数

调整单反馈请求

参数名	类型	列表	必填	备注
partnerId	string	N	Y	合作伙伴ID
customerCode	string	N	Y	客户编码
warehouseCode	string	N	Y	仓库编码
adjustNumber	string	N	Y	调整单号
referenceType	string	N	Y	调整来源类型；常见值：RECEIPT（入库）、GENERAL（普通）
referenceNo	string	N	N	调整来源参考单号
confirmDate	date	N	Y	调整单确认时间；JSON 序列化为时间戳
type	string	N	Y	调整类型；常见值：VARIANCE_ADJUSTMENT（差异调整）、VARIANCE_INV（差异盘点）、CYCLE_COUNT（循环盘点）等
reason	string	N	N	调整原因
note	string	N	N	备注
adjustList	object	Y	Y	调整明细
└ sku	string	N	Y	商品编码
└ adjustQty	int	N	Y	调整数量；可为正数或负数
└ invType	string	N	Y	调整库存类型；ADJUST_AVAILABLE_QTY（可用库存）、ADJUST_HOLD_QTY（冻结库存）、ADJUST_QUARANTINE_QTY（隔离库存）
└ status	string	N	N	货物状态；GOOD（良品）、DAMAGE（残品/破损）
└ batchNo	string	N	N	货物批次
└ mfgDate	string	N	N	货物生产日期
└ expDate	string	N	N	货物失效日期
└ countryOfOrigin	string	N	N	货物原产国
└ unit	string	N	N	单位
└ receiptDate	date	N	N	库存入库时间；JSON 序列化为时间戳

2.9.4. 请求样例

JSON

{
  "partnerId": "QIANYI",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "adjustNumber": "ADJ202606050001",
  "referenceType": "GENERAL",
  "referenceNo": "REF202606050001",
  "confirmDate": 1780632000000,
  "type": "VARIANCE_ADJUSTMENT",
  "reason": "库存差异调整",
  "note": "库存差异调整",
  "adjustList": [
    {
      "sku": "SKU001",
      "adjustQty": 5,
      "invType": "ADJUST_AVAILABLE_QTY",
      "status": "GOOD",
      "batchNo": "BATCH20260605",
      "mfgDate": "2026-01-01",
      "expDate": "2027-01-01",
      "countryOfOrigin": "CN",
      "unit": "EA",
      "receiptDate": 1780632000000
    },
    {
      "sku": "SKU002",
      "adjustQty": -2,
      "invType": "ADJUST_HOLD_QTY",
      "status": "GOOD",
      "batchNo": "BATCH20260606",
      "mfgDate": "2026-02-01",
      "expDate": "2027-02-01",
      "countryOfOrigin": "CN",
      "unit": "EA",
      "receiptDate": 1780632000000
    }
  ]
}

2.9.5. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码，如果操作失败了，则提示错误类型
message	string	N	N	提示信息

2.9.6. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "success"
}

2.10. 加工单创建接口

2.10.1. SERVICE_TYPE

GLINK_CREATE_PRODUCTION_ORDER

2.10.2. 请求参数

加工单创建请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID；接口会校验客户与partnerId是否匹配
productionOrderNumber	string	N	Y	加工单号
customerCode	string	N	Y	客户编码
warehouseCode	string	N	Y	仓库编码；必须是客户可用且已启用的仓库
productionType	string	N	Y	加工类型；KITTING：组套/组合加工，UNKITTING：拆套/拆分加工
note	string	N	N	备注
itemList	object	Y	Y	加工货物列表；至少传一条明细
└ lineNo	string	N	Y	行号
└ fromItemList	object	Y	Y	从货物列表；不能为空
└ skuCode	string	N	Y	商品编码；必须存在且处于启用状态
└ description	string	N	N	货物描述
└ unit	string	N	N	加工单位；常见值 EA（件），具体取值以仓库配置为准
└ expectQty	int	N	Y	加工数量；必须大于0
└ toItemList	object	Y	Y	去货物列表；不能为空
└ skuCode	string	N	Y	商品编码；必须存在且处于启用状态
└ description	string	N	N	货物描述
└ unit	string	N	N	加工单位；常见值 EA（件），具体取值以仓库配置为准
└ expectQty	int	N	Y	加工数量；必须大于0

2.10.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "productionOrderNumber": "PO202606050001",
  "customerCode": "CUSTOMER001",
  "warehouseCode": "WH001",
  "productionType": "KITTING",
  "note": "套装加工",
  "itemList": [
    {
      "lineNo": "1",
      "fromItemList": [
        {
          "skuCode": "SKU-FROM-001",
          "description": "原料商品1",
          "unit": "EA",
          "expectQty": 2
        }
      ],
      "toItemList": [
        {
          "skuCode": "SKU-TO-001",
          "description": "成品商品1",
          "unit": "EA",
          "expectQty": 1
        }
      ]
    }
  ]
}

2.10.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码；创建成功时实际返回success；失败时返回具体错误码
message	string	N	N	提示信息；创建成功时该字段不返回或为空

2.10.5. 响应样例

JSON

{
  "success": true,
  "code": "success"
}

2.11. 加工单取消接口

2.11.1. SERVICE_TYPE

GLINK_CANCEL_PRODUCTION_ORDER

2.11.2. 请求参数

加工单取消请求

参数名	类型	列表	必填	备注
partnerId	string	N	N	合作伙伴ID；接口会校验客户与partnerId是否匹配
productionOrderNumber	string	N	Y	加工单号
customerCode	string	N	Y	客户编码

2.11.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "productionOrderNumber": "PO202606050001",
  "customerCode": "CUSTOMER001"
}

2.11.4. 响应参数

参数名	类型	列表	必填	备注
success	boolean	N	Y	操作的处理结果，true表示处理成功，false表示处理失败
code	string	N	N	操作状态码；取消成功时实际返回success；订单不存在等失败场景返回具体错误码
message	string	N	N	提示信息

2.11.5. 响应样例

JSON

{
  "success": true,
  "code": "success"
}