霍元甲最新接口api

设置商户数据报送及预警月份

设置商户数据报送及预警月份<|-|>006<|-|>headers下token必传<|-|>vid必传，其余字段按需传入；APP和微信小程序报送开关只允许0或1。 no_report_months_app与no_report_months_miniapp分别对应APP和微信小程序不报送月份。渠道不报送月份需与对应is_report字段一并提交；is_report为1时会清空该渠道不报送月份。 warning_hidden_months独立于支付渠道，只能提交单个{year,month}月份对象。 warning_hidden_months传空数组表示清空配置；不传该字段则保留原配置。仅当商户status=0时生效，从配置月份（含当月）起往后的预警金额全部归零。配置月份之前金额正常展示；status=1的合作商户不执行归零。配置不会排除商户，商户仍保留在月度和季度数据申报预警列表中。<|-|>a:5:{s:4:"name";a:6:{i:0;s:3:"vid";i:1;s:13:"is_report_app";i:2;s:17:"is_report_miniapp";i:3;s:20:"no_report_months_app";i:4;s:24:"no_report_months_miniapp";i:5;s:21:"warning_hidden_months";}s:9:"paramType";a:6:{i:0;s:3:"int";i:1;s:3:"int";i:2;s:3:"int";i:3;s:5:"array";i:4;s:5:"array";i:5;s:5:"array";}s:4:"type";a:6:{i:0;s:1:"Y";i:1;s:1:"N";i:2;s:1:"N";i:3;s:1:"N";i:4;s:1:"N";i:5;s:1:"N";}s:7:"default";a:6:{i:0;s:0:"";i:1;s:0:"";i:2;s:0:"";i:3;s:2:"[]";i:4;s:2:"[]";i:5;s:2:"[]";}s:3:"des";a:6:{i:0;s:31:"商户ID，对应bbc_vendor.vid";i:1;s:58:"APP是否报送：0=不报送，1=报送；不传不修改";i:2;s:70:"微信小程序是否报送：0=不报送，1=报送；不传不修改";i:3;s:61:"APP不报送月份数组，每项格式为{year:2026,month:1}";i:4;s:73:"微信小程序不报送月份数组，每项格式为{year:2026,month:1}";i:5;s:112:"闭店商户预警金额归零起始月份，单个对象格式为{year:2026,month:8}；传空数组清空配置";}}<|-|>https://fl.tp6.hyj111.cn/admin/vendor/setVendorReportSwitch<|-|>POST<|-|>post

获取商户数据报送设置

获取商户数据报送设置<|-|>005<|-|>headers下token必传<|-|>根据商户ID返回APP、微信小程序报送开关，以及各渠道不报送月份。 warning_hidden_months为闭店商户的预警金额归零起始月份。该字段只返回单个月份对象；未配置时返回空字符串。配置仅对status=0的不合作商户生效；status=1的合作商户不受影响。该配置不修改涉税收入月汇总及资金明细原始数据。<|-|>a:5:{s:4:"name";a:1:{i:0;s:3:"vid";}s:9:"paramType";a:1:{i:0;s:3:"int";}s:4:"type";a:1:{i:0;s:1:"Y";}s:7:"default";a:1:{i:0;s:0:"";}s:3:"des";a:1:{i:0;s:31:"商户ID，对应bbc_vendor.vid";}}<|-|>https://fl.tp6.hyj111.cn/admin/vendor/getVendorReportSwitch<|-|>GET<|-|>get

商户月度数据申报预警列表

商户月度数据申报预警列表<|-|>004<|-|>headers下token必传<|-|>分页返回与涉税信息导出相同范围的商户及逐月收入金额，并返回rolling_twelve_month_total_income作为查询范围内最多12个自然月收入累计额。支持按商家类型type、纳税类型tax_type、支付方式pay_method和月预警额monthly_warning_amount筛选。已完成月份收入金额来自bbc_vendor_tax_income_month_summary.income_price，该汇总表来源为bbc_vendor_capital_detail.price，且仅统计income_type=1、rec_id>0的商品级收入。当月实时查bbc_vendor_capital_detail.price，不要求先生成当月月汇总，响应中的realtime_month标识本次实时月份。查询前只检查已完成月份的bbc_vendor_tax_income_month_refresh_log，未回填月份会返回提示，避免新汇总表没数据时误返回0。 monthly_warning_amount可选10000、100000、300000，传入时只返回存在月份金额达到该预警额的商户，并在monthly_income_warning中标记对应月份。未传月预警额时，个体工商户月收入大于等于10万标红，企业且小规模纳税人月收入大于等于30万标红。月度接口传year时返回该年12个自然月，year不能与start_month、end_month同时传入。开始月份和结束月份需同时传入，首尾月份均计入，最多12个自然月。三个时间条件都不传时默认查询当前月份及往前11个月，其中当前月实时查明细。老数据可调用/mobile/VendorCapital/refreshTaxIncomeMonthSummary?start_month=2025-07&end_month=2026-07回填。仅不合作商户status=0生效：warning_hidden_months为单个归零起始月份，该月及之后monthly_income返回0，并重新计算rolling_twelve_month_total_income；商户仍保留在列表中。<|-|>a:5:{s:4:"name";a:11:{i:0;s:4:"page";i:1;s:8:"pageSize";i:2;s:3:"vid";i:3;s:10:"store_name";i:4;s:4:"type";i:5;s:8:"tax_type";i:6;s:10:"pay_method";i:7;s:22:"monthly_warning_amount";i:8;s:4:"year";i:9;s:11:"start_month";i:10;s:9:"end_month";}s:9:"paramType";a:11:{i:0;s:3:"int";i:1;s:3:"int";i:2;s:3:"int";i:3;s:6:"string";i:4;s:3:"int";i:5;s:3:"int";i:6;s:6:"string";i:7;s:3:"int";i:8;s:3:"int";i:9;s:6:"string";i:10;s:6:"string";}s:4:"type";a:11:{i:0;s:1:"N";i:1;s:1:"N";i:2;s:1:"N";i:3;s:1:"N";i:4;s:1:"N";i:5;s:1:"N";i:6;s:1:"N";i:7;s:1:"N";i:8;s:1:"N";i:9;s:1:"N";i:10;s:1:"N";}s:7:"default";a:11:{i:0;s:1:"1";i:1;s:2:"10";i:2;s:0:"";i:3;s:0:"";i:4;s:0:"";i:5;s:0:"";i:6;s:0:"";i:7;s:0:"";i:8;s:0:"";i:9;s:0:"";i:10;s:0:"";}s:3:"des";a:11:{i:0;s:19:"页码，从1开始";i:1;s:23:"每页数量，默认10";i:2;s:31:"商户ID，对应bbc_vendor.vid";i:3;s:27:"商户名称，模糊查询";i:4;s:57:"商家类型：0=个体工商户，1=企业，2=自然人";i:5;s:55:"纳税类型：0=小规模纳税人，1=一般纳税人";i:6;s:61:"支付方式：mini-app=小程序，app=APP；空表示不限";i:7;s:100:"月预警额：10000=1万，100000=10万，300000=30万；按月份收入是否达到该金额筛选";i:8;s:115:"年份，格式YYYY；月度接口传year时返回该年12个自然月；不能与开始、结束月份同时传入";i:9;s:144:"开始月份，格式Y-m；与结束月份同时传入；不传year及月份范围时默认当前月份往前共12个月，当月实时查明细";i:10;s:101:"结束月份，格式Y-m；与开始月份同时传入；首尾月份均计入，最多12个自然月";}}<|-|>https://fl.tp6.hyj111.cn/admin/vendorReportWarning/monthly<|-|>GET<|-|>get

商户季度数据申报预警列表

商户季度数据申报预警列表<|-|>003<|-|>headers下token必传<|-|>分页返回与涉税信息导出相同范围的商户及收入金额，支持按商家类型type、纳税类型tax_type、支付方式pay_method和是否预警is_warning筛选。收入金额来自bbc_vendor_tax_income_month_summary.income_price，该汇总表来源为bbc_vendor_capital_detail.price，且仅统计income_type=1、rec_id>0的商品级收入。查询前会检查bbc_vendor_tax_income_month_refresh_log，未回填月份会返回提示，避免新汇总表没数据时误返回0。小规模纳税人rolling_four_quarter_total_income大于等于300万时is_warning=true，前端可将该累计额标红。传year时返回该年四个自然季度；year不能与start_month、end_month同时传入。 start_month和end_month可选但必须同时传入，开始月份必须为自然季度首月，结束月份必须为自然季度末月，首尾包含且最多4个自然季度。三个时间条件都不传时使用默认季度规则：统计到当前月份的上一个完整月，并取该月份所在季度及往前3个季度。金额按rolling_four_quarter_total_income倒序分页，金额越大越靠前。老数据可调用/mobile/VendorCapital/refreshTaxIncomeMonthSummary?start_month=2025-07&end_month=2026-07回填。仅不合作商户status=0生效：warning_hidden_months为单个归零起始月份，该月及之后收入按0参与季度及滚动累计额计算；商户仍保留在列表中。<|-|>a:5:{s:4:"name";a:11:{i:0;s:4:"page";i:1;s:8:"pageSize";i:2;s:3:"vid";i:3;s:10:"store_name";i:4;s:4:"type";i:5;s:8:"tax_type";i:6;s:10:"pay_method";i:7;s:10:"is_warning";i:8;s:4:"year";i:9;s:11:"start_month";i:10;s:9:"end_month";}s:9:"paramType";a:11:{i:0;s:3:"int";i:1;s:3:"int";i:2;s:3:"int";i:3;s:6:"string";i:4;s:3:"int";i:5;s:3:"int";i:6;s:6:"string";i:7;s:3:"int";i:8;s:3:"int";i:9;s:6:"string";i:10;s:6:"string";}s:4:"type";a:11:{i:0;s:1:"N";i:1;s:1:"N";i:2;s:1:"N";i:3;s:1:"N";i:4;s:1:"N";i:5;s:1:"N";i:6;s:1:"N";i:7;s:1:"N";i:8;s:1:"N";i:9;s:1:"N";i:10;s:1:"N";}s:7:"default";a:11:{i:0;s:1:"1";i:1;s:2:"10";i:2;s:0:"";i:3;s:0:"";i:4;s:0:"";i:5;s:0:"";i:6;s:0:"";i:7;s:0:"";i:8;s:0:"";i:9;s:0:"";i:10;s:0:"";}s:3:"des";a:11:{i:0;s:19:"页码，从1开始";i:1;s:23:"每页数量，默认10";i:2;s:31:"商户ID，对应bbc_vendor.vid";i:3;s:27:"商户名称，模糊查询";i:4;s:57:"商家类型：0=个体工商户，1=企业，2=自然人";i:5;s:55:"纳税类型：0=小规模纳税人，1=一般纳税人";i:6;s:61:"支付方式：mini-app=小程序，app=APP；空表示不限";i:7;s:81:"是否预警：1=是，0=否；按rolling_four_quarter_total_income_warning筛选";i:8;s:107:"年份，格式YYYY；传year时返回该年四个自然季度；不能与开始、结束月份同时传入";i:9;s:134:"开始月份，格式Y-m，必须为自然季度首月01、04、07或10；与结束月份同时传入；不传使用默认季度范围";i:10;s:138:"结束月份，格式Y-m，必须为自然季度末月03、06、09或12；与开始月份同时传入；首尾包含最多4个自然季度";}}<|-|>https://fl.tp6.hyj111.cn/admin/vendorReportWarning/quarterly<|-|>GET<|-|>get

商户年度数据申报汇总

商户年度数据申报汇总<|-|>001<|-|>headers下token必传<|-|>按year返回全年12个月、4个季度合计和年度总额；vid不传时从登录信息获取；每个月、季度合计、年度总额均返回detail_url和export_url；pay_method可选mini-app或app；原listVendorQuarterHistory接口不变。<|-|>a:5:{s:4:"name";a:3:{i:0;s:3:"vid";i:1;s:4:"year";i:2;s:10:"pay_method";}s:9:"paramType";a:3:{i:0;s:3:"int";i:1;s:3:"int";i:2;s:6:"string";}s:4:"type";a:3:{i:0;s:1:"N";i:1;s:1:"N";i:2;s:1:"N";}s:7:"default";a:3:{i:0;s:0:"";i:1;s:0:"";i:2;s:0:"";}s:3:"des";a:3:{i:0;s:41:"商户ID，不传时从登录信息获取";i:1;s:33:"年份，不传默认当前年份";i:2;s:64:"支付方式：mini-app=小程序，app=APP；不传表示不限";}}<|-|>https://fl.tp6.hyj111.cn/admin/vendor/listVendorAnnualReport<|-|>GET<|-|>get

商户数据申报详情

商户数据申报详情<|-|>002<|-|>headers下token必传<|-|>按start_month和end_month查询单月、季度或年度详情；平台佣金统计business_type=0，共享仓佣金统计business_type=5；vid不传时从登录信息获取；start_month不能大于end_month。<|-|>a:5:{s:4:"name";a:4:{i:0;s:3:"vid";i:1;s:11:"start_month";i:2;s:9:"end_month";i:3;s:10:"pay_method";}s:9:"paramType";a:4:{i:0;s:3:"int";i:1;s:6:"string";i:2;s:6:"string";i:3;s:6:"string";}s:4:"type";a:4:{i:0;s:1:"N";i:1;s:1:"Y";i:2;s:1:"Y";i:3;s:1:"N";}s:7:"default";a:4:{i:0;s:0:"";i:1;s:7:"2026-07";i:2;s:7:"2026-09";i:3;s:0:"";}s:3:"des";a:4:{i:0;s:41:"商户ID，不传时从登录信息获取";i:1;s:24:"开始月份，格式Y-m";i:2;s:51:"结束月份，格式Y-m，不能早于开始月份";i:3;s:64:"支付方式：mini-app=小程序，app=APP；不传表示不限";}}<|-|>https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail<|-|>GET<|-|>get

Home - 商户数据申报登录

最后修改者: huangyingliang 2026-08-13 16:55:01

设置商户数据报送及预警月份

编号 : 006

POST - https://fl.tp6.hyj111.cn/admin/vendor/setVendorReportSwitch

headers下token必传

请求参数

参数名	参数类型	必传	缺省值	描述
vid	int	Y		商户ID，对应bbc_vendor.vid
is_report_app	int	N		APP是否报送：0=不报送，1=报送；不传不修改
is_report_miniapp	int	N		微信小程序是否报送：0=不报送，1=报送；不传不修改
no_report_months_app	array	N	[]	APP不报送月份数组，每项格式为{year:2026,month:1}
no_report_months_miniapp	array	N	[]	微信小程序不报送月份数组，每项格式为{year:2026,month:1}
warning_hidden_months	array	N	[]	闭店商户预警金额归零起始月份，单个对象格式为{year:2026,month:8}；传空数组清空配置

返回值

{
    "status": 200, // 状态码
    "msg": "设置成功", // 提示信息
    "data": []
}

备注

vid必传，其余字段按需传入；APP和微信小程序报送开关只允许0或1。
no_report_months_app与no_report_months_miniapp分别对应APP和微信小程序不报送月份。
渠道不报送月份需与对应is_report字段一并提交；is_report为1时会清空该渠道不报送月份。
warning_hidden_months独立于支付渠道，只能提交单个{year,month}月份对象。
warning_hidden_months传空数组表示清空配置；不传该字段则保留原配置。
仅当商户status=0时生效，从配置月份（含当月）起往后的预警金额全部归零。
配置月份之前金额正常展示；status=1的合作商户不执行归零。
配置不会排除商户，商户仍保留在月度和季度数据申报预警列表中。

最后修改者: huangyingliang 2026-08-13 16:55:01

获取商户数据报送设置

编号 : 005

GET - https://fl.tp6.hyj111.cn/admin/vendor/getVendorReportSwitch

headers下token必传

请求参数

参数名	参数类型	必传	缺省值	描述
vid	int	Y		商户ID，对应bbc_vendor.vid

返回值

{
    "status": 200, // 状态码
    "msg": "ok", // 提示信息
    "data": {
        "vid": 92, // 商户ID
        "store_name": "示例商户", // 商户名称
        "is_report_app": 0, // APP是否报送：0=不报送，1=报送
        "is_report_miniapp": 1, // 微信小程序是否报送：0=不报送，1=报送
        "no_report_months_app": [ // APP不报送月份
            {
                "report_type": "app", // 报送渠道
                "year": 2026, // 年份
                "month": 1 // 月份
            }
        ],
        "no_report_months_miniapp": [], // 微信小程序不报送月份
        "warning_hidden_months": { // 闭店商户预警金额归零起始月份
            "year": 2026, // 年份
            "month": 8, // 月份
            "year_month": "2026-08" // 年月，格式YYYY-MM
        }
    }
}

备注

根据商户ID返回APP、微信小程序报送开关，以及各渠道不报送月份。
warning_hidden_months为闭店商户的预警金额归零起始月份。
该字段只返回单个月份对象；未配置时返回空字符串。
配置仅对status=0的不合作商户生效；status=1的合作商户不受影响。
该配置不修改涉税收入月汇总及资金明细原始数据。

最后修改者: huangyingliang 2026-08-13 16:55:01

商户月度数据申报预警列表

编号 : 004

GET - https://fl.tp6.hyj111.cn/admin/vendorReportWarning/monthly

headers下token必传

请求参数

参数名	参数类型	必传	缺省值	描述
page	int	N	1	页码，从1开始
pageSize	int	N	10	每页数量，默认10
vid	int	N		商户ID，对应bbc_vendor.vid
store_name	string	N		商户名称，模糊查询
type	int	N		商家类型：0=个体工商户，1=企业，2=自然人
tax_type	int	N		纳税类型：0=小规模纳税人，1=一般纳税人
pay_method	string	N		支付方式：mini-app=小程序，app=APP；空表示不限
monthly_warning_amount	int	N		月预警额：10000=1万，100000=10万，300000=30万；按月份收入是否达到该金额筛选
year	int	N		年份，格式YYYY；月度接口传year时返回该年12个自然月；不能与开始、结束月份同时传入
start_month	string	N		开始月份，格式Y-m；与结束月份同时传入；不传year及月份范围时默认当前月份往前共12个月，当月实时查明细
end_month	string	N		结束月份，格式Y-m；与开始月份同时传入；首尾月份均计入，最多12个自然月

返回值

{
    "status": 200, // 状态码
    "msg": "获取商户月度数据申报预警列表成功", // 提示信息
    "data": { // 返回数据
        "total": 1, // 符合条件的商户总数
        "per_page": 10, // 每页数量
        "current_page": 1, // 当前页码
        "last_page": 1, // 最后一页页码
        "data": [ // 商户预警数据列表
            {
                "vid": 18, // 商户ID
                "store_name": "礼尚往来", // 商户名称
                "type": 0, // 商家类型：0=个体工商户，1=企业，2=自然人
                "tax_type": 0, // 纳税类型：0=小规模纳税人，1=一般纳税人
                "monthly_income": { // 各自然月收入金额，键名与months.year_month一致
                    "2025-09": 100000.00, // 2025年9月收入金额
                    "2025-10": 110000.00, // 2025年10月收入金额
                    "2025-11": 115000.00, // 2025年11月收入金额
                    "2025-12": 125000.00, // 2025年12月收入金额
                    "2026-01": 120000.00, // 2026年1月收入金额
                    "2026-02": 118000.00, // 2026年2月收入金额
                    "2026-03": 132000.00, // 2026年3月收入金额
                    "2026-04": 128000.00, // 2026年4月收入金额
                    "2026-05": 135000.00, // 2026年5月收入金额
                    "2026-06": 127000.00, // 2026年6月收入金额
                    "2026-07": 130000.00, // 2026年7月收入金额
                    "2026-08": 86000.00 // 2026年8月当月实时收入金额
                },
                "monthly_income_warning": { // 各自然月金额是否预警，true时前端可将对应月份金额标红
                    "2025-09": true, // 2025年9月是否预警
                    "2025-10": true, // 2025年10月是否预警
                    "2025-11": true, // 2025年11月是否预警
                    "2025-12": true, // 2025年12月是否预警
                    "2026-01": true, // 2026年1月是否预警
                    "2026-02": true, // 2026年2月是否预警
                    "2026-03": true, // 2026年3月是否预警
                    "2026-04": true, // 2026年4月是否预警
                    "2026-05": true, // 2026年5月是否预警
                    "2026-06": true, // 2026年6月是否预警
                    "2026-07": true, // 2026年7月是否预警
                    "2026-08": false // 2026年8月当月实时金额是否预警
                },
                "rolling_twelve_month_total_income": 1426000.00, // 查询范围内最多12个自然月收入累计额
                "is_warning": true // 本行是否存在月度金额预警
            }
        ],
        "months": [ // 查询范围内的自然月，前端按此顺序生成月份列
            {
                "key": "2025-09", // monthly_income中的字段键名
                "label": "2025年9月", // 展示名称
                "year_month": "2025-09", // 年月
                "start_month": "2025-09", // 期间开始月份
                "end_month": "2025-09" // 期间结束月份
            },
            {
                "key": "2026-08", // monthly_income中的字段键名；中间月份结构相同，此处省略展示
                "label": "2026年8月", // 展示名称
                "year_month": "2026-08", // 年月
                "start_month": "2026-08", // 期间开始月份
                "end_month": "2026-08" // 期间结束月份
            }
        ],
        "query_start_month": "2025-09", // 本次收入统计开始月份；默认当前月份往前共12个月
        "query_end_month": "2026-08", // 本次收入统计结束月份，默认包含当前月份
        "pay_method": "", // 支付方式筛选条件，空字符串表示不限
        "monthly_warning_amount": 0, // 月预警额筛选条件，0表示未选择；未选择时按商家类型默认规则标红
        "monthly_warning_amount_options": [10000, 100000, 300000], // 月预警额可选项：1万、10万、30万
        "realtime_month": "2026-08" // 查询范围包含当前月时返回当前月份，表示该月收入实时读取bbc_vendor_capital_detail
    }
}

备注

分页返回与涉税信息导出相同范围的商户及逐月收入金额，并返回rolling_twelve_month_total_income作为查询范围内最多12个自然月收入累计额。
支持按商家类型type、纳税类型tax_type、支付方式pay_method和月预警额monthly_warning_amount筛选。
已完成月份收入金额来自bbc_vendor_tax_income_month_summary.income_price，该汇总表来源为bbc_vendor_capital_detail.price，且仅统计income_type=1、rec_id>0的商品级收入。
当月实时查bbc_vendor_capital_detail.price，不要求先生成当月月汇总，响应中的realtime_month标识本次实时月份。
查询前只检查已完成月份的bbc_vendor_tax_income_month_refresh_log，未回填月份会返回提示，避免新汇总表没数据时误返回0。
monthly_warning_amount可选10000、100000、300000，传入时只返回存在月份金额达到该预警额的商户，并在monthly_income_warning中标记对应月份。
未传月预警额时，个体工商户月收入大于等于10万标红，企业且小规模纳税人月收入大于等于30万标红。
月度接口传year时返回该年12个自然月，year不能与start_month、end_month同时传入。
开始月份和结束月份需同时传入，首尾月份均计入，最多12个自然月。
三个时间条件都不传时默认查询当前月份及往前11个月，其中当前月实时查明细。
老数据可调用/mobile/VendorCapital/refreshTaxIncomeMonthSummary?start_month=2025-07&end_month=2026-07回填。
仅不合作商户status=0生效：warning_hidden_months为单个归零起始月份，该月及之后monthly_income返回0，并重新计算rolling_twelve_month_total_income；商户仍保留在列表中。

最后修改者: huangyingliang 2026-08-13 16:55:01

商户季度数据申报预警列表

编号 : 003

GET - https://fl.tp6.hyj111.cn/admin/vendorReportWarning/quarterly

headers下token必传

请求参数

参数名	参数类型	必传	缺省值	描述
page	int	N	1	页码，从1开始
pageSize	int	N	10	每页数量，默认10
vid	int	N		商户ID，对应bbc_vendor.vid
store_name	string	N		商户名称，模糊查询
type	int	N		商家类型：0=个体工商户，1=企业，2=自然人
tax_type	int	N		纳税类型：0=小规模纳税人，1=一般纳税人
pay_method	string	N		支付方式：mini-app=小程序，app=APP；空表示不限
is_warning	int	N		是否预警：1=是，0=否；按rolling_four_quarter_total_income_warning筛选
year	int	N		年份，格式YYYY；传year时返回该年四个自然季度；不能与开始、结束月份同时传入
start_month	string	N		开始月份，格式Y-m，必须为自然季度首月01、04、07或10；与结束月份同时传入；不传使用默认季度范围
end_month	string	N		结束月份，格式Y-m，必须为自然季度末月03、06、09或12；与开始月份同时传入；首尾包含最多4个自然季度

返回值

{
    "status": 200, // 状态码
    "msg": "获取商户季度数据申报预警列表成功", // 提示信息
    "data": { // 返回数据
        "total": 1, // 符合条件的商户总数
        "per_page": 10, // 每页数量
        "current_page": 1, // 当前页码
        "last_page": 1, // 最后一页页码
        "data": [ // 商户预警数据列表
            {
                "vid": 18, // 商户ID
                "store_name": "礼尚往来", // 商户名称
                "type": 1, // 商家类型：0=个体工商户，1=企业，2=自然人
                "tax_type": 0, // 纳税类型：0=小规模纳税人，1=一般纳税人
                "quarter_income": { // 各展示期间的收入金额，键名与periods.key一致
                    "2025_q4": 350000.00, // 2025年第四季度收入总额
                    "2026_q1": 370000.00, // 2026年第一季度收入总额
                    "2026_q2": 390000.00, // 2026年第二季度收入总额
                    "2026_q3_to_07": 130000.00 // 2026年第三季度收入总额，本示例实际统计到7月底
                },
                "rolling_four_quarter_total_income": 1240000.00, // 最近四个季度收入累计额
                "rolling_four_quarter_total_income_warning": false, // 年累计额是否达到小规模纳税人300万预警线
                "is_warning": false // 本行是否预警，true时前端可将累计额标红
            }
        ],
        "periods": [ // 动态展示期间，前端按此顺序生成季度列
            {
                "key": "2025_q4", // quarter_income中的字段键名
                "label": "2025年第四季度", // 展示名称
                "start_month": "2025-10", // 期间开始月份
                "end_month": "2025-12", // 期间结束月份
                "is_rolling_period": true // 是否计入最近四个季度累计额
            },
            {
                "key": "2026_q1", // quarter_income中的字段键名
                "label": "2026年第一季度", // 展示名称
                "start_month": "2026-01", // 期间开始月份
                "end_month": "2026-03", // 期间结束月份
                "is_rolling_period": true // 是否计入最近四个季度累计额
            },
            {
                "key": "2026_q2", // quarter_income中的字段键名
                "label": "2026年第二季度", // 展示名称
                "start_month": "2026-04", // 期间开始月份
                "end_month": "2026-06", // 期间结束月份
                "is_rolling_period": true // 是否计入最近四个季度累计额
            },
            {
                "key": "2026_q3_to_07", // quarter_income中的字段键名
                "label": "2026年第三季度", // 展示名称
                "start_month": "2026-07", // 期间开始月份
                "end_month": "2026-07", // 期间结束月份
                "is_rolling_period": true // 当前季度已完成月份累计值计入最近四个季度累计额
            }
        ],
        "rolling_period_keys": [ // 最近四个季度累计额使用的quarter_income键名
            "2025_q4",
            "2026_q1",
            "2026_q2",
            "2026_q3_to_07"
        ],
        "query_start_month": "2025-10", // 本次收入统计开始月份
        "query_end_month": "2026-07", // 本次收入统计结束月份，默认统计到当前月份的上一个完整月
        "pay_method": "", // 支付方式筛选条件，空字符串表示不限
        "is_warning": "", // 是否预警筛选条件，空字符串表示不限
        "quarter_warning_amount": 3000000 // 小规模纳税人季度滚动累计预警额
    }
}

备注

分页返回与涉税信息导出相同范围的商户及收入金额，支持按商家类型type、纳税类型tax_type、支付方式pay_method和是否预警is_warning筛选。
收入金额来自bbc_vendor_tax_income_month_summary.income_price，该汇总表来源为bbc_vendor_capital_detail.price，且仅统计income_type=1、rec_id>0的商品级收入。
查询前会检查bbc_vendor_tax_income_month_refresh_log，未回填月份会返回提示，避免新汇总表没数据时误返回0。
小规模纳税人rolling_four_quarter_total_income大于等于300万时is_warning=true，前端可将该累计额标红。
传year时返回该年四个自然季度；year不能与start_month、end_month同时传入。
start_month和end_month可选但必须同时传入，开始月份必须为自然季度首月，结束月份必须为自然季度末月，首尾包含且最多4个自然季度。
三个时间条件都不传时使用默认季度规则：统计到当前月份的上一个完整月，并取该月份所在季度及往前3个季度。
金额按rolling_four_quarter_total_income倒序分页，金额越大越靠前。
老数据可调用/mobile/VendorCapital/refreshTaxIncomeMonthSummary?start_month=2025-07&end_month=2026-07回填。
仅不合作商户status=0生效：warning_hidden_months为单个归零起始月份，该月及之后收入按0参与季度及滚动累计额计算；商户仍保留在列表中。

最后修改者: huangyingliang 2026-08-03 15:02:09

商户年度数据申报汇总

编号 : 001

GET - https://fl.tp6.hyj111.cn/admin/vendor/listVendorAnnualReport

headers下token必传

请求参数

参数名	参数类型	必传	描述
vid	int	N	商户ID，不传时从登录信息获取
year	int	N	年份，不传默认当前年份
pay_method	string	N	支付方式：mini-app=小程序，app=APP；不传表示不限

返回值

{
    "status": 200, // 状态码
    "msg": "ok", // 提示信息
    "data": { // 返回数据
        "vid": 18, // 商户ID
        "year": 2025, // 汇总年份
        "pay_method": "", // 支付方式：mini-app=小程序，app=APP，空字符串表示不限
        "company_name": "南通礼尚往来礼品有限公司", // 公司名称
        "store_name": "礼尚往来", // 店铺名称
        "quarters": [ // 季度数据，共返回4个季度
            {
                "quarter": 1, // 季度序号
                "quarter_label": "第1季度", // 季度名称
                "start_month": "2025-01", // 季度开始月份
                "end_month": "2025-03", // 季度结束月份
                "months": [ // 季度内的月份明细
                    {
                        "month": 1, // 月份数字
                        "month_label": "1月份", // 月份名称
                        "year_month": "2025-01", // 年月
                        "start_month": "2025-01", // 查询详情的开始月份
                        "end_month": "2025-01", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-01&end_month=2025-01", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-01-01 00:00&exchange_time_end=2025-01-31 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 2, // 月份数字
                        "month_label": "2月份", // 月份名称
                        "year_month": "2025-02", // 年月
                        "start_month": "2025-02", // 查询详情的开始月份
                        "end_month": "2025-02", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-02&end_month=2025-02", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-02-01 00:00&exchange_time_end=2025-02-28 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 3, // 月份数字
                        "month_label": "3月份", // 月份名称
                        "year_month": "2025-03", // 年月
                        "start_month": "2025-03", // 查询详情的开始月份
                        "end_month": "2025-03", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-03&end_month=2025-03", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-03-01 00:00&exchange_time_end=2025-03-31 23:59" // 下载明细接口地址
                    }
                ],
                "quarter_total": { // 季度合计
                    "label": "合计金额", // 合计行名称
                    "start_month": "2025-01", // 季度开始月份
                    "end_month": "2025-03", // 季度结束月份
                    "total_income": 361668.00, // 季度收入合计
                    "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-01&end_month=2025-03", // 季度查看详情接口地址
                    "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-01-01 00:00&exchange_time_end=2025-03-31 23:59" // 季度下载明细接口地址
                }
            },
            {
                "quarter": 2, // 季度序号
                "quarter_label": "第2季度", // 季度名称
                "start_month": "2025-04", // 季度开始月份
                "end_month": "2025-06", // 季度结束月份
                "months": [ // 季度内的月份明细
                    {
                        "month": 4, // 月份数字
                        "month_label": "4月份", // 月份名称
                        "year_month": "2025-04", // 年月
                        "start_month": "2025-04", // 查询详情的开始月份
                        "end_month": "2025-04", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-04&end_month=2025-04", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-04-01 00:00&exchange_time_end=2025-04-30 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 5, // 月份数字
                        "month_label": "5月份", // 月份名称
                        "year_month": "2025-05", // 年月
                        "start_month": "2025-05", // 查询详情的开始月份
                        "end_month": "2025-05", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-05&end_month=2025-05", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-05-01 00:00&exchange_time_end=2025-05-31 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 6, // 月份数字
                        "month_label": "6月份", // 月份名称
                        "year_month": "2025-06", // 年月
                        "start_month": "2025-06", // 查询详情的开始月份
                        "end_month": "2025-06", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-06&end_month=2025-06", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-06-01 00:00&exchange_time_end=2025-06-30 23:59" // 下载明细接口地址
                    }
                ],
                "quarter_total": { // 季度合计
                    "label": "合计金额", // 合计行名称
                    "start_month": "2025-04", // 季度开始月份
                    "end_month": "2025-06", // 季度结束月份
                    "total_income": 361668.00, // 季度收入合计
                    "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-04&end_month=2025-06", // 季度查看详情接口地址
                    "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-04-01 00:00&exchange_time_end=2025-06-30 23:59" // 季度下载明细接口地址
                }
            },
            {
                "quarter": 3, // 季度序号
                "quarter_label": "第3季度", // 季度名称
                "start_month": "2025-07", // 季度开始月份
                "end_month": "2025-09", // 季度结束月份
                "months": [ // 季度内的月份明细
                    {
                        "month": 7, // 月份数字
                        "month_label": "7月份", // 月份名称
                        "year_month": "2025-07", // 年月
                        "start_month": "2025-07", // 查询详情的开始月份
                        "end_month": "2025-07", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-07&end_month=2025-07", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-07-01 00:00&exchange_time_end=2025-07-31 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 8, // 月份数字
                        "month_label": "8月份", // 月份名称
                        "year_month": "2025-08", // 年月
                        "start_month": "2025-08", // 查询详情的开始月份
                        "end_month": "2025-08", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-08&end_month=2025-08", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-08-01 00:00&exchange_time_end=2025-08-31 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 9, // 月份数字
                        "month_label": "9月份", // 月份名称
                        "year_month": "2025-09", // 年月
                        "start_month": "2025-09", // 查询详情的开始月份
                        "end_month": "2025-09", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-09&end_month=2025-09", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-09-01 00:00&exchange_time_end=2025-09-30 23:59" // 下载明细接口地址
                    }
                ],
                "quarter_total": { // 季度合计
                    "label": "合计金额", // 合计行名称
                    "start_month": "2025-07", // 季度开始月份
                    "end_month": "2025-09", // 季度结束月份
                    "total_income": 361668.00, // 季度收入合计
                    "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-07&end_month=2025-09", // 季度查看详情接口地址
                    "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-07-01 00:00&exchange_time_end=2025-09-30 23:59" // 季度下载明细接口地址
                }
            },
            {
                "quarter": 4, // 季度序号
                "quarter_label": "第4季度", // 季度名称
                "start_month": "2025-10", // 季度开始月份
                "end_month": "2025-12", // 季度结束月份
                "months": [ // 季度内的月份明细
                    {
                        "month": 10, // 月份数字
                        "month_label": "10月份", // 月份名称
                        "year_month": "2025-10", // 年月
                        "start_month": "2025-10", // 查询详情的开始月份
                        "end_month": "2025-10", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-10&end_month=2025-10", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-10-01 00:00&exchange_time_end=2025-10-31 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 11, // 月份数字
                        "month_label": "11月份", // 月份名称
                        "year_month": "2025-11", // 年月
                        "start_month": "2025-11", // 查询详情的开始月份
                        "end_month": "2025-11", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-11&end_month=2025-11", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-11-01 00:00&exchange_time_end=2025-11-30 23:59" // 下载明细接口地址
                    },
                    {
                        "month": 12, // 月份数字
                        "month_label": "12月份", // 月份名称
                        "year_month": "2025-12", // 年月
                        "start_month": "2025-12", // 查询详情的开始月份
                        "end_month": "2025-12", // 查询详情的结束月份
                        "total_income": 120556.00, // 当月收入金额
                        "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-12&end_month=2025-12", // 查看详情接口地址
                        "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-12-01 00:00&exchange_time_end=2025-12-31 23:59" // 下载明细接口地址
                    }
                ],
                "quarter_total": { // 季度合计
                    "label": "合计金额", // 合计行名称
                    "start_month": "2025-10", // 季度开始月份
                    "end_month": "2025-12", // 季度结束月份
                    "total_income": 361668.00, // 季度收入合计
                    "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-10&end_month=2025-12", // 季度查看详情接口地址
                    "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-10-01 00:00&exchange_time_end=2025-12-31 23:59" // 季度下载明细接口地址
                }
            }
        ],
        "annual_total": { // 年度合计
            "label": "年度总额", // 合计行名称
            "start_month": "2025-01", // 年度开始月份
            "end_month": "2025-12", // 年度结束月份
            "total_income": 1446672.00, // 年度收入合计
            "detail_url": "https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail?vid=18&start_month=2025-01&end_month=2025-12", // 年度查看详情接口地址
            "export_url": "https://fl.tp6.hyj111.cn/admin/vendorBill/miniappExport?vid=18&is_settle=2&exchange_time_start=2025-01-01 00:00&exchange_time_end=2025-12-31 23:59" // 年度下载明细接口地址
        }
    }
}

备注

按year返回全年12个月、4个季度合计和年度总额；vid不传时从登录信息获取；每个月、季度合计、年度总额均返回detail_url和export_url；pay_method可选mini-app或app；原listVendorQuarterHistory接口不变。

最后修改者: huangyingliang 2026-08-03 15:02:09

商户数据申报详情

编号 : 002

GET - https://fl.tp6.hyj111.cn/admin/vendor/vendorAnnualReportDetail

headers下token必传

请求参数

参数名	参数类型	必传	缺省值	描述
vid	int	N		商户ID，不传时从登录信息获取
start_month	string	Y	2026-07	开始月份，格式Y-m
end_month	string	Y	2026-09	结束月份，格式Y-m，不能早于开始月份
pay_method	string	N		支付方式：mini-app=小程序，app=APP；不传表示不限

返回值

{
    "status": 200, // 状态码
    "msg": "ok", // 提示信息
    "data": { // 返回数据
        "vid": 18, // 商户ID
        "company_name": "南通礼尚往来礼品有限公司", // 公司名称
        "start_month": "2026-07", // 查询开始月份
        "end_month": "2026-09", // 查询结束月份
        "time_range": "2026年7月-2026年9月", // 页面展示的时间范围
        "pay_method": "", // 支付方式：mini-app=小程序，app=APP，空字符串表示不限
        "total_income": 20135.46, // 收入总额
        "total_refund": 0.00, // 退款总额
        "platform_commission": 463.14, // 支付给平台佣金，business_type=0
        "shared_warehouse_commission": 463.14, // 支付给共享仓佣金，business_type=5
        "order_count": 36, // 订单数量
        "tax_number": "123456", // 统一社会信用代码或纳税识别号
        "service_agency_flag": "", // 专业服务机构标识
        "store_unique_code": 18, // 店铺或用户唯一标识码
        "store_name": "礼尚往来", // 店铺或用户名称
        "contact_name": "郭本娜", // 联系人姓名
        "contact_phone": "17739182175", // 联系电话
        "operation_start_date": "2025-10-20", // 经营开始日期原始值
        "operation_start_date_text": "2025年10月20日" // 经营开始日期展示值
    }
}

备注

按start_month和end_month查询单月、季度或年度详情；平台佣金统计business_type=0，共享仓佣金统计business_type=5；vid不传时从登录信息获取；start_month不能大于end_month。