# 对接必读!!!

# 空字段不返回的兼容

部分接口的返回数据情况,对于 “非必填字段” ,如果实际是空,则不会返回这个字段。请集成方对字段不存在进行合理的字段存在校验,规避由具体编程语言差异,可能导致的空指针异常!!!

  • 举例,如果实际数据是 {"name":"abc","phone":"17xxxx98"} , 则返回 : {"name":"abc","phone":"17xxxx98"}
  • 举例,如果实际数据是 {"name":"","phone":"17xxxx98"} , 则返回 : {"phone":"17xxxx98"}
  • 请严格判定非必填字段的 字段存在 ,字段不存在引起的NPE(空指针)属于编码规范问题,需对接方自行适配解决
  • 目前已知 开票相关接口,在返回字段数值为空的情况下,不会返回这个字段。
  • 已知的 python的dict会产生error级别错误、 php 数组会产生warning级别错误,其他语言需对接方自行判断,建议对可空字段严格做字段存在校验判断。

# 业务方案性缺陷

税务云提供的任何接口,对场景层面,因方案设计缺陷、不符合行业惯例、与税务常识不符导致的业务场景不匹配,不做任何的方案性拖底,如整体方案缺陷造成的对接问题需自行适配业务调整!!!涉税业务专业性较强,请对接同学提前确认具体产品业务层面无缺陷。

# 税种票据行业标准问题

  • 各票据类型部分必填项 代码、号码、开票日期、金额、税额、校验码等具有涉税业务固定意义的必填项目与校验类型,用友税务云均保持与税局制定下发的标准一致,且可能随政策法规与局端标准变化(如国税总局对发票号码代码发生过的长度改制),涉及入账、票夹、ocr、查验等接口如无特殊情况,现阶段暂不详做说明,如有疑问请自行查阅税局相关票据标准,或咨询相关业务人员后,确定系统设计。
Last Updated: 1/7/2022, 10:15:45 AM