# 红字信息表
# 申请红字信息表(购方销方)
# URL
POST
Content-Type:application/json
http://{HOST}:{PORT}/output-tax/api/redinfo-apply/insertWithRedApply
# 请求体说明
| 参数 | 类型 | 是否必填 | 描述 | 说明 | 
|---|---|---|---|---|
| fplx | String | 是 | 发票类型 | 2:增值税电子专用发票; 4:增值税专用发票 | 
| orgCode | String | 是 | 组织编码 | 申请开票的组织编码 | 
| reqMemo | String | 是 | 信息表申请类型 | 购买方申请已抵扣:1100000000;购买方申请未抵扣:1010000000;销售方申请:0000000100 | 
| yfpDm | String | 否 | 发票代码 | 未抵扣代码号码必填 | 
| yfpHm | String | 否 | 发票号码 | 未抵扣代码号码必填 | 
| gmfMc | String | 是 | 购买方名称 | |
| gmfNsrsbh | String | 是 | 购买方纳税人识别号 | |
| xsfMc | String | 是 | 销售方名称 | |
| xsfNsrsbh | String | 是 | 销售方纳税人识别号 | |
| cpyMemo | String | 否 | 红字申请表成品油涉及类型 | 1:涉及销售数量变更,2:涉及销售金额变更 | 
| jdcMemo | String | 否 | 红字申请表机动车涉及类型 | 1:涉及销售退回,开票有误等,将购买方机动车台账中对应合格证退回销售方,2:仅涉及销售折让,不涉及购销双方机动车购销台账调整 | 
| mineralsMemo | String | 否 | 红字申请表矿产品涉及类型 | 1涉及销售数量和金额变更,2仅涉及销售金额变更,不涉及购销方销售数量变动,需谨值操作! | 
| kprq | String | 否 | 开票日期 | 格式为:yyyyMMdd | 
| hjje | BigDecimal | 是 | 合计金额 | |
| hjse | BigDecimal | 是 | 合计税额 | |
| jshj | BigDecimal | 是 | 价税合计 | |
| items | List | 是 | 项目明细 | 申请红字信息表明细项目信息 | 
| xmmc | String | 是 | 带上简码的项目名称 | |
| ysxmmc | String | 否 | 不带简码的项目名称 | |
| xmje | BigDecimal | 是 | 项目金额 | |
| se | BigDecimal | 是 | 项目税额 | |
| xmjshj | BigDecimal | 是 | 项目价税合计 | |
| ggxh | String | 否 | 规格型号 | |
| dw | String | 否 | 单位 | |
| xmdj | BigDecimal | 否 | 项目单价 | |
| xmsl | BigDecimal | 否 | 项目数量 | |
| sl | BigDecimal | 是 | 税率 | |
| urls | List | 否 | 回调的url | |
| reqBillNo | String | 是 | 红字信息申请表流水号 | 唯一确定一次的红字信息申请信息 | 
| spbm | String | 是 | 商品税收分类编码 | 
# 请求体
{
    "items": [
        {
            "dw": "一二三",
            "ggxh": "一二三四五六七八",
            "sl": "0.01",
            "xmmc": "*运输服务*橡皮",
            "ysxmmc": "橡皮",
            "xmdj": "23.0041942911",
            "xmhsdj": "23.234213",
            "xmjshj": "-100",
            "se": "-0.99",
            "xmje": "-99.01",
            "xmsl": "-4.3039977296",
          	"spbm": "3213124314324322"
        }
    ],
    "hjje": "-99.01",
    "jshj": "-100.00",
    "hjse": "-0.99",
    "orgCode": "test333",
    "gmfMc": "用友金融信息技术股份有限公司123",
    "gmfNsrsbh": "111222333456333",
    "xsfMc": "测试333",
    "xsfNsrsbh": "111222333456333",
    "reqMemo" : "1100000000",
    "kprq":"202101",
    "reqBillNo" :"3213121232123",
    "urls":[
        "http://test1111.cn1.utools.club/hello测试新增"
    ]
}
# 返回样例
{
    "code":"0000",
    "datas":null
    "msg":"SUCCESS"
}
# 回调业务成功系统样例
{
    "msg": "上传成功",
    "code": "0000",
    "corpid": "1937501a-b06f-4bf6-87d6-d5b515dacd26",
    "hzxxbbh": "123123321112233222",
    "reqBillNo": "3213121232123"
}
# 回调业务系统失败样例
{
  "code":"9999",
  "msg":"申请失败",
  "reqBillNo":"32131232131"
}
# 查询红字信息表编号
# URL
GET
Content-Type:application/json; charset=UTF-8
http://{HOST}:{PORT}/output-tax/api/redinfo-apply/queryRedInfoApply/{reqBillNo}
# 请求样例
http://192.168.52.80/output-tax/api/redinfo-apply/queryRedInfoApply/1331134384608165888?appid=yonyouEinvoiceTest2018
# 返回结果说明
| 参数 | 类型 | 描述 | 说明 | 
|---|---|---|---|
| code | String | 状态 | |
| msg | String | 信息说明 | |
| statusDm | String | 信息表状态编码 | 1-未上传;2-上传中;3-上传失败;4-上传成功;5-获取中;6-获取失败;7-获取成功 | 
| corpid | String | 租户id | |
| gmfNsrsbh | String | 购买方纳税人识别号 | |
| hjse | BigDecimal | 合计税额 | |
| xsfNsrsbh | String | 销售方纳税人识别号 | |
| fpqqlsh | String | 发票请求流水号 | |
| xsfMc | String | 销售方名称 | |
| zdrq | String | 制单日期 | |
| bmbBbh | String | 编码版本号 | |
| jshj | BigDecimal | 加税合计 | |
| jqbh | String | 机器编号 | |
| ggxh | String | 规格型号 | |
| ysxmmc | String | 原始项目名称 | |
| xmdj | BigDecimal | 项目单价 | |
| xmje | BigDecimal | 项目金额 | |
| xmhsdj | BigDecimal | 项目价税合计 | |
| fphxz | String | 发票行性质 | |
| lslbs | String | 零税率标识 | |
| se | BigDecimal | 税额 | |
| dw | String | 单位 | |
| xmmc | String | 项目名称 | |
| xmsl | BigDecimal | 项目数量 | |
| xmjshj | BigDecimal | 项目价税合计 | |
| sl | BigDecimal | 税率 | |
| resBillNo | String | 红字信息申请表请求流水号 | 业务含义同 hzxxbbh | 
| statusMc | String | 信息表描述 | 参考statusDm | 
# 返回样例
{
    "code": "0000",
    "datas": {
        "statusDm": "7",
        "corpid": "1937501a-b06f-4bf6-87d6-d5b515dacd26",
        "reqMemo": "0000000100",
        "hjje": -11.00,
        "fpqqlsh": "1352442380677607425",
        "xsfMc": "辽宁维森信息技术股份有限公司",
        "zdrq": 1611244800000,
        "kprq": "202006",
        "bmbBbh": "35.0",
        "gmfDzdh": "1123",
        "skr": "",
        "gmfNsrsbh": "91211100279309506B",
        "hjse": 0.00,
        "fplx": "4",
        "gmfMc": "北方华锦化学工业股份有限公司",
        "kpr": "测试开票",
        "reqBillNo": "1352442380677607424",
        "xsfNsrsbh": "111222333456333",
        "fhr": "",
        "statusMc": "获取成功",
        "yfpHm": "77777777",
        "gmfYhzh": "123",
        "yfpDm": "7777777777",
        "jshj": -11.00,
        "items": [
            {
                "ggxh": "一二三四五六七八",
                "ysxmmc": "橡皮",
                "xmdj": 23.2342129976,
                "xmje": -11.00,
                "xmhsdj": 23.2342130000,
                "fphxz": 0,
                "lslbs": "",
                "se": 0.00,
                "dw": "一二三",
                "xmmc": "*运输服务*橡皮",
                "xmsl": -0.4734397503,
                "xmjshj": -11.00,
                "sl": 0.000000
            }
        ],
        "resBillNo": "123123321112233222"
    },
    "msg": "SUCCESS"
}
# 回调服务返回结果
回调服务对回调信息处理后,需要返回处理结果信息。 返回参数约定如下:
| 参数 | 类型 | 描述 | 说明 | 
|---|---|---|---|
| code | String | 处理结果编码 | 0000:表示回调服务处理成功 | 
| msg | String | 处理结果明细信息 | 回调处理的明细信息。如果存在错误,此处为错误信息 |