API para comunicação entre o emitente de NFe e os serviços dos SEFAZ estaduais. Inteiramente construído em PHP, roda em qualquer sistema operacional.
PHP Other
Latest commit 85a63d3 Sep 22, 2016 @robmachado robmachado committed on GitHub Merge pull request #870 from Yarkhan/patch-1
Correção do link para o repositório sped-efd
Permalink
Failed to load latest commit information.
certs [UPD] inclusão de outro modelo de Danfce, remossão de caracteres estr… May 30, 2016
config [UPD] Ajustes com a tranferencia das classes para outros repositórios Jun 26, 2016
exemplos [UPD] Correção em exemplo retirando parametros NVE e CEST do método t… Aug 10, 2016
images Refatoração da Classe Danfce.php seguindo os padrões do Manual DANFE … May 18, 2016
install Caminho para execução criaJsonConfig.php Jul 1, 2016
libs [UPD] Ajuste nos campos NVE e CEST, não criam a TAG se o parâmetro te… Aug 24, 2016
schemes/NFe [UPD] Limpeza na estrutura e deslocamento de projetos para outros rep… Jun 26, 2016
tests [UPD] Limpeza na estrutura e deslocamento de projetos para outros rep… Jun 26, 2016
.coverall.yml [INC] Incluso mais schemas, corrigido tiposBasico_v3.10.xsd Jan 13, 2015
.gitignore Correções a adequações para emissão de NFC-e de acordo com Manual de … May 14, 2016
.scrutinizer.yml [UPD] Ajustes no composer, travis e scrutinizer Feb 26, 2016
.travis.yml [UPD] Ajustes no composer, travis e scrutinizer Feb 26, 2016
COPYING [INC] Incluso mais schemas, corrigido tiposBasico_v3.10.xsd Jan 13, 2015
README.md Correção do link para o repositório sped-efd Sep 5, 2016
VERSION Ajustes Oct 24, 2015
bootstrap.php [INC] Incluso mais schemas, corrigido tiposBasico_v3.10.xsd Jan 13, 2015
composer.json [UPD] Ajustes com a tranferencia das classes para outros repositórios Jun 26, 2016
phpunit.xml.dist [UPD] scruninizer.yml May 28, 2015

README.md

NFePHP

Build Status Scrutinizer Code Quality Code Coverage License Latest Stable Version Latest Unstable Version Total Downloads

NFePHP é uma API para gerenciamento das comunicações entre o emitente de NFe e os serviços dos SEFAZ estaduais. Inteiramente construído em PHP para rodar sob qualquer sistema operacional. Para começar veja nossas páginas Wiki.

Não deixe de se cadastrar no grupo de discussão do NFePHP!

PULL REQUESTS

Srs. neste repositório somente serão aceitos "PULL REQUESTS" relativos a BUGS e correções derivadas de mudanças promovidas pelas SEFAZ.

Não mais serão aceitas alterações, melhorias no código ou inclusões de novos recursos ou de novos serviços, todas essas melhorias deverão ser encaminhadas para o novo repositório SPED-XXX.

Em breve (até meados de 2017), este repositório deixará de receber qualquer contribuição e será descontinuado, em favor dos novos repositórios !!! Para manter a integridade da API nessa nova versão (4.1.x-dev), estão sendo mantidos os "namespaces", as chamadas de métodos e seus parametros, que não deverão ser alterados a não ser por motivo de "força maior", como mudanças da SEFAZ que forcem essa situação. No uso da nova versão, atenção deve ser dedicada a nomenclatura de classes, que foi simplificada, e nos recursos como impressão que foram deslocados para outro repositório.

REESTRUTURAÇÃO DE REPOSITÓRIOS

As estruturas de CTe, MDFe e outras foram removidas deste repositório e levadas a seus novos repositórios veja:

SPED CTe Novo repositório das classes de CTe

SPED MDFe Novo repositório das classes de MDFe

Todas as contribuições em código devem ser direcionadas para esses novos repositórios pois não mais existirão no repositorio do nfephp original.

Os demais componentes também terão repositórios novos, mas por ora ainda permanecem neste.

SPED COMMON Novo repositório das classes comuns usadas por todos ou vários projetos.

SPED NFe Novo repositório da classes de NFe

SPED DA Novo repositório das classes que geram a impressão dos documentos.

Além desses outros repositórios estão em construção ou já dispõem de bibliotecas

SPED eFINANCEIRA Repositório da classes de eFinanceira (versão estável)

SPED EFD Repositório da classes de Sped EFD fiscal (disponível)

SPED GNRE Repositório da classes de GNRE (versão estável)

SPED RESTFUL Aplicativo RestFul para geração de documentos Sped (em desenvolvimento)

SPED CONSOLE Conjunto de recursos em linha de comando (desenvolvimento)

SPED DOCS Conjunto da documentação dos pacotes NFePHP (parcial)

SPED EMISSOR Aplicativo "front-end" para emissão de documentos (desenvolvimento)

SPED eSOCIAL Repositório das classes para eSocial (desenvolvimento)

SPED SERIALIZER Repositorio de classes para serialização de XML (conceito)

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.

Mas também, caso você ache que qualquer informação obtida aqui, lhe foi útil e que isso vale de algum dinheiro e está disposto a doar algo, sinta-se livre para enviar qualquer quantia através de :

Doar com Paypal

IMPORTANTE:

A partir desta versão o numero das versões seguirá uma sequencia própria da API e não mais irá se referir as versões de layout da NFe, CTe, etc.

Nesta versão (4.0.x) apenas a NFe é funcional, para CTe, e MDFe deve ser usado a TAG 3.10-Obsoleta, pelo menos até que outros colaboradores se disponham a auxiliar na refatoração

Versão de Desenvolvimento

Versão 4.0.x-dev (observa a versão de layout 3.10 da SEFAZ)

Versão Estável

Devido as constantes alterações, dos schemas, webservices e legislações, promovidas pelo Congresso Nacional, pelas SEFAZ estaduais e pelos provedores dos webservices, a versão em MASTER e a última TAG são as mais estáveis e funcionais.

Instalação com Composer

Pelo terminal vá até a raiz de seu projeto e lá execute :

composer require nfephp-org/nfephp

Isso fará com que o SEU arquivo composer.json seja acrescido da dependência da API. A API será baixada e colocada na pasta "vendor" e o arquivo autoload.php sejá atualizado.

Condicionantes

Para usar essa API é necessário conhecimento em programação PHP, bem como conhecer os padrões atuais da linguagem e ter bases de legislação fiscal. É extremanente recomendável que seja estudado o conteúdo dos seguintes sites.

NOTA: A NFSe Nota Fiscal de Serviços Eletrônica, não tem padrão único, e a API tem somente alguns exemplos de montagem de um sistema para esse fim, mas nenhuma API realmente funcional para esse tipo de documentos fiscais.

Objetivo

A API permite que um programa emissor de NFe se comunique com a SEFAZ. A API não foi criada para ela própria emitir a NFe tendo em vista a enorme quantidade de informações necessárias e as características e especificidades de cada emitente.

Dependências

Instalação

Para mais detalhes sobre a instalação, veja https://github.com/nfephp-org/nfephp/wiki/Instalação.

Quick start

Clone o repositório com git clone --branch=develop https://github.com/nfephp-org/nfephp.git ou baixe a última versão estável.

$ composer install
$ ./vendor/bin/phpunit

Versionamento

Para fins de transparência e discernimento sobre nosso ciclo de lançamento, e procurando manter compatibilidade com versões anteriores, o número de versão da NFePHP será mantida, tanto quanto possível, respeitando o padrão abaixo.

As liberações serão numeradas com o seguinte formato:

<major>.<minor>.<patch>

E serão construídas com as seguintes orientações:

  • Quebra de compatibilidade com versões anteriores, avança o <major>.
  • Adição de novas funcionalidades sem quebrar compatibilidade com versões anteriores, avança o <minor>.
  • Correção de bugs e outras alterações, avança <patch>.

Para mais informações, por favor visite http://semver.org/.

Desenvolvimento

Para todo o desenvolvimento, correções de bugs, inclusões e testes deverá ser usada branch develop. Na branch masterestarão os códigos considerados como estáveis. Novas branches poderão surgir em função das necessidades que se apresentarem, seja para manter versionamentos anteriores seja para estabelecer correções de bugs. Mas apenas essas duas branches estabelecidas é que serão permanentente mantidas.

Bug tracker

Encontrou um bug? Informe-nos aqui no GitHub!

https://github.com/nfephp-org/nfephp/issues

Mantenedores (em revisão)

  • NFe - Roberto L. Machado
  • NFCe - Roberto L. Machado
  • NFSe - não definido
  • CTe - não definido
  • MDFe - não definido
  • CLe - não definido

Pull Request

Para que seu Pull Request seja aceito ele deve estar seguindo os padrões descritos neste documento http://www.walkeralencar.com/PHPCodeStandards.pdf