Ir para o conteúdo principal

OS 91207 - OBRIGAÇÕES - DOCUMENTO ELETRÔNICO - CANCELAMENTO DE LANÇAMENTO - ORIGEM ENCONTRO DE CONTAS

Objetivo:

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

  • Transmitir RPS para a prefeitura e obter retorno do processamento (protocolo/situação/mensagens)mensagens e XML de resposta).

  • Consultar  a situaçãoexistência da chave do RPS jáno transmitidoambiente (parada acompanhamentoprefeitura equando validação).houver chave associada.

  • Cancelar RPS  quando necessário, informando o motivo e registrando o retornoXML do município.gerado.

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

Além disso, o processo passa a respeitar regras importantes definidas na implementação:

  • A transmissão poderá ocorrer em dois modos, conforme a configuração da opção
    Integração via Web Service Vinhedo habilitada ou desabilitada:

    • Quando a integração estiver desabilitada, o sistema mantém o comportamento anterior, apenas gerando os arquivos XML para download e importação manual no portal da prefeitura.

    • Quando a integração estiver habilitada e o serviço estiver disponível, o sistema realiza a transmissão diretamente via Web Service, seguindo o padrão atualizado do fornecedor Prescon.

  • Os XMLs de transmissão e de resposta ficam disponíveis no Dashboard
    (Relatórios > Em Processamento) para evidência e auditoria.

Em resumo: o usuário passa a ter rotinas completas de integração (transmissão, consulta, cancelamento e disponibilidade) para Vinhedo, com retornoevidência visívelde processamento e evidênciasfuncionamento deconforme processamento.o novo modelo do Web Service.

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:01A – Transmitir RPS com sucessointegração Web Service desabilitada (fluxodownload principal)manual de XML)

Passo a passopasso:

  1. Acessar ao rotinamenu deNFS-e > Transmissão deVinhedo.

    RPS
    2. –

  2. Confirmar que a opção Integração via Web Service Vinhedo está desabilitada.

  3. Localizar/selecionarSelecionar umuma RPSnota “Pendente de transmissão”.

  4. AcionarClicar em Gerar XML para Transmissão.

Resultado esperado:

  • O sistema mantém o comando/botãcomportamento anterior.

  • Gera o arquivo XML para transmissão.

  • Realiza o download automático do XML para importação manual no portal da prefeitura.

  • Exibe mensagem caso a nota já esteja com status XML Gerado/Validado.

Cenário 01B – Transmitir RPS com integração Web Service habilitada e serviço disponível

Passo a passo:

  1. Acessar o menu NFS-e > Transmissão Vinhedo.

  2. Confirmar que a opção Transmitir/EnviarIntegração via Web Service Vinhedo está habilitada.

  3. AguardarValidar que o processamento e serviço retornoapresenta dostatus Webativo/disponível Service.na tela.

  4. Selecionar uma ou mais notas para transmissão.

  5. Clicar em Gerar XML para Transmissão.

Resultado esperadoesperado:

  • SistemaO enviasistema otransmite RPSas aonotas via Web Service.Service conforme padrão atualizado.

  • RetornoO status da nota só é exibido/registradoalterado (ex.:após protocolo, mensagemretorno de sucesso e situação).êxito.

  • StatusMensagens e erros do RPSWeb éService atualizadosão paraexibidos algona equivalente a Transmitido/Processado/Em análise (conforme regra do município).tela.

  • RegistroO ficaXML de transmissão e o XML de resposta ficam disponívelveis parano consultaDashboard:
    Relatórios posterior.> Em Processamento.

  • Não ocorre download automático após o processamento.

Cenário 02 – Transmissão bloqueada por RPSnota inválidolida (ou erro de validação)o

Passo a passopasso:

  1. Selecionar um RPS propositalmente com inconsistência (ex.: campo obrigatório ausente/regraausente fiscalou código de serviço inválida)lido).

  2. Executar Transmitir/Enviar.Gerar XML para Transmissão.

Resultado esperadoesperado:

  • SistemaO sistema não conclui a transmissão.

  • Exibe mensagem clara indicando oa motivoinconsistência (validação interna e/ou retornoerro doretornado Webpelo Service).serviço.

  • RPSO status da nota permanece com status Pendente/Erro e apto a correção/reprocessamento.inalterado.

  • Log/retornoO erro fica registrado paracomo evidência de auditoria.

Cenário 03 – ConsultarVerificar RPSnotas com XML já transmitido (consulta de situação)gerado/validado

Passo a passopasso:

  1. AcessarSelecionar anotas rotinaque dejá Consultapossuam destatus RPSXML –Gerado Vinhedo.ou Validado.

  2. InformarClicar osem filtrosGerar (ex.:XML númeropara do RPS, período, situação, contribuinte, etc.).

  3. Executar Consultar.

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

Resultado esperadoesperado:

  • SistemaO consultasistema não Webgera/transmite Servicenovamente (ouessas base integrada) e retorna a situação atual.notas.

  • Exibe detalhesa domensagem retornoatualizada:
    “O (situação,XML mensagens,das protocolo/identificador).

    seguintes
    • notas

  • Caso não municípioforam retornegerados/transmitidos mudançapor já estarem com status de situação,XML o sistema reflete/atualiza a informação conforme regra.Gerado/Validado”.

Cenário 04 – Consulta de RPS inexistente/nãocom transmitidochave associada

Passo a passopasso:

  1. NaAtualizar rotina de Consulta, informar um RPS que não existegrid noselecionando municípiostatus (ou ainda não foi transmitido).TODAS.

  2. ExecutarSelecionar Consultar.uma nota que possua Chave da Nota Fiscal associada.

  3. Clicar no botão Consulta RPS.

Resultado esperadoesperado:

  • SistemaO retornasistema mensagemexecuta “nãoa localizado”consulta /via “semWeb registro” (conforme retorno do WS).Service.

  • NãoRetorna ocorreXML erroconfirmando técnicose (sema travarchave tela).existe na prefeitura.

  • RegistroAtenção: (quandoo aplicável)serviço permanecenão comretorna o status coerenteatual noda ERP.nota (transmitida/cancelada), apenas a existência.

  • O XML de retorno é exibido e registrado.

Cenário 05 – CancelarConsulta RPSindisponível compara sucessonotas (fluxosem principal)chave ou cliente modo consulta

Passo a passopasso:

  1. AcessarSelecionar uma nota sem chave associada ou cliente com licença rotinaapenas de Cancelamento de RPS – Vinhedo.consulta.

  2. SelecionarVerificar umse o botão Consulta RPS queestá 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.disponível.

Resultado esperadoesperado:

  • SistemaO envia solicitaçãbotão deConsulta cancelamentoRPS ao Web Service.

  • Retorno de sucessonão é apresentadoexibido (mensagem/protocolo).

    ou
    • a

  • Status do RPSfuncionalidade é atualizadobloqueada paraconforme Cancelado (ou equivalente).

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

Cenário 06 – CancelamentoTransmissão negadosimultânea de notas ativas e canceladas (RPSordem jáde cancelado ou situaçexecução não permite)o)

Passo a passopasso:

  1. Selecionar umnotas RPScom jástatus canceladonormal oue notas com status Cancelada.

  2. Clicar em situaçãoGerar queXML para Transmissão.

Resultado esperado:

  • O sistema executa em duas etapas:

    1. Gera e transmite XML das notas não permitecanceladas.

    2. Após intervalo de 3 segundos, gera e transmite XML das notas canceladas.

  • São gerados arquivos separados para transmissão e cancelamento.

  • ExecutarAmbos Cancelar.

    ficam
    • disponíveis no

    ResultadoDashboard esperado

    >
      Em

    • 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.Processamento.

    Cenário 07 – VerificarCancelamento disponibilidadecom domotivo serviço (WS online)obrigatório

    Passo a passopasso:

    1. AcessarSelecionar auma rotina/açãonota decancelada Disponibilidadepara do Serviço – Vinhedo.transmissão.

    2. ExecutarSelecionar a verificação (botãoMotivo “Verificar/Consultarde disponibilidade”).Cancelamento no combo.

    3. Clicar em Transmitir.

    Resultado esperadoesperado:

    • SistemaO retornasistema statusexige Disponível/Online.o motivo antes de prosseguir.

    • ExibeGera data/horao daXML checagemde (secancelamento previsto).separado.

    • LiberaExecuta execuçãa transmissão normaldo decancelamento transmissão/consulta/cancelamento.conforme novo padrão.

    Cenário 08 – IndisponibilidadeCancelamento doem serviçhomologação (WSambiente offline/instável)inexistente)

    Passo a passopasso:

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

    2. ExecutarConfirmar Disponibilidadea e, em seguida, tentar Transmitir/Consultar/Cancelar.transmissão.

    Resultado esperadoesperado:

    • RotinaO sistema exibe relatório de disponibilidadeinconsistência informainformando Indisponível/Erroque não existe ambiente de comunicaçhomologação compara mensagem amigável.cancelamento.

    • AoAinda tentar transmitir/consultar/cancelar,assim, o sistemaXML nãode quebracancelamento eé retornagerado errocomo controlado.evidência.

    • OrientaCancelamento real deve ser validado somente em produção usuáriocom a tentar novamente mais tarde e registra log técnico para suporte.acompanhamento.

    Cenário 09 – Auditoria/RegistroVerificar dedisponibilidade retornodo (rastreabilidade)serviço Web Service

    Passo a passopasso:

    1. Acessar a rotina de Transmissão Vinhedo.

    2. Observar o status do serviço exibido.

    Resultado esperado:

    • O sistema apresenta:

      • validade do certificado SEFAZ,

      • mensagens de erro do servidor,

      • status ativo/inativo do serviço.

    • A transmissão só pode ocorrer se o serviço estiver disponível.

    Cenário 10 – Evidência e rastreabilidade no Dashboard

    Passo a passo:

    1. Executar uma transmissão (sucessovia ouWeb erro)Service com a opção
      Integração via Web Service Vinhedo habilitada.

    2. Acessar oRelatórios detalhe> doEm registro (log/retorno/histórico da integração).Processamento.

  • ResultadoLocalizar esperadoo processo gerado.

  • Baixar:

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

    • PermiteXML rastrearResposta oVinhedo

      que
      • foi
    enviado

    • Resultado esperado:

    • Os arquivos ficam disponíveis para auditoria e o que o município retornou.validação.

    • FacilitaNão evidêexiste mais relatório de transmissão, apenas XMLs separados.

    • Evidência paracompleta suportedo envio e validaçãoretorno fiscal.fica registrada no sistema.

    4.png

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

Voltar ao topo