viniciusmuniz / nfse-bh-sdk
Biblioteca para geração de NFS-E de Belo Horizonte
Requires
- php: ^7.0
- league/flysystem: ^1.0
- mpdf/mpdf: ^8.0
- nesbot/carbon: ^2.28
- symfony/property-access: ^5.0
- symfony/serializer: ^5.0
Requires (Dev)
- phpunit/phpunit: ^7
- symfony/var-dumper: ^5.0
README
API de emissão, consulta e cancelamento de notas fiscais de serviço via webservice da prefeitura de Belo Horizonte - MG
Pré-requisitos
O que você precisa para instalar o software e como instalá-lo
Mínimo PHP 7.2
Instalando
Efetue download utilizando composer
composer require yaguin/nfse-bh-sdk
Começando
- Siga os passos abaixo para consumir corretamente a biblioteca
1 - Adicione seu certificado digital .PFX no seguinte diretório
storage/certificates/{{56142462000106}}/certificate.pfx
"56142462000106" é o CNPJ da empresa.
2 - Sempre que desejar usar algum ENDPOINT implementado, passe sempre os parâmetros de configuração.
tests/systemSettings
use Exception; use NFse\Config\Boot; use NFse\Helpers\Utils; use NFse\Models\Settings; try { //ambiente $settings = new Settings(); $settings->environment = 'homologacao'; //Emitente $settings->issuer->name = 'LINK SERVICOS DE CERTIFICACAO DIGITAL LTDA'; $settings->issuer->cnpj = 11508222000136; $settings->issuer->imun = 2530360019; $settings->issuer->codMun = 3106200; //certificado digital $settings->certificate->folder = __DIR__ . '/../storage/certificates/' . $settings->issuer->cnpj . '/'; $settings->certificate->certFile = 'certificate.pfx'; $settings->certificate->mixedKey = 'mixedKey.pem'; $settings->certificate->privateKey = 'privateKey.pem'; $settings->certificate->publicKey = 'publicKey.pem'; $settings->certificate->password = '215424958751'; $settings->certificate->noValidate = true; //dev if ($settings->environment == 'homologacao') { Utils::xdebugMode(); } //efetua o boot no lib $system = new Boot($settings); $system->init(); } catch (Exception $e) { throw $e; }
Execução dos testes
Siga os casos de testes dentro da pasta "tests"
Autor
- Yago Fernandes - Linkedin
Contribuintes
- Wander Alves - Linkedin
Licença
Este projeto está licenciado sob a licença MIT - consulte o arquivo [LICENSE.md] (LICENSE.md) para obter detalhes
Agradecimentos
- Krypton Tech pelo apoio ao me conceder tempo e recursos para a implementação desta biblioteca.