Shopee: buscar pedidos, o limite de período e gerar a venda
A tela de pedidos da Shopee é uma consulta ao marketplace, não uma cópia local que você navega à vontade. Guardando isso, quase toda dúvida desta tela se explica sozinha: o período limitado, a lista que fica vazia depois de filtrar e a paginação que só anda para frente.
ANTES DE TUDO, A AUTORIZAÇÃO
Ao abrir Pedidos o ERP primeiro consulta a autorização da integração. Se ela não estiver válida, a listagem nem chega a ser desenhada: você é levado direto para a tela de autorização da Shopee. Insistir no filtro não resolve — o caminho é refazer a autorização por lá. O que a autorização cobre, o vínculo por loja e o efeito de remover a integração são assunto da fonte de Integrações.
OS TRÊS FILTROS DA BUSCA AVANÇADA
O botão Busca avançada abre um cartão com três campos, e essa é a lista completa e fechada: Código, Situação e Data da venda (data inicial e data final). Não existe filtro de cliente, de valor, de loja nem de pagamento nessa tela. As opções do campo Situação vêm com a própria resposta da consulta, e a primeira delas é Todas. O cartão tem os botões Buscar e Limpar.
O LIMITE DE PERÍODO E A LISTA QUE FICA VAZIA
Quem valida o tamanho do período é o servidor, não a tela — a tela não faz nenhuma conferência de intervalo antes de enviar. Quando o período pedido não é aceito, a resposta volta com erro e a mensagem aparece como aviso de erro na tela. No mesmo instante a listagem é zerada e aparece "Nenhum pedido foi encontrado!". É por isso que o cliente liga dizendo que os pedidos sumiram: não sumiu nada, a busca foi recusada e não trouxe resultado nenhum. Leia a mensagem que apareceu — é ela que diz qual é o teto — e refaça a busca com um intervalo menor. Se o erro vier com código de não autorizado, ele aparece em caixa de diálogo em vez de aviso: aí o assunto é autorização, não período.
AS COLUNAS DA LISTAGEM
A lista é fechada, nesta ordem: caixa de seleção, Código, Cliente, Valor, Data, Pagamento, Situação, Sincronizado e Ações. O nome em Cliente vira link para o cadastro do cliente no ERP quando o pedido já está amarrado a um cliente. Sincronizado mostra sinal verde para Sim e sinal vermelho para Não.
POR QUE UM PEDIDO TEM DOIS STATUS
Porque vêm dois. A coluna Pagamento traz o status de pagamento e a coluna Situação traz o status do pedido. São informações diferentes, cada uma com sua cor, e uma não muda a outra. Um pedido pode estar pago e ainda não despachado, ou o contrário. Nenhuma das duas diz se a venda já existe no ERP: quem diz isso é a coluna Sincronizado.
AS AÇÕES DE CADA LINHA
Visualizar aparece sempre. Gerar venda só aparece enquanto Sincronizado estiver em Não. Quando o pedido já está sincronizado e tem a venda vinculada, no lugar dele aparece o atalho que leva à venda correspondente no ERP. Existe um caso intermediário: pedido marcado como sincronizado mas sem venda vinculada não mostra nenhum dos dois botões — nem Gerar venda, nem o atalho. Fora esse caso, "não aparece o botão de gerar venda" significa que aquele pedido já virou venda.
O BOTÃO SINCRONIZAR DO TOPO
Ele é outro caminho, diferente do Gerar venda da linha: trabalha em lote e não abre formulário nenhum. Sem nada marcado, avisa "Você deve selecionar no mínimo um pedido." e não faz nada. Com pedidos marcados, pede confirmação e manda todos os selecionados de uma vez para o servidor; deu certo, a mensagem de sucesso aparece e a lista é recarregada; deu errado, o erro vem em caixa de diálogo e a lista fica como estava. Se você tentar marcar um pedido já sincronizado, o sistema avisa "Este pedido já está sincronizado!" e desmarca a linha; a caixa do cabeçalho também só marca os pedidos ainda não sincronizados.
GERAR VENDA NÃO CRIA A VENDA SOZINHO
Este é o ponto que mais gera chamado. O botão Gerar venda da linha abre o formulário de venda do próprio ERP, já preenchido a partir do pedido, com o cartão de entrega oculto. A venda só passa a existir quando você salva esse formulário. E o vínculo entre o pedido da Shopee e a venda é gravado depois de o ERP aceitar a venda; gravado o vínculo, você volta para a lista de pedidos. Consequências práticas: se você abrir o formulário e sair sem salvar, o pedido continua como Não sincronizado, e está certo; se o ERP recusar a venda (produto sem estoque, cliente, forma de pagamento, permissão), a mensagem que você vê é do ERP e é lá que se resolve. Tudo que é regra de venda, cliente, produto, estoque, financeiro e nota fiscal é do ERP, não da integração, e se responde pelas fontes do ERP.
A TELA DE VISUALIZAR O PEDIDO
Mostra, na aba de dados gerais: código, nome, CPF, endereço, envio, forma de pagamento, os dois status, valor de envio, valor de desconto, valor subtotal, valor total, data de criação e data de modificação. Na aba Produtos ficam produto, quantidade, valor unitário e valor total, com link para o produto no ERP quando ele já está vinculado. É tela de leitura: não há ali nenhum botão que altere o pedido.
A LISTA SE ATUALIZA SOZINHA
Enquanto a janela está em foco, a tela reconsulta a cada poucos segundos quais dos pedidos listados já viraram venda, e troca o Não por Sim assim que isso acontece. Ao sair da janela ela para, e volta a consultar quando você retorna. Por isso, depois de gerar a venda, o normal é o Sincronizado virar Sim em segundos, sem F5.
A PAGINAÇÃO ANDA SÓ PARA FRENTE
A consulta entrega os pedidos por cursor, ou seja, ela informa apenas onde continua a leitura. O ERP mostra o total e os números de página, mas o número que você clica não é usado para saltar: o sistema sempre pede a página seguinte à que está na tela. Na prática, você avança de uma em uma e não volta clicando em número anterior. Para rever pedidos que já passaram, refaça a busca.
O QUE COSTUMA DAR ERRADO
"Sumiram os pedidos ao filtrar": quase sempre é o erro de período; a lista é limpa junto com o erro. Leia o aviso na tela antes de qualquer coisa.
"Não consigo buscar um período grande": é limite da consulta, não configuração do ERP. A mensagem na tela diz o teto; quebre em buscas menores.
"O pedido não entrou": confira primeiro se a autorização está válida (se estiver expirada, você cai na tela de autorização), depois se a data do pedido está dentro do período pesquisado, depois se ele não está filtrado por Código ou Situação. A tela mostra o que a consulta trouxe naquele intervalo, nada mais.
"Gerei a venda e o pedido continua como não sincronizado": ou o formulário do ERP não chegou a ser salvo, ou o ERP recusou a venda, ou a venda foi salva e a gravação do vínculo falhou logo depois, com erro em caixa de diálogo. Neste último caso a venda existe no ERP e o pedido continua marcado como Não; verifique a venda antes de gerar de novo, para não duplicar.
"Não aparece o botão de gerar venda": o pedido já está sincronizado; use o atalho da venda ao lado. Se não houver nem o atalho, o pedido está sincronizado sem venda vinculada — caso para verificar antes de tentar gerar de novo.
"Marquei tudo e o Sincronizar reclamou": pedidos já sincronizados são desmarcados automaticamente; se todos eram sincronizados, sobra seleção nenhuma.
ONDE ESTE ASSUNTO CONTINUA
O desenho comum dos canais de venda, o de-para de situações e meios de pagamento, quem é dono do pedido, do preço e do estoque, e as travas de autorização estão na pasta Marketplaces e e-commerce. O índice das integrações, o vínculo por loja, o efeito de remover e o conceito de Gerar venda estão na fonte raiz de Integrações. Cadastro de cliente, produto, forma de pagamento, venda, estoque e nota fiscal se respondem pelas fontes do ERP.