zatca qr

Zatca-qr

Una implementación de los requisitos, procesos y estándares de la investigación electrónica de Arabia Saudita Zatca en PHP.

Lea el PDF de documentación o los desarrolladores de sistemas para obtener más detalles.

Dependencias

Si planea usar el módulo EGS incorporado para generar claves y CSR. El módulo EGS en el paquete depende de que OpenSSL esté instalado en el sistema en el que se ejecuta. Se está utilizando para generar un par de claves ECDSA utilizando la curva secp256k1 . también para generar y firmar una CSR.

Todas las demás partes del paquete funcionarán bien sin OpenSSL . (es decir, admite react-nativo y otros marcos)

Soporte

Todos los futuros principales necesarios para incorporar un nuevo EGS. Crear, firmar e informar una factura de impuestos simplificada actualmente es compatible.

• EGS (sistema de generación de invocación electrónica).
  • Creación/incorporación (cumplimiento y producción X.509 CSID).
  • Generación de sellos criptográficos.
• Factura de impuestos simplificada.
  • Creación.
  • Firma.
  • Verificación de cumplimiento.
  • Informes.

Instalación

1. Descargue el paquete de Github
2. Ejecute composer update o composer install para instalar dependencias.
3. Ejecute un servidor local para ver los ejemplos utilizando php -S localhost:8000
4. Abra http: // localhost: 8000/fase-1.php en su navegador.
5. Abra http: // localhost: 8000/fase-2.php en su navegador.
6. Descargue la aplicación Zatca QR Reader de Google Play Store. Zatca QR ReaderApp
7. Escanee el código QR generado en el ejemplo.

Uso

Ver ejemplo completo en la fase-1.php y fase-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 ;

Implementación

• Implementación general (más detalles)
  • Reglas y negocios de KSA
  • Especificaciones UBL 2.1
  • ISO EN16931
  • Lista de códigos UN/Cefact 1001
  • ISO 3166
  • ISO 4217: 2015
  • Lista de códigos UN/Cefact 5305, D.16B
• Normas de seguridad (más detalles)
  • NCA National Cryptográfica estándares (NCS - 1: 2020)
  • Política de firma digital NCDC (Versión 1.1: 2020)
  • ETSI EN 319 102-1
  • ETSI EN 319 132-1
  • ETSI EN 319 142-1
  • W3C XML-Signature Syntax and Processing
  • ETSI EN 319 122-1
  • IETF RFC 5035 (2007)
  • RFC 5280
  • ISO 32000-1
  • IETF RFC 5652 (2009)
  • RFP6749
  • NIST SP 56A

Aviso de no afiliación y descargo de responsabilidad

zatca-qr está influenciado por zatca-xml-php que no está afiliado, asociado, autorizado, respaldado por o de alguna manera oficialmente conectado con Zatca (Zakat, Autoridad de Tax y Aduanas), o cualquiera de sus subsidiarias o sus afiliados. El sitio web oficial de Zatca se puede encontrar en https://zatca.gov.sa.

Contribución

Todas las contribuciones son apreciadas.

No planeo apoyar Tax Invoices (no las simplificadas). Si alguien quiere abordar esa parte.