Essa é uma biblioteca, não oficial, para acessar facilmente a API do http://www.nfemail.com.br. Para acessar a api você precisa de uma chave de acesso e para isso entre em contato com suporte que irão disponibilizar para você.
Para acessar a documentação da API do NfeMail acesse: (http://www.nfemail.com.br/Manualapi/)
Quem quiser pode usar composer para facilitar o trabalho e basta executar:
composer require wallacesilva/nfemail-sdk
Baixe ou clone o repositorio completo. Depois adicione(require) o arquivo autoload.php no seu projeto. Faça o download aqui
# informe o caminho para o projeto corretamente, se necessário
require_once(__DIR__.'/nfemail-sdk/autoload.php');
- PHP 5.6+ (sugerido 7.1+)
Para usar é simples basta chamar uma instancia e fazer os request. Veja abaixo exemplos básicos, para mais exemplos veja na pasta de exemplos em examples/.
$cnpj = 'cnpj aqui';
$apikey = 'chave de acesso';
$nfemail = new \NfeMail\NfeMail($cnpj, $apikey);
$clientes = $nfemail->getClientes();
# Retorna lista com 10 clientes
$clientes->all(1, 10)->toArray();
# Retorna o cliente encontrado pelo id
#$clientes->findById(45)->toArray();
# Retorna o cliente encontrado pelo Cpf/Cnpj
#$clientes->findByCpfCnpj(12345678912)->toArray();
Caso tenha dúvidas e queira ver formas de usar essa SDK acesse a pasta examples que contem alguns exemplos de uso.
Caso tenha problemas e/ou dúvidas crie uma nova issue aqui (https://github.com/wallacesilva/nfemail-sdk/issues)
Aqui algumas coisas que precisa ser feito e você pode ajudar com um pull request.
- Criar Provider para usar no Laravel/Lumen Framework;
- Adicionar mais exemplos de consumo da api;
- Criar testes básicos;
- Add projeto no packagist/composer;
O ideal é trabalhar com o padrão SEMVER, muito comum no mundo de software e linux, porém essa é uma versão por enquanto, caso não conheça saiba mais em (http://semver.org/).
A linceça desse projeto é a MIT License, por favor, verifique se isso interfere na politica da sua empresa, antes de usar o projeto.