Passo 2 · Vendas Web Service: sincronizar e entender o que chega
O que o botão Sync WEB faz: buscar os pedidos abertos, criar um orçamento para cada um, avisar o serviço, os status que voltam (Aberto, Excluido, Cancelada, Faturado) e o que fazer depois.
Conteúdo criado com apoio de inteligência artificial · em revisão pela equipe da B4 System
Esta página mostra o que acontece por baixo do botão Sync WEB (e da sincronização que a tela faz ao abrir): como um pedido do aplicativo vira um orçamento no seu sistema e como o serviço fica sabendo do que aconteceu com ele.
#O que o sistema faz, passo a passo
- Pergunta ao serviço quais pedidos estão abertos (ainda não trazidos).
- Se não há nenhum, a barra de status mostra a mensagem do serviço (por exemplo, que não há registros) e para.
- Para cada pedido, o sistema confere se já existe um orçamento APP-WEB com o mesmo número de pedido. Se existe, pula (assim não duplica).
- Cria o orçamento, com o número interno novo, tipo orçamento e status “[ APP-WEB ]”, data e hora de agora, o cliente e o total do pedido.
- Grava cada item: código da mercadoria, quantidade, descrição, unidade, preço e subtotal. O custo e o lucro vêm do cadastro da mercadoria.
- Itens bonificados (brinde) entram com preço, subtotal, custo e lucro zerados.
- Avisa o serviço que recebeu: manda o número do pedido do aplicativo, o status Aberto e o número do orçamento criado. Quando o serviço confirma, o orçamento fica marcado como já avisado.
- Atualiza a lista da tela.
| No orçamento criado | O que vale |
|---|---|
| Vendedor e atendente | O usuário que fez a sincronização |
| Forma de pagamento | Sempre a de código 1 |
| Observação do pedido | Vai para o campo de observação do orçamento (descrição do terceiro) |
| Nome do cliente | O do cadastro, se o código existir no seu sistema |
#Os status que voltam para o serviço
Depois do pedido recebido, o sistema avisa o serviço quando o orçamento muda de situação:
| Status enviado | Quando |
|---|---|
| Aberto | Ao trazer o pedido (passo 7 acima) |
| Excluido 1 | Quando o orçamento do pedido é excluído |
| Excluido 2 | Quando a venda gerada do pedido é excluída |
| Cancelada | Quando a venda gerada é cancelada |
| Faturado | Quando a venda é efetivada e a conta a receber é gerada |
Com isso o cliente que fez o pedido pode acompanhar a situação no aplicativo.
O pedido chega como orçamento. O estoque só baixa e o financeiro só é gerado quando você efetiva o orçamento como venda. Veja Efetivar a venda.
#Onde mais a sincronização acontece
A mesma sincronização é feita ao abrir a busca de orçamento e a busca de ordem de serviço. Por isso pode haver pedidos novos mesmo sem você ter aberto o Vendas Web Service.
#O que a barra de status pode mostrar
Quando algo falha, a barra mostra o texto do problema. Aqui, uma falha de conexão fictícia.
- Barra de status: “Registros sincronizados !” quando deu certo; a mensagem do serviço quando não há pedidos; um número (por exemplo 401 ou 500) quando o serviço respondeu com erro; ou “Erro:” seguido do motivo quando não foi possível falar com o serviço.
A sincronização ignora os erros no meio do caminho. Se o serviço devolver uma resposta fora do esperado, a barra pode ficar em branco, sem dizer o que houve. Se a conexão cair no meio, um orçamento pode ficar criado sem todos os itens, e o serviço não é avisado dele. Confira os pedidos que chegaram com o aplicativo.
Pelo código lido, o pedido de pedidos abertos e o aviso de status vão ao serviço sem chave de acesso: só o endereço do serviço e o código da empresa identificam a loja. O restante da família B4 usa chave de acesso. Isso é uma observação para o suporte da B4 System confirmar; não mude nada na loja.
Se o código de cliente do aplicativo não existe no seu sistema, o orçamento é criado sem o nome, ligado a esse código. Cadastre o cliente (ou corrija o código) antes de efetivar.
Cada sincronização trata no máximo 1000 pedidos e 1000 itens por pedido. É um limite do código; pedidos acima disso ficam para a próxima vez.
#Depois que o pedido chegou
- Abra o orçamento pela busca de orçamentos (status “[ APP-WEB ]”).
- Confira cliente, itens e preços.
- Efetive como venda (venda detalhada). O serviço será avisado do Faturado.
#Mensagens deste passo
| O que aparece | O que significa | O que fazer |
|---|---|---|
| “Registros sincronizados !” | Os pedidos foram trazidos e o serviço foi avisado. | Conferir a lista. |
| Mensagem do serviço (por exemplo, sem registros) | Não há pedidos abertos. | Nada. |
| Um número, como 401 ou 500 | O serviço recusou ou falhou. | Chamar o suporte da B4 System. |
| “Erro: ...” | Não foi possível falar com o serviço (sem internet, endereço errado). | Conferir a internet; chamar o suporte se persistir. |
Se o endereço do serviço não estiver preenchido no sistema, a barra mostra “Erro:” ou um número, porque a tela de pedidos não avisa que falta o endereço. Chame o suporte da B4 System.
