- 账户
- 模型调用
- 会话(chat)
- 嵌入(embedding)
- 图像(dall)
- 排序模型
- 图片
- midjourney
- 工具
发票查验
POST
https://api.agicto.cn/v1/tool/invoiceValidate
请求参数
Header 参数
Authorization
string
必需
示例值:
Bearer sk-
Content-Type
string
必需
示例值:
application/json
Body 参数application/json
fpdm
string | null
发票代码
fphm
string
发票号码
kprq
string
开票日期
jym
string | null
可选
je
string | null
可选
示例
{
"fpdm": "string",
"fphm": "string",
"kprq": "string",
"jym": "string",
"je": "string"
}示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.agicto.cn/v1/tool/invoiceValidate' \
--header 'Authorization: Bearer sk-' \
--header 'Content-Type: application/json' \
--data-raw '{
"fpdm": "string",
"fphm": "string",
"kprq": "string",
"jym": "string",
"je": "string"
}'返回响应
🟢200成功
application/json
Body
object {0}
示例
增值税发票 (01)
{
"code": 200, // 返回码，详见code返回码说明
"msg": "成功", //code对应的描述
"taskNo": "12552230716560623515", // 本次唯一请求号
"data": {
"fplx": "01", // 发票类型，详见发票类型说明
"times": 4, // 查验次数（第几次）
"xfsbh":"1522***********K01451", //销方识别号
"gfmc":"东方****有限公司", //购方名称
"gmfyhzh":"工行杭州景江苑支行 12******************36", //购买方银行账号
"xhqdBz":"N", //清单标志：发票明细中是否有清单行（Y清单 N非清单）
"dkXsfmc":"马*弟<", //代开销售方名称
"dq":"内蒙古自治区", //地区
"tspzDm": "", // 特殊票种代码，02农产品收购发票 08成品油发票
"xsfdzdh":"乌兰浩特市 1584****535", //销售方地址电话
"se":240, //税额
"kprq":"2022-01-04 00:00:00", //开票日期
"bz":"代开企业税号:15222*****71610 代开企业名称:马*弟<br/>房屋坐落地址:乌兰浩特市爱国小区*号楼", //备注
"kjlx":"2", //开具类型
"fpztDm":"0", //发票状态代码
"sbbh":"661816407119", //设备编号
"gfsbh":"91330********66XE", //购方识别号
"fpdm":"150*****60", //发票代码
"fphm":"00****89", //发票号码
"jym":"69591030500952264929", //校验码
"dkXsfsbh":"152**************610", //代开销售方识别号
"gmfdzdh":"杭州市滨江区****66号 0571-8*****34", //购买方地址电话
"xsfyhzh":"31522***********07111", //销售方银行账号
"jshj":16800, //价税合计
"jshjcn":"壹万陆仟捌佰元整", //价税合计（中文大写）
"je":16560, //金额
"xfmc":"国家税务总局乌兰浩特市税务局第一税务分局", //销方名称
"txfbz":"Y",//如果是通行费，则有该字段，Y表示该通行费可抵扣，N表示不可以抵扣 //通行费标识
"hwxx":[ //货物信息
{
"ggxh":"", //规格型号
"jldw":"套", //计量单位
"dj":"16560.00", //单价
"mxxh":1, //明细序号
"se":240, //税额
"ysse":"240", //原始税额
"mc":"房屋租赁（20220101-20221231）", //名称
"sl":"1", //数量
"je":16560, //金额
"slv":0.015, //税率
"ysslv":"1.5%", //原始税率
"spbm":"" //商品编码
}
]
}
}
机动车销售统一发票(03)
{
"code": 200,
"msg": "成功",
"taskNo": "12552230716560623515",
"data": {
"fplx": "03", //发票类型 ，详见发票类型说明
"times": 4, //查验次数 （第几次）
"cjhm":"JN8BY2NY0J912****", // 车架号码/车辆识别代码
"dh":"022-8625****", //电话
"gfmc":"陈**", // 购买方名称
"sfzhm":"4203*********2712", //身份证号码/组织机构代码
"xhdwsbh":"9112*********C933", // 销货单位纳税人识别号
"dq":"天津", //地区
"jshjcn":"肆拾叁万伍仟伍佰元整", //价税合计中文大写
"dw":"", //吨位
"yszzsse":"60068.97", //原始增值税税额字段
"xcrs":"7", //限乘人数
"kprq":"2018-09-19 00:00:00", //开票日期
"dz":"天津自贸实验区（天津港保税区）**广场*号****汽车城****室", //地址
"kjlx":"1", //开具类型标识：1自开 2代开 3代办退税
"cllx":"越野车", //车辆类型
"fpztDm":"0", //发票状态代码：发票状态代码 0正常 1失控（历史数据） 2作废 3已红冲
"hgzh":"", //合格证号
"khyh":"中国银行股份有限公司天津***分行", //开户银行
"sbbh":"661604157082", //机打代码/机打号码
"gfsbh":" ", //购买方纳税人识别号
"cd":"日本", //产地
"fpdm":"1120****0160", //发票代码
"swjgMc":"原天津市保税区国家税务局第三税务所", //主管税务机关名称
"sjdh":"BA021****", //商检单号
"zh":"27008115****", //账号
"swjgDm":"112942200", //主管税务机关代码
"wspzhm":"", //完税凭证号码
"lslbs":" ", //零税率标识：空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
"cpxh":"克罗迪 涂乐 ****CC越野车", //厂牌型号
"zzsse":60068.97, //增值税税额
"jkzmsh":"H0218023****", // 进口证明书号
"xhdwmc":"天津****贸易有限公司", //销货单位名称
"jshj":435500, //价税合计
"je":375431.03, //不含税价
"slv":0.16, //增值税税率或征收率
"ysslv":"16%", //原始税率字符串
"fdjhm":"VQ40664****", //发动机号码
"fphm":"00****97" //发票号码
}
}
增值税普通发票(04)
{
"code": 200,
"msg": "成功",
"taskNo": "12552230716560623515",
"data": {
"fplx": "04", //发票类型 ，详见发票类型说明
"times": 4, //查验次数 （第几次）
"xfsbh":"4303**********3014", //销售方识别号
"gfmc":"湘潭市**包装有限公司", //购买方名称
"gmfyhzh":"中国银行股份有限公司*****支行6054****4355", //购买方银行账号
"xhqdBz":"N", //清单标志：发票明细中是否有清单行（Y清单 N非清单）
"tspzDm":"02", //特殊票种代码，02农产品收购发票 08成品油发票
"dq":"湖南", //地区
"xsfdzdh":"", //销售方地址电话
"se":0, //税额
"kprq":"2018-08-18 00:00:00", //开票日期
"bz":"", //备注
"kjlx":"1", //开具类型标识：1自开 2代开 3代办退税
"fpztDm":"0", //（电子底账用）发票状态代码：发票状态代码 0正常 1失控（历史数据） 2作废 3已红冲
"sbbh":"661510345883", //设备/机器编号：税控盘号、金税盘号
"gfsbh":"9143**********016C", //购买方识别号
"fpdm":"0430****0104", //发票代码
"gmfdzdh":"湘潭市**区**村 0731-52****99", //购买方地址电话
"xsfyhzh":"", //销售方银行账号
"jshj":9672, //价税合计
"jshjcn":"玖仟陆佰柒拾贰元整", //价税合计（中文大写）
"je":9672, //金额
"xfmc":"冯*春", //销售方名称
"fphm":"26****02", //发票号码
"jym":"7699*************4758" , //校验码
"hwxx":[ //货物信息
{
"ggxh":"", //规格型号
"jldw":"吨", //计量单位
"dj":"800.00", //单价
"mxxh":1, //明细序号
"lslbs":"1", //零税率标识：空：非零税率，0：出口零税，1：免税，2：不征税，3 普通零税率
"se":0, //税额
"ysse":"***", //原始税额字符串
"mc":"*林业产品*松元木", //货物劳务名称
"sl":"12.09", //数量
"je":9672, //金额
"slv":0, //税率
"ysslv":"免税", //原始税率字符串
"spbm":"1010202010000000000" //税局编码/税收分类编码
}
]
}
}
增值税电子专票和增值税电子普票(08)
{
"code": 200, // 返回码，详见code返回码说明
"msg": "成功", //code对应的描述
"taskNo": "12552230716560623515", // 本次唯一请求号
"data": {
"fplx": "08", // 发票类型，详见发票类型说明
"times": 4, // 查验次数（第几次）
"xfsbh":"91330******M3FR34P", //销方识别号
"gfmc":"广州***集成家居有限公司", //购方名称
"gmfyhzh":"招商银行股份有限公司广州**支行12091****10777", //购买方银行账号
"xhqdBz":"N", //清单标志：发票明细中是否有清单行（Y清单 N非清单）
"purl":"https://****", //PDF版式文件下载链接（只有税务ukey开具的电子专票和电子普票有）
"dq":"浙江", //地区
"tspzDm": "", // 特殊票种代码，02农产品收购发票 08成品油发票
"xsfdzdh":"浙江省义乌市**街道**路*号*楼0579-85****66", //销售方地址电话
"se":54.51, //税额
"kprq":"2021-10-09 00:00:00", //开票日期
"bz":"", //备注
"kjlx":"1", //开具类型
"fpztDm":"0", //发票状态代码
"sbbh":"917106314504", //设备编号
"gfsbh":"91440*******QD3L35", //购方识别号
"fpdm":"0330****0113", //发票代码
"url":"https://******", //OFD版式文件下载链接（只有税务ukey开具的电子专票和电子普票有）
"gmfdzdh":"广州市增城区**镇****村、**村（办公楼D）020-82****98", //购买方地址电话
"xsfyhzh":"宁波银行股份有限公司****支行79040******245913", //销售方银行账号
"jshj":963, //价税合计
"jshjcn":"玖佰陆拾叁元整", //价税合计（中文大写）
"je":908.49, //金额
"xfmc":"义乌市**酒店管理有限公司", //销方名称,
"fphm":"09****92", //发票号码
"jym":"10959777606333*******" //校验码
"hwxx":[ //货物信息
{
"ggxh":"", //规格型号
"jldw":"天", //计量单位
"dj":"181.698113", //单价
"mxxh":1, //明细序号
"se":54.51, //税额
"ysse":"54.51", //原始税额
"mc":"*住宿服务*住宿费", //名称
"sl":"5.000000", //数量
"je":908.49, //金额
"slv":0.06, //税率
"ysslv":"6%", //原始税率
"spbm":"30704*********000000" //商品编码
}
]
}
}
通行费发票/增值税电子普通发票（通行费）(14)
{
"code": 200,
"msg": "成功",
"taskNo": "12552230716560623515",
"data": {
"fplx": "14", // 发票类型，详见发票类型说明
"times": 4, // 查验次数（第几次）
}
}
二手车销售统一发票查验成功返回结果(15)
{
"code": 200,
"msg": "成功",
"taskNo": "12552230716560623515",
"data": {
"fplx": "15", // 发票类型，详见发票类型说明
"times": 4, // 查验次数（第几次）
"xfsbh":"9142**********988G", //销方识别号
"gfmc":"中国**集团有限公司", //购方名称
"gmfyhzh":"建行***支行 4200*********0980", //购买方银行账号
"dq":"湖北", //地区
"xsfdzdh":"湖北省**市**县***农场**管理所 027-83****68", //销售方地址电话
"jshjcn":"壹佰零伍元玖角捌分", //价税合计（中文大写）
"se":3.09, //税额
"kprq":"2022-06-14 00:00:00", //开票日期
"bz":"汇总开具", //备注
"kjlx":"1", //开具类型
"fpztDm":"0", //发票状态代码
"sbbh":"499099651596", //设备编号
"txfbz":"Y", //通行费标志
"gfsbh":"9142********5556", //购方识别号
"fpdm":"042******112", //发票代码
"fplx":"14", //发票类型
"gmfdzdh":"**区**街坊（**区**路*号****大楼） 027-68****15", //购买方地址电话
"xsfyhzh":"工行**县支行1814**********7451", //销售方银行账号
"jshj":105.98, //价税合计
"je":102.89, //金额
"xfmc":"湖北**高速公路经营有限公司", //销方名称
"fphm":"89****71", //发票号码
"jym":"0335************4357", //校验码
"hwxx":[
{
"mxxh":1, //明细序号
"ggxh":"鄂******", //车牌号
"jldw":"客车", //类型
"sl":"20220602", //数量（通行日期起）
"dj":"20220610", //单价（通行日期止）
"txrqq":"20220602", //通行日期起
"txrqz":"20220610", //通行日期止
"lslbs":" ", //零税率标识
"se":3.09, //税额
"ysse":"3.09", //原始税额
"mc":"经营租赁通行费", //名称
"je":102.89, //金额
"slv":0.03, //税率
"ysslv":"3%", //原始税率
"spbm":"3040502020301000000" //商品编码
}
]
}
}
全电纸质(机动车销售统一发票)(0903)
{
"code": 200, // 返回码，详见code返回码说明
"msg": "成功", //code对应的描述
"taskNo": "12552230716560623515", // 本次唯一请求号
"data": {
"fplx": "0903", //发票类型
"times": 4, // 查验次数（第几次）
"dq": "天*", //地区
"fpdm": "11******60", //发票代码
"fphm": "00****11", //发票号码
"kprq": "2023-11-17 00:00:00",//开票日期
"gfmc": "张**", //购方名称
"sfzhm": "", //身份证号码
"gfsbh": "12*******29", //购方识别号
"cllx": "插电式混合动力轿车", //车辆类型
"cpxh": "比亚迪牌******", //厂牌型号
"cd": "深圳市", //产地
"hgzh": "YK********15", //合格证号
"jkzmsh": "无", //进口证明书号
"sjdh": "无", //商检单号
"fdjhm": "L2*****61", //发动机号码
"cjhm": "LC*******32", //车架号码/车辆识别代码
"jshj": 213800.00, //价税合计
"jshjcn": "贰拾壹万叁仟捌佰元整",//价税合计（中文大写）
"xhdwmc": "天津市******公司",//销货单位名称
"dh": "28******11", //电话
"xhdwsbh": "91*********5A", //销货单位纳税人识别号
"zh": "75**********39", //账号
"dz": "河西********85", //地址
"khyh": "中国*******业部", //开户银行
"slv": 0.13, //增值税税率或征收率
"ysslv": "13%", //原始税率 字符串 例【不征税】
"zzsse": 24596.46, //增值税税额
"yszzsse": "24596.46", //原始增值税税额
"swjgDm": "11******00", //主管税务机关代码
"swjgMc": "国家********务所", //主管税务机关名称
"je": 189203.54, //金额（不含税）
"wspzhm": "", //完税凭证号码
"dw": "0.5", //吨位
"xcrs": "5", //限乘人数
"kpr": null, //开票人
"lslbs": "", //税控码
"kjlx": "1", //开具类型
"sbbh": "", //设备编号
"fpztDm": "0" //发票状态代码
}
}
全电纸质(二手车销售统一发票)(0915)
{
"code": 200, // 返回码，详见code返回码说明
"msg": "成功", //code对应的描述
"taskNo": "12552230716560623515", // 本次唯一请求号
"data": {
"fplx": "0915", //发票类型
"times": 4, // 查验次数（第几次）
"dq": "天津", //地区
"fpdm": "01********17", //发票代码
"fphm": "00****96", //发票号码
"kprq": "2023-11-14 00:00:00", //开票日期
"skm": null, //税控码
"gfDm": "12**************46", //买方单位/个人代码
"gfMc": "张*", //买方单位/个人名称
"gfDz": "天津****************14",//买方单位/个人地址
"gfDh": "13*****21", //买方单位/个人电话
"xfDm": "12*************27", //卖方单位/个人代码
"xfMc": "吴*", //卖方单位/个人名称
"xfDz": "天津************4号", //卖方单位/个人地址
"xfDh": "18*******51", //卖方单位/个人电话
"spbm": null, //商品编码
"cpzh": "津******", //车牌照号
"djzh": "12********32", //登记证号
"cllx": "小型轿车", //车辆类型
"clsbdm": "LS******10", //车架号/车辆识别代码
"cpxh": "晶锐牌********", //厂牌型号
"zrdclglsMc": "天津市车辆管理所", //转入地车辆管理所名称
"cjhj": 1000.00, //车价合计
"cjhjcn": "壹仟元整", //车价合计(中文大写)
"jyPmSbh": "", //经营、拍卖单位纳税人识别号
"jyPmMc": "", //经营、拍卖单位纳税人识别号
"jyPmDz": "", //经营、拍卖单位地址
"jyPmDh": "", //经营、拍卖单位电话
"jyPmYhzh": "", //经营、拍卖单位开户银行账号
"escSbh": "91**********1J", //二手车市场识别号
"escMc": "天津********公司", //二手车市场名称
"escDh": "02*******58", //二手车市场电话
"escDz": "天津市********院内", //二手车市场地址
"escYhzh": "天津农**********", //二手车市场开户行账号
"bz": "", //备注
"kpfLx": null, //开票方类型：1经营单位 2拍卖单位 03二手车市场
"kpfNsrsbh": null, //开票方纳税人识别号
"kpr": null, //开票人
"kjlx": "1", //开具类型标识：1自开 2代开 3代办退税
"zfr": null, //作废人
"zfrq": null, //作废日期
"fpztBz": null, //发票状态标识：0正数票 1负数票 2空白作废发票 3正数作废发票 4负数作废发票
"bsNsrsbh": null, //报税纳税人识别号
"sbbh": "", //设备/机器编号：税控盘号、金税盘号
"zxbm": null, //自行编码
"fpztDm": "0" //发票状态代码
}
}
查无此票返回样例
{
"code": 201,
"msg": "查无此票",
"taskNo": "12552230716560623515",
"data": {
"fplx": "01"
}
}
不一致返回样例
{
"code": 202,
"msg": "不一致",
"taskNo": "12552230716560623515",
"data": {
"fplx": "01"
}
}
发票类型列表：
01 增值税专用发票
03 机动车销售统一发票
04 增值税普通发票
08 增值税专用发票（电子）
09 全电发票
0901 全电纸质发票(增值税专用发票)
0903 全电纸质(机动车销售统一发票)
0904 全电纸质发票(增值税普通发票)
0910 电子发票（普通发票）
0915 全电纸质(二手车统一销售发票)
0920 电子发票（增值税专用发票）
10 增值税普通发票（电子）
11 增值税普通发票（卷式）
14 通行费发票
15 二手车发票
83 电子发票（铁路电子客票）
61 电子发票（航空运输电子客票行程单）