B4 Guia

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.

Sistema: SoftWay Comercial (Retaguarda) · Atualizado em 22/11/2026

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

  1. Pergunta ao serviço quais pedidos estão abertos (ainda não trazidos).
  2. Se não há nenhum, a barra de status mostra a mensagem do serviço (por exemplo, que não há registros) e para.
  3. 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).
  4. 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.
  5. 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.
  6. Itens bonificados (brinde) entram com preço, subtotal, custo e lucro zerados.
  7. 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.
  8. 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 não baixa estoque nem gera contas

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

Barra de status mostrando uma falha de conexão no lugar de Registros sincronizados

Quando algo falha, a barra mostra o texto do problema. Aqui, uma falha de conexão fictícia.

  1. 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.
Falhas podem passar em silêncio

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.

Sem chave de acesso no pedido (a confirmar com a B4)

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.

O cliente do pedido pode não existir no seu cadastro

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.

Até 1000 pedidos por vez

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

  1. Abra o orçamento pela busca de orçamentos (status “[ APP-WEB ]”).
  2. Confira cliente, itens e preços.
  3. 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.

© 2026 B4 System · B4 Guia, manual de treinamento. Material criado com apoio de inteligência artificial e em revisão pela equipe da B4 System; pode conter imprecisões. Os exemplos usam dados fictícios e as telas são ilustrações geradas a partir do sistema.