**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**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/VS85ahUkYGcGuMr1-image.png) 2. Acesse o menu **Configuração Empresa > Séries**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/URm59j2OiFJHoyk9-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/8NQ9peeAC0JBKztW-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**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/EtzqywnoqFy2i7OK-image.png) 3. Localize o campo **Código de Serviço**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/RVW0OBeYDDRLtJjx-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/R3Dq3RHdR2ZQCwOD-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**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/m0nM0436KUYMX3tX-image.png) 2. Acesse o menu **Configuração > Cadastro de Parâmetros**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/GZOjmLaz908ikQRg-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**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/QYYGTv3o1t9HUGRJ-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/iLT5YrFUYy90ZDAT-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**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/m0nM0436KUYMX3tX-image.png) 2. Acesse o menu **NFS-e > Transmissão Teresina**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/nfay34ajrbn6nMsF-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/LiwSZkc6ErgYLASe-image.png) 7. Confira a mensagem apresentada pelo sistema. 8. Consulte novamente a nota. 9. Verifique se a transmissão foi concluída. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/XitSCqGUL7qicIEo-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/ktGO61ohOr2Tq7Go-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**. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/m0nM0436KUYMX3tX-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/xtmumEf4cDPJHl3t-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. [](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-10/J73TYG0HF11ktk0W-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.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2026-04/RrRcDgWKxEDQk3gv-ficou-com-alguma-duvida.png)**ATENÇÃO:** As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.