批量查询【未/忘打卡】接口

概述

该接口主要用于第三方平台或自主研发者,需要通过日期、单号、部门批量查询ERP系统的单据时,则可调用该单据的批量查询接口,将Sunlike ERP或Online ERP系统中的批量单据信息查询到第三方平台中。

参数说明

1.请求方式

请求方式 POST
接口地址 http://ERPAPI站点/CARD_DETAIL/BATCHDATA
格式 JSON
编码类型 UTF-8

2.header参数

Content-Type application/json
Authorization token 授权接口所获取的值

3.请求参数

字段名称 字段代号 类型 长度 必填 固定值 备注
程序代号 PGM     CARD_DETAIL  
员工代号 YG_NO   30    
日期类型 DATE_TYPE String 1   0表示单据日期,1表示制单日期,2表示终审日期,3修改日期
开始日期 START_DATE datetime     从开始日期开始查询单据,必填
结束日期 END_DATE datetime     查询以结束日期截止的单据,必填
部门 DEP string 8     多个部门,用中括号[]包住多个部门,以豆号隔开,不含下属部门,如”DEP”:[“01″,”02”];单个部门,不用中括号,有含下属
排序 ORDER_BY         例如:“ORDER BY”:{“EG_DD”:”DESC”}

请求JSON示例

{

    "PGM": "CARD_DETAIL", //程序代号

    "YG_NO": "", //按员工代号查询,可多个员工代号,加中括号[],员工代号之间用逗号隔开

    "SZ_NO": "C12", //考勤项目代号,C11:忘打卡、C12:未打卡

    "DATE_TYPE": 0, //0表示单据日期,1表示制单日期,2表示终审日期,3修改日期

    "START_DATE": "2026-08-01", //查询的开始日期

    "END_DATE": "2026-08-31", //查询的结束日期

    "DEP": "",

    "ORDER_BY": { //排序规则

        "YG_NO": "DESC" //DESC表示降序排序

    }

}

返回结果示例

{

    "code": 0,

    "message": "查询成功",

    "data": {

        "UP_DD": "",

        "TOTAL_NUM": 2,

        "BILL_LIST": [

            {

                "TF_SKTZ": [

                    {

                        "DEP_ORG": "",

                        "YG_NO": "002",

                        "SZ_NO": "C12",

                        "TRS_DD": "2026-08-18 18:00:00",

                        "SZ_YM": "2026-08-01 00:00:00",

                        "CHK_ID": "Y",

                        "CHK_MAN": "ADMIN",

                        "REM": ";内部版本,禁止使用于商业或盈利用途,违者必究",

                        "USR": "ADMIN",

                        "CLS_DATE": "2026-08-18 18:00:00",

                        "YG_NAME": "李四",

                        "DEP": "00000000",

                        "DEP_NAME": "First Department",

                        "POS_NAME": "",

                        "SPC_ID": "5"

                    }

                ],

                "TF_SKTZ_UTF8": [

                    {

                        "YG_NO": "002",

                        "SZ_NO": "C12",

                        "TRS_DD": "2026-08-18 18:00:00"

                    }

                ],

                "BILL_STATE": {

                    "READONLY": false,

                    "READONLY_REM": []

                }

            },

            {

                "TF_SKTZ": [],

                "BILL_STATE": {

                    "READONLY": false,

                    "READONLY_REM": []

                }

            }

        ],

        "DEFINE_INFO": {}

    }

}