Biblioteca não oficial de integração do site Transmitenota em Ruby
Descrição
Essa biblioteca foi desenvolvida para facilitar o envio de NFE através do site https://transmitenota.com.br/
Instalação
- Adicione a biblioteca ao seu Gemfile.
gem "transmitenota"Ou instale:
$ gem install transmitenota
Configuração
Para fazer a autenticação, você precisará configurar as credenciais da api do Transmitenota.
require 'transmitenota'
transmitenota = Transmitenota::Nfe.new
transmitenota.configuration
transmitenota.configuration.ApiKey = "SUA_KEY_AQUI"
transmitenota.configuration.Cnpj = "SEU_CNPJ_AQUI"Criando uma NFE e transmitindo
nota = Transmitenota::Nota.new(transmitenota.configuration.ApiKey, transmitenota.configuration.Cnpj)
dado = Transmitenota::Dado.new
dado.natureza_operacao = "VENDAS"
dado.data_emissao = "18/01/2017"
dado.data_saida_entrada = "18/01/2017"
dado.hora_saida_entrada = "05:35:00"
dado.tipo_operacao = "1"
dado.codigo_cfop = "5405"
dado.forma_pagamento = "0"
dado.finalidade_emissao = "1"
dado.nome_destinatario = "CRISTIANO FRANCISCO"
dado.cnpj_destinatario = "14074178000511"
dado.inscricao_estadual_destinatario = ""
dado.telefone_destinatario = "51984951792"
dado.logradouro_destinatario = "RUA TESTE"
dado.numero_destinatario = "242"
dado.complemento_destinatario = ""
dado.bairro_destinatario = "LEOPOLDINA"
dado.municipio_destinatario = "Porto Alegre"
dado.uf_destinatario = "RS"
dado.pais_destinatario = "Brasil"
dado.cep_destinatario = "91250200"
dado.icms_base_calculo = "0"
dado.icms_valor_total = "0"
dado.icms_base_calculo_st = "0"
dado.icms_valor_total_st = "0"
dado.icms_modalidade_base_calculo = "0"
dado.icms_valor = "0"
dado.valor_frete = "0.0000"
dado.valor_seguro = "0"
dado.valor_total = "12.00"
dado.valor_total_sem_desconto = "12.00"
dado.valor_ipi = "0"
dado.modalidade_frete = "1"
dado.informacoes_adicionais_contribuinte = "REFERENTE AO PEDIDO X"
dado.nome_transportadora = ""
dado.cnpj_transportadora = ""
dado.endereco_transportadora = ""
dado.municipio_transportadora = ""
dado.uf_transportadora = ""
dado.inscricao_estadual_transportadora = ""
item = Transmitenota::Item.new
item.numero_item = "1"
item.codigo_produto = "9999999"
item.descricao = "Perfume Polo Black 1"
item.cfop = "5405"
item.unidade_comercial = "un"
item.quantidade_comercial = "1"
item.valor_unitario_comercial = "12.00"
item.codigo_ncm = "33030010"
item.valor_desconto = ""
item.valor_frete = ""
item.valor_seguro = ""
item.valor_outras_despesas = ""
item.valor_total = "12.00"
item.valor_total_sem_desconto = "12.00"
item.icms_aliquota_calc_credito = ""
item.icms_valor_credito = ""
item.icms_origem_cstb = ""
item.icms_mod_base_calculo = " "
item.icms_base_calculo = ""
item.icms_reducao_base_calculo = ""
item.icms_aliquota = ""
item.icms_valor = ""
item.icms_valor_st = ""
item.icms_valor_bc_st_ret = ""
item.icms_valor_st_ret = ""
item.icms_mod_bc_st = ""
item.icms_mva_st = ""
item.icms_bc_st = ""
item.icms_red_bc_st = ""
item.icms_aliquota_st = ""
item.valor_bc_icms_uf_destino = ""
item.aliquota_icms_uf_destino = ""
item.valor_icms_int_uf_destino = ""
item.aliquota_int_uf_envolvidas = ""
item.valor_icms_int_uf_remetente = ""
item.aliquota_perc_prov_part_icms_int = ""
item.aliquota_icms_fundo_combate_pobreza_uf_dest = ""
item.valor_icms_fundo_combate_pobreza_uf_dest = ""
item.pis_situacao_tributaria = ""
item.aliquota_pis = ""
item.valor_pis = ""
item.base_calculo_pis = ""
item.cofins_situacao_tributaria = ""
item.aliquota_cofins = ""
item.valor_cofins = ""
item.base_calculo_cofins = ""
item.ipi_situacao_tributaria = ""
item.aliquota_ipi = ""
item.valor_ipi = ""
item.base_calculo_ipi = ""
item.cst_ipi = ""
item.ipi_codigo_enquadramento_legal = ""
item.aliquota_iof = ""
item.valor_ii = ""
item.valor_iof = ""
item.base_calculo_ii = ""
item.aliquota_ii = ""
item.valor_despesas_aduaneiras = ""
items = []
items << item.to_hash
dado.Itens << items
item = Transmitenota::Item.new
item.numero_item = "2"
item.codigo_produto = "999"
item.descricao = "Serviço"
item.cfop = "5933"
item.unidade_comercial = "un"
item.quantidade_comercial = "1"
item.valor_unitario_comercial = "6.00"
item.codigo_ncm = "00000000"
item.valor_desconto = ""
item.valor_frete = ""
item.valor_seguro = ""
item.valor_outras_despesas = ""
item.valor_total = "12.00"
item.valor_total_sem_desconto = "12.00"
item.icms_aliquota_calc_credito = ""
item.icms_valor_credito = ""
item.icms_origem_cstb = ""
item.icms_mod_base_calculo = " "
item.icms_base_calculo = ""
item.icms_reducao_base_calculo = ""
item.icms_aliquota = ""
item.icms_valor = ""
item.icms_valor_st = ""
item.icms_valor_bc_st_ret = ""
item.icms_valor_st_ret = ""
item.icms_mod_bc_st = ""
item.icms_mva_st = ""
item.icms_bc_st = ""
item.icms_red_bc_st = ""
item.icms_aliquota_st = ""
item.valor_bc_icms_uf_destino = ""
item.aliquota_icms_uf_destino = ""
item.valor_icms_int_uf_destino = ""
item.aliquota_int_uf_envolvidas = ""
item.valor_icms_int_uf_remetente = ""
item.aliquota_perc_prov_part_icms_int = ""
item.aliquota_icms_fundo_combate_pobreza_uf_dest = ""
item.valor_icms_fundo_combate_pobreza_uf_dest = ""
item.pis_situacao_tributaria = ""
item.aliquota_pis = ""
item.valor_pis = ""
item.base_calculo_pis = ""
item.cofins_situacao_tributaria = ""
item.aliquota_cofins = ""
item.valor_cofins = ""
item.base_calculo_cofins = ""
item.ipi_situacao_tributaria = ""
item.valor_ipi = ""
item.base_calculo_ipi = ""
item.aliquota_ipi = ""
item.cst_ipi = ""
item.ipi_codigo_enquadramento_legal = ""
item.aliquota_iof = ""
item.valor_ii = ""
item.valor_iof = ""
item.base_calculo_ii = ""
item.aliquota_ii = ""
item.valor_despesas_aduaneiras = ""
items = []
items << item.to_hash
dado.Itens << items
nota.Dados = dado.to_hash
searchkey = transmitenota.enviar_nfe(nota.to_hash)Consultando uma NFE transmitida
nota = Transmitenota::Nota.new(transmitenota.configuration.ApiKey, transmitenota.configuration.Cnpj)
dado = Transmitenota::Dado.new
dado.searchkey = searchkey
nota.Dados = dado.to_hash
transmitenota.consultar_nfe(nota.to_hash)Enviando por email uma NFE autilizada
nota = Transmitenota::Nota.new(transmitenota.configuration.ApiKey, transmitenota.configuration.Cnpj)
dado = Transmitenota::Dado.new
dado.de = "pimenta@red4sis.com"
dado.para = "lfptwins@gmail.com"
dado.assunto = "Envio XML e PDF Nota Fiscal Eletrônica de Serviço"
dado.mensagem = "Prezado cliente segue e-mail com XML e PDF da Nota Fiscal solicitada"
dado.searchkey = searchkey
nota.Dados = dado.to_hash
transmitenota.enviar_email_nfe(nota.to_hash)TODO
Falta implementar e testar :
- Testes
- Cancelamento da NFE
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/luispimenta/transmitenota. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
License
The gem is available as open source under the terms of the MIT License.