# 对账单
# 新增对账单
接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window) 3、部分预置字段的特殊逻辑，参考 fields特殊参数说明特殊参数说明
请求方式： POST（HTTPS）
**请求地址：
** https://openapi.qince.com/api/ig/v1/accountStatementAdd/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| fields | VARCHAR | 是 | JSON格式字符串。格式：{字段key:value}， (非特殊字段数据格式参见附录六) |
| is_trigger | boolean | 否 | 是否触发工作流；true:触发，false:不触发 |
| trigger_employee | VARCHAR(32) | 否 | 是否触发工作流为true的时候必填，员工id |
| check_rule | boolean | 否 | 是否校验验证规则和查重规则；true:校验，false:不校验 |
fields参数说明：
| 字段名称 | 字段key | 字段类型 | 必填 | 特殊说明 |
|---|---|---|---|---|
| 客户名称 | customer | 关联关系（模板对象） | 是 | 系统对应客户id |
| 对账日期 | state_date | 日期 | 是 | 业务日期 |
slave_fields.ig_account_statement_detail 特殊参数说明：
| 字段名称 | 字段key | 字段类型 | 必填 | 特殊说明 |
|---|---|---|---|---|
| 应收单 | accounts_receivable | 关联关系 | 否 | 对应应收单id |
响应示例：
{
"msg_id": "X000001",
"return_code": 0,
"return_msg": "",
"response_data": "6066483328179541690"
}
异常示例：
{
"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 |
# 修改对账单
接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)
请求方式： POST（HTTPS）
**请求地址：
** https://openapi.qince.com/api/ig/v1/accountStatementEdit/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data_id | VARCHAR | 是 | 数据id |
| fields | VARCHAR | 是 | JSON格式字符串。格式：{字段key:value}， (非特殊字段数据格式参见附录六) |
| slave_fields | VARCHAR | 是 | JSON格式字符串。数据中传入id为编辑，无id为新增， 格式：{对象key:[{字段key:字段值}]}(非特殊字段数据格式参见附录六) |
| is_trigger | boolean | 否 | 是否触发工作流；true:触发，false:不触发 |
| trigger_employee | VARCHAR(32) | 否 | 是否触发工作流为true的时候必填，员工id |
| check_rule | boolean | 否 | 是否校验验证规则和查重规则；true:校验，false:不校验 |
fields特殊参数说明：
| 字段名称 | 字段key | 字段类型 | 必填 | 特殊说明 |
|---|---|---|---|---|
| 客户名称 | customer | 关联关系（模板对象） | 是 | 系统对应客户id |
| 对账日期 | state_date | 日期 | 是 | 业务日期 |
slave_fields.ig_account_statement_detail 特殊参数说明：
| 字段名称 | 字段key | 字段类型 | 必填 | 特殊说明 |
|---|---|---|---|---|
| 应收单 | accounts_receivable | 关联关系 | 否 | 对应应收单id |
响应示例：
{
"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 | 响应说明 |
# 查询对账单
接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)
请求方式： POST（HTTPS）
**请求地址：
** https://openapi.qince.com/api/ig/v1/accountStatementQuery/{ 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示例:
[
{
"state_date": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"customer": {
"objectKey": "bas_cm_dealer",
"name": "江苏万帮4S",
"objectName": "经销商",
"id": "5636794923394770871",
"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": "查询失败！"
}
# 推送对账单
推送说明：参见 推送aPaaS对象数据变更 (opens new window)
请求示例：
{
"appId": 200004,
"data": {
"state_date": {
"format": "YYYY-MM-DD",
"value": "2025-03-13"
},
"customer": {
"objectKey": "bas_cm_dealer",
"name": "江苏万帮4S",
"objectName": "经销商",
"id": "5636794923394770871",
"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"
},
"dataFormat": "json",
"dataId": "5588559312036759197",
"dataSource": "biz",
"dataType": "apaas_data_change_event",
"tenantId": 5457613360890366827,
"version": "v1"
}
# 删除对账单
接口说明： 1、删除指定ID的对账单
请求方式： POST（HTTPS）
**请求地址：
** https://openapi.qince.com/api/ig/v1/accountStatementDelete/{ openid }/{ timestamp }/{ digest }/{ msg_id }
在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| data_id | VARCHAR | 是 | 要删除的数据ID |
响应示例：
{
"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 | 响应说明 |