Pacote para facilitar integração com o sistema de emissão de notas fiscais Notazz.
Instalação via linha de comando:
$ composer require rocheleedenis/laravel-notazz
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('[email protected]')
->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.
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'.
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!
Esta é uma API não oficial. Foi criada com base na documentação disponibilizada pelo Notazz.
Este projeto foi baseado no SDK PHP Notazz.
Para reportar qualquer bug ou deixar sugestões, por favor, abra uma nova issue no github.
Distribuido sobre a licença MIT. Copie, cole, modifique, melhore e compartilhe!