zatca qr

zatca-qr

沙特阿拉伯Zatca在PHP中的电子供应要求，过程和标准的实施。

阅读文档PDFS或系统开发人员以获取更多详细信息。

依赖性

如果您打算使用内置的EGS模块生成密钥和CSR。软件包中的EGS模块取​​决于正在运行的系统中安装的OpenSSL。它用于使用secp256k1曲线生成ECDSA密钥对。还可以生成和签署CSR。

包装的所有其他部分都可以在没有OpenSSL情况下工作正常。 （这意味着它支持反应和其他框架）

支持

上载新的EGS所需的所有主要期货。目前支持创建，签名和报告简化的税收发票。

• 例如（电子发电系统）。
  • 创建/板载（合规性和生产X.509 CSID）。
  • 加密邮票生成。
• 简化的税收发票。
  • 创建。
  • 签名。
  • 合规性检查。
  • 报告。

安装

1. 从Github下载包裹
2. 运行composer update或composer install以安装依赖项。
3. 运行本地服务器以使用php -S localhost:8000
4. 打开http：// localhost：8000/phase-1.php在您的浏览器中。
5. 打开http：// localhost：8000/phase-2.php在您的浏览器中。
6. 从Google Play商店下载ZATCA QR Reader应用程序。 Zatca QR ReaderApp
7. 扫描示例中生成的QR码。

用法

查看阶段1.php和阶段2.php的完整示例。

 // New Invoice and EGS Unit
$ egs = new  ZATCA  EGS ( $ egsUnit );

$ egs -> production = false ;

// New Keys & CSR for the EGS
list ( $ privateKey , $ csr ) = $ egs -> generateNewKeysAndCSR ( ' solution_name ' );

// Issue a new compliance cert for the EGS
list ( $ requestId , $ binarySecurityToken , $ secret ) = $ egs -> issueComplianceCertificate ( ' 123345 ' , $ csr );

// Sign invoice
list ( $ signedInvoiceString , $ invoiceHash , $ qr ) = $ egs -> signInvoice ( $ invoice , $ egsUnit , $ binarySecurityToken , $ privateKey );

// Check invoice compliance
echo ( $ egs -> checkInvoiceCompliance ( $ signedInvoiceString , $ invoiceHash , $ binarySecurityToken , $ secret ));
echo PHP_EOL ;

执行

• 一般实施（更多详细信息）
  • KSA规则与业务
  • UBL 2.1规格
  • ISO EN16931
  • UN/CEFACT代码列表1001
  • ISO 3166
  • ISO 4217：2015
  • UN/CEFACT代码列表5305，d.16b
• 安全标准（更多详细信息）
  • NCA国家加密标准（NCS -1：2020）
  • NCDC数字签名政策（版本1.1：2020）
  • ETSI EN 319 102-1
  • ETSI EN 319 132-1
  • ETSI EN 319 142-1
  • W3C XML签名语法和处理
  • ETSI EN 319 122-1
  • IETF RFC 5035（2007）
  • RFC 5280
  • ISO 32000-1
  • IETF RFC 5652（2009）
  • RFP6749
  • NIST SP 56A

非陪伴和免责声明的通知

zatca-qr受zatca-xml-php的影响，该ZATCA-XML-PHP与与Zatca（Zakat，tax and Tax and Tax and Tax and Tax Authority）或其任何子公司或其分支机构的任何方式相关，相关，授权，认可或以任何方式。 Zatca官方网站可以在https://zatca.gov.sa上找到。

贡献

所有贡献都将受到赞赏。

我不打算支持Tax Invoices （不是简化的发票）。如果有人想解决这一部分。