Pular para o conteúdo principal

Web services da Nota Fiscal Eletrônica

Realize a integração do software de gestão com o e-Nota, consulte o manual e veja quais serviços estão disponíveis e o formato de dados esperado. Clique no conteúdo desejado e confira:

Web services da Nota Fiscal Eletrônica

Layout da Betha sistema

  • Versão 1.0

- Download do manual de integração

- Download do schema do XML

Envio de notas para o ambiente de homologação
O sistema e-Nota (Cloud) disponibiliza um ambiente de homologação que permite a você, contribuinte, realizar os testes de emissão de nota fiscal.

Por meio do ambiente de homologação, é possível testar emissões de nota fiscal via tela do sistema, como também realizar testes de conversão de RPS em nota fiscal eletrônica, utilizando os Web Services disponibilizados pelo sistema.

No ambiente de homologação, todos os testes realizados terão como base as informações cadastrais do contribuinte que estão registradas no ambiente oficial do Município, assim como, serão aplicadas todas as regras e configurações do sistema contidas também no ambiente oficial.

Para poder ativar e utilizar o ambiente de homologação, o contribuinte precisa realizar alguns procedimentos, que se inicia com o acesso ao sistema, e em seguida, com a ativação do ambiente de homologação.

Acessando o sistema:

O contribuinte precisa cadastrar uma Solicitação de Acesso ao sistema e-Nota (Cloud), para o Município que deseja emitir suas notas fiscais.

Após a solicitação ter sido registrada, é necessário aguardar que o município faça o Deferimento do seu pedido de acesso.

Fique ligado

FIQUE LIGADO: Em caso de dúvidas sobre como cadastrar a solicitação de acesso, você poderá fazer a leitura do Manual para Solicitar Acesso ao Sistema e-Nota (Cloud).

Após sua solicitação de acesso ter sido Deferida pelo Município, o sistema e-Nota (Cloud) já poderá ser utilizado.

Para isso, acesse o site https://nota-eletronica.betha.cloud, e faça seu acesso como contribuinte, clicando no botão Acessar como contribuinte.

executando

Na tela de login do sistema, informe seus dados de usuário e senha, que foram os mesmos indicados na solicitação de acesso, e clique em Acessar.

executando

Se o seu usuário estiver relacionado a mais de um contribuinte, o sistema vai listar a relação de contribuintes para que você escolha qual deseja acessar, caso contrário, será feito o direcionamento direto para o ambiente oficial do contribuinte com suas respectivas funcionalidades disponíveis.

Ativando o ambiente de homologação:

Já no ambiente oficial do contribuinte, localize na relação de menus disponíveis a sua esquerda, a opção Ambiente de Homologação.

executando

Será disponibilizado a opção para que seja ativado o ambiente, para isso, você deve clicar no botão Ativar Ambiente de Homologação.

executando

O sistema exibirá uma tela contendo uma relação de informações do que acontece ao ativar o ambiente de homologação, e é muito importante que estas informações sejam lidas para uma boa operacionalização nos testes do sistema.

Para efetivar a ativação do ambiente de homologação, clique no botão Sim.

executando

Você perceberá que no ambiente de homologação a relação de menus é reduzida, e a partir desse momento, todas as operações feitas juntamente com seus dados serão armazenadas em um banco de dados de testes.

Em todas as funcionalidades do sistema que você acessar, você estará sendo informado que encontra-se no ambiente de homologação, através dessa mensagem no topo da tela do sistema.

executando

Para emitir notas fiscais no ambiente de homologação, acesse o menu Notas Fiscais e logo depois clique no botão +Nota Fiscal.

Se você possuir alguma dúvida no preenchimento da nota fiscal, consulte a documentação referente a Nota Fiscal de Serviços Eletrônica -- NFS-e.

executando

Para consultar os lotes de RPS que forem enviados via Web Service para o ambiente de homologação, ou ainda, se desejar importar o XML do lote de RPS, acesse o menu RPS e em seguida a guia Eletrônica.

Para importar o XML do lote, clique no botão Importar Lote.

executando

Ativando o ambiente Oficial

Para ativar o ambiente oficial do contribuinte, localize na relação de menus disponíveis a sua esquerda, a opção Ambiente de Homologação.

executando

Será disponibilizado a opção para que seja ativado o ambiente oficial, precisando para isso, clicar no botão Ativar Ambiente Oficial.

O sistema exibirá uma tela contendo explicações sobre a ativação do ambiente oficial, e para efetivar a ativação, clique no botão Sim.

executando

URLs para o ambiente de produção e homologação

Realize a integração do software de gestão com o e-Nota, consulte o manual e veja quais serviços estão disponíveis e o formato de dados esperado.

Serviço para recepção e processamento de Lote de RPS URL: https://nota-eletronica.betha.cloud/rps/ws/recepcionarLoteRps

Serviço para consultar a situação do Lote de RPS

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarSituacaoLoteRps

Serviço para consultar apenas os Lotes de RPS contendo rps SEM a tag condição de pagamento (CondicaoPagamento)

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarLoteRps

Serviço para consultar os Lotes de RPS contendo rps COM ou SEM a tag condição de pagamento (CondicaoPagamento)

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarLoteRpsV110

Serviço para cancelar a nota fiscal

URL: https://nota-eletronica.betha.cloud/rps/ws/cancelarNfse

Serviço para consultar as notas fiscais SEM a tag condição de pagamento (CondicaoPagamento)

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarNfse

Serviço para consultar as notas fiscais COM ou SEM a tag condição de pagamento (CondicaoPagamento)

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarNfseV110

Serviço para consultar pelo número do RPS, as notas fiscais SEM a tag condição de pagamento (CondicaoPagamento)

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarNfsePorRps

Serviço para consultar pelo número do RPS, as notas fiscais COM ou SEM a tag condição de pagamento (CondicaoPagamento)

URL: https://nota-eletronica.betha.cloud/rps/ws/consultarNfsePorRpsV110

Importante

Essas URLs são as mesmas para fazer o envio dos dados no ambiente oficial e no ambiente de homologação do contribuinte. Caso necessite realizar testes no ambiente de homologação, este ambiente deverá estar ativado. Em caso de dúvidas sobre como ativar o ambiente de homologação, você poderá fazer a leitura do Manual para emissão de nota fiscal no ambiente de homologação do sistema e-Nota (Cloud).

- Download dos exemplos de XML

- Download da tabela de erros e alertas

Layout da Abrasf

  • Versão 2.02

- Download do manual de integração

- Download do modelo conceitual

- Download do schema do XML

Envio de notas para o ambiente de homologação
O sistema e-Nota (Cloud) disponibiliza um ambiente de homologação que permite a você, contribuinte, realizar os testes de emissão de nota fiscal.

Por meio do ambiente de homologação, é possível testar emissões de nota fiscal via tela do sistema, como também realizar testes de conversão de RPS em nota fiscal eletrônica, utilizando os Web Services disponibilizados pelo sistema.

No ambiente de homologação, todos os testes realizados terão como base as informações cadastrais do contribuinte que estão registradas no ambiente oficial do Município, assim como, serão aplicadas todas as regras e configurações do sistema contidas também no ambiente oficial.

Para poder ativar e utilizar o ambiente de homologação, o contribuinte precisa realizar alguns procedimentos, que se inicia com o acesso ao sistema, e em seguida, com a ativação do ambiente de homologação.

Acessando o sistema:

O contribuinte precisa cadastrar uma Solicitação de Acesso ao sistema e-Nota (Cloud), para o Município que deseja emitir suas notas fiscais.

Após a solicitação ter sido registrada, é necessário aguardar que o município faça o Deferimento do seu pedido de acesso.

Fique ligado

FIQUE LIGADO: Em caso de dúvidas sobre como cadastrar a solicitação de acesso, você poderá fazer a leitura do Manual para Solicitar Acesso ao Sistema e-Nota (Cloud).

Após sua solicitação de acesso ter sido Deferida pelo Município, o sistema e-Nota (Cloud) já poderá ser utilizado.

Para isso, acesse o site https://nota-eletronica.betha.cloud, e faça seu acesso como contribuinte, clicando no botão Acessar como contribuinte.

executando

Na tela de login do sistema, informe seus dados de usuário e senha, que foram os mesmos indicados na solicitação de acesso, e clique em Acessar.

executando

Se o seu usuário estiver relacionado a mais de um contribuinte, o sistema vai listar a relação de contribuintes para que você escolha qual deseja acessar, caso contrário, será feito o direcionamento direto para o ambiente oficial do contribuinte com suas respectivas funcionalidades disponíveis.

Ativando o ambiente de homologação:

Já no ambiente oficial do contribuinte, localize na relação de menus disponíveis a sua esquerda, a opção Ambiente de Homologação.

executando

Será disponibilizado a opção para que seja ativado o ambiente, para isso, você deve clicar no botão Ativar Ambiente de Homologação.

executando

O sistema exibirá uma tela contendo uma relação de informações do que acontece ao ativar o ambiente de homologação, e é muito importante que estas informações sejam lidas para uma boa operacionalização nos testes do sistema.

Para efetivar a ativação do ambiente de homologação, clique no botão Sim.

executando

Você perceberá que no ambiente de homologação a relação de menus é reduzida, e a partir desse momento, todas as operações feitas juntamente com seus dados serão armazenadas em um banco de dados de testes.

Em todas as funcionalidades do sistema que você acessar, você estará sendo informado que encontra-se no ambiente de homologação, através dessa mensagem no topo da tela do sistema.

executando

Para emitir notas fiscais no ambiente de homologação, acesse o menu Notas Fiscais e logo depois clique no botão +Nota Fiscal.

Se você possuir alguma dúvida no preenchimento da nota fiscal, consulte a documentação referente a Nota Fiscal de Serviços Eletrônica -- NFS-e.

executando

Para consultar os lotes de RPS que forem enviados via Web Service para o ambiente de homologação, ou ainda, se desejar importar o XML do lote de RPS, acesse o menu RPS e em seguida a guia Eletrônica.

Para importar o XML do lote, clique no botão Importar Lote.

executando

Ativando o ambiente Oficial

Para ativar o ambiente oficial do contribuinte, localize na relação de menus disponíveis a sua esquerda, a opção Ambiente de Homologação.

executando

Será disponibilizado a opção para que seja ativado o ambiente oficial, precisando para isso, clicar no botão Ativar Ambiente Oficial.

O sistema exibirá uma tela contendo explicações sobre a ativação do ambiente oficial, e para efetivar a ativação, clique no botão Sim.

executando

URLs para o ambiente de produção e homologação

Realize a integração do software de gestão com o e-Nota, consulte o manual e veja quais serviços estão disponíveis e o formato de dados esperado.

URL: https://nota-eletronica.betha.cloud/rps/ws

Para o layout da Abrasf existe apenas uma URL disponível, e o que diferencia qual serviço está sendo executado, é a tag do serviço indicada no XML. Os serviços disponíveis são:

  • EnviarLoteRpsEnvio
  • EnviarLoteRpsSincronoEnvio
  • GerarNfseEnvio
  • CancelarNfseEnvio
  • SubstituirNfseEnvio
  • ConsultarNfseServicoTomadoEnvio
  • ConsultarNfseServicoPrestadoEnvio
  • ConsultarNfseRpsEnvio
  • ConsultarNfseFaixaEnvio
  • ConsultarLoteRpsEnvio
Importante

Essas URLs são as mesmas para fazer o envio dos dados no ambiente oficial e no ambiente de homologação do contribuinte. Caso necessite realizar testes no ambiente de homologação, este ambiente deverá estar ativado. Em caso de dúvidas sobre como ativar o ambiente de homologação, você poderá fazer a leitura do Manual para emissão de nota fiscal no ambiente de homologação do sistema e-Nota (Cloud).

- Download dos exemplos de XML

- Download da tabela de erros e alertas

Comparativo dos layout Betha e Abrasf

Download do comparativo entre os layouts Betha 1.0 e Abrasf

Aplicativos auxiliares para integração

- Download do emissor e assinador de XML