# 应收单接口

# 查询应收单

接口说明 1、通过查询对象配置 (opens new window)接口,获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符,详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六:aPaaS字段类型样式说明 (opens new window)

请求方式: POST(HTTPS
**请求地址: ** https://openapi.qince.com/api/ig/v1/accountsReceivableQuery/{ 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": "查询失败!"
}               

# 查询应收单明细

接口说明 1、通过查询对象配置 (opens new window)接口,获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符,详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六:aPaaS字段类型样式说明 (opens new window)

请求方式: POST(HTTPS
**请求地址: ** https://openapi.qince.com/api/ig/v1/accountsReceivableDetailQuery/{ 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": "查询失败!"
}               

# 推送应收单

推送说明:参见 推送aPaaS对象数据变更 (opens new window)

{
  "appId": 200004,
  "data": {
    "objectKey": "ig_accounts_receivable",
    "slaveObjectMap": {
      "ig_accounts_receivable_detail": [
        {
          "bill_code": "HT2025070200046",
          "modify_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 14:15:49"
          },
          "invoiced_amount": "0.00",
          "receivable_amount": "3500.00",
          "business_type": {
            "code": "busitype_default__c",
            "id": "7099157361929467096",
            "label": "默认业务类型",
            "status": "1"
          },
          "modifyier_id": {
            "name": "gm",
            "id": "8300537268794337524",
            "status": "1"
          },
          "verified_amount": "0.00",
          "bill_type": {
            "code": "5",
            "label": "合同"
          },
          "verify_status": {
            "code": "1",
            "label": "未完成"
          },
          "id": "6717522208337450105",
          "department": {
            "name": "RMIG",
            "id": "10",
            "status": "1"
          },
          "bill_id": "4621216743847845585",
          "owner": {
            "name": "gm",
            "id": "8300537268794337524",
            "status": "1"
          },
          "product": {
            "name": "标准选配",
            "id": "8196363667280520531",
            "status": "1"
          },
          "lock_status": {
            "code": "UNLOCK",
            "label": "未锁定"
          },
          "create_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 14:15:51"
          },
          "approval_status": {
            "code": "APPROVED",
            "label": "已通过"
          },
          "source_type": {
            "code": "LROPFXCJ",
            "label": "自建"
          },
          "bill_detail": "HTMX2025070200117",
          "accounts_receivable": {
            "name": "AR2025070200013",
            "id": "6250650467278832411"
          },
          "remain_amount": "3500.00",
          "remain_invoice_amount": "3500.00",
          "actual_invoiced_amount": "0.00",
          "verify_finish_time": {
            "format": "YYYY-MM-DD HH:mm"
          },
          "remain_verify_amount": "3500.00",
          "creator_id": {
            "name": "gm",
            "id": "8300537268794337524",
            "status": "1"
          },
          "name": "00034",
          "unbilled_invoice_amount": "3500.00",
          "reverse_invoice_amount": "0.00",
          "status": {
            "code": "NORMAL",
            "label": "正常"
          }
        },
        {
          "bill_code": "HT2025070200046",
          "modify_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 14:15:49"
          },
          "invoiced_amount": "0.00",
          "receivable_amount": "0.00",
          "business_type": {
            "code": "busitype_default__c",
            "id": "7099157361929467096",
            "label": "默认业务类型",
            "status": "1"
          },
          "modifyier_id": {
            "name": "gm",
            "id": "8300537268794337524",
            "status": "1"
          },
          "verified_amount": "0.00",
          "bill_type": {
            "code": "5",
            "label": "合同"
          },
          "verify_status": {
            "code": "1",
            "label": "未完成"
          },
          "id": "9003911968889814127",
          "department": {
            "name": "RMIG",
            "id": "10",
            "status": "1"
          },
          "bill_id": "4621216743847845585",
          "owner": {
            "name": "gm",
            "id": "8300537268794337524",
            "status": "1"
          },
          "product": {
            "name": "12.8英寸悬浮式智能旋转屏",
            "id": "9087975640610350960",
            "status": "1"
          },
          "lock_status": {
            "code": "UNLOCK",
            "label": "未锁定"
          },
          "create_time": {
            "format": "YYYY-MM-DD HH:mm:ss",
            "value": "2025-07-02 14:15:52"
          },
          "approval_status": {
            "code": "APPROVED",
            "label": "已通过"
          },
          "source_type": {
            "code": "LROPFXCJ",
            "label": "自建"
          },
          "bill_detail": "HTMX2025070200118",
          "accounts_receivable": {
            "name": "AR2025070200013",
            "id": "6250650467278832411"
          },
          "remain_amount": "0.00",
          "remain_invoice_amount": "0.00",
          "actual_invoiced_amount": "0.00",
          "verify_finish_time": {
            "format": "YYYY-MM-DD HH:mm"
          },
          "remain_verify_amount": "0.00",
          "creator_id": {
            "name": "gm",
            "id": "8300537268794337524",
            "status": "1"
          },
          "name": "00035",
          "unbilled_invoice_amount": "0.00",
          "reverse_invoice_amount": "0.00",
          "status": {
            "code": "NORMAL",
            "label": "正常"
          }
        }
      ]
    },
    "bill_code": "HT2025070200046",
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 14:15:49"
    },
    "receivable_amount": "3500.00",
    "total_invoiced_amount": "0.00",
    "total_reverse_invoice_amount": "0.00",
    "receivable_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-07-02"
    },
    "business_type": {
      "code": "busitype_default__c",
      "id": "8806340658828265348",
      "label": "默认业务类型",
      "status": "1"
    },
    "modifyier_id": {
      "name": "gm",
      "id": "8300537268794337524",
      "status": "1"
    },
    "verified_amount": "0.00",
    "bill_type": {
      "code": "5",
      "label": "合同"
    },
    "verify_status": {
      "code": "1",
      "label": "未核销"
    },
    "id": "6250650467278832411",
    "department": {
      "name": "RMIG",
      "id": "10",
      "status": "1"
    },
    "bill_id": "4621216743847845585",
    "owner": {
      "name": "gm",
      "id": "8300537268794337524",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-07-02 14:15:49"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "actual_invoiced_amount": "0.00",
    "verify_finish_time": {
      "format": "YYYY-MM-DD HH:mm"
    },
    "remain_verify_amount": "3500.00",
    "reverse_status": {
      "code": "1",
      "label": "正常"
    },
    "creator_id": {
      "name": "gm",
      "id": "8300537268794337524",
      "status": "1"
    },
    "name": "AR2025070200013",
    "status": {
      "code": "NORMAL",
      "label": "正常"
    },
    "customer": {
      "objectKey": "bas_cm_dealer",
      "name": "江苏万帮4S",
      "objectName": "经销商",
      "id": "5636794923394770871",
      "status": "1"
    }
  },
  "dataFormat": "json",
  "dataId": "6250650467278832411",
  "dataSource": "biz",
  "dataType": "apaas_data_change_event",
  "tenantId": 5457613360890366827,
  "version": "v1"
}