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, de forma prática e rastreável, garantindo que seja possível:

  • Transmitir RPS para a prefeitura e obter retorno do processamento (mensagens e XML de resposta).

  • Consultar a existência da chave do RPS no ambiente da prefeitura quando houver chave associada.

  • Cancelar RPS quando necessário, informando o motivo e registrando o XML gerado.

  • Verificar a disponibilidade do serviço (status do Web Service) 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 evidência de processamento e funcionamento conforme 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 01A – Transmitir RPS com integração Web Service desabilitada (download manual de XML)

Passo a passo:

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

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

  3. Selecionar uma nota “Pendente de transmissão”.

  4. Clicar em Gerar XML para Transmissão.

Resultado esperado:

  • O sistema mantém o 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 Integração via Web Service Vinhedo está habilitada.

  3. Validar que o serviço apresenta status ativo/disponível na tela.

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

  5. Clicar em Gerar XML para Transmissão.

Resultado esperado:

  • O sistema transmite as notas via Web Service conforme padrão atualizado.

  • O status da nota só é alterado após retorno de êxito.

  • Mensagens e erros do Web Service são exibidos na tela.

  • O XML de transmissão e o XML de resposta ficam disponíveis no Dashboard:
    Relatórios > Em Processamento.

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

Cenário 02 – Transmissão bloqueada por nota inválida ou erro de validação

Passo a passo:

  1. Selecionar um RPS com inconsistência (campo obrigatório ausente ou código de serviço inválido).

  2. Executar Gerar XML para Transmissão.

Resultado esperado:

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

  • Exibe mensagem clara indicando a inconsistência ou erro retornado pelo serviço.

  • O status da nota permanece inalterado.

  • O erro fica registrado como evidência de auditoria.

Cenário 03 – Verificar notas com XML já gerado/validado

Passo a passo:

  1. Selecionar notas que já possuam status XML Gerado ou Validado.

  2. Clicar em Gerar XML para Transmissão.

Resultado esperado:

  • O sistema não gera/transmite novamente essas notas.

  • Exibe a mensagem atualizada:
    “O XML das seguintes notas não foram gerados/transmitidos por já estarem com status de XML Gerado/Validado”.

Cenário 04 – Consulta RPS com chave associada

Passo a passo:

  1. Atualizar o grid selecionando status TODAS.

  2. Selecionar uma nota que possua Chave da Nota Fiscal associada.

  3. Clicar no botão Consulta RPS.

Resultado esperado:

  • O sistema executa a consulta via Web Service.

  • Retorna XML confirmando se a chave existe na prefeitura.

  • Atenção: o serviço não retorna o status atual da nota (transmitida/cancelada), apenas a existência.

  • O XML de retorno é exibido e registrado.

Cenário 05 – Consulta indisponível para notas sem chave ou cliente modo consulta

Passo a passo:

  1. Selecionar uma nota sem chave associada ou cliente com licença apenas consulta.

  2. Verificar se o botão Consulta RPS está disponível.

Resultado esperado:

  • O botão Consulta RPS não é exibido ou a funcionalidade é bloqueada conforme regra.

Cenário 06 – Transmissão simultânea de notas ativas e canceladas (ordem de execução)

Passo a passo:

  1. Selecionar notas com status normal e notas com status Cancelada.

  2. Clicar em Gerar XML para Transmissão.

Resultado esperado:

  • O sistema executa em duas etapas:

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

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

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

  • Ambos ficam disponíveis no Dashboard > Em Processamento.

Cenário 07 – Cancelamento com motivo obrigatório

Passo a passo:

  1. Selecionar uma nota cancelada para transmissão.

  2. Selecionar o Motivo de Cancelamento no combo.

  3. Clicar em Transmitir.

Resultado esperado:

  • O sistema exige o motivo antes de prosseguir.

  • Gera o XML de cancelamento separado.

  • Executa a transmissão do cancelamento conforme novo padrão.

Cenário 08 – Cancelamento em homologação (ambiente inexistente)

Passo a passo:

  1. Executar cancelamento em ambiente de homologação.

  2. Confirmar a transmissão.

Resultado esperado:

  • O sistema exibe relatório de inconsistência informando que não existe ambiente de homologação para cancelamento.

  • Ainda assim, o XML de cancelamento é gerado como evidência.

  • Cancelamento real deve ser validado somente em produção com acompanhamento.

Cenário 09 – Verificar disponibilidade do serviço Web Service

Passo a passo:

  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 via Web Service com a opção
    Integração via Web Service Vinhedo habilitada.

  2. Acessar Relatórios > Em Processamento.

  3. Localizar o processo gerado.

  4. Baixar:

    • XML Transmissão

    • XML Resposta Vinhedo

Resultado esperado:

  • Os arquivos ficam disponíveis para auditoria e validação.

  • Não existe mais relatório de transmissão, apenas XMLs separados.

  • Evidência completa do envio e retorno 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