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.