API整体流程

API流程认证（登录API）

MyInvois API仅对注册纳税人及其ERP/POS系统提供保护和访问权限。
客户端ID和客户端密钥将由MyInvois系统生成，并可在纳税人的MyInvois个人资料中找到。
纳税人需要在其ERP/POS系统中配置客户端ID和客户端密钥以访问MyInvois API。
配置客户端ID和客户端密钥后，纳税人应通过调用登录API获取用于通过API提交电子发票的访问令牌。

1. 使用提交电子发票API提交电子发票

提交电子发票API支持以XML/JSON格式提交的文档。
纳税人系统负责根据API数据结构将发票数据转换为所需的XML/JSON格式。
根据调用此API所需的输入数据，参考电子发票特定指南。
调用API时，它将根据电子发票特定指南进行验证。验证成功后，API将返回验证后的电子发票、验证日期和时间，以及由MyInvois系统生成的验证链接。

2. 使用通知API接收通知

供应商发行电子发票后，买方可以通过电子邮件或API接收通知。
买方可以通过验证链接检索更多信息。

3. 请求拒绝

买方可以通过API发送拒绝电子发票的请求，在72小时内发送。
发送请求拒绝API后，将向供应商发送通知，通知其拒绝请求。
供应商随后有选择接受拒绝请求并取消电子发票的选项。

4. 取消

在收到买方的拒绝请求后，供应商可以在72小时内通过取消文档API取消电子发票。
如果供应商在72小时内未执行任何取消操作，电子发票仍将保持验证状态。

验证逻辑流程

MyInvois系统执行一系列检查，以确保XML/JSON文件符合电子发票的格式、结构和数据标准。在电子发票文件验证过程中，通常应用三种类型的验证规则：

(a) 语法验证

MyInvois系统进行初始和基本检查，以验证XML/JSON文件的结构。 validate the structure of the XML/JSON file.
此检查确保没有错误，例如缺少标签、不正确的数据类型或无效字符。任何未通过此检查的文件将被视为无效，无法进一步处理。

(b) 架构验证

在通过初始检查后，MyInvois系统进行第二次验证，包括检查XML/JSON文件的数据类型和格式。
此验证包括与数据字典（如电子发票类型、发票货币代码、税种目录等）的参考检查。

(c) 业务规则验证

MyInvois系统根据IRBM的要求进行业务规则验证。
此验证包括对TIN验证、发票详细信息、产品/服务详细信息、付款信息以及按照算术原则计算的总计含税/不含税金额等的检查。

验证成功后，MyInvois系统将返回验证后的电子发票，以及IRBM唯一标识号、验证日期和时间，以及返回供应商的验证链接。

失败情况

API重试机制：

纳税人系统应实施重试机制，以处理MyInvois的服务器错误消息。如果错误持续存在，该机制应在延迟后重试API调用，并按指数递增延迟。

使用MyInvois门户上传：

如果MyInvois API不可用，纳税人可以使用MyInvois门户提交电子发票。该门户允许批量上传合并的电子发票或手动输入发票数据。
通过MyInvois门户提交的验证电子发票将包含IRBM唯一标识号。
当MyInvois API恢复在线状态时，纳税人需要将IRBM唯一标识号输入其ERP系统，并调用获取文档API以将发票状态与MyInvois同步。

在72小时内重新发送电子发票：

纳税人在MyInvois系统再次可用时有72小时的时间重新传输电子发票。

获取系统状态信息：

在系统中断期间，IRBM确保提供支持纳税人的帮助台。纳税人将通过帮助台、微网站和电子邮件定期获得进展更新。

结论

总而言之，MyInvois的API流程为纳税人提供了无缝的过程。它始于通过登录API进行认证，然后使用提交电子发票API提交电子发票。买方收到通知，并可以选择请求拒绝，而供应商则可以取消电子发票。

系统采用验证逻辑流程，包括语法、架构和业务规则的验证。在API失败的情况下，建议使用重试机制，并且纳税人可以使用MyInvois门户作为备选方案。在中断期间提供系统状态更新。API整体流程指南提供了有关过程的全面信息。

免责声明：
此平台上提供的信息仅供一般信息目的。它不构成专业建议，不应依赖于作出决策。Wanconnect Consulting Group T对内容中的任何错误或疏漏以及基于提供的信息采取的任何行动概不负责。我们建议针对具体情况寻求专业建议。Wanconnect Consulting Group 保留修改、更新或删除任何内容的权利，恕不另行通知。

API流程