1、数电开票
## 1.设置二维码认证有效时长
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/smsc
#### 请求方式:POST
>d 可通过此接口设置扫脸二维码认证的有效时长,登录人的身份必须是财务负责人或法定代表人
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|phxxz|扫码时长|String|是|设置的扫码时长(单位分钟,只能为30的倍数)|
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
#### 响应参数说明:
## 2.商品管理-列表查询
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/spxxCx
#### 请求方式:POST
>d 从电子税务局查询已存在的商品信息列表
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|pageIndex|当前页码|Integer|是||
|pageSize|每页行数|Integer|是||
|params|查询参数|Params|是||
##### Params对象字段说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|xmmc|项目名称|String|否||
|jm|简码|String|否||
|ggxh|对方税号|String|否||
|slv|对方纳税人名称|String|否||
|dj|单价|String|否||
|spfwbm|税收分类编码|String|否||
|spfwjc|税收分类名称|String|否||
|dwdm|计量单位代码|String|否||
|dwmc|计量单位名称|String|否||
|fluuid|分类uuid|String|否|要查询的商品分类ID, 默认为00|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|records|总记录数|Integer| 是||
|commodityList|商品集合|List< Commodity >| 是||
##### Commodity对象字段说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|uuid|商品UUID|String| 是||
|fluuid|商品分类UUID|String| 是||
|xmmc|项目名称|String| 是||
|ggxh|规格型号|String| 否||
|dwdm|计量单位代码|String| 否||
|dwmc|计量单位名称|String| 否||
|spfwbm|税收服务编码|String| 否||
|spfwjc|税收服务简称|String| 否||
|jm|简码|String| 否||
|dj|单价|String| 否||
|hsbz|含税标记|String| 否|Y含税 / N不含税|
|slv|税率|String| 否||
|yhzsbz|是否享受优惠政策标志|String| 否|Y是 / N否|
|zzstsgl|增值税简易计税类型|String| 否|03:免税;08:按3%简易征收|
## 3.商品管理-商品新增
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/spxxAdd
#### 请求方式:POST
>d 在电子税务局新增商品信息
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|xmmc|项目名称|String|是||
|fluuid|商品分类UUID|String|否||
|ggxh|规格型号|String|否||
|dwdm|计量单位代码|String|否||
|dwmc|计量单位名称|String|否||
|slv|税率|String|是||
|spfwbm|税收服务编码|String|是||
|spfwjc|税收服务简称|String|是||
|hsbz|含税标记|String|否|Y含税 / N不含税|
|jm|简码|String|否||
|dj|单价|String|否||
|yhzsbz|是否享受优惠政策标志|String|否|Y是 / N否|
|zzstsgl|增值税简易计税类型|String|否|03:免税;08:按3%简易征收|
|sm|商品说明|String|否|根据电票平台规则,建议在给商品赋予税收编码时,将税收编码中的sm传入本字段中|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|result|执行结果|Boolean| 是|true成功, false失败|
## 4.商品管理-商品编辑
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/spxxUpdate
#### 请求方式:POST
>d 在电子税务局修改指定uuid的商品信息
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|uuid|商品UUID|String|是||
|xmmc|项目名称|String|是||
|fluuid|商品分类UUID|String|是||
|ggxh|规格型号|String|否||
|dwdm|计量单位代码|String|否||
|dwmc|计量单位名称|String|否||
|slv|税率|String|是||
|spfwbm|税收服务编码|String|是||
|spfwjc|税收服务简称|String|是||
|hsbz|含税标记|String|否|Y含税 / N不含税|
|jm|简码|String|否||
|dj|单价|String|否||
|yhzsbz|是否享受优惠政策标志|String|否|Y是 / N否|
|zzstsgl|增值税简易计税类型|String|否|03:免税;08:按3%简易征收|
|sm|商品说明|String|否|根据电票平台规则,建议在给商品赋予税收编码时,将税收编码中的sm传入本字段中|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|result|执行结果|Boolean| 是|true成功, false失败|
## 5.商品管理-商品删除
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/spxxDel
#### 请求方式:POST
>d 在电子税务局删除一个或多个商品信息
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|uuids|商品UUID列表|List< String>|是|一次可删除一个或多个|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|result|执行结果|Boolean| 是|true成功, false失败|
## 6.获取企业基本信息
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/qyjbxxcx
#### 请求方式:POST
>d 通过本接口获取当前登录的企业基本信息,
本接口数据从局端实时获取,河马未做任何加工处理。
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|nsrmc|纳税人名称|String| 是||
|nsrsbh|纳税人识别号|String|是||
|sfkkjzzfp|是否可开具增值税发票|String| 是||
|qyhyxz|企业行业性质|List< String>|是||
|bsrxm|办税人姓名|String|是||
|provinceId|所在省市行政区划码|String|是||
|province|所在省或市名称|String|是||
|nsrztdm|纳税人状态代码|String|是||
|Jyfw|经营范围|String|是||
|zcdz|注册地址|String|是||
|djxh|纳税人登记序号|String|是||
|yhzh|银行账户|String|是||
|swjgdm|税务机关代码|String|是||
|ssjswjgdm|所属局税务机关代码|String|是||
|Swjgmc|税务机关名称|String|是||
|fpzldms|税务机关名称|Fpzldms|是||
##### Fpzldms对象字段说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|fpzldm|发票种类代码|String| 是|01:增值税专用发票, 02:普通发票|
|fpzlmc|发票种类名称|String| 是||
## 7.获取开票统计信息
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/kptjxxcx
#### 请求方式:POST
>d 通过本接口获取当前登录的企业发票统计信息
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|sysxed|可用发票额度|String| 是||
|ysysxed|已使用发票额度|String|是||
|zsxed|发票总额度|String| 是||
|syzzfpzs|当前可用纸票数量|String|是||
|ysyfpzs|已使用发票张数|String|是||
|bykjlpzs|本月已开具蓝票张数|String|是||
|fpejse|发票累计税额|String|是||
|fphjje|发票合计金额|String|是||
|zfpzs|总发票张数|String|是||
## 8.办税(开票)人授信类别查询
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/sxlbCx
#### 请求方式:POST
>d 通过本接口可获取当前登录纳税人的风险等级,预警等级、开票前是否需要刷脸等授信信息。
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|yjjb|预警级别|String| 是|01,无预警 02,红色预警 03,黄色预警 04,蓝色预警|
|sxlb|授信类别|String|是|1,高风险纳税人 2,中风险纳税人 3,低风险纳税人 4,无风险纳税人|
|sfsl|开票前是否需要刷脸|String| 是|Y或null:需要刷脸;N:无需刷脸,建议用户在获取到sfsl不为'N'时,触发刷脸程序。|
## 9.获取人脸识别认证二维码
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/rzewm
#### 请求方式:POST
>d 1.通过本接口可获取当前登录用户人脸识别认证使用的二维码文本信息。
2.因税局变更,在调完本接口,完成人脸识别后必须去请求:获取人脸识别认证结果,该扫脸认证方可生效!!!
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|nsrssbh|企业纳税人识别号|String| 是||
|ewm|二维码内容|String|是||
|rzid|认证ID,通过该ID可查询是否已刷脸状态|String| 是||
## 10.获取人脸识别认证结果
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/rzztcx
#### 请求方式:POST
>d 通过本接口可获取当前登录用户人脸识别的结果
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|rzid|前一接口获取到的认证二维码ID|String|是|参考获取人脸识别认证二维码接口返回值|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|nsrssbh|企业纳税人识别号|String| 是||
|slzt|刷脸状态|String|是|1,已生成二维码未扫脸 2,扫脸成功 3,二维码已过期|
## 11.数电发票开具接口
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/fpkjZzs
#### 请求方式:POST
>d 通过本接口可实现开具全面数字化电子发票的开具
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|lyDdbh|来源订单编号|String|是|指业务系统中对应的订单编号,销售单号或合同单号等,本接口同一个单号仅能开具一次发票。|
|fplxdm|发票类型代码|String|是|030,全电普通发票 032,全电专用发票|
|xsfNsrsbh|销方税号|String|是||
|xsfNsrmc|销方名称|String|是||
|xsfDz|销售方地址|String|是||
|xsfDh|销售方电话|String|是||
|xsfYhmc|销售方开户银行|String|是||
|xsfYhzh|销售方银行账号|String|是||
|gmfLx|购方类型|String|是|0,企业 1,个人|
|gmfNsrsbh|购方税号|String|是||
|gmfNsrmc|购方名称|String|是||
|gmfDz|购买方地址|String|否||
|gmfDh|购买方电话|String|否||
|gmfYhmc|购买方开户银行|String|否||
|gmfYhzh|购买方银行账号|String|否||
|hjje|合计金额|String|否|不传时会自动通过明细计算,为保证您的票面金额的准确性,在开具不含税发票时,建议您传入合计金额。|
|hjse|合计税额|String|否|不传时会自动通过明细计算|
|jshj|价税合计|String|否|不传时会自动计算,为保证您的票面金额的准确性,在开具含税发票时,建议您传入价税合计。|
|bz|备注|String|否||
|kpr|开票人姓名|String|否||
|hsslbs|含税标识|String|否|1: 是不含税价, 不传值默认为含税价 2:是含税价(注:本参数仅用于价税分离,如您的请求报文已包含项目金额、税额,则本参数无任何意义)|
|xgmXsyhzc|小规模享受优惠政策|String|否|04”和”05“均为不享受优惠政策;如您不是小规模优惠对象,本参数请传空或不传|
|gfxxConfirm||String|否|"0": 忽略购方信息错误,直接开具; 空或不传,则会提示购方信息错误|
|kjjeConfirm||String|否|"0": 忽略大金额提示,直接开具; 空或不传,则会提示开具金额较大|
|sfzsgmfyhzh|是否展示购买方银行账号|String|否|1 展示 0或空不展示|
|sfzsxsfyhzh|是否展示销售方银行账号 |String|否|1 展示 0或空不展示|
|xmmx|开票明细项目|List< Xmmx>|是||
##### Xmmx对象字段说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|fphxz|发票行性质|String| 是|0:正常行 1:折扣行 2:被折扣行|
|spbm|税收商品编码|String| 是|19位的商品编码(简称)|
|spmc|税收商品名称|String| 是|19位商品编码对应的名称|
|xmmc|自定义的商品名称|String| 是||
|ggxh|商品规格型号|String| 否||
|dw|单位|String| 否||
|spsl|商品数量|String| 否||
|dj|单价|String| 否||
|sl|税率|String| 是||
|je|金额|String| 是||
|se|税额|String| 否|不传时会自动计算|
|slbs|税率标识|String| 是|空:非零税率, 1:免税;2:不征税;3: 普通零税率,|
|je|税收优惠政策类型|String| 否|”08“:"按3%简易征收","09":"按5%简易征收"|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|requestId|异步接口调用后会返回requestId|String| 否|开票请求成功有|
## 12.开票结果查询
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/fpjgcx
#### 请求方式:POST
>d 通过本接口可查询开票结果
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|requestId|上面发票开具接口结果返回|String|是||
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|requestId|上面发票开具接口结果返回|String| 是||
|xsfNsrsbh|销售方税号|String| 否||
|xsfNsrmc|销售方名称|String| 否||
|gmfNsrsbh|购买方税号|String| 否||
|gmfNsrmc|购买方名称|String| 否||
|kplx|开票类型|String| 否|开票成功时有 0:蓝票|
|kprq|开票日期|String| 否|开票成功时有|
|jshj|开票含税金额|String| 否|开票成功时有|
|fplxdm|发票类型代码|String| 否|开票成功时有;030,全电普票 032,全电专票|
|fphm|发票号码|String| 否|开票成功时有|
## 13.开票结果回调
#### 接口地址:
客户提供回调地址
#### 请求方式:POST
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|requestId|上面发票开具接口结果返回|String| 是||
|xsfNsrsbh|销售方税号|String| 否||
|xsfNsrmc|销售方名称|String| 否||
|gmfNsrsbh|购买方税号|String| 否||
|gmfNsrmc|购买方名称|String| 否||
|kplx|开票类型|String| 否|开票成功时有 0:蓝票|
|kprq|开票日期|String| 否|开票成功时有,格式:yyyy-MM-dd HH:mm:ss|
|jshj|开票含税金额|String| 否|开票成功时有|
|fplxdm|发票类型代码|String| 否|开票成功时有;030,全电普票 032,全电专票|
|fphm|发票号码|String| 否|开票成功时有|
## 14.已开发票版式文件下载
#### 接口地址:
/open/ct/api/v1/invoice/sdfp/bswjxz
#### 请求方式:POST
>d 通过本接口可查询开票结果
#### 请求参数说明:
|参数名称|参数含义|数据类型|是否必填|参数备注|
|-|-|-|-|-|
|nsrsbh|企业纳税人识别号|String|是||
|eno|办税人员编码|String|是|表示一个企业一个身份类型一个身份证唯一的一个编码|
|kprq|开票日期|String|是|格式:yyyy-MM-dd HH:mm:ss|
|fphm|发票号码|String|是|20位数电发票号码|
|wjgs|文件格式|String|是|PDF、OFD、XML|
|xzlx|下载类型|String|是|base64或url|
#### 响应参数说明:
|参数名称| 参数含义|数据类型| 是否必有| 参数备注|
|-|-|-|-|-|
|kprq|开票日期|String|是|格式:yyyy-MM-dd HH:mm:ss|
|fphm|发票号码|String|是|20位数电发票号码|
|wjgs|文件格式|String|是|PDF、OFD、XML|
|base64|文件内容(Base64格式)|String|否|下载类型为base64有|
|url|文件内容(url格式)|String|否|下载类型为url有|