# 发货单接口

# 推送发货申请单

推送说明:参见 推送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 } 在线调试
请求示例:

{
  "fields": {
    "customer": "6928823652322085688",
    "order_id": "8260806049276379882",
    "delivery_date": "2025-06-12",
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "slave_fields": {
    "ig_delivery_order_detail": [
      {
        "slave_order_id": "5026567945695121137",
        "order_detail_id": "4626879479901376126",
        "delivery_count": "2"
      },
      {
        "slave_order_id": "5026567945695121137",
        "order_detail_id": "7942171627478385837",
        "delivery_count": "2"
      },
      {
        "slave_order_id": "5026567945695121137",
        "order_detail_id": "7814914111393830123",
        "delivery_count": "2"
      }
    ],
    "objectKey(自定义从对象对象key)": [
      {
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ]
  },
  "is_trigger": false,
  "check_rule": false
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

字段 名称 类型 必填 说明
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 } 在线调试
请求示例:

{
  "data_id": "6306446111600440638",
  "fields": {
    "id": "6306446111600440638",
    "delivery_status": "3",
    "status_change_time": "2025-03-13 15:23",
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "slave_fields": {
    "ig_delivery_order_detail": [
      {
        "id": "8783733298222774920",
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ],
    "objectKey(自定义从对象对象key)": [
      {
        "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
      }
    ]
  },
  "is_trigger": false,
  "check_rule": false
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

字段 名称 类型 必填 说明
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": "4957981088963247630"
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_xjcv4__c",
          "operator": "NQ",
          "field_values": [
            "1"
          ]
        }
      ]
    }
  ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_xjcv4__c",
          "operator": "NQ",
          "field_values": [
            "1"
          ]
        }
      ]
    }
  ]
}
说明: 本示例仅供参考,具体以参数说明为准。

参数说明:

参数 类型 必填 说明
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