Stone: lista de Recebimentos, situações e recebimento avulso
Recebimentos é a tela do aplicativo Stone que lista os pagamentos que passaram pela maquininha. Ela consulta a Stone no momento em que você abre e cruza o resultado com os vínculos de venda guardados no ERP. Por isso o que você vê é sempre a foto atual do lado da Stone, e não uma cópia antiga guardada aqui.
A tela de início do aplicativo Stone só mostra os atalhos quando a integração está ativa. Enquanto a configuração está em validação, ou se ela não foi aprovada, o que aparece ali é o status da integração. Isso está explicado na fonte de configuração da Stone. O roteiro comum de ligar um meio de pagamento está na pasta Meios de pagamento, e o índice das integrações e o efeito de remover estão na fonte raiz de Integrações.
O QUE A LISTA MOSTRA
As colunas são Cód Stone, Cliente, Data, Valor, Método e Situação, mais a coluna Ações. Quando o pagamento foi parcelado, o número de parcelas aparece ao lado do método, entre parênteses. No rodapé fica a paginação, no formato "Mostrando X a Y de um total de Z". Quando a consulta não devolve nada, a tela mostra "Nenhum recebimento foi encontrado!".
O método aparece traduzido como Débito, Crédito, Voucher ou Pix. Se a Stone devolver um método fora desses, ele aparece como veio.
A LISTA JÁ ABRE FILTRADA PELO MÊS ATUAL
Esta é a informação mais importante da tela. Ao entrar em Recebimentos o período já vem preenchido do primeiro ao último dia do mês corrente. Recebimento de mês anterior não aparece enquanto você não trocar o período. É a causa mais comum do chamado "sumiu meu recebimento": o pagamento existe, está na Stone, mas está fora da janela de datas que a tela usou.
Para trocar, use o seletor de período no topo. Ele oferece Hoje, Esta semana, Mês passado, Este mês, Últimos 30 dias, Todo o período e Escolha o período — esta última abre a busca avançada. Todo o período é a opção que tira o recorte de datas e traz tudo que a Stone tiver.
A busca avançada tem os campos Período e Situação, com os botões Buscar e Limpar. Ali o período é obrigatório. E atenção: o botão Limpar não mostra tudo — ele devolve o filtro ao mês corrente e zera a situação. Para ver tudo, use Todo o período no seletor do topo.
AS SITUAÇÕES
A tela traduz cinco situações: A receber, Recebido, Cancelado, Falha e Estornado.
A receber é o pagamento criado e ainda não confirmado. Recebido é o pagamento confirmado. Cancelado é o pagamento encerrado sem ter sido pago. Falha é a tentativa que não foi concluída.
Estornado é o caso diferente: o sistema deduz essa situação na hora de montar a lista, olhando a cobrança por trás do recebimento. Se aquela cobrança está cancelada na Stone, a linha aparece como Estornado, mesmo que a situação do pagamento em si fosse outra.
Se a Stone devolver alguma situação fora dessa lista, ela aparece exatamente como veio, sem tradução. É raro, mas acontece — não trate a lista acima como se fosse tudo o que pode aparecer na coluna.
POR QUE O FILTRO DE SITUAÇÃO NÃO TEM ESTORNADO
Na busca avançada o campo Situação oferece Todas, A receber, Recebido, Cancelado e Falha. Não existe opção Estornado, e isso não é falha de carregamento. O que você escolhe ali é repassado à Stone como filtro, e Estornado não é uma situação da Stone: é uma conclusão que o sistema tira depois, já com o dado na mão. Para achar um estorno, filtre pelo período e leia a coluna Situação.
AS AÇÕES MUDAM CONFORME A SITUAÇÃO
Visualizar aparece sempre, em qualquer situação.
Cancelar só aparece quando a situação é A receber. Ele envia o cancelamento à Stone. Não existe botão de estornar nesta tela: pagamento já recebido não se desfaz por aqui.
Ver venda relacionada aparece quando aquele recebimento já tem uma venda vinculada e a situação não é A receber. Ele leva para a venda de balcão no ERP. O botão fica desabilitado se a situação não for Recebido, ou seja, em Cancelado, Falha e Estornado ele aparece apagado.
Sincronizar com uma venda aparece no caso oposto: recebimento sem nenhuma venda vinculada e situação diferente de A receber. Também só fica clicável quando a situação é Recebido.
O QUE É UM RECEBIMENTO AVULSO
Recebimento avulso é o pagamento que passou na maquininha sem ficar amarrado a uma venda do ERP. Acontece em duas situações. A primeira: a venda foi feita no PDV, o pagamento passou, mas a venda não chegou a ser finalizada com sucesso. O vínculo só é escrito depois que a finalização da venda dá certo; se esse passo não se completou, o recebimento fica solto. A segunda: a cobrança foi feita direto na maquininha, sem passar pelo PDV. Aí nunca houve venda para vincular.
Recebimento avulso não é erro de integração. É pagamento sem par no ERP. Ele conta como dinheiro na Stone, mas não aparece amarrado a nenhuma venda até você sincronizar.
COMO A SINCRONIZAÇÃO PROCURA A VENDA
Ao clicar em Sincronizar com uma venda, o sistema não procura qualquer venda. Ele lista vendas de balcão que atendam, ao mesmo tempo, a três condições: não terem parcela já lançada com uma forma de pagamento POS Stone, ter valor total exatamente igual ao valor do recebimento e ser da mesma data do recebimento.
É por isso que muita busca volta vazia. Um centavo de diferença, um desconto ou acréscimo aplicado depois, um frete somado ao total, ou uma venda lançada em outro dia já quebram a comparação. Quando nada bate, a tela mostra "Nenhuma venda encontrada com o valor e data do recebimento selecionado.". Isso não quer dizer que a venda não exista: quer dizer que nenhuma venda casou com o valor e a data.
Se a busca traz vendas, elas aparecem numa tabela com Nº, Cliente, Data, Situação e Valor. Você escolhe uma, e o sistema pede confirmação antes de gravar.
O alerta amarelo no topo da janela avisa o que vai acontecer, e vale ler antes: ao sincronizar um recebimento avulso, a forma de pagamento e a conta bancária da venda, e também da movimentação financeira vinculada a ela, são atualizadas. A venda passa a apontar para a forma de pagamento POS Stone correspondente ao método do recebimento. Dando certo, a mensagem é "Venda sincronizada com sucesso!" e a lista é recarregada. Não há botão para desfazer isso pela tela. Confira a venda escolhida antes de confirmar.
Sincronizar não cria venda nenhuma. Ela só liga o recebimento a uma venda que já existe.
CANCELAR UM RECEBIMENTO
Ao clicar em Cancelar, abre a janela Cancelar recebimento Stone com a data da venda, o valor total e a forma de pagamento daquele recebimento, para você conferir que é o registro certo, e os botões Confirmar cancelamento e Fechar. Confirmando, o cancelamento é enviado à Stone e o sistema responde "Recebimento cancelado com sucesso.". Depois disso a lista é recarregada.
OS NOMES QUE APARECEM NA COLUNA CLIENTE
Nem sempre a coluna Cliente traz um nome de cadastro. Quando a Stone não devolve nome de cliente para aquele pagamento, a lista mostra Consumidor. Quando a Stone devolve o cliente como desconhecido — o caso típico da cobrança feita direto na maquininha, sem cliente informado —, aparece Cliente avulso. Nenhum dos dois é cadastro do ERP: são rótulos de quem não foi identificado.
O QUE A VISUALIZAÇÃO MOSTRA A MAIS
Abrindo um recebimento com o botão Visualizar você vê, além de método de pagamento, cliente, valor e status: o Código do recebimento na Stone, o Código, o Parcelado por (quando o pagamento foi parcelado, indicando se o parcelamento foi do Estabelecimento ou do Emissor do cartão), a Loja, o e-mail do cliente quando existe, e as datas de Cadastrado em e Modificado em.
O QUE COSTUMA DAR ERRADO
Recebimento não aparece na lista. Quase sempre é o período: a tela abriu no mês corrente e o pagamento é de antes. Troque o período antes de qualquer outra coisa — Mês passado ou Todo o período resolvem a maioria dos casos. Depois disso, confira se sobrou uma situação selecionada no filtro e se o registro não está em outra página.
A lista está vazia mesmo com período largo. Verifique se a integração está ativa. Enquanto a configuração está em validação, ou se ela não foi aprovada, a tela de início do aplicativo mostra o status em vez dos atalhos, e não há o que listar.
O botão Sincronizar aparece apagado. Ele só é clicável quando a situação é Recebido. Em Falha, Cancelado ou Estornado não há o que vincular.
A busca de vendas não encontra nada. Confira o valor até o centavo e a data. Se a venda teve desconto, acréscimo ou frete lançado depois do pagamento, o total da venda deixou de ser igual ao valor que passou na maquininha, e a busca não casa. Venda de outro dia também não aparece, e venda que já tem uma parcela com forma POS Stone fica de fora da busca de propósito.
O cliente diz que o valor está errado ou que quer estornar. Estorno de pagamento já recebido é assunto da Stone, não desta tela. Aqui só existe cancelamento de recebimento em A receber.
O QUE NÃO SE RESPONDE AQUI
Venda, movimentação financeira, forma de pagamento, conta bancária e cadastro de cliente são conceitos do ERP e têm fontes próprias. A tela de venda que o botão Ver venda relacionada abre é a venda de balcão do ERP, não uma tela do aplicativo Stone. Configuração da integração, Stone Code, maquininhas cadastradas e ativação também têm fonte própria, na mesma pasta da Stone.