开发指南

接入方式

发票云API采用RESTfull的设计方式，客户端通过HTTP协议的GET、POST(目前主要是这两种)方法请求进行调用。

Restful：参考资料
http://www.infoq.com/cn/articles/designing-restful-http-apps-roth

API的调用地址基本上遵循如下约定的方式： API地址前缀 + 服务 + 资源 + 参数

测试环境: https://api-sit.piaozone.com
正式环境: https://api.piaozone.com

这些环境已经配置在本接口平台的环境变量，便于直接测试。
单机版组件开票产品为了兼容历史客户，环境地址有所不同，详情请参考该产品的开发指南

对接过程中需要：

发票云授权标识（client_id）

授权密钥（client_secret）

client_id和client_secret用于授权认证：获取AccessToken
每个环境的授权不同，获取方式可以找实施人员协助提供。如果是金蝶机构的同事，也可以直接通过智能审批获取，审批流名称如下：

若无特别说明，接口返回如下：

返回码	描述	原因
0000	操作成功
1000	Not Found
1001	系统错误
2001	参数错误	输入无效或错误参数，比如输入不支持的文件
2001	Invalid Parameter: '{detail}"	文件没有后缀
3000	服务器错误	其他服务器内部错误
3001	大模型服务错误	调用大模型错误，description里会有具体原因
3002	服务不可用
3003	网关超时
3004	外部服务错误	调用第三方服务错误，description里会有具体原因
3005	OCR服务错误	OCR服务错误，description里会有具体原因
A0301	访问未授权	client_id 为空
A0301	访问未授权	client_id 【】未找到对应的组织
1999	授权信息对应企业信息已被删除！	企业不存在或者禁用
A0301	国际发票识别已用完或不存在	没有国际发票识别权益，需要购买权益
1999	转换图失败	转换图失败
1999	切图响应为空	切图响应为空
1999	Invalid imageFile parameter, maxsize 8MB	图片大于8M，pdf转换后图片大于8M。