1. 发票开具

1.1. 接口说明

通过此接口完成发票开具。

1.2. 调用方式

请求方式：POST

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

1.3. 请求参数

1.3.1. 参数示例

{
    "kpzdbs": "1655kpzd2",
    "yfpdm": "",
    "yfphm": "",
    "ykprq": "",
    "chyydm": "",
    "xxbbh": "",
    "xxbid": "",
    "lsh": "12342333",
    "tspz": "00",
    "isAuto": "0",
    "fplxdm": "026",
    "ghdwmc": "成都*********有限公司",
    "ghdwsbh": "9151*********55R",
    "ghdwdz": "购货单位地址",
    "ghdwdh": "购货单位电话",
    "ghdwyh": "购货单位银行",
    "ghdwzh": "购货单位账户",
    "sfzsghdwyhzh": "0",
    "sfzsghdwdzdh": "0",
    "xhdwsbh": "9888*********77R",
    "xhdwmc": "北京*********有限公司",
    "xhdwdz": "销货单位地址",
    "xhdwdh": "销货单位电话",
    "xhdwyh": "销货单位银行",
    "xhdwzh": "销货单位账户",
    "sfzsxhdwyhzh": "0",
    "sfzsxhdwdzdh": "0",
    "skr": "张三",
    "fhr": "李四",
    "kpr": "王五",
    "jshj": 4.12,
    "zkje": 0,
    "bz": "",
    "email": "",
    "ywy": "",
    "phone": "",
    "details": [
        {
            "fphxz": "0",
            "spmc": "软件服务",
            "ggxh": "",
            "dw": "",
            "spsl": 4,
            "dj": 1.03,
            "je": 4.12,
            "sl": 0.03,
            "spbm": "3040201030000000000",
            "yhzcbs": "0",
            "lslbs": "",
            "zzstsgl": "",
            "mxbh": "",
            "spbh": ""
        }
    ],
    "tdywxx": {
        "jzfw": {
            "fsdxxdz": "发生地详细地址",
            "jzfwfsd": "建筑服务发生地",
            "jzxmmc": "建筑项目名称",
            "kdsbz": "跨地市标志",
            "tdzzsxmbh": "土地增值税项目编号",
            "kqysssxbgglbm": "跨区域涉税事项报验管理编号"
        },
        "hwysfw": [
            {
                "ddd": "到达地",
                "qyd": "起运地",
                "ysgjhp": "运输工具号牌",
                "ysgjzl": "运输工具种类",
                "yshwmc": "运输货物名称"
            }
        ],
        "bdcxsfw": {
            "bdcdz": "不动产地址",
            "bdcxxdz": "不动产详细地址",
            "fwcqzshm": "房屋产权证书/不动产权证号码",
            "kdsbz": "跨地市标志",
            "mjdw": "面积单位",
            "wqhtbabh": "不动产单元代码/网签合同备案编码",
            "tdzzsxmbh": "土地增值税项目编号",
            "hdjsjg": "核定计税价格",
            "sjcjhsje": "实际成交含税金额"
        },
        "bdcjyzlfw": {
            "bdcdz": "不动产地址",
            "bdcxxdz": "不动产详细地址",
            "fwcqzshm": "房屋产权证书/不动产权证号码",
            "kdsbz": "跨地市标志",
            "mjdw": "面积单位",
            "zlqq": "租赁期起",
            "zlqz": "租赁期止",
            "cph": "车牌号"
        },
        "lkysfw": [
            {
                "cfd": "出发地",
                "cxr": "出行人",
                "cxrq": "出行日期",
                "cxrzjhm": "出行人证件号码",
                "cxrzjlx": "出行人证件类型",
                "ddd": "到达地",
                "dengj": "等级",
                "jtgjlx": "交通工具类型"
            }
        ]
    }
}

1.3.2. 参数说明

数据长度指的是GBK字符长度，一个中文字符占两个长度，一个英文字符占一个长度。

主要信息

明细说明

特定业务信息

建筑服务

货物运输服务

不动产销售服务

不动产租赁服务

旅客运输服务

1.3.3. 码表信息

优惠政策

[
    {
        "code": "01",
        "name": "简易征收"
    },
    {
        "code": "02",
        "name": "稀土产品"
    },
    {
        "code": "03",
        "name": "免税"
    },
    {
        "code": "04",
        "name": "不征税"
    },
    {
        "code": "05",
        "name": "先征后退"
    },
    {
        "code": "06",
        "name": "100%先征后退"
    },
    {
        "code": "07",
        "name": "50%先征后退"
    },
    {
        "code": "08",
        "name": "按3%简易征收"
    },
    {
        "code": "09",
        "name": "按5%简易征收"
    },
    {
        "code": "10",
        "name": "按5%简易征收减按1.5%计征"
    },
    {
        "code": "11",
        "name": "即征即退30%"
    },
    {
        "code": "12",
        "name": "即征即退50%"
    },
    {
        "code": "13",
        "name": "即征即退70%"
    },
    {
        "code": "14",
        "name": "即征即退100%"
    },
    {
        "code": "15",
        "name": "超税负3%即征即退"
    },
    {
        "code": "16",
        "name": "超税负8%即征即退"
    },
    {
        "code": "17",
        "name": "超税负12%即征即退"
    },
    {
        "code": "18",
        "name": "超税负6%即征即退"
    }
]

证件类型

[
    {
        "code": "101",
        "name": "组织机构代码证"
    },
    {
        "code": "102",
        "name": "营业执照"
    },
    {
        "code": "103",
        "name": "税务登记证"
    },
    {
        "code": "199",
        "name": "其他单位证件"
    },
    {
        "code": "201",
        "name": "居民身份证"
    },
    {
        "code": "202",
        "name": "军官证"
    },
    {
        "code": "203",
        "name": "武警警官证"
    },
    {
        "code": "204",
        "name": "士兵证"
    },
    {
        "code": "205",
        "name": "军队离退休干部证"
    },
    {
        "code": "206",
        "name": "残疾人证"
    },
    {
        "code": "207",
        "name": "残疾军人证（1-8级）"
    },
    {
        "code": "208",
        "name": "外国护照"
    },
    {
        "code": "210",
        "name": "港澳居民来往内地通行证"
    },
    {
        "code": "212",
        "name": "中华人民共和国往来港澳通行证"
    },
    {
        "code": "213",
        "name": "台湾居民来往大陆通行证"
    },
    {
        "code": "214",
        "name": "大陆居民往来台湾通行证"
    },
    {
        "code": "215",
        "name": "外国人居留证"
    },
    {
        "code": "216",
        "name": "外交官证"
    },
    {
        "code": "217",
        "name": "使（领事）馆证"
    },
    {
        "code": "218",
        "name": "海员证"
    },
    {
        "code": "219",
        "name": "香港永久性居民身份证"
    },
    {
        "code": "220",
        "name": "台湾身份证"
    },
    {
        "code": "221",
        "name": "澳门特别行政区永久性居民身份证"
    },
    {
        "code": "222",
        "name": "外国人身份证件"
    },
    {
        "code": "224",
        "name": "就业失业登记证"
    },
    {
        "code": "225",
        "name": "退休证"
    },
    {
        "code": "226",
        "name": "离休证"
    },
    {
        "code": "227",
        "name": "中国护照"
    },
    {
        "code": "228",
        "name": "城镇退役士兵自谋职业证"
    },
    {
        "code": "229",
        "name": "随军家属身份证明"
    },
    {
        "code": "230",
        "name": "中国人民解放军军官转业证书"
    },
    {
        "code": "231",
        "name": "中国人民解放军义务兵退出现役证"
    },
    {
        "code": "232",
        "name": "中国人民解放军士官退出现役证"
    },
    {
        "code": "233",
        "name": "外国人永久居留身份证（外国人永久居留证）"
    },
    {
        "code": "234",
        "name": "就业创业证"
    },
    {
        "code": "235",
        "name": "香港特别行政区护照"
    },
    {
        "code": "236",
        "name": "澳门特别行政区护照"
    },
    {
        "code": "237",
        "name": "中华人民共和国港澳居民居住证"
    },
    {
        "code": "238",
        "name": "中华人民共和国台湾居民居住证"
    },
    {
        "code": "239",
        "name": "《中华人民共和国外国人工作许可证》（A类）"
    },
    {
        "code": "240",
        "name": "《中华人民共和国外国人工作许可证》（B类）"
    },
    {
        "code": "241",
        "name": "《中华人民共和国外国人工作许可证》（C类）"
    },
    {
        "code": "291",
        "name": "医学出生证明"
    },
    {
        "code": "299",
        "name": "其他个人证件"
    }
]

1.4. 返回结果

1.4.1. 返回示例

{
    "status": true,
    "code": 0,
    "msg": "提示信息",
    "timestamp": "2021-06-13T03:06:02.619+00:00",
    "data": [
        {
            "fplxdm": "发票类型代码",
            "fpdm": "发票代码",
            "fphm": "66987825",
            "kprq": "2021-06-11T05:32:10.000+00:00",
            "skm": "税控码",
            "jym": "校验码",
            "pdf": "pdf地址",
            "ofd": "ofd地址",
            "xml": "xml地址",
            "qr": "二维码地址",
            "kplx": "开票类型",
            "zflx": "作废类型",
            "jshj": "价税合计",
            "lsh": "请求流水号（订单编号）"
        }
    ]
}

1.4.2. 返回说明

除税控服务器外其余设备开票都为异步执行，提交开票请求成功后需调用开具结果查询接口查询开票结果，或者以相同流水号再次请求发票开具获取相应结果。