1. OCR识别及查验

1.1. 接口说明

OCR识别及查验

1.2. 调用方式

请求方式：POST

https://invoice.youepiao.com/input/openApi/ocr

1.3. 请求参数

1.3.1. 参数示例

{
  "uuid": "",
  "picture": ""
}

1.3.2. 参数说明

1.4. 返回结果

1.4.1. 返回示例

{
  "returnStateInfo": {
    "returnCode": "0000",
    "returnMessage": "识别成功"
  },
  "invoice": [
    查验结果集合，具体模型参考详情
  ]
}

1.4.2. 增值税专普电票报文详情

返回示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "SFCY": "",
    "FPDM": "",
    "FPHM": "",
    "GMFMC": "",
    "GMFSBH": "",
    "GMFDZDH": "",
    "GMFYHZH": "",
    "XHFMC": "",
    "XHFSBH": "",
    "XHFDZDH": "",
    "XHFYHZH": "",
    "KPRQ": "",
    "JYM": "",
    "HJJE": "",
    "JSHJ": "",
    "BZ": "",
    "FWM": "",
    "SKR": "",
    "FHR": "",
    "KPR": "",
    "SFYGSYZ": "",
    "XFLX": "",
    "CPYBZ": "",
    "JQBM": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "SFDK": "",
    "SFSG": "",
    "FPZL": "",
    "FPLC": "",
    "FPDJL": "",
    "JZZXX": "",
    "FPBT": "",
    "JZZMC": "",
    "JDDM": "",
    "JDHM": "",
    "QKLBZ": "0",
    "DZBZ": "0",
    "FPMX": [
      {
        "MXXH": "",
        "HWMC": "",
        "GGXH": "",
        "DW": "",
        "SPSL": "",
        "DJ": "",
        "JE": "",
        "SL": "",
        "SE": ""
      }
    ],
    "FJXX": {
      "CWFPDM": "",
      "EWM": ""
    }
  }
}

参数说明

1.4.3. 增值税普通（卷式）发票报文详情

返回示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "KPRQ": "20190313",
    "FPDJL": "",
    "BZ": "",
    "HJJE": "1000.00",
    "GMFDZDH": "",
    "FPHM": "23456701",
    "SFYGSYZ": "1",
    "SFSG": "",
    "XFLX": "用车",
    "FPSZSHI": "",
    "XHFSBH": "911100008011253056",
    "JSHJ": "1000",
    "FPSZSHENG": "北京市",
    "XHFMC": "中国石化销售有限公司北京石油分公司",
    "XHFDZDH": "",
    "SFCY": "1",
    "XHFYHZH": "",
    "FWM": "",
    "JYM": "45335057371438243918",
    "GMFSBH": "91110108MA004CPN95",
    "FPLC": "",
    "FPZL": "",
    "SKR": "张良军",
    "FPMX": [
      {
        "DW": "",
        "SE": "0.00",
        "SPSL": "1.00000000",
        "GGXH": "",
        "SL": "0%",
        "JE": "1000.00",
        "DJ": "1000.00000000",
        "MXXH": "1",
        "HWMC": "*预付卡销售*加油 IC 卡充值款"
      }
    ],
    "JZZXX": "",
    "FPBT": "",
    "JZZMC": "",
    "CPYBZ": "",
    "GMFMC": "",
    "SFDK": "",
    "KPR": "",
    "FPDM": "011001850107",
    "JQBM": "661711762018",
    "FHR": "",
    "GMFYHZH": "",
    "QKLBZ": "0",
    "HJSE": "",
    "FJXX": {
      "CWFPDM": "",
      "EWM": ""
    }
  }
}

参数说明

1.4.4. 通行费发票报文详情

返回示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "SFCY": "",
    "FPDM": "",
    "FPHM": "",
    "GMFMC": "",
    "GMFSBH": "",
    "GMFDZDH": "",
    "GMFYHZH": "",
    "XHFMC": "",
    "XHFSBH": "",
    "XHFDZDH": "",
    "XHFYHZH": "",
    "KPRQ": "",
    "JYM": "",
    "HJJE": "",
    "JSHJ": "",
    "BZ": "",
    "FWM": "",
    "SKR": "",
    "FHR": "",
    "KPR": "",
    "SFYGSYZ": "",
    "XFLX": "",
    "CPYBZ": "",
    "JQBM": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "SFDK": "",
    "SFSG": "",
    "FPLC": "",
    "FPDJL": "",
    "JZZXX": "",
    "FPBT": "",
    "JZZMC": "",
    "FPMX": [
      {
        "MXXH": "",
        "HWMC": "",
        "CPZH": "",
        "CLLX": "",
        "TXRQQ": "",
        "TXRQZ": "",
        "JE": "",
        "SL": "",
        "SE": "",
        "HJSE": "",
        "JDHM": "",
        "QKLBZ": "0"
      }
    ],
    "FJXX": {
      "CWFPDM": "",
      "EWM": ""
    }
  }
}

参数说明

1.4.5. 出租车发票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPDM": "",
    "FPHM": "",
    "KPRQ": "",
    "SCSJ": "",
    "XCSJ": "",
    "LC": "",
    "JSHJ": "",
    "SZD": "",
    "XFLX": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "CPZH": "",
    "JZZMC": ""
  }
}

参数说明

1.4.6. 火车票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "PZHM": "",
    "KPRQ": "",
    "SJ": "",
    "XM": "",
    "CFZD": "",
    "DDZD": "",
    "CC": "",
    "ZWDJ": "",
    "JSHJ": "",
    "XFLX": "",
    "XLH": "",
    "SFZH": ""
  }
}

参数说明

1.4.7. 机打发票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPBT": "",
    "FPDM": "",
    "FPHM": "",
    "KPRQ": "",
    "SJ": "",
    "JYM": "",
    "FPZL": "",
    "JSHJ": "",
    "GMFMC": "",
    "GMFSBH": "",
    "XHFMC": "",
    "XHFSBH": "",
    "XFLX": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "SFYGSYZ": "",
    "JZZMC": ""
  }
}

参数说明

1.4.8. 定额发票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPDM": "",
    "FPHM": "",
    "JSHJ": "",
    "XFLX": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "SFYGSYZ": "",
    "JZZMC": ""
  }
}

参数说明

1.4.9. 过路费报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPBT": "",
    "FPDM": "",
    "FPHM": "",
    "KPRQ": "",
    "SJ": "",
    "RK": "",
    "CK": "",
    "JSHJ": "",
    "XFLX": "",
    "JZZMC": ""
  }
}

参数说明

1.4.10. 客运汽车报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPBT": "",
    "FPDM": "",
    "FPHM": "",
    "KPRQ": "",
    "SJ": "",
    "CFZD": "",
    "DDZD": "",
    "JSHJ": "",
    "XM": "",
    "XFLX": "",
    "JZZMC": ""
  }
}

参数说明

1.4.11. 航空运输电子客票行程单报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "XM": "",
    "SFZH": "",
    "PZHM": "",
    "YZM": "",
    "TKRQ": "",
    "XSDWDH": "",
    "TKDW": "",
    "PJ": "",
    "MHFZJJ": "",
    "RYFJF": "",
    "QTSF": "",
    "ZE": "",
    "BXF": "",
    "FJXC": [
      {
        "CFZD": "上海",
        "DDZD": "北京",
        "HBH": "GS7563",
        "RQ": "2018年02月20日",
        "SJ": "12:34",
        "ZWDJ": "N",
        "CYR": "南航"
      }
    ],
    "XFLX": "",
    "GNGJBQ": ""
  }
}

参数说明

1.4.12. 二手车销售统一发票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPBT": "",
    "FPDM": "",
    "FPHM": "",
    "KPRQ": "",
    "JSHJ": "",
    "GMFMC": "",
    "GMFSBH": "",
    "XHFMC": "",
    "XHFSBH": "",
    "ESCSC": "",
    "ESCNSRSBH": "",
    "CPZH": "",
    "DJZH": "",
    "CLSBH": "",
    "CPXH": "",
    "XFLX": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "JZZMC": ""
  }
}

参数说明

1.4.13. 机动车销售统一发票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "JZZXX": "",
    "FPBT": "",
    "FPDM": "",
    "FPHM": "",
    "JQBM": "",
    "KPRQ": "",
    "HJJE": "",
    "JSHJ": "",
    "GMFMC": "",
    "GMFSBH": "",
    "XHFMC": "",
    "XHFSBH": "",
    "ZGSWJG": "",
    "ZGSWJGDM": "",
    "CLSBH": "",
    "FDJHM": "",
    "CPXH": "",
    "HGZH": "",
    "XFLX": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "JQBH": "",
    "JZZMC": ""
  }
}

参数说明

1.4.14. 国际小票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "DM": "",
    "KPRQ": "",
    "SJ": "",
    "HJJE": "",
    "HJSE": "",
    "ZK": "",
    "XF": "",
    "JSHJ": "",
    "BZ": "",
    "XFLX": ""
  }
}

参数说明

1.4.15. 滴滴出行行程单报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "KPRQ": "",
    "XCKS": "",
    "XCJS": "",
    "XCRSJH": "",
    "JSHJ": "",
    "MX": [
      {
        "CX": "快车",
        "JE": "171.40",
        "LC": "42.6",
        "FPSZSHI": "上海市",
        "CFZD": "东方海外大厦-西北 2 门",
        "DDZD": "红梅小区(昌吉路)",
        "SCSJ": "06-28 02:30 周五"
      }
    ],
    "XFLX": ""
  }
}

参数说明

1.4.16. 完税证明报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "FPHM": "",
    "JSHJ": "",
    "GMFSBH": "",
    "GMFMC": "",
    "KPRQ": ""
  }
}

参数说明

1.4.17. 船票详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "FPDM": "",
    "FPHM": "",
    "KPRQ": "",
    "SJ": "",
    "CFZD": "",
    "DDZD": "",
    "JSHJ": "",
    "XM": "",
    "XFLX": "",
    "FPSZSHENG": "",
    "FPSZSHI": "",
    "BZ": ""
  }
}

参数说明

1.4.18. 可报销其他发票报文详情

参数示例

{
  "FPLXDM": "",
  "XZJD": "",
  "region": [
    0,
    0,
    0,
    0
  ],
  "data": {
    "FPDM": "",
    "JSHJ": "0.50",
    "FPHM": "045732",
    "XFLX": "",
    "FPBT": ""
  }
}

参数说明

1.4.19. 返回代码说明

1.4.20. 备注信息

1. 对识别图片的要求一般要求

   ①票面文字清晰，肉眼要辨清

   ②对比度、亮度要适中

   ③票面平整，无皱褶，无变形

   ④发票边缘要清晰，不要在屏幕外边

   ⑤边缘颜色不要与背景颜色相同

2. 对扫描图像的要求

   扫描时选择分辨率 300dpi，不能低于 150 dpi，分辨率最好不要过高。

3. 对拍摄图像的要求

   ①拍摄时注意光照的影响，尽量避免反光和黑影

   ②拍摄时做好聚焦，以免图像模糊不清

   ③拍摄角度不要过大，±5度以内的小角度，以免造成图片变形

   ④拍摄时请不要选择过高的分辨率拍摄（可以等比压缩处理），一方面造成图片过大，不利于传输，一方面分辨率过高也会影响识别率。拍摄时可以选择 1280*960 分辨率拍摄，低一些的分辨率也可以选择，但是要确保图像文字清晰