Download the PHP package sqginfo/sped-mail without Composer
On this page you can find all versions of the php package sqginfo/sped-mail. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sqginfo/sped-mail
More information about sqginfo/sped-mail
Files in sqginfo/sped-mail
Package sped-mail
Short Description API para geração e envio dos emails relacionados com o SPED.
License GPL-3.0+ LGPL-3.0+ MIT
Homepage https://github.com/nfephp-org/sped-mail
Informations about the package sped-mail
sped-mail
O envio de emails é parte integrante das necessidades de quem opera com os serviços SPED.
De acordo com a legislação é obrigatório o envio de emails contendo os xml das NFe e dos CTe aos seus repectivos destinatários.
Alguns destinatários, erroneamente, pedem também que seja enviado o PDF relativo ao Documento Auxiliar (DANFE, DACTE ou DACCE) em anexo a esse email.
Outros requerem que os emails seja enviados a várias caixas postais.
Esta parte da API se destina a prover essa facilidade, caso se deseje.
Como instalar :
Adicione este pacote com o composer, por linha de comando:
Ou adicione ao seu composer.json:
Como usar :
Essa classe pode ser usada de duas formas distintas.
1 - Usando o método estatico:
Onde : $config é um stdClass contendo as configuração de seu SMTP (OBRIGATÓRIO)
$xml é o path ou o conteudo do xml que se deseja enviar (OBRIGATÓRIO)
ou ainda
Idem para o $pdf (OPCIONAL)
ou ainda
$address é um array contendo os endereços de email para quem você deseja enviar a mensagem. Essas listas de email serão verificadas e os endereços que não forem validos serão descartados. Se não for passada uma lista de endereços o sistema irá procurar no XML pelos endereços e esses serão usados, se existirem. (OPCIONAL)
O template usado pode ser substituido pelo de sua escolha, usando o parametro $template (OPCIONAL). Use como referencia os templates padrões para criar o seu veja isso na classe Base.php
Para maiores detalhes veja os exemplos indicados na pasta examples.
NOTA: Em caso de falha será retornado um EXCEPTION
Como enviar para vários destinatários
Pordemos enviar os emails para vários destinatários basicamente de duas maneiras diferentes:
1 - Indicando todos os destinatários no próprio XML do documento
Neste caso podemos fazer uso da tag <obsCont> podem existir dezenas desses campos no xml, essa com certeza é a manira mais inteligente de indicar vários destinários, pois podem ser lidos diretamente do xml.
Veja que o tipo do campo xCampo="email" passa a ser obrigatório para que possamos identificar que este campo indica um email.
2 - Passando os endereços adicionais em um array nesta classe
Essa forma já foi indicada acima na variável $addresses = [ ... ];