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: Acesse o módulo Cadastro . Acesse o menu Configuração Empresa > Séries . Clique na opção para inserir uma nova série. Selecione o tipo de documento correspondente à nota fiscal de serviço. Informe uma série composta somente por números. Preencha os demais campos obrigatórios. Salve o cadastro. 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: Acesse o módulo Cadastro . Acesse o menu Produtos e Serviços > Serviços . Localize o campo Código de Serviço . Posicione o cursor sobre o campo ou sobre o recurso de ajuda correspondente. Confira a orientação apresentada pelo sistema. 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: Acesse o módulo Documento Eletrônico . Acesse o menu Configuração > Cadastro de Parâmetros . Localize os parâmetros de NFS-e de Teresina. Clique no ícone de engrenagem. Altere a versão para 1.01 . Confirme a alteração. Clique em Alterar . Importe os parâmetros correspondentes à versão selecionada. 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/ . Confira os serviços importados. Verifique se o campo Nome do Recurso permanece vazio nos serviços do novo layout. 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: Acesse o módulo Documento Eletrônico . Acesse o menu NFS-e > Transmissão Teresina . Localize uma nota emitida com série alfanumérica. Selecione a nota. Execute a transmissão. Confira o retorno apresentado. 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: Acesse o módulo Documento Eletrônico . Acesse o menu NFS-e > Transmissão Teresina . Localize a nota disponível para envio. Selecione a nota. Clique na opção de transmissão. Aguarde o processamento. Confira a mensagem apresentada pelo sistema. Consulte novamente a nota. Verifique se a transmissão foi concluída. Confira a chave de acesso, o protocolo e a situação da NFS-e. 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: Acesse o módulo Documento Eletrônico . Acesse o menu NFS-e > Transmissão Teresina . Localize a nota cuja transmissão apresentou timeout. Selecione a nota. Acione a opção de transmissão novamente. Confira se o serviço informa que a nota já existe. Selecione novamente a nota. Clique na opção de consulta de protocolo. Aguarde o sistema consultar a nota pela DPS e gravar a chave da NFS-e. Depois da gravação da chave, execute novamente a consulta. Confira se o sistema utiliza a chave para obter os dados completos da NFS-e. 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: Acesse o módulo Documento Eletrônico . Acesse o menu NFS-e > Transmissão Teresina . Localize a NFS-e autorizada. Selecione a nota. Clique na opção de cancelamento. Informe os dados solicitados. Confirme o envio do evento. Aguarde o processamento. Consulte novamente a nota. Verifique se a situação foi atualizada para cancelada. 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: Acesse o módulo Documento Eletrônico . Acesse o menu NFS-e > Transmissão Teresina . Localize a nota cujo cancelamento apresentou timeout. Selecione a nota. Acesse a opção de inserção manual do protocolo de cancelamento. Informe o protocolo correspondente ao cancelamento. Confirme a operação. Consulte novamente a nota. Verifique se o protocolo foi gravado. 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.