🔄 Procedimento em Caso de Falha de Comunicação Mobile – Integração com Reshop

🎯Objetivo

Dar maior clareza ao processo de cadastro de clientes, à comunicação e aos procedimentos a serem adotados quando ocorre falha de comunicação entre os sistemas Mobile e Reshop.

📋Índice

📝Cadastro de Clientes

Durante o cadastro de um cliente no Mobile, os dados são enviados para:

  • Reshop (para integração com processos internos)
  • UX (para experiência do usuário e sincronização)
  • ERP (o UX sincroniza os dados com o ERP, que posteriormente realiza a sincronização com o Reshop)

Para que isso ocorra, é necessário que a comunicação com ambos os sistemas esteja ativa e funcional.

🧩Passo a Passo do Processo

1- Início do Cadastro

    • O cliente é cadastrado no Mobile.
    • Os dados são preparados para envio ao Reshop e UX.
    • No Mobile, existe um timeout fixo de 10 segundos para o fluxo de integração com o Reshop e um timeout fixo de 5 segundos para o fluxo de integração com o UX.

2- Verificação de Comunicação

    • O Mobile envia os dados do cadastro primeiramente ao Reshop e, na sequência, ao UX.
    • É apresentada apenas a notificação de sucesso do cadastro.
    • Caso ocorram problemas de comunicação com o Reshop, é apresentada mensagem informativa de falha de comunicação com o Reshop, seguindo o fluxo de cadastro no UX.

Caso 1: Comunicação OK com ambos

    • O cadastro é concluído com sucesso nos dois sistemas.
    • Uma mensagem informativa de sucesso é exibida ao usuário.


Caso 2:  ❌ Falha com UX 

    • Uma mensagem informativa é apresentada ao usuário, indicando que não foi possível realizar o cadastro do cliente.
      Mensagem: O serviço está indisponível (11). O nome remoto não pôde ser resolvido: 'qa-ux-svc.linx.com.br'


Caso 3: ❌ Falha com Reshop

    • O cadastro não é efetuado de imediato no Reshop.
    • Porém, como os dados foram enviados para UX, o fluxo se resolve posteriormente:
    • UX possui funcionalidade para repassar os dados ao Reshop quando a comunicação estiver normalizada.
    • Uma mensagem informativa de sucesso de cadastro é exibida ao usuário, e outra mensagem notificando sobre a falha de comunicação com o Reshop é apresentada.


Caso 4: ❌ Falha com Reshop quando o cadastro é realizado via Mobile

    • Cadastro não é efetuado de imediato no Reshop.
    • Porém, como os dados foram enviados para UX, que reenvia os dados para o ERP, o fluxo se resolve posteriormente:
    • O ERP possui funcionalidade para repassar os dados ao Reshop quando a comunicação estiver normalizada.
    • Uma mensagem informativa de sucesso é exibida ao usuário, e outra mensagem notificando sobre a falha de comunicação com o Reshop é apresentada.


✔️ Mesmo com falhas entre Mobile e Reshop, o processo é garantido porque UX atua como intermediário, enviando os dados ao Reshop assim que possível.

FLUXO DO PROCESSO

Outras situações onde pode ocorrer falha de comunicação entre Mobile e UX com o Reshop:


O Mobile realiza comunicação direta com o Reshop, que pode ocorrer via Server ou Client, dependendo do cenário, conforme descrito abaixo:

👤 Consulta de Clientes

O Mobile realiza a consulta de clientes no UX. Caso a aplicação esteja indisponível, o processo de cadastro ou consulta do cliente não é realizado.
Quando a aplicação está online, a consulta ocorre primeiramente no UX e, posteriormente, no Reshop.

Se o cadastro do cliente existir apenas no UX, o sistema apresenta os dados em tela e efetua automaticamente o cadastro do cliente no Reshop.

FLUXO DO PROCESSO


🎫 Consulta de Campanha de Uso Único

Quando o Reshop estiver offline, essa consulta fica indisponível tanto para o Server quanto para o Client.
Nesse cenário, o fluxo segue normalmente porém sem a aplicação da campanha.
🔗 Existe uma tabela com as modalidades de campanhas funcionais e não funcionais. Para mais detalhes, consultar a documentação específica do Reshop.

🎁 Consulta de Campanhas Opcionais

Assim como no caso anterior, se o Reshop estiver offline, a consulta também fica indisponível para Server e Client.
Nesse cenário o fluxo segue normalmente porém sem a aplicação da campanha.
🔗 Existe uma tabela com as modalidades de campanhas funcionais e não funcionais. Para mais detalhes, consultar a documentação específica do Reshop.

💲Consulta de Preço Remarcado

Se o Reshop estiver offline, o preço remarcado não é retornado. Nessa situação, o sistema utiliza o preço original proveniente do UX.

  • É apresentada a mensagem: Problema de comunicação com o Reshop. Ocorreu um erro ao consultar remarcação Reshop
  • 🔗 Para mais detalhes, consultar a documentação específica do Reshop.


🧮 Totalização

Atualmente, o processo funciona da seguinte forma: sempre que há uma venda, é obrigatória a disponibilidade do Reshop. Caso o Reshop esteja offline, não é possível concluir a venda.

Em breve, será disponibilizado um novo parâmetro que permitirá que o fluxo de venda ocorra mesmo em caso de falhas de comunicação com o Reshop.
Com o parâmetro ativo, a venda será realizada normalmente e os registros serão integrados no OmniPOS, UX, Mobile e Self-checkout. No entanto, essa venda não será registrada no Reshop no momento da transação; o envio ocorrerá posteriormente pelo UX ou ERP, dependendo da configuração do apontamento.


🎉 Geração de Benefício

  • 🔗 Depende da comunicação com o Reshop, quando server e client estão offline não opera.

  • ❌ Reshop offline:

    • Benefícios não são aplicados

    • Não há geração via dados offline

🔗 Existe uma tabela com as modalidades de campanhas funcionais e não funcionais. Para mais detalhes, consultar a documentação específica do Reshop.

⏱️ Timeout 

No Mobile, há um timeout fixo de 60 segundos para o fluxo de integração com o Reshop. Esse comportamento é controlado pelo parâmetro REQUEST_TIMEOUT_RESHOP, que define o tempo máximo de espera (em segundos) para o retorno das requisições entre o Mobile e o Reshop.
Além disso, existe também um timeout fixo de 5 segundos para o fluxo de integração com o UX.

Em caso de falha de comunicação, é exibida em tela uma mensagem informativa e o processo segue normalmente.





  • Sem rótulos