Ir para o conteúdo principal

OS 92106 - CONTAS A PAGAR - FATURA CARTÃO DE CRÉDITO E PARCELAMENTO DE TÍTULO CONTROLADO

Objetivo:

Permitir que o usuário integre o envio de RPS do SEND ERP com a Prefeitura de Vinhedo via Web Service, de forma prática e rastreável, garantindo que seja possível:

  • Transmitir RPS para a prefeitura e obter retorno (protocolo/situação/mensagens).

  • Consultar a situação do RPS já transmitido (para acompanhamento e validação).

  • Cancelar RPS quando necessário, registrando o retorno do município.

  • Verificar a disponibilidade do serviço (status do Web Service) antes/ durante as rotinas, reduzindo falhas por indisponibilidade externa.

Em resumo: o usuário passa a ter rotinas completas de integração (transmissão, consulta, cancelamento e disponibilidade) para Vinhedo, com retorno visível e evidências de processamento.

Premissas:

  • Necessário o ambiente estar atualizado com a versão do módulo Documento Eetrônico de número xxxxx Genexus 17 ou superior;

Teste realizado após a atualização

Cenário 1: Transmitir RPS com sucesso (fluxo principal)

Passo a passo

  1. Acessar a rotina de Transmissão de RPS – Vinhedo.

  2. Localizar/selecionar um RPS “Pendente de transmissão”.

  3. Acionar o comando/botão Transmitir/Enviar.

  4. Aguardar o processamento e o retorno do Web Service.

Resultado esperado

  • Sistema envia o RPS ao Web Service.

  • Retorno é exibido/registrado (ex.: protocolo, mensagem de sucesso e situação).

  • Status do RPS é atualizado para algo equivalente a Transmitido/Processado/Em análise (conforme regra do município).

  • Registro fica disponível para consulta posterior.

Cenário 02 – Transmissão bloqueada por RPS inválido (validação)

Passo a passo

  1. Selecionar um RPS propositalmente com inconsistência (ex.: campo obrigatório ausente/regra fiscal inválida).

  2. Executar Transmitir/Enviar.

Resultado esperado

  • Sistema não conclui a transmissão.

  • Exibe mensagem clara indicando o motivo (validação interna e/ou retorno do Web Service).

  • RPS permanece com status Pendente/Erro e apto a correção/reprocessamento.

  • Log/retorno fica registrado para auditoria.

Cenário 03 – Consultar RPS já transmitido (consulta de situação)

Passo a passo

  1. Acessar a rotina de Consulta de RPS – Vinhedo.

  2. Informar os filtros (ex.: número do RPS, período, situação, contribuinte, etc.).

  3. Executar Consultar.

  4. Selecionar um item retornado (quando aplicável) e visualizar detalhes.

Resultado esperado

  • Sistema consulta o Web Service (ou base integrada) e retorna a situação atual.

  • Exibe detalhes do retorno (situação, mensagens, protocolo/identificador).

  • Caso o município retorne mudança de situação, o sistema reflete/atualiza a informação conforme regra.

Cenário 04 – Consulta de RPS inexistente/não transmitido

Passo a passo

  1. Na rotina de Consulta, informar um RPS que não existe no município (ou ainda não foi transmitido).

  2. Executar Consultar.

Resultado esperado

  • Sistema retorna mensagem “não localizado” / “sem registro” (conforme retorno do WS).

  • Não ocorre erro técnico (sem travar tela).

  • Registro (quando aplicável) permanece com status coerente no ERP.

Cenário 05 – Cancelar RPS com sucesso (fluxo principal)

Passo a passo

  1. Acessar a rotina de Cancelamento de RPS – Vinhedo.

  2. Selecionar um RPS que esteja em situação permitida para cancelamento (ex.: transmitido/autorizado, conforme regra).

  3. Informar motivo/justificativa (se a rotina exigir).

  4. Acionar Cancelar e confirmar a ação.

Resultado esperado

  • Sistema envia solicitação de cancelamento ao Web Service.

  • Retorno de sucesso é apresentado (mensagem/protocolo).

  • Status do RPS é atualizado para Cancelado (ou equivalente).

  • Item permanece consultável com histórico do cancelamento.

Cenário 06 – Cancelamento negado (RPS já cancelado ou situação não permite)

Passo a passo

  1. Selecionar um RPS já cancelado ou em situação que não permite cancelamento.

  2. Executar Cancelar.

Resultado esperado

  • Sistema bloqueia a ação ou recebe retorno de negação do WS.

  • Exibe mensagem clara informando o motivo (ex.: “RPS já cancelado” / “situação não permite”).

  • Não altera indevidamente o status do documento.

  • Mantém evidência/log do retorno.

Cenário 07 – Verificar disponibilidade do serviço (WS online)

Passo a passo

  1. Acessar a rotina/ação de Disponibilidade do Serviço – Vinhedo.

  2. Executar a verificação (botão “Verificar/Consultar disponibilidade”).

Resultado esperado

  • Sistema retorna status Disponível/Online.

  • Exibe data/hora da checagem (se previsto).

  • Libera execução normal de transmissão/consulta/cancelamento.

Cenário 08 – Indisponibilidade do serviço (WS offline/instável)

Passo a passo

  1. Simular indisponibilidade (ex.: apontar para endpoint inválido em homologação, bloquear rede, ou usar janela de WS fora do ar).

  2. Executar Disponibilidade e, em seguida, tentar Transmitir/Consultar/Cancelar.

Resultado esperado

  • Rotina de disponibilidade informa Indisponível/Erro de comunicação com mensagem amigável.

  • Ao tentar transmitir/consultar/cancelar, o sistema não quebra e retorna erro controlado.

  • Orienta o usuário a tentar novamente mais tarde e registra log técnico para suporte.

Cenário 09 – Auditoria/Registro de retorno (rastreabilidade)

Passo a passo

  1. Executar uma transmissão (sucesso ou erro).

  2. Acessar o detalhe do registro (log/retorno/histórico da integração).

Resultado esperado

  • O retorno do WS (mensagens, códigos, protocolo, payload mínimo ou rastreio) fica registrado.

  • Permite rastrear o que foi enviado e o que o município retornou.

  • Facilita evidência para suporte e validação fiscal.

4.png

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

Voltar ao topo