1. 红字信息表申请

1.1. 接口说明

申请专票或数电票红字信息表为异步流程，提交申请红字信息表成功后，调用查询红字信息表接口获取申请结果，若申请成功则可使用红字信息表进行红字发票开具。

1.2. 调用方式

请求方式：POST

https://invoice.youepiao.com/openApi/v4/fp/hzsq

1.3. 请求参数

1.3.1. 参数示例

{
  "lsh": "123123132",
  "fpdm": "",
  "fphm": "",
  "sqly": "",
  "kpzdbs": "",
  "xhdwsbh": "",
  "xhdwmc": "",
  "details": [
    {
      "spmc": "",
      "ggxh": "",
      "dw": "",
      "spsl": 0.0,
      "dj": 0.0,
      "je": 0.0,
      "sl": 0.0,
      "spbm": "",
      "fphxz": "",
      "lslbs": "",
      "yhzcbs": "",
      "zzstsgl": "",
      "xh": 1
    }
  ]
}

1.3.2. 参数说明

主要信息

参数 参数名称 类型 长度 必须 备注
lsh 申请流水号 String 50 是 申请唯一流水号
fpdm 发票代码 String 12 是 数电票可不填
fphm 发票号码 String 20 是
sqly 申请理由 String 1 是 参数为：0、1、2
购方申请：
0：已抵扣
1：（1 对应以下四个理由中 的其中一个） 未抵扣无法认证； 未抵扣税号认证不符； 未抵扣代码号码认证不符； 货物不属于增值税项目范围
销方申请：
2：（2 对应以下两个理由中 的其中一个） 开票有误购买方拒收； 开票有误等原因尚未交付
kpzdbs 开票终端标识 String 30 是 数电票可不填
xhdwsbh 销货单位识别号 String 20 是
xhdwmc 销货单位名称 String 300 是
chyydm 冲红原因代码 String 1 否 数电发票申请时必填
1-销货退回（只允许修改数量，不允许修改单价）
2-开票有误（必须全额冲红，不允许修改明细信息）
3-服务中止（允许修改总金额和数量，不允许修改单价）
4-销售折让（不能修改单价和数量）
details 申请明细 否 无值则表示以原蓝票明细所有信息进行申请，有值参考明细说明

明细说明

参数 参数名称 类型 长度 必须 备注
fphxz 发票行性质 1 是 0-正常行
1-折扣行
0- 被折扣行 折扣行与被折扣行数据需紧邻，且被折扣行数据在折扣行之上，折扣行应与被折扣行名称相同，且不需要填写商品数量与单价
spmc 商品名称 String 92 是 折扣行与被折扣行名称需一致
ggxh 规格型号 String 40 否
dw 单位 String 14 否
spsl 商品数量 10/8 否 整数位不超过10位，小数位不超过8位的负数，明细为折扣行是填null
dj 单价 10/8 否 整数位不超过10位，小数位不超过8位的正数，明细为折扣行是填null
je 金额 10/2 是 整数位不超过10位，小数位保留2位的负数
sl 税率 0/2 是 保留小数点后两位 示例：0.03
spbm 商品编码 String 19 是
yhzcbs 优惠政策标识 String 1 否 0-未使用
1-使用
lslbs 零税率标识 String 1 否 空代表无
1-出口免税和其他免税优惠政策
2-不征增值税
3-普通零税率
zzstsgl 增值税特殊管理 String 50 否 优惠政策标识为1时填写对应优惠政策说明
xh 序号 Int 否 申请数电票红字信息表时候必填，填写原蓝字发票对应明细序号。

1.4. 返回结果

1.4.1. 返回示例

{
    "status": true,
    "code": 0,
    "msg": "成功",
    "timestamp": "2021-06-23T03:22:50.894+00:00",
    "data": {
        "sqdh": "申请单号"
    }
}

1.4.2. 返回说明

参数 参数名称 类型 长度 必须 说明
sqdh 申请单号 String 100 否 税控服务器申请有
托管UKey无
数电票无

results matching ""

    No results matching ""