zatca qr

Zatca-qr

Une mise en œuvre des exigences, des processus et des normes de l'e-involution de Zatca de Zatca en PHP.

Lisez la documentation PDFS ou développeurs de systèmes pour plus de détails.

Dépendances

Si vous prévoyez d'utiliser le module EGS intégré pour générer des clés et CSR. Le module EGS dans le package dépend de l'installation d'OpenSSL dans le système sur lequel il fonctionne. Il est utilisé pour générer une paire de clés ECDSA à l'aide de la courbe secp256k1 . également pour générer et signer un RSE.

Toutes les autres parties de l'emballage fonctionneront bien sans OpenSSL . (ce qui signifie qu'il prend en charge les frameworks réactifs et autres)

Soutien

Tous les avenir principal requis pour embarquer un nouvel EGS. Créer, signer et signaler qu'une facture fiscale simplifiée est actuellement prise en charge.

• EGS (E-invoice Generation System).
  • Création / embarquement (conformité et production x.509 csids).
  • Génération de timbres cryptographiques.
• Facture fiscale simplifiée.
  • Création.
  • Signature.
  • Vérification de la conformité.
  • Rapports.

Installation

1. Téléchargez le package à partir de github
2. Exécutez composer update ou composer install pour installer des dépendances.
3. Exécutez un serveur local pour afficher les exemples en utilisant php -S localhost:8000
4. Ouvrez http: // localhost: 8000 / phase-1.php dans votre navigateur.
5. Ouvrez http: // localhost: 8000 / phase-2.php dans votre navigateur.
6. Téléchargez l'application Zatca QR Reader sur Google Play Store. Zatca QR ReaderApp
7. Scannez le code QR généré dans l'exemple.

Usage

Voir l'exemple complet à phase-1.php et phase-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 ;

Mise en œuvre

• Implémentation générale (plus de détails)
  • Règles et affaires KSA
  • UBL 2.1 Spec
  • ISO EN16931
  • Liste de code UN / CEFACT 1001
  • ISO 3166
  • ISO 4217: 2015
  • Liste de code UN / CEFACT 5305, D.16B
• Normes de sécurité (plus de détails)
  • NATURES CRYPTOGRAPHES NATIONALES NCA (NCS - 1: 2020)
  • Politique de signature numérique NCDC (version 1.1: 2020)
  • ETSI EN 319 102-1
  • ETSI EN 319 132-1
  • ETSI EN 319 142-1
  • Syntaxe et traitement de signature XML W3C
  • ETSI EN 319 122-1
  • IETF RFC 5035 (2007)
  • RFC 5280
  • ISO 32000-1
  • IETF RFC 5652 (2009)
  • RFP6749
  • NIST SP 56A

Avis de non-affiliation et de non-responsabilité

zatca-qr est influencé par zatca-xml-php qui n'est pas affilié, associé, autorisé, approuvé par, ou de quelque manière que ce soit officiellement lié à Zatca (Zakat, Tax and Customs Authority), ou dans l'une de ses filiales ou ses sociétés affiliées. Le site officiel de Zatca se trouve sur https://zatca.gov.sa.

Contribution

Toutes les contributions sont appréciées.

Je ne prévois pas de soutenir Tax Invoices (pas simplifiées). Si quelqu'un veut s'attaquer à cette partie.