conectra/sped-da

sped-da contêm as classes para criação dos documentos auxiliares referidos no projeto Sped.

sped-da

Classes para geração dos documentos auxiliares usados pelos padrões Sped, _(*1)

NOTA: Este repositório contêm as classes "LEGADAS", para criação dos PDF's do projeto original NFePHP. Porém essas classes foram ajustadas e alguns recursos estarão ausentes ou pelo menos diferentes das suas contrapartes originais., _(*2)

Serão retiradas das classes todas os recursos considerados como não "pertencentes" ao escopo das mesmas e não serão mais aceitas inclusões de métodos referentes a particuliaridades de qualuqer sistema. Estas classes devem ser e permanecer o tão genéricas quanto possivel., _(*3)

UNDER DEVELOPMENT (NOT FULLY READY)

![Build Status][ico-travis] ![Quality Score][ico-code-quality] ![Latest Version on Packagist][ico-version] , _(*4)

![Forks][ico-forks] [![Chat][ico-gitter]][link-gitter], _(*5)

Orientação

Abaixo seguem as orientações gerais para desenvolvedores que desejarem contribuir para a construção e melhoria dos códigos., _(*6)

Uma novo projeto oriundo do TCPDF está em desenvolvimento por Nicola Azuni. Este novo projeto é uma evolução do TCPDF e está sendo estruturado de acordo com as práticas mais atuais do PHP., _(*7)

Dito isso, estas classes do sped-da, que são legadas do projeto NFePHP, deverão ser refatoradas, assim que esse novo projeto tc-lib-pdf estiver em uma versão usável., _(*8)

Estrutura das classes

Para a geração dos documentos auxiliares devem feitas as seguintes considerações:, _(*9)

• Esta biblioteca deverá ser escrita para PHP7, não será testado ou aceito o seu uso em ambientes com php menor que o 5.6 (por ora, pelo menos durante o seu desenvolvimento) e apartir da sua primeira versão estável somente PHP >= 7.0 será aceitável.
• Este pacote "sped-da" se tornará uma dependência (sugerida) dos demais, e será de competência do desenvolvedor coloca-la como dependência de sua aplicação ou não, usando o composer.
• A renderização das classes principais (Danfe, Dacte, Damdfe, Dacce e o NFCe, este com ressalvas) devem ser feita em PDF ou em HTML.
• Essas classes principais devem extender a classe Da.php que é a construtora básica.
• Os documentos auxiliares podem ser renderizados a partir dos XMLs ou das classes construtoras, estabelecidas em cada pacote. Ou seja, tanto pode ser passada uma classe com os dados do documento como o próprio documento em XML.
• Deve ser permitida e facilitada a criação de um PDF com múltiplos documentos.
• Todas as classes devem observar os principios S.O.L.I.D. e atender aos PSR-2 e PSR-4.
• Todos os métodos devem possuir testes unitários utilizando o phpunit, de forma a evitar a quebra do funcionamento das classes.
• Será montado um esquema que permitirá o "pull request" apenas se os testes unitários não falharem.
• No caso especifico da NFC-e (Nota fiscal do consumidor) existe um outro pacote que poderá vir a ser usado, trata-se do "posprint" devido ao fato desse documento auxiliar normalmente ser impresso em impressoras térmicas POS, que não trabalham adequadamente com PDF e devem receber os dados em sua pópria linguagem (RAW data). Dessa forma o pacote "posprint" poderá tornar-se ser uma das dependências desse pacote.
• Para a conversão dos dados em PDF é necessário o uso de uma biblioteca que seja ativamente mantida, usada por um grande contingênte de programadores e que atenda minimamente os PSR. Uma grande atenção deve ser dedicada a esse ponto pois com a inclusão do PHP7 podem surgir problemas de incompatibilidade com bibliotecas que não sejam mantidas atualizadas.

Contribuindo

Este é um projeto totalmente OpenSource, para usa-lo e modifica-lo você não paga absolutamente nada. Porém para continuarmos a mante-lo é necessário qua alguma contribuição seja feita, seja auxiliando na codificação, na documentação ou na realização de testes e identificação de falhas e BUGs., _(*10)

Este pacote esta listado no Packgist foi desenvolvido para uso do Composer, portanto não será explicitada nenhuma alternativa de instalação., _(*11)

Durante a fase de desenvolvimento e testes este pacote deve ser instalado com:, _(*12)

composer require nfephp-org/sped-da:dev-master

Ou ainda alterando o composer.json do seu aplicativo inserindo:, _(*13)

"require": {
    "nfephp-org/sped-da" : "dev-master"
}

NOTA: Ao utilizar este pacote ainda na fase de desenvolvimento não se esqueça de alterar o composer.json da sua aplicação para aceitar pacotes em desenvolvimento, alterando a propriedade "minimum-stability" de "stable" para "dev"., _(*14)

"minimum-stability": "dev"
  

Os stable realeases estão disponíveis (mas com algumas classes ainda em desenvolvimento), pode ser instalado com:, _(*15)

composer require nfephp-org/sped-da

Ou ainda alterando o composer.json do seu aplicativo inserindo:, _(*16)

"require": {
    "nfephp-org/sped-da" : "^0.1"
}

Forma de uso

DANFE, _(*17)

Log de mudanças e versões

Acompanhe o CHANGELOG para maiores informações sobre as alterações recentes., _(*18)

Testing

Todos os testes são desenvolvidos para operar com o PHPUNIT, _(*19)

Security

Caso você encontre algum problema relativo a segurança, por favor envie um email diretamente aos mantenedores do pacote ao invés de abrir um ISSUE., _(*20)

Credits

Roberto L. Machado (owner and developer), _(*21)

License

Este pacote está diponibilizado sob LGPLv3 ou MIT License (MIT). Leia Arquivo de Licença para maiores informações., _(*22)