zatca qr

Zatca-Qr

Uma implementação dos requisitos, processos e padrões e padrões de investimento eletrônico da Arábia Saudita Zatca no PHP.

Leia a documentação PDFS ou desenvolvedores de sistemas para obter mais detalhes.

Dependências

Se você planeja usar o módulo EGS integrado para gerar teclas e CSR. O módulo EGS no pacote depende da instalação do OpenSSL no sistema em que está sendo executado. Ele está sendo usado para gerar um par de teclas ECDSA usando a curva secp256k1 . Também para gerar e assinar uma CSR.

Todas as outras partes do pacote funcionarão bem sem OpenSSL . (o que significa que ele suporta estruturas reagidas e outras estruturas)

Suportes

Todos os futuros principais necessários para a bordo de um novo EGS. Criar, assinar e relatar uma fatura tributária simplificada é atualmente suportada.

• EGS (sistema de geração de e-in-invoice).
  • Criação/bordo (conformidade e produção X.509 CSIDs).
  • Geração de selos criptográficos.
• Fatura fiscal simplificada.
  • Criação.
  • Assinatura.
  • Verificação de conformidade.
  • Relatórios.

Instalação

1. Baixe o pacote do Github
2. Execute composer update ou composer install para instalar dependências.
3. Execute um servidor local para visualizar os exemplos usando php -S localhost:8000
4. Aberto http: // localhost: 8000/fase-1.php no seu navegador.
5. Abrir http: // localhost: 8000/fase-2.php no seu navegador.
6. Faça o download do aplicativo Zatca QR Reader da Google Play Store. Zatca qr Readerapp
7. Digitalize o código QR gerado no exemplo.

Uso

Veja o exemplo completo na fase-1.php e na 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 ;

Implementação

• Implementação geral (mais detalhes)
  • Regras e negócios da KSA
  • UBL 2.1 Spec
  • ISO EN16931
  • Lista de código un/cefact 1001
  • ISO 3166
  • ISO 4217: 2015
  • Lista de código un/cefact 5305, d.16b
• Padrões de segurança (mais detalhes)
  • Padrões criptográficos nacionais da NCA (NCS - 1: 2020)
  • Política de assinatura digital do NCDC (versão 1.1: 2020)
  • Etsi EN 319 102-1
  • Etsi EN 319 132-1
  • Etsi EN 319 142-1
  • Sintaxe e processamento W3C XML Signature
  • Etsi EN 319 122-1
  • IETF RFC 5035 (2007)
  • RFC 5280
  • ISO 32000-1
  • IETF RFC 5652 (2009)
  • RFP6749
  • NIST SP 56A

Aviso de não afiliação e isenção de isenção

zatca-qr é influenciado pelo zatca-xml-php que não afiliou, associado, autorizado, endossado por ou de qualquer forma oficialmente conectada com Zatca (Zakat, Authority and Alfândega) ou qualquer uma de suas subsidiárias ou afiliados. O site oficial da ZATCA pode ser encontrado em https://zatca.gov.sa.

Contribuição

Todas as contribuições são apreciadas.

Não estou planejando apoiar Tax Invoices (não simplificadas). Se alguém quiser abordar essa parte.