Logo Instagram

Documento Eletrônico

O módulo Documento Eletrônico tem como objetivo gerenciar a emissão, transmissão e controle de documentos fiscais eletrônicos, como Nota Fiscal Eletrônica (NF-e), Conhecimento de Transporte Eletrônico (CT-e), Manifesto de Documentos Fiscais Eletrônicos (MDF-e) e Nota Fiscal de Serviço Eletrônica (NFS-e). Ele permite a automação do processo de emissão e envio dos documentos, garantindo conformidade com as exigências fiscais.

Com o Módulo Documento Eletrônico, sua empresa automatiza, organiza e garante conformidade na emissão e gestão de documentos fiscais, tornando os processos mais ágeis e seguros. 🚀

OS 105700 – MELHORIA – DOC. ELETRÔNICO – NOVO LAYOUT DE NFS-E DE TERESINA

Objetivo:

Premissas:

Atenção: a utilização de uma série alfanumérica poderá ocasionar rejeição na transmissão da NFS-e.

Cenário 01: cadastrar uma série numérica para emissão da NFS-e

Objetivo: cadastrar uma série compatível com a formação da chave de acesso do novo layout de Teresina.

Pré-condição: possuir acesso ao módulo Cadastro e permissão para alterar as séries da empresa.

Resultado Esperado: a série numérica é cadastrada e fica disponível para utilização na emissão da NFS-e.

Passo a passo:

  1. Acesse o módulo Cadastro.

    image.png


  2. Acesse o menu Configuração Empresa > Séries.

    image.png


  3. Clique na opção para inserir uma nova série.
  4. Selecione o tipo de documento correspondente à nota fiscal de serviço.
  5. Informe uma série composta somente por números.
  6. Preencha os demais campos obrigatórios.
  7. Salve o cadastro.
  8. Confirme se a nova série está disponível para utilização.

    image.png


Atenção: para o novo layout de Teresina, não utilize letras ou outros caracteres na série da NFS-e.

Observação: O sistema complementa a série com o dígito 2 à esquerda até atingir cinco posições no envio. Por exemplo, 01 será transmitida como 22201. Não é necessário cadastrar as cinco posições no campo de série.

Cenário 02: conferir a orientação para o código de serviço

Objetivo: consultar a orientação apresentada para o preenchimento do código de serviço utilizado no novo layout.

Pré-condição: possuir acesso ao cadastro de serviços.

Resultado Esperado: o sistema apresenta uma orientação para o preenchimento do código completo da Lei Complementar nº 116, com o desdobramento e o código municipal aplicáveis.

Passo a passo:

  1. Acesse o módulo Cadastro.
  2. Acesse o menu Produtos e Serviços > Serviços.

    image.png


  3. Localize o campo Código de Serviço.

    image.png


  4. Posicione o cursor sobre o campo ou sobre o recurso de ajuda correspondente.
  5. Confira a orientação apresentada pelo sistema.
  6. Verifique se o serviço está cadastrado com o código necessário para utilização no novo layout.

    image.png


Observação: A alteração no cadastro contempla o texto de orientação do campo. Caso o código já esteja preenchido corretamente, não é necessário alterá-lo.

Cenário 03: configurar os parâmetros do layout 1.01

Objetivo: configurar os parâmetros de envio utilizados na comunicação com o novo serviço de NFS-e de Teresina.

Pré-condição: possuir acesso ao módulo Documento Eletrônico e permissão para alterar os parâmetros de envio.

Resultado Esperado: os parâmetros da versão 1.01 são importados e o endereço de homologação é configurado corretamente.

Passo a passo:

  1. Acesse o módulo Documento Eletrônico.

    image.png


  2. Acesse o menu Configuração > Cadastro de Parâmetros.

    image.png


  3. Localize os parâmetros de NFS-e de Teresina.
  4. Clique no ícone de engrenagem.
  5. Altere a versão para 1.01.
  6. Confirme a alteração.
  7. Clique em Alterar.

    image.png

  8. Importe os parâmetros correspondentes à versão selecionada.
  9. Em ambiente de homologação, confirme se os dados do Web Service foram preenchidos com a URL https://nfse2-the.dsfweb.com.br, o servidor nfse2-the.dsfweb.com.br e a Base URL /notafiscal-ws/nfse/.
  10. Confira os serviços importados.
  11. Verifique se o campo Nome do Recurso permanece vazio nos serviços do novo layout.
  12. Salve a configuração.

    image.png


Atenção: utilize uma série totalmente numérica. Séries alfanuméricas podem causar rejeição na transmissão da NFS-e.

Cenário 04: transmitir uma NFS-e pelo novo layout

Objetivo: transmitir uma NFS-e de Teresina utilizando a versão 1.01.

Pré-condição: possuir uma nota de serviço válida, emitida com série numérica e disponível para transmissão.

Resultado Esperado: a NFS-e é autorizada e o sistema grava a chave de acesso, o protocolo, a situação e o XML retornado.

Passo a passo:

  1. Acesse o módulo Documento Eletrônico.
    image.png
  2. Acesse o menu NFS-e > Transmissão Teresina.
    image.png
  3. Localize a nota disponível para envio.
  4. Selecione a nota.
  5. Clique na opção de transmissão.
  6. Aguarde o processamento.

    image.png


  7. Confira a mensagem apresentada pelo sistema.
  8. Consulte novamente a nota.
  9. Verifique se a transmissão foi concluída.

    image.png

  10. Confira a chave de acesso, o protocolo e a situação da NFS-e.
  11. Confirme se o XML retornado foi gravado.

    image.png


Observação: A emissão da nota pelos processos de contratos ou faturamento permanece com o fluxo habitual. A alteração contempla sua transmissão no novo layout.

Observação — timeout na transmissão: Se ocorrer timeout, a nota pode ter sido recebida pela prefeitura, mesmo sem retorno ao sistema. Consulte o protocolo para recuperar a chave da NFS-e. Depois que a chave for gravada, faça uma nova consulta para obter os dados e o XML da nota. O timeout, por si só, não confirma a autorização; se a consulta não retornar os dados, verifique a situação antes de tentar transmiti-la novamente.

Cenário 05: cancelar uma NFS-e autorizada

Objetivo: cancelar uma NFS-e transmitida pelo novo layout de Teresina.

Pré-condição: possuir uma NFS-e autorizada e disponível para cancelamento.

Resultado Esperado: o cancelamento é processado e a situação da NFS-e é atualizada corretamente no sistema.

Passo a passo:

  1. No módulo de origem, cancele a nota. Para notas geradas no Contratos, acesse o apontamento e utilize Cancela Nota Fiscal.
  2. Acesse o módulo Documento Eletrônico.
    image.png
  3. Acesse o menu NFS-e > Transmissão Teresina e marque Exibir Somente NF's Canceladas.
  4. Selecione a nota e informe o motivo do cancelamento.
  5. Clique em Transmitir.
  6. Aguarde o processamento.

    image.png


  7. Consulte novamente a nota.
  8. Verifique se a situação foi atualizada para cancelada.
  9. Confira se as informações do cancelamento foram gravadas.

    image.png


Observação — timeout no cancelamento: Se ocorrer timeout no envio do cancelamento, confirme se ele foi efetivado pela prefeitura. Caso tenha sido confirmado e o protocolo esteja disponível, utilize a opção de inserção manual do protocolo de cancelamento e confira a situação da nota no sistema. Esse procedimento é necessário somente em caso de timeout. Quando o envio é concluído normalmente, o retorno deve ser gravado pelo sistema.

Importante: as informações apresentadas nesta documentação são orientações para utilização da funcionalidade. Os retornos dos serviços externos podem variar de acordo com a disponibilidade do município.

Ficou com alguma dúvida?

ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.