Stone: enviar o pagamento para a maquininha no PDV e o que acontece depois

Esta fonte trata do momento da venda: como o pagamento sai do PDV e chega na maquininha Stone, e o que o sistema faz depois que o cartão passa. Ativar a integração, cadastrar maquininha e informar o Stone Code são assunto das outras fontes desta pasta.

ONDE A VENDA ACONTECE
A tela inicial do aplicativo Stone tem quatro cards: Vender, Recebimentos, Configurações e Usuários. Essa lista é fechada. O card Vender não abre uma venda dentro do aplicativo: ele apenas leva você para o PDV do ERP. É no PDV que a venda é montada e que o pagamento é enviado para a maquininha. Venda, cliente, produto, estoque, forma de pagamento e financeiro continuam sendo do ERP; o aplicativo Stone cuida da conversa com a maquininha e da lista de recebimentos.
Os quatro cards só aparecem quando a integração está ativa. Enquanto a Stone valida o cadastro, a tela inicial mostra o andamento da validação no lugar dos cards, e o próprio sistema fala em até 48 horas úteis. Se a integração não for aprovada, a tela inicial pede para revisar as informações e configurar novamente. Se ela nunca foi configurada, a tela pede para acessar o menu de configurações.

O QUE PRECISA ESTAR PRONTO ANTES
Integração ativa. Ao ativar, o sistema cria sozinho uma conta bancária Stone e quatro formas de pagamento ligadas a ela: Crédito, Débito, Voucher e Pix, com o nome da conta na frente. São essas quatro, e a lista é fechada. Elas já nascem disponíveis no PDV, o crédito com até 12 parcelas e as outras três em uma vez. Na lista de formas de pagamento do ERP o botão de editar dessas quatro fica desativado de propósito: são formas de controle da integração, não formas comuns. O detalhe de como elas nascem está na fonte da conta bancária e das formas de pagamento da Stone.
Pelo menos uma maquininha cadastrada nas configurações, com nome, modelo e número de série — os três são obrigatórios. É pelo número de série que a Stone sabe em qual aparelho o pedido deve aparecer.

COMO ENVIAR O PAGAMENTO PARA A MAQUININHA
Monte a venda no PDV normalmente.
Clique em Finalizar venda (F6). Na tela de pagamento, no cartão Receber, escolha em Forma de pagamento uma das quatro formas da Stone.
Se você tem mais de uma maquininha cadastrada, aparece o campo Maquininha (vazio, ele mostra "Selecione a maquininha"), já com uma preenchida. Se você tem apenas uma, esse campo não aparece: o sistema envia direto para ela. Não é falha, é o comportamento de quem tem uma máquina só.
No crédito, quando a forma permite mais de uma parcela, escolha a quantidade no campo Parcelas (uma lista; antes eram botões 1x, 2x). Em Débito, Voucher e Pix o campo Parcelas fica desabilitado.
Confira o campo Valor recebido e clique em Confirmar (F3).
O pedido vai para a maquininha e abre a janela de espera, que tem como título o nome da maquininha escolhida. É a maneira mais rápida de conferir para qual aparelho o pedido foi. Se a janela abrir sem nome nenhum no título, a maquininha guardada no navegador não corresponde a nenhuma das cadastradas hoje.

POR QUE O ENVIO SÓ ACONTECE EM ALGUNS CASOS
O PDV não olha o nome da forma de pagamento: olha o banco gravado nela. Só as formas com o banco da Stone disparam o envio para a maquininha, e hoje a Stone é a única maquininha integrada ao PDV. Uma forma de cartão criada à mão só registra a parcela, não conversa com aparelho nenhum.
O valor precisa ser de no mínimo 0,01. Com valor zerado o sistema avisa (a mensagem ainda chama o campo Valor recebido pelo nome antigo): Para enviar o recebimento para maquininha, o campo Total a pagar deve ser maior ou igual a 0,01!

A ÚLTIMA MAQUININHA USADA FICA GRAVADA NO NAVEGADOR
Quando você escolhe uma maquininha, essa escolha é guardada no próprio navegador daquele computador. É por isso que ela volta selecionada em uma máquina do balcão e não volta em outra, mesmo com o mesmo usuário e a mesma loja. Trocar de computador, trocar de navegador ou limpar os dados do navegador zera essa memória, e nada disso mexe no cadastro. Sem nada guardado, o sistema usa a primeira maquininha da lista.
Esse detalhe explica um problema silencioso: o que está guardado no navegador tem preferência sobre o cadastro. Se a maquininha foi apagada das configurações e o navegador ainda guarda o número de série antigo, o envio vai para um aparelho que não está mais cadastrado. Com duas ou mais maquininhas você percebe pelo campo de seleção; com uma só, não há campo nenhum na tela.

A JANELA DE ESPERA
Depois do envio a janela mostra o que foi enviado (forma, parcelas, maquininha e número de série, número do pedido e valor), a frase Peça para o cliente passar o cartão — "A confirmação chega sozinha quando a maquininha responder." — e três passos: Pedido enviado, Cliente paga, Sistema confirma. Embaixo, dois botões: Cancelar na maquininha e Já pagou? Verificar agora. São só esses dois. A janela não fecha clicando fora nem pelo Esc: ela segura a venda até aquele pagamento ser resolvido.
O sistema fica ouvindo a confirmação em tempo real. Quando a Stone conclui, o próprio sistema busca o resultado sozinho, sem você clicar em nada.
Já pagou? Verificar agora serve para conferir na hora. Se a Stone ainda não concluiu, aparece Pagamento pendente! Isso não cancela nem reenvia nada: o pedido continua na maquininha.
Cancelar na maquininha pede confirmação com este texto: Tem certeza que deseja cancelar o pagamento? O valor não será processado e o recebimento será cancelado. Confirmando, o sistema pede o cancelamento do pedido na Stone e fecha a janela. Esse é o caminho de quando o cliente desistiu antes de passar o cartão.

QUANDO O PAGAMENTO É APROVADO
A janela mostra Pagamento aprovado, com a bandeira e a autorização em selos, e os dois botões somem. O código de autorização devolvido pela Stone entra na parcela, junto com a bandeira do cartão informada pela Stone; no Pix da maquininha, esse código é o identificador da transação Pix. No cartão Pagamentos recebidos do PDV essa parcela é diferente das outras: o código de autorização não pode ser digitado nem alterado e não existe botão para remover a parcela. O dinheiro já passou na maquininha, e apagar a linha na tela não desfaria isso.
O pagamento da maquininha vai para a venda já marcado como recebido, diferente de uma parcela comum, que fica a receber.
Se o valor recebido ficar igual ao total da venda, a janela fecha e a venda é finalizada sozinha poucos segundos depois, caindo direto na tela de finalização. Se ainda faltar valor, a janela fecha e você continua registrando o restante, podendo inclusive mandar outro valor para a maquininha. Se a finalização automática esbarrar em algum impedimento da venda — produto sem estoque, por exemplo —, o sistema mostra o erro e a venda continua na tela com o pagamento já registrado; resolva o impedimento e finalize, sem passar o cartão de novo.

O VÍNCULO COM A VENDA SÓ NASCE NO FINAL
O recebimento só é amarrado à venda depois que a venda é finalizada. É nesse momento que o sistema informa quais recebimentos pertencem àquela venda.
Consequência prática: se o cartão passou e a venda não foi finalizada, o recebimento existe, aparece na lista Recebimentos com a situação Recebido e fica sem venda ligada. Para esse caso a lista de recebimentos tem a ação Sincronizar com uma venda, que liga o recebimento a uma venda já existente. Quando o vínculo existe, a mesma lista oferece a ação de ver a venda relacionada. A lista também tem Visualizar em qualquer situação. Como essa busca funciona e por que ela volta vazia estão na fonte da lista de Recebimentos.

CANCELAR A VENDA DEPOIS QUE O CARTÃO JÁ PASSOU
Ao clicar em Cancelar na tela de pagamento do PDV com um pagamento da Stone já aprovado, o sistema avisa: Atenção: Esta venda possui um ou mais pagamentos recebidos via maquininha Stone. Ao cancelar, é necessário realizar o estorno do(s) pagamento(s) na maquininha. Tem certeza de que deseja cancelar esta venda?
Leia o aviso ao pé da letra. Cancelar a venda no PDV descarta a venda na tela e não estorna nada na Stone: o valor continua cobrado do cliente. O estorno é feito na maquininha. Quando a Stone informa o estorno, o recebimento passa a aparecer como Estornado na lista; e, se aquele recebimento já estava ligado a uma venda, o sistema também cancela a confirmação do pagamento no financeiro. Se o recebimento nunca chegou a ser ligado a uma venda, não há lançamento no financeiro para cancelar.
Nunca oriente o cliente a passar o cartão de novo para tentar de novo. Se a venda travou depois de um pagamento aprovado, o caminho é conferir o recebimento na lista Recebimentos e sincronizar com a venda, nunca cobrar duas vezes.

O QUE COSTUMA DAR ERRADO
Falha ao enviar o pedido para a maquininha. Tente novamente ou verifique a conexão com a internet: essa é a mensagem genérica de envio do PDV. Ela aparece na falha de comunicação com a integração e também quando o plano da empresa não cobre a Stone, porque o aviso de plano não chega até a tela do PDV. Antes de reenviar, olhe a maquininha para ter certeza de que o pedido não chegou; se o aparelho está ligado, com internet, e a integração está ativa, vale conferir também o plano.
Você não tem permissão para realizar esta ação!: essa é a mensagem de permissão do usuário, e a janela de espera nem chega a abrir. É uma frase diferente da anterior, e só ela indica permissão. Permissão é assunto da fonte específica.
Maquininha desligada ou sem internet: o pedido não aparece no aparelho e a janela fica aguardando até você cancelar.
Número de série diferente do que está cadastrado: confira o número de série da etiqueta da maquininha contra o das configurações antes de reenviar.
Maquininha apagada das configurações com a antiga ainda guardada no navegador: o envio vai para um número de série que não está mais cadastrado.
Pagamento pendente! ao clicar em Verificar: o cliente ainda não concluiu na maquininha ou a Stone ainda não devolveu a confirmação. Espere e verifique de novo, sem reenviar.
As formas da Stone não aparecem na lista do PDV: enquanto a integração não é ativada, essas quatro formas nem existem. E com o PDV vendendo sem internet elas também somem da lista, porque o envio para a maquininha depende de conexão.
Pagamento aprovado e venda perdida: o vínculo não foi gravado porque a venda não chegou a ser finalizada. Resolve com Sincronizar com uma venda.

O QUE ESTA FONTE NÃO COBRE
Ativação, Stone Code, cadastro de maquininha e configuração de parcelamento: fonte de configuração. Lista de Recebimentos, situações e sincronização: fonte de Recebimentos. Conta bancária e as quatro formas: fonte própria. Mapa de telas: fonte de telas. Conceitos de forma de pagamento, conta bancária, venda, estoque e financeiro: fontes do ERP. Pix em geral: pasta Meios de pagamento.