rocheleedenis/laravel-notazz

Pacote Laravel para integração com Notazz

v1.0 2021-03-15 00:35 UTC

Requires

• php: >=7.2
• guzzlehttp/guzzle: ^6.2
• illuminate/support: ~5.8.0|^6.0|^7.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^7.5|^8.0

MIT

• Rochele Edenís

• rocheleedenis
• laravel-notazz

README

Laravel Notazz

Pacote para facilitar integração com o sistema de emissão de notas fiscais Notazz.

Instalação

Requerimentos

• Php 7.2
• Laravel 5.8

Instalação via linha de comando:

$ composer require rocheleedenis/laravel-notazz

Modo de usar

Por enquanto só é possível gerar NF-e (Nota Fiscal de Produto). Exemplo de como criar uma com os campos obrigatórios:

$notaFiscal = app(NotaFiscalBuilder::class);
$notaFiscal
    ->nfe()
    ->apiKey('b5b8f576a8075442d75be165b0447ace')
    ->destination()
        ->name('Beatriz Isabelly Mendes')
        ->taxid('01708781390')
        ->taxtype('F')
        ->street('Rua João Soares Lima')
        ->number('S/N')
        ->district('Centro')
        ->city('Águas Belas')
        ->uf('CE')
        ->zipcode('63887-973')
        ->email('[e-mail]')
        ->phone('(88) 2592-2647')
    ->document()
        ->basevalue(70.30)
        ->description('Venda')
    ->products()
        ->add()
            ->cod(123)
            ->name('Escova de dente Cepacol')
            ->qtd(2)
            ->unitaryValue(15.20)
        ->save()
        ->add()
            ->cod(124)
            ->name('Pano de prato para cozinha')
            ->qtd(1)
            ->unitaryValue(55.10)
        ->save();

Os métodos usados após usar os métodos principais document(), destination() e products() levam exatamente o mesmo nome das propriedades descritas na documentação oficial do Notazz, mas removendo o prefixo da entidade a quem pertece. Qualquer propriedade que não esteja presente no exemplo está disponível seguindo essa lógica.

Testes

Por definição o retorno das funções que fazem chamada na API do Notazz retornam sempre mensagens de sucesso, personalizada de acordo com o método chamado, se o ambiente não for 'production'.

Métodos disponíveis

Após instanciar a classe Notazz será possível chamar os seguintes métodos:

$notaFiscal = new \RocheleEdenis\LaravelNotazz\Builders\NotaFiscalBuilder;

// Retorna a soma do valor dos itens da nota fiscal
$notaFiscal->sumItemsValue();

// Retorna o array com a nota ja montada
$notaFiscal->toArray()

Após instanciar a classe Notazz será possível chamar os seguintes métodos:

$notazz = new \RocheleEdenis\LaravelNotazz;

// Envia a requisição para o Notazz para registrar a nova nota
$notaFiscal = new NotaFiscalBuilder;
...
$notazz->register($notaFiscal);

Importante! Como já tivemos muitos problemas com envio de informações para o Notazz com tipos diferentes de dados, todas as propriedades serão convertidas para string antes do envio, não importa o tipo de dados recebido ao montar a nota!

Documentação Oficial

Esta é uma API não oficial. Foi criada com base na documentação disponibilizada pelo Notazz.

Créditos

Este projeto foi baseado no SDK PHP Notazz.

Suporte

Para reportar qualquer bug ou deixar sugestões, por favor, abra uma nova issue no github.

Licença

Distribuido sobre a licença MIT. Copie, cole, modifique, melhore e compartilhe!