Gravar de novo o pedido do app quando a gravação falha

Se a gravação de um pedido novo falha no app (sinal fraco, demora, erro do servidor), você pode gravar de novo sem medo de criar um pedido repetido. O mesmo pedido não nasce duas vezes, e o que você digitou continua na tela.

O caminho é o de sempre: App Kryia One → Vendas → Pedidos → Novo pedido. Não há botão, menu ou passo novo para isso. Os botões do fluxo continuam sendo Salvar rascunho, Avançar e Confirmar.

O que fazer quando a gravação falha

Toque de novo em Salvar rascunho. O Confirmar também grava o rascunho antes de enviar o pedido à próxima etapa, então vale a mesma regra para ele.

Quando a gravação falha, o app mostra a mensagem do servidor, se houver uma. Sem mensagem do servidor, mostra:

Não foi possível salvar o rascunho. O que você digitou foi mantido.

O que o app faz por trás

Cada pedido novo começa com uma chave própria do rascunho, que o app cria sozinho na primeira tentativa de gravar. Você não vê nem digita essa chave.

• Se a primeira gravação falha e você grava de novo, o app reenvia a mesma chave. Se o servidor já tinha criado o pedido, ele devolve esse pedido em vez de criar outro. Nessa repetição o servidor só lê o pedido que já existe.
• Em seguida, o app grava nesse pedido o que está na tela naquele momento. Edições feitas entre a tentativa que falhou e a nova tentativa não se perdem.
• A chave vale enquanto o pedido ainda não tem número.
• Cada rascunho novo (ao iniciar um novo pedido) começa sem chave e ganha uma chave nova. Dois pedidos diferentes continuam sendo dois pedidos.

A web não muda: a chave é opcional no servidor e só o app a envia. Sem chave, a criação do documento segue como antes.

Quando duas gravações chegam ao mesmo tempo

Se duas gravações do mesmo rascunho chegam juntas, uma grava e a outra recebe a mensagem:

Este documento já está sendo gravado por outra tentativa. Tente de novo em instantes.

Espere um instante e grave de novo. A nova tentativa encontra o pedido que já foi criado e grava nele o conteúdo da tela.

Quando o servidor recusa a criação

Se o servidor recusa a criação de vez (um erro 4xx, como uma regra de negócio), nenhum pedido nasceu. O app descarta a chave e a próxima tentativa começa limpa. O que você digitou fica mantido: corrija o que a mensagem apontar e grave de novo.

Problemas comuns

A gravação falhou e não sei se o pedido foi criado. Grave de novo. Se o pedido já existia, o app o reaproveita e grava nele o que está na tela; não surge um segundo pedido.

Recebi “Este documento já está sendo gravado por outra tentativa.” Outra gravação do mesmo rascunho estava em andamento. Tente de novo em instantes.

Perdi o que digitei? Não. Com a mensagem “Não foi possível salvar o rascunho. O que você digitou foi mantido.”, os dados continuam na tela.

Para escrever quantidade, preço e descontos do jeito que o app entende, veja digitar quantidade e preço no pedido pelo app.