OS 80246 - OBRIGAÇÃO FISCAL - SIS/WEB - DOC ELETRONICO - DESENVOLVIMENTO DO WEB SERVICE NOTAS FISCAIS DE SERVIÇO - VINHEDO

Objetivo:

Esta solicitação tem por objetivo validarValidar a correçimplementação dado divergênciaWeb Service de R$ 0,01 no valor do ISS informado nas Notas Fiscais de Serviço (NFS)NFS-e) enviadasda para a Prefeituraprefeitura de SãoVinhedo, Paulo,garantindo através da implementação do novo parâmetro da Unidade Operacional que define se a prefeitura trunca o valor de ISS. O teste deverá confirmar que, com o parâmetro ativado, os cálculos do ISS são truncados corretamente e, quando necessário, ajustados no item de maior valor, conforme previsto.
que:

Situação reportada:

• Usuário reporta

  Os que".serviços do WS estejam corretamente integrados (getToken, getNextInvoice, getActivity, setInvoice, setCancelNfeOnly);

• Os controles de ambiente estejam respeitando a limitação de homologação (sem transmissões indevidas);

• Os retornos esperados sejam corretamente processados, exibidos e armazenados;

• A nova tela de testes execute os serviços e retorne os dados conforme esperado;

• A funcionalidade HABILITA_WEBSERVICE_VINHEDO e a funcionalidade wpTestaWSVinhedo estejam operando corretamente;

• Os relatórios e arquivos XML sejam gerados corretamente para cada situação testada.

Premissas:

• Necessário o ambiente estar atualizado com as versões:
  • CorporativoDoc. Eletrônico de número 116748XXXX Genexus 17 ou superior;
    
  • Faturamento de número 116758 Genexus 17 ou superior;
  • Script de número 116854 SQL e 116855 PostGreSQL;
  • Cliente utiliza a funcionalidade UTILIZA_SERVICO.

  • ASE e Pedido de Serviço já gerados e aprovados.
    

• Regras do Parâmetro "Prefeitura trunca valor de ISS?"

  • Parâmetro definido como "NÃO":
    O sistema segue o fluxo atual, realizando o arredondamento dos valores de ISS para cada item.

  • Parâmetro definido como "SIM":

    • PASSO 1: Todos os itens terão o valor de ISS calculado e truncado na segunda casa decimal (sem arredondamento).

    • PASSO 2: Quando os itens possuem a mesma alíquota, o sistema verifica a diferença entre:

      • a soma dos valores truncados item a item

      • e o valor truncado do total das bases multiplicado pela alíquota
        Essa diferença, se houver, é ajustada no item de maior valor.

    • Quando os itens possuem alíquotas diferentes, o sistema não aplica o PASSO 2, mantendo os valores truncados individualmente.

Teste realizado após a atualização

Cenário 01:1: EmissãParâmetros iniciais e configuração de Nota com parâmetro “Prefeitura trunca valor de ISS?” definido como NÃO

Passos:

1. Acesse o módulo CorporativoDocumento Eletrônico > Configuração Empresa > Parâmetro Unidade;
   

   
   

   
   

   

2. Na guia Faturamento, defina o parâmetro “Prefeitura trunca valorCadastro de ISS?” como NÃOParâmetros;
   

   

3. Gere um Pedido de Serviço com dois itens:

   • Item 01: Base R$ 875.041,30, Alíquota ISS: 5%;

   • ItemClique 02: Base R$ 1.625.076,70, Alíquota ISS: 5%;
     

     

4. Emita a nota no menuem FaturamentoInserir >e Notas Fiscais > Emitir NF de Serviço;
   

   
   

   
   

   

5. Visualize oselecione Espelho da NotaRPS_Vinhedo.
   

   

Resultado Esperado:

• Cálculo do ISS com arredondamento:

  • Item 01: 875.041,30 * 5% = 43.752,0650 → 43.752,07

  • Item 02: 1.625.076,70 * 5% = 81.253,8350 → 81.253,84

• Total de ISS da nota: 125.005,91

• Campo de ISS no espelho da nota deve exibir valor arredondado.

Evidência esperada:

• Captura do espelho da nota com ISS: 125.005,91

• Tela com o parâmetro desativado.
  

  

  
  

---

Cenário 02: Emissão de Nota com parâmetro “Prefeitura trunca valor de ISS?” definido como SIM

Passos:

1. Acesse Corporativo > Configuração Empresa > Parâmetro Unidade;

   1. 
      

      
      

      

2. Na guia Faturamento, defina o parâmetro “Prefeitura trunca valor de ISS?” como SIM;
   
   

3. Utilize o mesmo Pedido de Serviço do cenário anterior;

4. Cancele a nota anterior, retorne o pedido (se necessário);

5. EmitaDefina o ambiente (produção ou homologação) e a nota novamente;versão;

6. VisualizeClique para editar o parâmetro;

7. Insira o EspelhoSchema dapara Notao serviço getToken;

8. Clique em Senha RPS – Vinhedo. e insira a senha fornecida pelo cliente.

Resultado Esperado:

• CálculoO doparâmetro ISSé salvo com truncamento:

  • Item 01: 875.041,30 * 5% = 43.752,0650 → 43.752,06sucesso.

  • ItemA 02:senha 1.625.076,70do *RPS 5%é = 81.253,8350 → 81.253,83armazenada.

  • SomaO truncada: 125.005,89

  • Base total: 2.500.118,00 * 5% = 125.005,90

  • Ajuste no itembotão de maiorsenha valorsó (itemaparece 02): +0,01 → 81.253,84

• Total de ISS na nota: 125.005,90

Evidência esperada:

• Captura do espelho da nota com ISS: 125.005,90

• Tela compara o parâmetrotipo ativado.
  

  RPS_Vinhedo.

---

Cenário 03:2: ConsultaValidação dedo Notaserviço Fiscal emitidagetToken

Passos:

1. Com a FUNDAD ativa, acesse o menu NFS-e > Transmissão Vinhedo;

2. Observe o ambiente informado (Homologação ou Produção);

3. Verifique a exibição da mensagem “Token de acesso WebService válido até...”;

4. Acesse a tela de teste WS Vinhedo;

5. Clique em Zerar Token e, em seguida, Confirmar para gerar novo token.

Resultado Esperado:

• Token é obtido e armazenado no cookie.

• Mensagens de erro são exibidas corretamente se inscrição ou senha estiverem ausentes ou inválidas.

• Nova geração de token respeita o tempo de expiração de 15 minutos.

---

Cenário 3: Validação do serviço getActivity

Passos:

1. Na tela de teste do WS Vinhedo, selecione a opção getActivity;

2. Clique em Confirmar.

Resultado Esperado:

• Grid é preenchido com as atividades retornadas pela prefeitura;

• Cada linha exibe código, descrição e tipo de ISS.

---

Cenário 4: Validação do serviço getNextInvoice

Passos:

1. Na tela de teste do WS Vinhedo, selecione a opção getNextInvoice;

2. Clique em Confirmar.

Resultado Esperado:

• É exibido o número da próxima nota disponível para escrituração.

---

Cenário 5: Transmissão de nota fiscal (Homologação)

Passos:

1. Com a FUNDAD ativa e ambiente configurado para Homologação, acesse o menu Transmissão Vinhedo;

2. Selecione nota(s) fiscal(is) e clique em Gerar XML para Transmissão.

Resultado Esperado:

• Sistema imprime relatório com destaque em vermelho indicando que se trata de homologação;

• Não há envio real da nota;

• Status de transmissão da nota não deve ser alterado;

• Mensagem de homologação aparece no topo da tela.

---

Cenário 6: Transmissão de nota fiscal (Produção)

Pré-requisitos: Ambiente configurado como Produção.

Passos:

1. Acesse o menu FaturamentoTransmissão > Notas Fiscais > ConsultaVinhedo;
   

   

   

2. Localize aSelecione nota emitidaativa noe cenárioclique 2;em Gerar XML para Transmissão;

3. VerifiqueAguarde osrelatório totaisde daprocessamento;

   nota

4. Baixe e osvisualize tributoso porXML item.gerado.

Resultado Esperado:

• TotalNota dedeve ISS:ser 125.005,90marcada como impressa (NfsFlgImp = S);

• ItemRelatório 1exibe comdetalhes ISS:da 43.752,06nota;

• Item 2 com ISS: 81.253,84

Evidência esperada:

---

Considerações Finais

• • O parâmetroCaso de truncamentosucesso: deve afetar apenas a formastatus de cálculo do ISS, sem alterar transmissão comportamentoalterado e número de outrosprotocolo tributos;armazenado;

  • Notas com alíquotas diferentes nos itens não terão rateioCaso de diferença;
    erro: mensagem de erro impressa no relatório em vermelho;

  • XML é baixado automaticamente.

  ---

  Cenário 7: Cancelamento de nota fiscal (Homologação)

  Passos:

  1. Selecione nota cancelada em ambiente de homologação;

  2. Clique em Gerar XML para Cancelamento.

  Resultado Esperado:

  • Status da nota não é alterado;

  • XML de cancelamento é gerado;

  • Relatório contém informações simuladas;

  • Nenhum dado é transmitido à prefeitura.

  ---

  Cenário 8: Cancelamento de nota fiscal (Produção)

  Passos:

  1. Selecione nota válida e ativa para cancelamento;

  2. Clique em Gerar XML para Cancelamento;

  3. Baixe o XML gerado.

  Resultado Esperado:

  • XML gerado contém número da nota, inscrição municipal e motivo de cancelamento;

  • Status da nota alterado para cancelada;

  • Caso de erro: mensagens retornadas no relatório;

  • Se não houver campo de justificativa e o Web Service exigir, erro será retornado.

  ---

  Cenário 9: Transmissão e cancelamento simultâneos

  Passos:

  1. Selecione uma nota para transmissão e outra para cancelamento;

  2. Clique em Gerar XML.

  Resultado Esperado:

  • XML único é gerado para ambos os casos;

  • Relatórios de transmissão e cancelamento são impressos separadamente;

  • Sistema realiza pausa de 1 segundo entre requisições.

  ---

  Cenário 10: Verificação da FUNDAD HABILITA_WEBSERVICE_VINHEDO

  Passos:

  1. Desative a FUNDAD HABILITA_WEBSERVICE_VINHEDO;

  2. Acesse novamente a tela de transmissão.

  Resultado Esperado:

  • Sistema volta a utilizar a versão anterior do modelo de impressão;

  • WS de Vinhedo não é exibido;

  • Transmissão ocorre como antes da OS 80090.

  ---

  Observações Finais e Evidência de Sucesso

  • Os relatórios gerados devem conter número da nota, atividade, alíquota e valor;

  • As mensagens retornadas do WS devem aparecer no layout padronizado com quebras de linha (máx. 130 caracteres);

  • Todos os XMLs gerados (transmissão/cancelamento) devem seguir o layout exigido pela prefeitura;

  • O token deve ser validado em tempo real na tela de testes;

  • Transmissões realizadas em produção são válidas fiscalmente — deve-se garantir ambiente controlado nos testes.

  
  

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