PHPackages sqginfo/sped-mail - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. sqginfo/sped-mail ActiveLibrary[Mail & Notifications](/categories/mail) sqginfo/sped-mail ================= API para geração e envio dos emails relacionados com o SPED. v0.1.5(1y ago)0759↓57.1%1GPL-3.0+PHPPHP >= 5.6 Since Oct 12Pushed 1y ago4 watchersCompare [ Source](https://github.com/sqginfo/sped-mail)[ Packagist](https://packagist.org/packages/sqginfo/sped-mail)[ Docs](https://github.com/nfephp-org/sped-mail)[ RSS](/packages/sqginfo-sped-mail/feed)WikiDiscussions master Synced yesterday READMEChangelog (2)Dependencies (7)Versions (7)Used By (0) 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. [![Join the chat at https://gitter.im/nfephp-org/sped-mail](https://camo.githubusercontent.com/b39881a0235df0b0531623d6358a277b4b7bbd00b3a5b03c8da85417abe148d2/68747470733a2f2f6261646765732e6769747465722e696d2f6e66657068702d6f72672f737065642d6d61696c2e737667)](https://gitter.im/nfephp-org/sped-mail?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Build Status](https://camo.githubusercontent.com/c76982ad7be18bc941668466c59169842112a0e2b51311201ae9b696bcc1ace4/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f6e66657068702d6f72672f737065642d6d61696c2f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/nfephp-org/sped-mail)[![Coverage Status](https://camo.githubusercontent.com/f919a0d3d617df3dec0d281c95bb2c70e515b3ceafd703a4832bcedcaf10a11f/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/nfephp-org/sped-mail/code-structure)[![Quality Score](https://camo.githubusercontent.com/f18e74e87057050e53b9c00d5bfdd98a05ebc2695afb4677126d0fa3b178cd21/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/nfephp-org/sped-mail)[![Latest Stable Version](https://camo.githubusercontent.com/7b23f4243f4dba0c237d519b2608dc4757bfa845101b39fb02e8e1ab64af40ef/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f737065642d6d61696c2f762f737461626c652e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/releases)[![Latest Version on Packagist](https://camo.githubusercontent.com/a6850bb31474e38582a11cdee2b14cedf82cbd67fe977649e2336a1cefdf6c26/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-mail)[![License](https://camo.githubusercontent.com/e0273385d246b6a90332d858facac88177613ea018b9a21e402ffad0d613f302/68747470733a2f2f706f7365722e707567782e6f72672f6e66657068702d6f72672f6e66657068702f6c6963656e73652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-mail)[![Total Downloads](https://camo.githubusercontent.com/42cc5bed89a7fc09ed2482f5c73c665559de3ac721c0e1fadafd10268b51a0e3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nfephp-org/sped-mail) [![Issues](https://camo.githubusercontent.com/98a3d01184c5e60c225502da3b81066f29040a5d9ea532423402b12186570e22/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/issues)[![Forks](https://camo.githubusercontent.com/b745d748b74c384838b62068526870ba1882f2185f2c87aad8470e4329308303/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/network)[![Stars](https://camo.githubusercontent.com/efceb341d5f93bdd428bc26855b10b3ab1aacb54e4263c4c745325c8bef5af36/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e66657068702d6f72672f737065642d6d61696c2e7376673f7374796c653d666c61742d737175617265)](https://github.com/nfephp-org/sped-mail/stargazers) Como instalar : =============== [](#como-instalar-) Adicione este pacote com o composer, por linha de comando: ``` composer require nfephp-org/sped-mail ``` Ou adicione ao seu composer.json: ``` { "require": { "nfephp-org/sped-mail": "^0.1" } } ``` Como usar : =========== [](#como-usar-) Essa classe pode ser usada de duas formas distintas. 1 - Usando o método estatico: ----------------------------- [](#1---usando-o-método-estatico) ``` $resp = Mail::sendMail($config, $xml, $pdf, $addresses, $template); ``` Onde : $config é um stdClass contendo as configuração de seu SMTP (OBRIGATÓRIO) ``` $config = new stdClass(); $config->mail->host = 'smtp.test.com.br'; $config->mail->user = 'usuario@test.com.br'; $config->mail->password = 'senha'; $config->mail->secure = 'tls'; $config->mail->port = 587; $config->mail->from = 'usuario@test.com.br'; $config->mail->fantasy = 'Test Ltda'; $config->mail->replyTo = 'vendas@test.com.br'; $config->mail->replyName = 'Vendas'; ``` $xml é o path ou o conteudo do xml que se deseja enviar (OBRIGATÓRIO) ``` $xml = '../nfe.xml'; ``` ou ainda ``` $xml = file_get_contents('../nfe.xml'); ``` Idem para o $pdf (OPCIONAL) ``` $pdf = '../nfe.pdf'; ``` ou ainda ``` $pdf = file_get_contents('../nfe.pdf'); ``` $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) ``` $addresses = ['fulano@client.com.br']; ``` 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 ``` $template = 'Meu HTML {emitente} .... '; ``` Para maiores detalhes veja os exemplos indicados na pasta examples. > #### NOTA: Em caso de falha será retornado um EXCEPTION > > [](#nota-em-caso-de-falha-será-retornado-um-exception) Como enviar para vários destinatários ===================================== [](#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 ---------------------------------------------------------------- [](#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. ``` fulano@yahoo.com.br ``` 2 - Passando os endereços adicionais em um array nesta classe ------------------------------------------------------------- [](#2---passando-os-endereços-adicionais-em-um-array-nesta-classe) Essa forma já foi indicada acima na variável $addresses = \[ ... \]; [Documentação](docs/Mail.md) ============================ [](#documentação) ### Health Score 32 — LowBetter than 69% of packages Maintenance35 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community16 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 93.1% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~589 days Recently: every ~726 days Total 6 Last Release 605d ago PHP version history (2 changes)v0.1.0PHP ~5.6|~7.0 v0.1.4PHP >= 5.6 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/24393221?v=4)[SQG Tecnologia](/maintainers/sqginfo)[@sqginfo](https://github.com/sqginfo) --- Top Contributors [![robmachado](https://avatars.githubusercontent.com/u/1437008?v=4)](https://github.com/robmachado "robmachado (81 commits)")[![LuizCastro](https://avatars.githubusercontent.com/u/7267210?v=4)](https://github.com/LuizCastro "LuizCastro (2 commits)")[![amandita3581](https://avatars.githubusercontent.com/u/55669500?v=4)](https://github.com/amandita3581 "amandita3581 (1 commits)")[![AriosvaldoJunior](https://avatars.githubusercontent.com/u/15378884?v=4)](https://github.com/AriosvaldoJunior "AriosvaldoJunior (1 commits)")[![gitter-badger](https://avatars.githubusercontent.com/u/8518239?v=4)](https://github.com/gitter-badger "gitter-badger (1 commits)")[![Victor2752](https://avatars.githubusercontent.com/u/65194770?v=4)](https://github.com/Victor2752 "Victor2752 (1 commits)") --- Tags nfsenfephpsped ### Code Quality TestsPHPUnit Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/sqginfo-sped-mail/health.svg) ``` [![Health](https://phpackages.com/badges/sqginfo-sped-mail/health.svg)](https://phpackages.com/packages/sqginfo-sped-mail) ``` ### Alternatives [matomo/matomo Matomo is the leading Free/Libre open analytics platform 21.7k38.9k](/packages/matomo-matomo)[nfephp-org/sped-mail API para geração e envio dos emails relacionados com o SPED. 1126.9k](/packages/nfephp-org-sped-mail)[terminal42/notification_center Notification Center extension for Contao Open Source CMS 80413.7k101](/packages/terminal42-notification-center)[lucas-simoes/php-nfse API para geração e comunicação da NFSe com as Prefeituras. Este é um fork do projeto nfephp-org/sped-nfse que foi descontinuado 882.3k](/packages/lucas-simoes-php-nfse)[nfephp-org/sped-nfse-ginfes API para geração e comunicação de RPS e NFSe no padão Ginfes. 445.9k](/packages/nfephp-org-sped-nfse-ginfes) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)