E-notas client
Ruby Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin enotas Jan 18, 2017
lib Remove dead code Feb 7, 2017
spec
.gitignore Remove dead code Feb 7, 2017
.rspec
.travis.yml enotas Jan 18, 2017
Gemfile enotas Jan 18, 2017
LICENSE.txt Update the auto generated license Feb 18, 2017
README.md
Rakefile enotas Jan 18, 2017
enotas.gemspec Remove dead code Feb 7, 2017

README.md

eNotas Gateway - Ruby

Wrapper Ruby da API do eNotas Gateway, plataforma de emissâo automática de nota fiscal eletrônica de serviço (NFS-e), Produto (NF-e) e Consumidor (NFC-e).

A documentação completa dos endpoints pode ser encontrada aqui: API eNotas Gateway.

Mais detalhes: enotasgw.com.br

Exemplo em PHP pode ser encontrado aqui. - na biblioteca oficial.

Instalação

Adicione o código abaixo ao Gemfile da sua aplicação:

gem 'enotas'

E execute:

$ bundle

Ou instale manualmente:

$ gem install enotas

Uso básico

  • Instancie o cliente passando sua API key:
client = Enotas::Client.new('sua-api-key-do-e-notas')

Agora já podemos emitir uma nota!

  • Emitindo uma nova nota:
nfe = Enotas::Model::Nfe.new
nfe.tipo = 'NFS-e'
nfe.idExterno = '42'
nfe.cliente = {
  name: 'Nome Cliente',
  email: 'cliente@email.com',
  cpfCnpj: '23857396237'
}
nfe.endereco = {
  uf: 'MG',
  cidade: 'Belo Horizonte',
  logradouro: 'Rua 01',
  numero: '112',
  bairro: 'Savassi',
  cep: '32323111'
}

nfe.nfe_create('id-da-empresa-no-enotas', nfe)

Contribuindo

Para contruibuir de uma forma adequada, siga os passos abaixo:

  • Faça um fork do projeto;
  • Após clonar seu fork, crie um novo branch com a feature que deseja implementar;
  • Envie seu branch para seu repositório remoto;
  • Solicite um PR a partir desse novo branch enviado.

Issues e comentários são sempre bem-vindos no repoistório oficial: https://github.com/enotas/enotas-ruby.

ROADMAP

Quer contribuir e não sabe por onde começar? Veja nosso ROADMAP:

  • Escrever testes;
  • Normalizar campos dos models para o padrão ruby;
  • Cobrir os endpoints referentes ao resource "empresa".

License

Esta gem está disponível através da licença MIT.