# 发货单接口
# 推送发货申请单
推送说明:参见 推送aPaaS对象数据变更 (opens new window)
请求示例:
{
"appId": 200004,
"data": {
"objectKey": "ig_delivery_apply_order",
"slaveObjectMap": {
"ig_delivery_apply_order_detail": [
{
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-09-16 15:23:09"
},
"apply_amount": "1000.00",
"apply_count": "10.00",
"pd_portfolio": {
"name": "ZH20250916001",
"id": "6834388186941996900",
"status": "1"
},
"pd_portfolio_detail": {
"name": "ZHMX20250916001",
"id": "4967115001311135508",
"status": "1"
},
"business_type": {
"code": "busitype_default__c",
"id": "5544409283238908775",
"label": "默认业务类型",
"status": "1"
},
"modifyier_id": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"id": "8783733298222774920",
"department": {
"name": "CPG",
"id": "10",
"status": "1"
},
"pd_unit_id": {
"name": "箱",
"id": "5859522895738938134",
"status": "1"
},
"pd_id": {
"name": "测试商品001",
"id": "7307951445481009003",
"status": "1"
},
"owner": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-09-16 15:23:09"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"delivery_apply_id": {
"name": "FHSQ2025091600001",
"id": "6306446111600440638"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"slave_order_id": {
"name": "DD2025091600001",
"id": "5026567945695121137",
"status": "1"
},
"order_detail_id": {
"name": "DDMX2025091600001",
"id": "4626879479901376126",
"status": "1"
},
"delivery_model": {
"code": "PTO",
"label": "PTO(允许按子商品进行分批交付)"
},
"is_bom": {
"code": "true",
"label": "是"
},
"separate_present": {
"code": "false",
"label": "否"
},
"tree_data": "",
"node_id": "5878298479055129061",
"parent_node_id": "",
"root_node_id": "5878298479055129061",
"creator_id": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"name": "FHSQMX2025091600001",
"status": {
"code": "NORMAL",
"label": "正常"
}
}
]
},
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-09-16 15:23:09"
},
"business_type": {
"code": "busitype_default__c",
"id": "6427868406516526784",
"label": "默认业务类型",
"status": "1"
},
"modifyier_id": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"id": "6306446111600440638",
"department": {
"name": "CPG",
"id": "10",
"status": "1"
},
"owner": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-09-16 15:23:09"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"apply_date": {
"format": "YYYY-MM-DD",
"value": "2025-09-16"
},
"creator_id": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"name": "FHSQ2025091600001",
"status": {
"code": "NORMAL",
"label": "正常"
},
"customer": {
"objectKey": "bas_cm_customer",
"name": "测试客户",
"objectName": "客户",
"id": "6928823652322085688",
"status": "1"
},
"order_id": {
"name": "DD2025091600001",
"id": "5026567945695121137",
"status": "1"
}
},
"dataFormat": "json",
"dataId": "6306446111600440638",
"dataSource": "biz",
"dataType": "apaas_data_change_event",
"tenantId": 7867203268463838962,
"version": "v1"
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| appId | Number | 应用ID |
| dataFormat | String | 数据格式,如json |
| dataId | String | 数据ID,发货申请单ID |
| dataSource | String | 数据来源,如biz |
| dataType | String | 数据类型,如apaas_data_change_event |
| tenantId | Number | 租户ID |
| version | String | 版本号,如v1 |
| data | Object | 发货申请单数据对象 |
发货申请单数据字段说明(data):
| 字段 | 类型 | 说明 |
|---|---|---|
| objectKey | String | 对象key,固定为ig_delivery_apply_order |
| id | String | 发货申请单ID |
| name | String | 发货申请单编号 |
| customer | Object | 客户信息,包含objectKey、objectName、id、name、status等 |
| order_id | Object | 订单信息,包含id、name、status等 |
| apply_date | Object | 申请日期,包含format和value |
| status | Object | 数据状态,包含code和label,如NORMAL-正常 |
| lock_status | Object | 锁定状态,包含code和label,如UNLOCK-未锁定 |
| approval_status | Object | 审批状态,包含code和label,如APPROVED-已通过 |
| source_type | Object | 来源类型,包含code和label,如LROPFXCJ-自建 |
| business_type | Object | 业务类型,包含code、id、label、status等 |
| owner | Object | 负责人,包含id、name、status等 |
| department | Object | 部门,包含id、name、status等 |
| creator_id | Object | 创建人,包含id、name、status等 |
| modifyier_id | Object | 修改人,包含id、name、status等 |
| create_time | Object | 创建时间,包含format和value |
| modify_time | Object | 修改时间,包含format和value |
| slaveObjectMap | Object | 从对象映射,包含发货申请单明细等从对象数据 |
发货申请单明细字段说明(data.slaveObjectMap.ig_delivery_apply_order_detail):
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 发货申请单明细ID |
| name | String | 发货申请单明细编号 |
| delivery_apply_id | Object | 发货申请单信息,包含id、name |
| slave_order_id | Object | 订单信息,包含id、name、status等 |
| order_detail_id | Object | 订单明细信息,包含id、name、status等 |
| pd_id | Object | 商品信息,包含id、name、status等 |
| pd_unit_id | Object | 单位信息,包含id、name、status等 |
| apply_count | String | 申请数量 |
| apply_amount | String | 申请金额 |
| pd_portfolio | Object | 商品组合信息,包含id、name、status等 |
| pd_portfolio_detail | Object | 商品组合明细信息,包含id、name、status等 |
| delivery_model | Object | 发货模式,包含code和label |
| is_bom | Object | 是否BOM,包含code和label |
| separate_present | Object | 是否独立发货,包含code和label |
| node_id | String | BOM节点ID |
| parent_node_id | String | BOM父节点ID |
| root_node_id | String | BOM根节点ID |
| tree_data | String | BOM树数据 |
| status | Object | 数据状态,包含code和label,如NORMAL-正常 |
| lock_status | Object | 锁定状态,包含code和label,如UNLOCK-未锁定 |
| approval_status | Object | 审批状态,包含code和label,如APPROVED-已通过 |
| source_type | Object | 来源类型,包含code和label,如LROPFXCJ-自建 |
| business_type | Object | 业务类型,包含code、id、label、status等 |
| owner | Object | 负责人,包含id、name、status等 |
| department | Object | 部门,包含id、name、status等 |
| creator_id | Object | 创建人,包含id、name、status等 |
| modifyier_id | Object | 修改人,包含id、name、status等 |
| create_time | Object | 创建时间,包含format和value |
| modify_time | Object | 修改时间,包含format和value |
# 新增发货单
接口说明: 1、通过查询对象配置 (opens new window)接口,获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六:aPaaS字段类型样式说明 (opens new window) 3、部分预置字段存在特殊逻辑
请求方式: POST(HTTPS)
**请求地址:
** https://openapi.qince.com/api/ig/v1/deliveryOrderAdd/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
| 字段 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| is_trigger | 触发工作流 | Boolean | 否 | 是否触发工作流,默认 false |
| trigger_employee | 触发员工 | Long | 否 | 触发员工 ID。 当 isTrigger=true 时必填 |
| check_rule | 校验规则 | Boolean | 否 | 是否校验验证规则,默认 false |
| fields | 主属性数据 | Map | 是 | JSON格式字符串。格式:{字段key:value}, (数据格式参见附录六) |
| fields.customer | 客户ID | Long | 是 | 必传 |
| fields.order_id | 订单ID | Long | 是 | 必传,且需要是当前客户的订单 |
| fields.delivery_date | 发货日期 | Number | 否 | 格式为时间戳 |
| fields.currency_type | 币种 | String | 否 | 币种代码,如 CNY。未开启多币种时,不需要传,无论币种字段传入什么值均不接收; 开启多币种后,币种字段不传默认为本位币,传值取传入的值。 |
| fields.cm_balance | 客户余额ID | Long | 否 | 需要是当前客户的客户余额,开启多币种时币种也需保持一致 |
| fields.status_change_rule | 审批通过状态变更规则 | String | 否 | 1-审批通过自动发货,2-审批通过不自动发货,不传值时默认为"审批通过不自动发货" |
| fields.delivery_apply_id | 发货申请单ID | Long | 否 | 不建议使用接口传入,需匹配发货申请的数据逻辑 |
| fields.name | 发货单编号 | String | 只读 | 系统管理 |
| fields.delivery_status | 发货状态 | String | 只读 | 系统管理 |
| fields.reverse_status | 红冲状态 | String | 只读 | 系统管理 |
| fields.cm_useful_amount | 客户可用额度 | String | 只读 | 系统管理 |
| fields.status_change_time | 实际发货日期 | Date | 只读 | 系统管理 |
| fields.delivery_total_amount | 发货金额 | BigDecimal | 只读 | 自动统计 |
| fields.confirm_receipt_amount_total | 确认收货金额 | BigDecimal | 只读 | 自动统计 |
| fields.field_xxx__c | 自定义字段 | Any | 只读 | 自定义字段,字段类型和格式参见附录六 |
| slave_fields | 从对象数据 | Map | 是 | 格式:{对象key:[{字段key:字段值}]}(字段数据格式参见附录六) |
| slave_fields.ig_delivery_order_detail | 发货单明细 | List | 是 | 发货单明细列表,至少包含一条明细 |
| slave_fields.ig_delivery_order_detail.order_detail_id | 订单明细ID | Long | 是 | 需要与主对象传入的订单ID匹配。 若企业参数“企业CPQ”开启: 若父商品为PTO模式,支持传独立发货的子商品订单明细编号,不支持独立发货的不可传入,自动补齐; 若父商品为ATO模式,子节点全部不可传入,自动补齐; Bom套Bom,ATO里面套ATO或PTO:整体按照ATO处理 |
| slave_fields.ig_delivery_order_detail.delivery_count | 发货数量 | BigDecimal | 是 | 发货数量,必须大于 0 |
| slave_fields.ig_delivery_order_detail.delivery_amount | 发货金额 | BigDecimal | 否 | 支持传入发货金额,若不传入则系统自动计算: 1. 若发货数量 >= 可发货数量(订单数量-已发货数量-在途发货数量),则使用未发货金额(优惠后金额-已发货金额) 2. 否则按比例计算:优惠后金额 / 订单数量 × 发货数量 |
| slave_fields.ig_delivery_order_detail.pd_portfolio | 商品组合ID | Long | 否 | 商品组合 ID。 启用 CPQ 且商品是组合父商品时必填。 仅支持标准 BOM,配置 BOM 会报错 |
| slave_fields.ig_delivery_order_detail.name | 发货单明细编号 | String | 只读 | 系统管理 |
| slave_fields.ig_delivery_order_detail.delivery_order_id | 发货单明ID | Long | 只读 | 系统管理 |
| slave_fields.ig_delivery_order_detail.slave_order_id | 订单ID | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_id | 商品ID | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_unit_id | 单位ID | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_portfolio | 商品组合 | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_portfolio_detail | 商品组合明细 | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.node_id | BOM节点ID | Long | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.parent_node_id | BOM父节点ID | Long | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.root_node_id | BOM根节点ID | Long | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.tree_data | BOM树数据 | String | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.field_xxx__c | 自定义字段 | Any | 只读 | 自定义字段,字段类型和格式参见附录六 |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": "",
"response_data": "{\"id\":\"6112431127080995368\"}"
}
异常示例:
{
"msg_id": "X000001",
"return_code": 1,
"return_msg": "保存失败!"
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
| return_data | String | 新增数据信息,如 id |
# 修改发货单
接口说明: 1、通过查询对象配置 (opens new window)接口,获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六:aPaaS字段类型样式说明 (opens new window) 3、发货单修改只支持自定义字段和部分预置字段 4、发货单明细针对已有的发货单明细,可以修改自定义字段,暂不支持修改预置字段
请求方式: POST(HTTPS)
**请求地址:
** https://openapi.qince.com/api/ig/v1/deliveryOrderEdit/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
| 字段 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| is_trigger | 触发工作流 | Boolean | 否 | 是否触发工作流,默认 false |
| trigger_employee | 触发员工 | Long | 否 | 触发员工 ID。 当 isTrigger=true 时必填 |
| check_rule | 校验规则 | Boolean | 否 | 是否校验验证规则,默认 false |
| data_id | 数据id | Boolean | 是 | 发货单数据id |
| fields | 主属性数据 | Map | 是 | JSON格式字符串。格式:{字段key:value}, (数据格式参见附录六) |
| fields.delivery_status | 发货状态 | String | 否 | 0-待发货 1-已收货 2-已拒签 3-已发货 只允许"待发货"→"已发货"→"已收货",不允许逆向修改 |
| fields.status_change_time | 实际发货日期 | Number | 否 | 系统管理 |
| fields.customer | 客户ID | Long | 只读 | 不支持修改 |
| fields.order_id | 订单ID | Long | 只读 | 不支持修改 |
| fields.delivery_date | 发货日期 | Number | 只读 | 不支持修改 |
| fields.currency_type | 币种 | String | 只读 | 不支持修改 |
| fields.cm_balance | 客户余额ID | Long | 只读 | 不支持修改 |
| fields.status_change_rule | 审批通过状态变更规则 | String | 只读 | 不支持修改 1-审批通过自动发货,2-审批通过不自动发货 |
| fields.delivery_apply_id | 发货申请单ID | Long | 只读 | 不支持修改 |
| fields.name | 发货单编号 | String | 只读 | 系统管理 |
| fields.reverse_status | 红冲状态 | String | 只读 | 系统管理 |
| fields.cm_useful_amount | 客户可用额度 | String | 只读 | 系统管理 |
| fields.delivery_total_amount | 发货金额 | BigDecimal | 只读 | 自动统计 |
| fields.confirm_receipt_amount_total | 确认收货金额 | BigDecimal | 只读 | 自动统计 |
| fields.field_xxx__c | 自定义字段 | Any | 只读 | 自定义字段,字段类型和格式参见附录六 |
| slave_fields | 从对象数据 | Map | 是 | 数据中传入id为编辑,无id为新增, 格式:{对象key:[{字段key:字段值}]}(字段数据格式参见附录六) |
| slave_fields.ig_delivery_order_detail | 发货单明细 | List | 是 | 发货单明细列表,至少包含一条明细 |
| slave_fields.ig_delivery_order_detail.order_detail_id | 订单明细ID | Long | 是 | 需要与主对象传入的订单ID匹配。 若企业参数“企业CPQ”开启: 若父商品为PTO模式,支持传独立发货的子商品订单明细编号,不支持独立发货的不可传入,自动补齐; 若父商品为ATO模式,子节点全部不可传入,自动补齐; Bom套Bom,ATO里面套ATO或PTO:整体按照ATO处理 |
| slave_fields.ig_delivery_order_detail.delivery_count | 发货数量 | BigDecimal | 是 | 发货数量,必须大于 0 |
| slave_fields.ig_delivery_order_detail.delivery_amount | 发货金额 | BigDecimal | 否 | 支持传入发货金额,若不传入则系统自动计算: 1. 若发货数量 >= 可发货数量(订单数量-已发货数量-在途发货数量),则使用未发货金额(优惠后金额-已发货金额) 2. 否则按比例计算:优惠后金额 / 订单数量 × 发货数量 |
| slave_fields.ig_delivery_order_detail.pd_portfolio | 商品组合ID | Long | 否 | 商品组合 ID。 启用 CPQ 且商品是组合父商品时必填。 仅支持标准 BOM,配置 BOM 会报错 |
| slave_fields.ig_delivery_order_detail.name | 发货单明细编号 | String | 只读 | 系统管理 |
| slave_fields.ig_delivery_order_detail.delivery_order_id | 发货单明ID | Long | 只读 | 系统管理 |
| slave_fields.ig_delivery_order_detail.slave_order_id | 订单ID | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_id | 商品ID | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_unit_id | 单位ID | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_portfolio | 商品组合 | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.pd_portfolio_detail | 商品组合明细 | Long | 只读 | 由订单明细补齐 |
| slave_fields.ig_delivery_order_detail.node_id | BOM节点ID | Long | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.parent_node_id | BOM父节点ID | Long | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.root_node_id | BOM根节点ID | Long | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.tree_data | BOM树数据 | String | 只读 | BOM 展开时自动生成 |
| slave_fields.ig_delivery_order_detail.field_xxx__c | 自定义字段 | Any | 只读 | 自定义字段,字段类型和格式参见附录六 |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": ""
}
异常示例:
{
"msg_id": "X000001",
"return_code": 1,
"return_msg": "保存失败!"
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
# 红冲发货单
接口说明:
请求方式: POST(HTTPS)
**请求地址:
** https://openapi.qince.com/api/ig/v1/deliveryOrderReverse/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| dataId | VARCHAR(32) | 否 | 发货单ID,与dataName至少传入一个 |
| dataName | VARCHAR | 否 | 发货单编号(name字段),与dataId至少传入一个 |
响应示例:
{
"return_code": 0,
"return_msg": "success",
"msg_id": "X0001",
"response_data": null
}
异常示例:
{
"msg_id": "X000001",
"return_code": 1,
"return_msg": "数据不存在,dataName=FH2025070400021"
}
参数说明:
| 参数 | 说明 |
|---|---|
| return_code | 响应编码 |
| return_msg | 响应信息 |
| msg_id | 消息ID |
# 查询发货单
接口说明 1、通过查询对象配置 (opens new window)接口,获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符,详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六:aPaaS字段类型样式说明 (opens new window)
请求方式: POST(HTTPS)
**请求地址:
** https://openapi.qince.com/api/ig/v1/deliveryOrderQuery/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | INT | 是 | 页数,默认值为1 |
| rows | INT | 是 | 条数,默认值为100 |
| sorts | List | 是 | 排序,默认按创建时间倒序排序 |
| sorts.field_key | VARCHAR(30) | 是 | 排序字段 |
| sorts.type | VARCHAR(4) | 是 | 排序类型:asc 正序,desc 倒序 |
| query_group | List | 是 | 查询条件列表 |
| query_group.connector | List | 是 | 组内查询条件,条件AND或OR |
| query_group.filters | VARCHAR(4) | 是 | 组内查询条件 |
| query_group.filters.field_key | VARCHAR(32) | 是 | 字段key |
| query_group.filters.operator | VARCHAR(10) | 是 | 操作符,详见附录操作符说明 (opens new window) |
| query_group.filters.field_values | List | 是 | 字段值集合 |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": "",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"field_QxaDA__c": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"field_T08db__c": "222",
"field_TtFXb__c": "222",
"field_dWPHL__c": [
{
"code": "91CIFbjO",
"label": "选项1",
"status": "1"
}
],
"id": "9222626961451321265",
"field_pOceu__c": "1",
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"field_whz1e__c": "222",
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-03-13 15:23:46"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"field_3kgN5__c": {
"code": "nPFlJR4S",
"label": "选项1"
},
"name": "0313cs02",
"creator_id": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"field_GOITb__c": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"field_8JouQ__c": {
"code": "true",
"label": "是"
},
"status": {
"code": "NORMAL",
"label": "正常"
},
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-03-13 15:23:46"
},
"field_Dxf38__c": "1.00",
"field_Y4dFC__c": "00005",
"business_type": {
"code": "busitype_default__c",
"id": "8438431948543484993"
},
"modifyier_id": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"department": {
"name": "IP16",
"id": "10",
"status": "1"
},
"owner": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"field_MhfYa__c": {
"format": "YYYY-MM-DD HH:mm",
"value": "2025-03-13 15:23"
},
"field_ujceN__c": "222"
}
]
异常示例:
{
"msg_id": "X000001",
"return_code": 1,
"return_msg": "查询失败!"
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
| response_data | List | 响应数据列表,包含发货单信息 |
响应数据字段说明(response_data):
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 发货单ID |
| name | String | 发货单编号 |
| customer | Object | 客户信息,包含id、name、status等 |
| order_id | Object | 订单信息,包含id、name、status等 |
| delivery_date | Object | 发货日期,包含format和value |
| delivery_total_amount | String | 发货金额 |
| confirm_receipt_amount_total | String | 确认收货金额 |
| delivery_status | Object | 发货状态,包含code和label |
| reverse_status | Object | 红冲状态,包含code和label |
| status_change_time | Object | 状态变更时间,包含format和value |
| currency_type | String | 币种代码,如CNY |
| cm_useful_amount | String | 客户可用额度 |
| status | Object | 数据状态,包含code和label,如NORMAL-正常 |
| lock_status | Object | 锁定状态,包含code和label,如UNLOCK-未锁定 |
| approval_status | Object | 审批状态,包含code和label,如APPROVED-已通过 |
| source_type | Object | 来源类型,包含code和label,如LROPFXCJ-自建 |
| business_type | Object | 业务类型,包含code、id、label等 |
| owner | Object | 负责人,包含id、name、status等 |
| department | Object | 部门,包含id、name、status等 |
| creator_id | Object | 创建人,包含id、name、status等 |
| modifyier_id | Object | 修改人,包含id、name、status等 |
| create_time | Object | 创建时间,包含format和value |
| modify_time | Object | 修改时间,包含format和value |
| field_xxx__c | Any | 自定义字段,字段类型和格式参见附录六 |
# 查询发货单明细
接口说明 1、通过查询对象配置 (opens new window)接口,获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符,详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六:aPaaS字段类型样式说明 (opens new window)
请求方式: POST(HTTPS)
**请求地址:
** https://openapi.qince.com/api/ig/v1/deliveryOrderDetailQuery/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例:
参数说明:
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | INT | 是 | 页数,默认值为1 |
| rows | INT | 是 | 条数,默认值为100 |
| sorts | List | 是 | 排序,默认按创建时间倒序排序 |
| sorts.field_key | VARCHAR(30) | 是 | 排序字段 |
| sorts.type | VARCHAR(4) | 是 | 排序类型:asc 正序,desc 倒序 |
| query_group | List | 是 | 查询条件列表 |
| query_group.connector | List | 是 | 组内查询条件,条件AND或OR |
| query_group.filters | VARCHAR(4) | 是 | 组内查询条件 |
| query_group.filters.field_key | VARCHAR(32) | 是 | 字段key |
| query_group.filters.operator | VARCHAR(10) | 是 | 操作符,详见附录操作符说明 (opens new window) |
| query_group.filters.field_values | List | 是 | 字段值集合 |
响应示例:
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": "",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"field_QxaDA__c": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"field_T08db__c": "222",
"field_TtFXb__c": "222",
"field_dWPHL__c": [
{
"code": "91CIFbjO",
"label": "选项1",
"status": "1"
}
],
"id": "9222626961451321265",
"field_pOceu__c": "1",
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"field_whz1e__c": "222",
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-03-13 15:23:46"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"field_3kgN5__c": {
"code": "nPFlJR4S",
"label": "选项1"
},
"name": "0313cs02",
"creator_id": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"field_GOITb__c": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"field_8JouQ__c": {
"code": "true",
"label": "是"
},
"status": {
"code": "NORMAL",
"label": "正常"
},
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-03-13 15:23:46"
},
"field_Dxf38__c": "1.00",
"field_Y4dFC__c": "00005",
"business_type": {
"code": "busitype_default__c",
"id": "8438431948543484993"
},
"modifyier_id": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"department": {
"name": "IP16",
"id": "10",
"status": "1"
},
"owner": {
"name": "x1",
"id": "6611719441804418541",
"status": "1"
},
"field_MhfYa__c": {
"format": "YYYY-MM-DD HH:mm",
"value": "2025-03-13 15:23"
},
"field_ujceN__c": "222"
}
]
异常示例:
{
"msg_id": "X000001",
"return_code": 1,
"return_msg": "查询失败!"
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| msg_id | String | 请求消息ID |
| return_code | int | 响应编码。0:成功,1:失败。其他详见附录错误码说明 (opens new window) |
| return_msg | String | 响应说明 |
| response_data | List | 响应数据列表,包含发货单明细信息 |
响应数据字段说明(response_data):
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 发货单明细ID |
| name | String | 发货单明细编号 |
| delivery_order_id | Object | 发货单信息,包含id、name |
| slave_order_id | Object | 订单信息,包含id、name、status等 |
| order_detail_id | Object | 订单明细信息,包含id、name、status等 |
| pd_id | Object | 商品信息,包含id、name、status等 |
| pd_unit_id | Object | 单位信息,包含id、name、status等 |
| delivery_count | String | 发货数量 |
| delivery_amount | String | 发货金额 |
| confirm_receipt_num | String | 确认收货数量 |
| confirm_receipt_amount | String | 确认收货金额 |
| pd_portfolio | Object | 商品组合信息,包含id、name、status等 |
| pd_portfolio_detail | Object | 商品组合明细信息,包含id、name、status等 |
| delivery_model | Object | 发货模式,包含code和label |
| is_bom | Object | 是否BOM,包含code和label |
| separate_present | Object | 是否独立发货,包含code和label |
| node_id | String | BOM节点ID |
| parent_node_id | String | BOM父节点ID |
| root_node_id | String | BOM根节点ID |
| tree_data | String | BOM树数据 |
| currency_type | Object | 币种,包含code和label |
| exchange_rate | String | 汇率 |
| status | Object | 数据状态,包含code和label,如NORMAL-正常 |
| lock_status | Object | 锁定状态,包含code和label,如UNLOCK-未锁定 |
| approval_status | Object | 审批状态,包含code和label,如APPROVED-已通过 |
| source_type | Object | 来源类型,包含code和label,如LROPFXCJ-自建 |
| business_type | Object | 业务类型,包含code、id、label、status等 |
| owner | Object | 负责人,包含id、name、status等 |
| department | Object | 部门,包含id、name、status等 |
| creator_id | Object | 创建人,包含id、name、status等 |
| modifyier_id | Object | 修改人,包含id、name、status等 |
| create_time | Object | 创建时间,包含format和value |
| modify_time | Object | 修改时间,包含format和value |
| field_xxx__c | Any | 自定义字段,字段类型和格式参见附录六 |
# 推送发货单
推送说明:参见 推送aPaaS对象数据变更 (opens new window)
请求示例:
{
"appId": 200004,
"data": {
"objectKey": "ig_delivery_order",
"owner": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"slaveObjectMap": {
"ig_delivery_order_detail": [
{
"slave_order_id": {
"name": "DD2025061300027",
"id": "5026567945695121137",
"status": "1"
},
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-07-04 08:54:15"
},
"tree_data": "",
"delivery_model": {
"code": "PTO",
"label": "PTO(允许按子商品进行分批交付)"
},
"delivery_amount": "20.00",
"delivery_count": "2.00",
"pd_portfolio": {
"name": "ZH20250613000262",
"id": "6828518669092637650",
"status": "1"
},
"business_type": {
"code": "busitype_default__c",
"id": "7977955542741030243",
"label": "默认业务类型",
"status": "1"
},
"modifyier_id": {
"name": "外部系统",
"id": "998"
},
"id": "8783733298222774920",
"department": {
"name": "CPG",
"id": "10",
"status": "1"
},
"pd_id": {
"name": "root节点L1父商品-PTO",
"id": "7307951445481009003",
"status": "1"
},
"owner": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"exchange_rate": "1.000000",
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-07-04 08:54:15"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"delivery_order_id": {
"name": "FH2025070400021",
"id": "6306446111600440638"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"root_node_id": "5878298479055129061",
"order_detail_id": {
"name": "DDMX2025061300068",
"id": "4626879479901376126",
"status": "1"
},
"pd_unit_id": {
"name": "箱",
"id": "5859522895738938134",
"status": "1"
},
"currency_type": {
"code": "CNY",
"label": "人民币"
},
"creator_id": {
"name": "外部系统",
"id": "998"
},
"name": "FHMX2025070400122",
"status": {
"code": "NORMAL",
"label": "正常"
},
"node_id": "5878298479055129061"
},
{
"is_bom": {
"code": "false",
"label": "否"
},
"slave_order_id": {
"name": "DD2025061300027",
"id": "5026567945695121137",
"status": "1"
},
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-07-04 08:54:15"
},
"delivery_model": {
"code": "PTO",
"label": "PTO(允许按子商品进行分批交付)"
},
"delivery_count": "2.00",
"parent_node_id": "5878298479055129061",
"pd_portfolio": {
"name": "ZH20250613000262",
"id": "6828518669092637650",
"status": "1"
},
"business_type": {
"code": "busitype_default__c",
"id": "7977955542741030243",
"label": "默认业务类型",
"status": "1"
},
"modifyier_id": {
"name": "外部系统",
"id": "998"
},
"id": "9044563084357906977",
"department": {
"name": "CPG",
"id": "10",
"status": "1"
},
"pd_id": {
"name": "叶节点L201-可独立发货",
"id": "7460595801255834310",
"status": "1"
},
"owner": {
"name": "hts",
"id": "7007385368014262146",
"status": "1"
},
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"exchange_rate": "1.000000",
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-07-04 08:54:15"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"delivery_order_id": {
"name": "FH2025070400021",
"id": "6306446111600440638"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"root_node_id": "5878298479055129061",
"pd_portfolio_detail": {
"name": "ZHMX20250613000429",
"id": "4967115001311135508",
"status": "1"
},
"order_detail_id": {
"name": "DDMX2025061300069",
"id": "7942171627478385837",
"status": "1"
},
"pd_unit_id": {
"name": "包",
"id": "5778096904880721227",
"status": "1"
},
"currency_type": {
"code": "CNY",
"label": "人民币"
},
"creator_id": {
"name": "外部系统",
"id": "998"
},
"name": "FHMX2025070400123",
"separate_present": {
"code": "true",
"label": "是"
},
"status": {
"code": "NORMAL",
"label": "正常"
},
"node_id": "5503227998577776453"
}
]
},
"lock_status": {
"code": "UNLOCK",
"label": "未锁定"
},
"create_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-07-04 08:54:15"
},
"approval_status": {
"code": "APPROVED",
"label": "已通过"
},
"delivery_total_amount": "20.00",
"modify_time": {
"format": "YYYY-MM-DD HH:mm:ss",
"value": "2025-07-04 08:54:15"
},
"source_type": {
"code": "LROPFXCJ",
"label": "自建"
},
"delivery_date": {
"format": "YYYY-MM-DD",
"value": "2025-06-26"
},
"business_type": {
"code": "busitype_default__c",
"id": "4933400189895259551",
"label": "默认业务类型",
"status": "1"
},
"modifyier_id": {
"name": "外部系统",
"id": "998"
},
"reverse_status": {
"code": "1",
"label": "正常"
},
"creator_id": {
"name": "外部系统",
"id": "998"
},
"name": "FH2025070400021",
"id": "6306446111600440638",
"department": {
"name": "CPG",
"id": "10",
"status": "1"
},
"order_id": {
"name": "DD2025061300027",
"id": "5026567945695121137",
"status": "1"
},
"delivery_status": {
"code": "0",
"label": "待签收"
},
"status": {
"code": "NORMAL",
"label": "正常"
},
"customer": {
"objectKey": "bas_cm_customer",
"name": "测试客户",
"objectName": "客户",
"id": "6928823652322085688",
"status": "1"
}
},
"dataFormat": "json",
"dataId": "6306446111600440638",
"dataSource": "biz",
"dataType": "apaas_data_change_event",
"tenantId": 7867203268463838962,
"version": "v1"
}
参数说明:
| 参数 | 类型 | 说明 |
|---|---|---|
| appId | Number | 应用ID |
| dataFormat | String | 数据格式,如json |
| dataId | String | 数据ID,发货单ID |
| dataSource | String | 数据来源,如biz |
| dataType | String | 数据类型,如apaas_data_change_event |
| tenantId | Number | 租户ID |
| version | String | 版本号,如v1 |
| data | Object | 发货单数据对象 |
发货单数据字段说明(data):
| 字段 | 类型 | 说明 |
|---|---|---|
| objectKey | String | 对象key,固定为ig_delivery_order |
| id | String | 发货单ID |
| name | String | 发货单编号 |
| customer | Object | 客户信息,包含objectKey、objectName、id、name、status等 |
| order_id | Object | 订单信息,包含id、name、status等 |
| delivery_date | Object | 发货日期,包含format和value |
| delivery_total_amount | String | 发货金额 |
| confirm_receipt_amount_total | String | 确认收货金额 |
| delivery_status | Object | 发货状态,包含code和label |
| reverse_status | Object | 红冲状态,包含code和label |
| status | Object | 数据状态,包含code和label,如NORMAL-正常 |
| lock_status | Object | 锁定状态,包含code和label,如UNLOCK-未锁定 |
| approval_status | Object | 审批状态,包含code和label,如APPROVED-已通过 |
| source_type | Object | 来源类型,包含code和label,如LROPFXCJ-自建 |
| business_type | Object | 业务类型,包含code、id、label、status等 |
| owner | Object | 负责人,包含id、name、status等 |
| department | Object | 部门,包含id、name、status等 |
| creator_id | Object | 创建人,包含id、name、status等 |
| modifyier_id | Object | 修改人,包含id、name、status等 |
| create_time | Object | 创建时间,包含format和value |
| modify_time | Object | 修改时间,包含format和value |
| slaveObjectMap | Object | 从对象映射,包含发货单明细等从对象数据 |
发货单明细字段说明(data.slaveObjectMap.ig_delivery_order_detail):
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 发货单明细ID |
| name | String | 发货单明细编号 |
| delivery_order_id | Object | 发货单信息,包含id、name |
| slave_order_id | Object | 订单信息,包含id、name、status等 |
| order_detail_id | Object | 订单明细信息,包含id、name、status等 |
| pd_id | Object | 商品信息,包含id、name、status等 |
| pd_unit_id | Object | 单位信息,包含id、name、status等 |
| delivery_count | String | 发货数量 |
| delivery_amount | String | 发货金额 |
| confirm_receipt_num | String | 确认收货数量 |
| confirm_receipt_amount | String | 确认收货金额 |
| pd_portfolio | Object | 商品组合信息,包含id、name、status等 |
| pd_portfolio_detail | Object | 商品组合明细信息,包含id、name、status等 |
| delivery_model | Object | 发货模式,包含code和label |
| is_bom | Object | 是否BOM,包含code和label |
| separate_present | Object | 是否独立发货,包含code和label |
| node_id | String | BOM节点ID |
| parent_node_id | String | BOM父节点ID |
| root_node_id | String | BOM根节点ID |
| tree_data | String | BOM树数据 |
| currency_type | Object | 币种,包含code和label |
| exchange_rate | String | 汇率 |
| status | Object | 数据状态,包含code和label,如NORMAL-正常 |
| lock_status | Object | 锁定状态,包含code和label,如UNLOCK-未锁定 |
| approval_status | Object | 审批状态,包含code和label,如APPROVED-已通过 |
| source_type | Object | 来源类型,包含code和label,如LROPFXCJ-自建 |
| business_type | Object | 业务类型,包含code、id、label、status等 |
| owner | Object | 负责人,包含id、name、status等 |
| department | Object | 部门,包含id、name、status等 |
| creator_id | Object | 创建人,包含id、name、status等 |
| modifyier_id | Object | 修改人,包含id、name、status等 |
| create_time | Object | 创建时间,包含format和value |
| modify_time | Object | 修改时间,包含format和value |