# OS 105700 – MELHORIA – DOC. ELETRÔNICO – NOVO LAYOUT DE NFS-E DE TERESINA #### **Objetivo:** - Disponibilizar a transmissão e o cancelamento de NFS-e do município de Teresina por meio do novo layout, contemplando a versão 1.01, o novo endereço de comunicação e a recuperação dos dados da nota quando ocorrer timeout. #### **Premissas:** - Necessário o ambiente estar atualizado com a versão do módulo **Cadastro** de número **xxx** ou superior; - Necessário o ambiente estar atualizado com a versão do módulo **Documento Eletrônico** de número **xxx** ou superior; - A versão dos parâmetros de envio deve estar configurada como **1.01**; - Os parâmetros correspondentes à versão devem estar importados; - A série utilizada na emissão da NFS-e deve ser totalmente numérica; - O código do serviço deve estar cadastrado com o código completo da Lei Complementar nº 116, incluindo o desdobramento e o código municipal aplicáveis; - A empresa deve possuir certificado digital válido e os dados necessários para emissão em ambiente de homologação.

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

#### **Teste realizado após a atualização** #### **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**. 2. Acesse o menu **Configuração Empresa > Séries**. 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.

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

#### **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**. 3. Localize o campo **Código de Serviço**. 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. #### **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**. 2. Acesse o menu **Configuração > Cadastro de Parâmetros**. 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**. 8. Importe os parâmetros correspondentes à versão selecionada. 9. 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. #### **Cenário 04: validar a rejeição de uma NFS-e com série alfanumérica** **Objetivo:** verificar o retorno apresentado quando a NFS-e utiliza uma série incompatível com o novo layout. **Pré-condição:** possuir uma nota de serviço disponível para transmissão com uma série alfanumérica.

**Resultado Esperado:** a transmissão não é concluída e o sistema apresenta a rejeição devolvida pelo serviço de NFS-e, indicando a incompatibilidade da série.

**Passo a passo:** 1. Acesse o módulo **Documento Eletrônico**. 2. Acesse o menu **NFS-e > Transmissão Teresina**. 3. Localize uma nota emitida com série alfanumérica. 4. Selecione a nota. 5. Execute a transmissão. 6. Confira o retorno apresentado. 7. Verifique se a nota permanece sem autorização.

**Atenção:** a série alfanumérica é utilizada neste cenário exclusivamente para validar a rejeição. Para transmissões válidas, utilize uma série totalmente numérica.

#### **Cenário 05: 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**. 2. Acesse o menu **NFS-e > Transmissão Teresina**. 3. Localize a nota disponível para envio. 4. Selecione a nota. 5. Clique na opção de transmissão. 6. Aguarde o processamento. 7. Confira a mensagem apresentada pelo sistema. 8. Consulte novamente a nota. 9. Verifique se a transmissão foi concluída. 10. Confira a chave de acesso, o protocolo e a situação da NFS-e. 11. Confirme se o XML retornado foi gravado. #### **Cenário 06: recuperar uma NFS-e após timeout na transmissão** **Objetivo:** recuperar a chave de acesso e o XML quando a prefeitura receber a NFS-e, mas o sistema não obtiver o retorno dentro do tempo esperado. **Pré-condição:** possuir uma nota cuja transmissão tenha apresentado timeout e que tenha sido recebida pelo serviço municipal.

**Resultado Esperado:** o sistema recupera a chave da NFS-e e, em uma nova consulta, obtém e grava o XML da nota.

**Passo a passo:** 1. Acesse o módulo **Documento Eletrônico**. 2. Acesse o menu **NFS-e > Transmissão Teresina**. 3. Localize a nota cuja transmissão apresentou timeout. 4. Selecione a nota. 5. Acione a opção de transmissão novamente. 6. Confira se o serviço informa que a nota já existe. 7. Selecione novamente a nota. 8. Clique na opção de consulta de protocolo. 9. Aguarde o sistema consultar a nota pela DPS e gravar a chave da NFS-e. 10. Depois da gravação da chave, execute novamente a consulta. 11. Confira se o sistema utiliza a chave para obter os dados completos da NFS-e. 12. Verifique se o XML de retorno foi gravado.

**Atenção:** este procedimento deve ser utilizado somente quando ocorrer timeout. Na transmissão normal, o XML é retornado e gravado durante o próprio envio.

#### **Cenário 07: 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. Acesse o módulo **Documento Eletrônico**. 2. Acesse o menu **NFS-e > Transmissão Teresina**. 3. Localize a NFS-e autorizada. 4. Selecione a nota. 5. Clique na opção de cancelamento. 6. Informe os dados solicitados. 7. Confirme o envio do evento. 8. Aguarde o processamento. 9. Consulte novamente a nota. 10. Verifique se a situação foi atualizada para cancelada. 11. Confira se as informações do cancelamento foram gravadas. #### **Cenário 08: registrar o protocolo de cancelamento após timeout** **Objetivo:** atualizar a NFS-e quando o cancelamento for recebido pelo município, mas o sistema não obtiver o retorno dentro do tempo esperado. **Pré-condição:** possuir uma NFS-e cujo cancelamento tenha apresentado timeout e cujo evento já tenha sido recebido pelo serviço municipal.

**Resultado Esperado:** o protocolo informado é gravado e a situação da NFS-e é atualizada corretamente.

**Passo a passo:** 1. Acesse o módulo **Documento Eletrônico**. 2. Acesse o menu **NFS-e > Transmissão Teresina**. 3. Localize a nota cujo cancelamento apresentou timeout. 4. Selecione a nota. 5. Acesse a opção de inserção manual do protocolo de cancelamento. 6. Informe o protocolo correspondente ao cancelamento. 7. Confirme a operação. 8. Consulte novamente a nota. 9. Verifique se o protocolo foi gravado. 10. Confira se a situação da NFS-e foi atualizada corretamente.

**Atenção:** a inserção manual do protocolo deve ser utilizada somente quando ocorrer timeout e houver confirmação de que o cancelamento foi recebido pelo serviço municipal.

**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.

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

[![Ficou com alguma dúvida?](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/RrRcDgWKxEDQk3gv-ficou-com-alguma-duvida.png)](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/RrRcDgWKxEDQk3gv-ficou-com-alguma-duvida.png)