# 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 Validar a implementação do Web Service de Notas Fiscais de Serviço (NFS-e) da prefeitura de Vinhedo, garantindo que:
- Os 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`ativa, apenas para clientes que possuem cadastro de vinhedo e a funcionalidade `wpWSVinhedo` vinculada ao perfil do usuário;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/cnEUpw6Yizb4qpUf-image.png)
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/jeGNlqejjdJaf324-image.png)
**Premissas:**
- Necessário o ambiente estar atualizado com as versões:
- **Doc. Eletrônico** de número **117553** **Genexus 17** ou superior;
#### **Teste realizado após a atualização**
#### **Cenário 1: Parâmetros iniciais e configuração**
**Passos:**
1. Acesse o módulo **Documento Eletrônico > Configuração > Cadastro de Parâmetros**;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/5isWzaffUrVwvBNm-image.png)
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/Qe7T2Zimu4B1m8bL-image.png)
2. Clique em **Inserir** e selecione **RPS\_Vinhedo**;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/Ing1YsjprkJLx3Iq-image.png)
3. Defina o ambiente (produção ou homologação) e a versão;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/QhW8Wsx75vWf7g9b-image.png)
4. Clique para **editar o parâmetro**;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/Xvq7tQ7U3ZOw3lic-image.png)
5. Insira o **Schema** para o serviço `getToken`;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/2vYLqTzqLtJS5Ulh-image.png)
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/HZg91PGiIg9Rl6HC-image.png)
6. Clique em **Senha RPS – Vinhedo** e insira a senha fornecida pelo cliente.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/eSbfPXwyVKer4R6e-image.png)
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/63vRC6pW0KOFeyUc-image.png)
**Resultado Esperado:**
- O parâmetro é salvo com sucesso.
- A senha do RPS é armazenada.
- O botão de senha só aparece para o tipo `RPS_Vinhedo`.
---
#### **Cenário 2: Validação com funcionalidade inativa**
**Passos:**
1. Com a funcionalidade ativa, acesse o menu **NFS-e > Transmissão Vinhedo**;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/kMlisZgf0pbAnA07-image.png)
2. Será apresentada a mensagem **Web Service inativo. Necessária transmissão via sistema da prefeitura de Vinhedo**.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/PP1FzakELMl1trwy-image.png)
#### **Cenário 3: Validação do serviço `getToken`**
**Passos:**
1. Com a funcionalidade ativa, acesse o menu **NFS-e > Transmissão Vinhedo**;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/kMlisZgf0pbAnA07-image.png)
2. Acesse a **tela de teste WS Vinhedo**;
3. Observe o ambiente informado (Homologação ou Produção);
4. Com a funcionalidade `HABILITA_WEBSERVICE_VINHEDO`ativa, apenas para clientes que possuem cadastro de vinhedo e a funcionalidade `wpWSVinhedo` vinculada ao perfil do usuário.
5. Verifique a exibição da mensagem “Token de acesso WebService válido até...”;
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/IDIXJZJcgo4XcOhE-image.png)
6. Clique em **Zerar Token** e, em seguida, **Confirmar** para gerar novo token.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/MlPtuebv12q6xSzT-image.png)
**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.
- Com a funcionalidade desligada, apenas o texto de Ambiente de Homologação é exibido.
---
#### **Cenário 4: Validação do serviço `getActivity`**
**Passos:**
1. Na tela de teste do WS Vinhedo, selecione a opção `getActivity`;
2. Clique em **Confirmar**.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/m3x3u1cdJPXbScQK-image.png)
**Resultado Esperado:**
- Grid é preenchido com as atividades retornadas pela prefeitura;
- Cada linha exibe código, descrição e tipo de ISS.
---
#### **Cenário 5: Validação do serviço `getNextInvoice`**
**Passos:**
1. Na tela de teste do WS Vinhedo, selecione a opção `getNextInvoice`;
2. Clique em **Confirmar**.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/pEFjTwRsy1PvnFFz-image.png)
**Resultado Esperado:**
- É exibido o número da próxima nota disponível para escrituração.
---
#### **Cenário 6: Verificação das opções de geração XML sem transmissão e com transmissão (Homologação)**
**Passos:**
1. Com a funcionalidade ativa e ambiente configurado para **Homologação**;
2. Selecione nota(s) fiscal(is) e clique em **Gerar XML para Transmissão**.
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/Eg8WpRqg0OYcSk4v-image.png)
[](https://wiki.sendsolutions.com.br/uploads/images/gallery/2025-08/nXkiyF2ANsoPoJMJ-image.png)
**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.
---
##### 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;
**ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.**