HTTP(S) Service API 接口文档
修订纪录
| 日期 | 功能模块 | 说明 | 相关文档 | 备注 |
|---|---|---|---|---|
| 2024/7/15 | 发货通知 | 新增 DESADV 发货通知 API； | 新增 DESADV 发货通知 API； | |
| 2024/7/29 | 发货通知 | 新增 Body 请求参数字段； | 新增接口字段： shipment_gross_weight shipment_net_weight mark_supplier_number quantity 详见请求参数说明。 | |
| 2024/9/12 | 发货通知 | 修改日期时间格式； 新增 Body 请求参数字段； | 新增接口字段： bill_of_lading delivery_order_number equipment_number package_type 详见请求参数说明。 | |
| 2024/10/17 | 发货通知 | 增加 ASN 编号参数字段； | 新增接口字段： delivery_number 详见请求参数说明。 | |
| 2025/04/17 | 发货通知 | 新增 Body 请求参数字段； | 新增接口字段： equipment_initial lot_number 详见请求参数说明。 | |
| 2025/04/25 | 发货通知 | 新增 Body 请求参数字段； item_detail_loop节点 | 新增接口字段： line_item_number 详见请求参数说明。 | |
| 2025/07/16 | 发货通知 | 新增 发货通知 API: 外包装（托盘）+内包装场景 | 新增发货通知 API: 外包装（托盘）+内包装场景 详见请求参数说明。 | |
| 2025/07/25 | 发货通知 | 增加 合作伙伴 ID 参数字段； | 新增接口字段： receiver_id 详见请求参数说明。 |
API 接口说明
通过 API 接口，将线下 发货信息/发票信息，提交给 EDI 系统，通过 EDI 系统生成 856/810 或 DESADV/INVOIC 等报文，并发送给客户。
发送报文业务处理逻辑，异步执行。
特殊参数说明
包装标记类型（Type of Marking）
- 单⼀包装 S (1J)：无分装的包装。由一个既是内包装又是外包装组成。
- 同质包装 M (6J)：均质装载单元/（主）批发单元包。由一个或多个内包装组成，但是只包含一种商品。
- 混合包装 G (5J)：混合装载单元/混合托盘/混合批发单元包装。由一个或多个内包装组成，但是可包含多个商品。
标签重量
标签中重量显示整数，使用四舍五入规则。
- 净重（Net Weight）
Total weight in kilograms of the parts inside a package printed without decimals.
Standard rounding rules apply. In case of M or G package structure, the master label will indicate the total weight in kilograms of all parts in the structure.
- 毛重（Gross Weight）
Total weight in kilograms of the package printed without decimals.
Standard rounding rules apply. In case of M or G package structure, the master label will indicate the total weight in kilograms of the complete transport handling unit.
发货通知 API - 外包装（托盘）+内包装场景
请求说明
| 请求地址 | http://xxx.xxx.xxx.xxx:8491/api/edi |
|---|---|
| 请求方法 | POST |
具体 API 地址和端口号，以部署服务器 地址和端口 为准。
请求参数
Body 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| edi_flag | String | 发货通知 ASN 标识 | 是 | A6577DF788A2 | 固定值 |
| receiver_id | String | 接收者 ID (合作伙伴 ID) | 是 | O000000CLIP | 合作伙伴 ID，一般用于对接多个合作伙伴时使用 |
| delivery_number | String | ASN 编号 (Advanced Shipping Note) | 是 | 00000110025 | 发货通知编号，唯一编号， 推荐最多8个数字符号（不同客户要求不一致） |
| despatch_datetime | String | 发货日期/时间 | 是 | 20240627 或 20240627091201 | 格式：CCYYMMDD 或 CCYYMMDDHHmmss |
| delivery_datetime | String | 预计交付日期/时间 | 否 | 20240715 或 20240715120603 | 格式：CCYYMMDD 或 CCYYMMDDHHmmss |
| estimated_arrival_date | String | 预计到达日期 | 是 | 20240715 | 格式：CCYYMMDD |
| shipment_gross_weight | Number | 装运毛重(单位：KGM) | 是 | 520.00 | ASN 中所有货物总毛重（精确到小数点后两位） |
| shipment_net_weight | Number | 装运净重(单位：KGM) | 是 | 480.00 | ASN 中所有货物总净重（精确到小数点后两位） |
| ship_from_id | String | 发货地编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| ship_from_name | String | 发货地名称 | 是 | ||
| ship_from_agency_code | String | 发货地编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| ship_from_address | String | 地址 | 是 | ||
| ship_from_address_info | String | 详细地址 | 否 | ||
| ship_from_city_name | String | 城市 | 是 | ||
| ship_from_state_province_code | String | 省/州编码 | 否 | ||
| ship_from_postal_code | String | 邮政编码 | 否 | ||
| ship_from_country_code | String | 国家/地区编号 | 否 | ||
| ship_to_id | String | 收货地编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| ship_to_name | String | 收货地名称 | 是 | ||
| ship_to_agency_code | String | 收货地编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| ship_to_address | String | 地址 | 是 | ||
| ship_to_address_info | String | 详细地址 | 否 | ||
| ship_to_city_name | String | 城市 | 是 | ||
| ship_to_state_province_code | String | 省/州编码 | 否 | ||
| ship_to_postal_code | String | 邮政编码 | 否 | ||
| ship_to_country_code | String | 国家/地区编号 | 否 | ||
| buyer_id | String | 买方/采购方编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| buyer_name | String | 买方/采购方名称 | 是 | ||
| buyer_agency_code | String | 买方/采购方编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| buyer_address | String | 地址 | 是 | ||
| seller_id | String | 卖方/销售方编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| seller_name | String | 卖方/销售方名称 | 是 | ||
| seller_agency_code | String | 卖方/销售方编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| seller_address | String | 地址 | 是 | ||
| consignee_id | String | 发货方编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| consignee_name | String | 发货方名称 | 是 | ||
| consignee_agency_code | String | 发货方编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| consignee_address | String | 地址 | 是 | ||
| consignor_id | String | 收货方编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| consignor_name | String | 收货方名称 | 是 | ||
| consignor_agency_code | String | 收货方编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| consignor_address | String | 地址 | 是 | ||
| supplier_id | String | 供应商编码 | 是 | 根据 agency_code 参数， 一般是 92， 由 客户 （买方） 提供。 | |
| supplier_name | String | 供应商名称 | 是 | ||
| supplier_agency_code | String | 供应商编号类型 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| bill_of_lading | String | 提货单编号 | 是 | 2024123456987 | |
| packing_list_number | String | 装运箱编号 | 是 | PL2404120011 | |
| delivery_note_number | String | 送货单编号 | 是 | ASN000006461 | |
| transport_document_number | String | 运输单据编号 | 是 | VDFNL0733 | |
| place_of_delivery | String | 交货地点代码 | 是 | HE01 | 来自客户订单的交货地点代码 |
| place_port_discharge | String | 卸货地点/港口代码 | 是 | SDNF | 来自客户订单的卸货港口代码 |
| additional_internal_destination | String | 内部目的地代码 | 是 | 3256 | 来自客户订单的内部目的地代码 |
| carrier_bill_number | String | 承运人编号 | 否 | CN00001 | |
| carrier_scac | String | 承运人 SCAC 代码 | 否 | UPSN | 一般由四位字母组成 |
| transport_mode | String | 运输方式 (Transportation Method) | 否 | LT | (A) Air (AE) Air Express (LT) Less than trailer load (M) Motor (Full truck) (R) Rail (SE) Sea |
| transport_type_name | String | 运输工具名称 | 否 | AC-DC 1234 | 长度在35个字符以内 |
| equipment_unit | String | 运输设备代码 (Equipment Description Code) | 否 | TE | (CN) Container (RR) Railcar (TE) Trailer (TL) Trailer (not otherwise specified) |
| equipment_initial | String | 运输识别编号或前缀 | 是 | UPSN | |
| equipment_number | String | 运输设备编号 (运输车号或海运集装箱编号) | 是 | 200003211 | 客户运输设备编号 |
| packages.package_loop | Array | 包装/产品明细 |
package_loop 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| package_level | String | 包装级别 | 是 | 4 | (1) Inner package (3) Outer package (4) No packaging hierarchy |
| outer_package | Object | 外包装（托盘）信息 | 否 | package_level=3 时必选 | |
| cps_items.cps_item_loop | Array | （内）包装以及物料信息 | 是 |
outer_package 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| pac_items.pac_item_loop | Array | 外包装（托盘）信息 | 是 |
cps_item_loop 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| pac_items.pac_item_loop | Array | （内）包装信息 | 是 | ||
| line_items.line_item_loop | Array | 物料信息 | 是 |
pac_item_loop 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| package_type | String | 包装类型 | 是 | BOX | |
| package_type_agency_code | String | 包装类型代码 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| quantity_of_pack | String | 包裹数量 | 是 | 5 | |
| quantity_per_pack | String | 每包数量 | 是 | 100 | |
| type_of_marking | String | 标记类型 | 是 | S | (S) Simplified Handling Unit (M) Homogeneous Handling Unit (G) Mixed Handling Unit |
| type_of_marking_agency_code | String | 标记类型代码 | 是 | 92 | (91) Assigned by seller or seller's agent (92) Assigned by buyer or buyer's agent |
| package_gross_weight | Number | 包装毛重（单位：KGM） | 是 | 129.47 | |
| package_net_weight | Number | 包装净重（单位：KGM） | 是 | 109.05 | |
| gir_items.gir_item_loop | Array | 包装明细 | 是 |
gir_item_loop 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| label_number | String | 包装/托盘等标签编号 | 是 | 25071404 | |
| batch_number | String | 批次号 | 否 |
line_item_loop 参数
| 参数名称 | 描述 | 描述 | 是否必选 | 示例值 | 说明 |
|---|---|---|---|---|---|
| line_item_number | String | 物料行号 | 是 | 00010 | 来自客户订单的物料行号 |
| buyer_item_number | String | 买方/采购方物料编号 | 是 | SN240112A01AB | 客户交付计划的物料编号 |
| seller_item_number | String | 卖方/销售方物料编号 | 是 | SI240418001 | |
| supplier_item_number | String | 供应商物料编号 | 是 | SI240418001 | |
| quantity | Number | 发货数量 | 是 | 500 | 包装中物料数量（整数） |
| quantity_unit | String | 单位 | 是 | EA | |
| order_number | String | 订单号 | 是 | 991935452615 | |
| order_line_number | String | 订单行号 | 是 | 00010 | |
| country_origin | String | 原产国 | 否 | CN | (CN) China (DE) Germany (PL) Poland (US) America |
| item_description | String | 物料描述 | 否 |
返回参数
| 参数名称 | 类型 | 描述 | 示例值 | 说明 |
|---|---|---|---|---|
| status | String | 返回状态 | success | success or failure |
| message | String | 返回消息内容 | xxx |
示例
请求示例一（混合场景）
此处为通用配置下的请求示例，可选字段可设置为空字符串。
json5
{
"edi_flag": "A6577DF788A2",
"delivery_number": "00000110025",
"despatch_datetime": "20240627091201",
"delivery_datetime": "20240720151210",
"estimated_arrival_date": "20240715",
"shipment_gross_weight": "520",
"shipment_net_weight": "480",
"ship_from_id": "1001",
"ship_from_name": "ChinLink",
"ship_from_agency_code": "92",
"ship_from_address": "Fenghui South Road, High tech Zone",
"ship_from_address_info": "1107B, Building B, Huajing Plaza, No. 20",
"ship_from_city": "Xian",
"ship_from_street": "",
"ship_from_state_province_code": "XA",
"ship_from_postal_code": "710075",
"ship_from_country_code": "CN",
"ship_to_id": "1002",
"ship_to_name": "Ship To Name",
"ship_to_agency_code": "92",
"ship_to_address": "Ship To Address",
"ship_to_address_info": "Ship To Address Info",
"ship_to_city": "Ship To City",
"ship_to_state_province_code": "",
"ship_to_postal_code": "111000",
"ship_to_country_code": "US",
"supplier_id": "1001",
"supplier_name": "ChinLink",
"supplier_agency_code": "92",
"supplier_city": "Xian",
"bill_of_lading": "2024123456987",
"packing_list_number": "PL2404120011",
"carrier_scac": "UPSN",
"transport_mode": "LT",
"equipment_unit": "TE",
"equipment_initial": "UPSN",
"equipment_number": "2400008112",
"packages": {
"package_loop": [
{
"package_level": 4,
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"quantity_per_pack": 100,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716001,
"batch_number": "CN001"
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936A",
"seller_item_number": "10400001A",
"supplier_item_number": "10400001A",
"quantity": 100,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
}
]
}
},
{
"package_level": 1,
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 120,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716002,
"batch_number": "CN002"
},
{
"label_number": 250716003,
"batch_number": "CN002"
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936A",
"seller_item_number": "10400001A",
"supplier_item_number": "10400001A",
"quantity": 250,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
}
]
}
},
{
"package_level": 3,
"outer_package": {
"pac_items": {
"pac_item_loop": [
{
"package_type": "PAL",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"type_of_marking": "M",
"type_of_marking_agency_code": 92,
"package_gross_weight": 184.06,
"package_net_weight": 436.2,
"gir_items": {
"gir_item_loop": {
"label_number": 250716004,
"batch_number": ""
}
}
}
]
}
},
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 4,
"quantity_per_pack": 30,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716005,
"batch_number": ""
},
{
"label_number": 250716006,
"batch_number": ""
},
{
"label_number": 250716007,
"batch_number": ""
},
{
"label_number": 250716008,
"batch_number": ""
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936B",
"seller_item_number": "10400001B",
"supplier_item_number": "10400001B",
"quantity": 120,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
}
]
}
},
{
"package_level": 3,
"outer_package": {
"pac_items": {
"pac_item_loop": [
{
"package_type": "PAL",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"type_of_marking": "M",
"type_of_marking_agency_code": 92,
"package_gross_weight": 184.06,
"package_net_weight": 436.2,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716009,
"batch_number": ""
}
]
}
}
]
}
},
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 50,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716010,
"batch_number": ""
},
{
"label_number": 250716011,
"batch_number": ""
}
]
}
},
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 100,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716012,
"batch_number": ""
},
{
"label_number": 250716013,
"batch_number": ""
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936C",
"seller_item_number": "10400001C",
"supplier_item_number": "10400001C",
"quantity": 300,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
}
]
}
},
{
"package_level": 3,
"outer_package": {
"pac_items": {
"pac_item_loop": [
{
"package_type": "PAL",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"type_of_marking": "G",
"type_of_marking_agency_code": 92,
"package_gross_weight": 184.06,
"package_net_weight": 436.2,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716014,
"batch_number": ""
}
]
}
}
]
}
},
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 30,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716015,
"batch_number": ""
},
{
"label_number": 250716016,
"batch_number": ""
}
]
}
},
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716017,
"batch_number": ""
},
{
"label_number": 250716018,
"batch_number": ""
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936D",
"seller_item_number": "10400001D",
"supplier_item_number": "10400001D",
"quantity": 100,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
},
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 40,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716019,
"batch_number": ""
},
{
"label_number": 250716020,
"batch_number": ""
}
]
}
},
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 50,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716021,
"batch_number": ""
},
{
"label_number": 250716022,
"batch_number": ""
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936E",
"seller_item_number": "10400001E",
"supplier_item_number": "10400001E",
"quantity": 180,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
},
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 2,
"quantity_per_pack": 80,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250716023,
"batch_number": ""
},
{
"label_number": 250716024,
"batch_number": ""
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "80024936F",
"seller_item_number": "10400001F",
"supplier_item_number": "10400001F",
"quantity": 160,
"quantity_unit": "EA",
"item_description": "CRASH FRONT SUSPENSION",
"order_number": 991935452615,
"additional_internal_destination": "TCFS",
"country_origin": "CN"
}
]
}
}
]
}
}
]
}
}请求示例二（托盘 + 单一物料场景 + 满箱）
示例仅显示 packages 参数部分。
json5
{
"packages": {
"package_loop": [
{
"package_level": 3,
"outer_package": {
"pac_items": {
"pac_item_loop": [
{
"package_type": "PAL",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"type_of_marking": "M",
"type_of_marking_agency_code": 92,
"package_gross_weight": 184.06,
"package_net_weight": 436.2,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714005,
"batch_number": ""
}
]
}
}
]
}
},
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX",
"package_type_agency_code": 92,
"quantity_of_pack": 4,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714001
},
{
"label_number": 250714002
},
{
"label_number": 250714003
},
{
"label_number": 250714004
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "BY_A",
"seller_item_number": "SE_A",
"supplier_item_number": "SE_A",
"quantity": 80,
"quantity_unit": "EA",
"item_description": "",
"order_number": "991935452615",
"country_origin": "CN"
}
]
}
}
]
}
}
]
}
}请求示例二（托盘 + 单一物料场景 + 物料未装满）
示例仅显示 packages 参数部分。
json5
{
"packages": {
"package_loop": [
{
"package_level": 3,
"outer_package": {
"pac_items": {
"pac_item_loop": [
{
"package_type": "PAL",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"type_of_marking": "M",
"type_of_marking_agency_code": 92,
"package_gross_weight": 184.06,
"package_net_weight": 436.2,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714005,
"batch_number": ""
}
]
}
}
]
}
},
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX1",
"package_type_agency_code": 92,
"quantity_of_pack": 3,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714001
},
{
"label_number": 250714003
},
{
"label_number": 250714004
}
]
}
},
{
"package_type": "BOX1",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"quantity_per_pack": 15,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714002,
"batch_number": ""
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "BY_A",
"seller_item_number": "SE_A",
"supplier_item_number": "SE_A",
"quantity": 75,
"quantity_unit": "EA",
"item_description": "",
"order_number": "991935452615",
"country_origin": "CN"
}
]
}
}
]
}
}
]
}
}请求示例三（托盘 + 多物料混合场景）
示例仅显示 packages 参数部分。
json5
{
"packages": {
"package_loop": [
{
"package_level": 3,
"outer_package": {
"pac_items": {
"pac_item_loop": [
{
"package_type": "PAL",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"type_of_marking": "G",
"type_of_marking_agency_code": 92,
"package_gross_weight": 184.06,
"package_net_weight": 436.2,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714005,
"batch_number": ""
}
]
}
}
]
}
},
"cps_items": {
"cps_item_loop": [
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX1",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714001
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "BY_A",
"seller_item_number": "SE_A",
"supplier_item_number": "SE_A",
"quantity": 20,
"quantity_unit": "EA",
"item_description": "",
"order_number": "991935452615",
"country_origin": "CN"
}
]
}
},
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX1",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714002
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "BY_B",
"seller_item_number": "SE_B",
"supplier_item_number": "SE_B",
"quantity": 20,
"quantity_unit": "EA",
"item_description": "",
"order_number": "991935452615",
"country_origin": "CN"
}
]
}
},
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX1",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714003
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "BY_C",
"seller_item_number": "SE_C",
"supplier_item_number": "SE_C",
"quantity": 20,
"quantity_unit": "EA",
"item_description": "",
"order_number": "991935452615",
"country_origin": "CN"
}
]
}
},
{
"pac_items": {
"pac_item_loop": [
{
"package_type": "BOX1",
"package_type_agency_code": 92,
"quantity_of_pack": 1,
"quantity_per_pack": 20,
"type_of_marking": "S",
"type_of_marking_agency_code": 92,
"package_gross_weight": 129.49,
"package_net_weight": 109.05,
"gir_items": {
"gir_item_loop": [
{
"label_number": 250714004
}
]
}
}
]
},
"line_items": {
"line_item_loop": [
{
"buyer_item_number": "BY_D",
"seller_item_number": "SE_D",
"supplier_item_number": "SE_D",
"quantity": 20,
"quantity_unit": "EA",
"item_description": "",
"order_number": "991935452615",
"country_origin": "CN"
}
]
}
}
]
}
}
]
}
}返回示例
- 正常返回示例
json5
{
"status": "success",
"message": "File received: inbound-240712144235484 (1658 Bytes)"
}- 异常返回示例
json5
{
"status": "failure",
"message": "File received failure."
}请求参数，必选字段 根据客户报文标准为准。