Stone: configurar a integração e os três estados até a ativação

A integração Stone liga o PDV do ERP à sua maquininha: você fecha a venda no sistema, o valor vai para o aparelho e a confirmação volta para o ERP. Antes disso, porém, a configuração passa por uma validação feita pela nossa equipe. Salvar o formulário não liga a integração. Aqui você vê o que preenche, o que o sistema faz com isso e os três estados pelos quais a integração passa até ficar ativa.

O QUE VOCÊ PREENCHE

A tela de Configurações do aplicativo Stone tem três blocos. Em Configurações gerais existe um único campo seu: Stone code, obrigatório. Ele aceita apenas números, tem nove dígitos e o campo não deixa digitar mais que isso; com menos de nove, a tela não permite salvar.

Em Configuração PDV existe o campo Parcelado por, também obrigatório. Em Maquininhas você cadastra os aparelhos.

Existe ainda um campo chamado Chave secreta, mas ele só é exibido para usuário de Suporte. Na sua tela ele não aparece, e não deve aparecer. Você não precisa dessa informação e não deve procurá-la, nem enviá-la para ninguém. Se você já tiver alguma chave ou token em mãos, não cole em conversa de atendimento: gere outra no portal do parceiro e descarte a antiga.

ONDE ENCONTRAR O STONE CODE

O Stone code é um dado da Stone, não do ERP. A própria tela traz a dica com o caminho no portal da Stone: entre no portal, clique no nome do seu estabelecimento, que aparece no canto superior direito, vá em Meu perfil e clique em tarifas. O Stone code fica ao lado do nome do seu negócio. Enquanto não há código salvo, a tela mostra um aviso com o link para abrir conta na Stone.

POR QUE O CÓDIGO VOLTA COM ASTERISCOS

Depois de salvo, o Stone code nunca mais é devolvido inteiro para a tela. Ele volta mascarado, com apenas os três primeiros e os três últimos caracteres visíveis, e o campo aparece travado. Isso é proteção do dado, não erro de gravação. Muita gente reabre a configuração, vê os asteriscos no meio do código e conclui que gravou errado — não gravou.

Para trocar o código de verdade você marca a caixa Atualizar Stone code. Só então o campo é liberado para digitação. Enquanto essa caixa estiver desmarcada, o código guardado permanece como está, mesmo que você salve a tela de novo.

PARCELADO POR

Parcelado por define quem assume o parcelamento na maquininha. A lista é fechada e tem duas opções: Estabelecimento e Emissor. Essa é uma escolha da integração, não do caixa. Quem opera o PDV não vê nem altera esse campo na hora da venda: o PDV lê a opção que está gravada aqui e a usa nos pagamentos enviados para o aparelho. Para mudar, é aqui na configuração.

MAQUININHAS

Cada maquininha tem três campos, todos obrigatórios: Nome, Modelo e Número de série. O nome é livre e serve só para você identificar o aparelho no PDV. O modelo vem de uma lista fechada, com estas opções e nenhuma outra: S920, Q92, A8, P2, L3 e L4.

O número de série é o dado que faz a venda chegar no aparelho certo — é ele que o ERP envia para a Stone ao mandar o pedido. Errar esse número é a causa mais comum de a venda sair do PDV e a maquininha nunca apitar. A ajuda da própria tela, no link acima da tabela, mostra onde encontrá-lo: no adesivo da traseira da maquininha, no conjunto de letras e números depois da sigla S/N, ou nos comprovantes de venda depois da sigla SN.

Você adiciona quantas maquininhas quiser pelo botão Adicionar maquininha. A última linha não pode ser removida: o botão de excluir só existe quando há mais de uma maquininha cadastrada. No PDV, o seletor de maquininha só aparece quando existe mais de um aparelho cadastrado; com um só, o sistema já usa aquele.

OS TRÊS ESTADOS ATÉ A ATIVAÇÃO

O status da integração é decidido pelo sistema e é sempre um destes três: em processamento, não aprovada ou ativa. Não há outros. Quando ainda não existe código configurado, a tela de Início mostra Integração não configurada, com o texto pedindo que você acesse o menu de configurações.

Primeiro estado, em processamento. Assim que você salva a configuração pela primeira vez, o cadastro nasce já em processamento e você é levado para a tela de Início, que mostra Sua integração foi configurada com sucesso! e, logo abaixo, A configuração da sua integração está em processamento e pode levar até 48 horas úteis para ser concluída. Esse prazo é o texto que a tela exibe, não uma garantia. A lista de etapas ao lado mostra a primeira concluída, Configurar integração Stone, e a segunda em andamento, Validando configuração. Nada no ERP acelera ou pula essa etapa: a validação é feita fora da sua tela, pela equipe, junto à Stone. Você não tem botão de ativar, e não deve procurar um.

Segundo estado, não aprovada. Se a validação não passar, a tela de Início muda para Sua integração não foi aprovada, com a linha Por favor, revise as informações e configure novamente. Também chega uma notificação no sistema com esse mesmo recado. A terceira linha da lista de etapas é a mais importante: ela traz a mensagem devolvida pela equipe explicando o motivo. Quando não vem mensagem, aparece o texto padrão Verifique seu Stone Code. Essa terceira linha é clicável e leva para as Configurações.

Terceiro estado, ativa. Quando a equipe conclui a validação, a integração passa a ativa. Nesse momento o sistema cria sozinho, no seu ERP, uma conta bancária da Stone e quatro formas de pagamento ligadas a ela, uma para Crédito, uma para Débito, uma para Voucher e uma para Pix. Os nomes das formas começam pelo nome dessa conta — em geral Stone - Crédito, Stone - Débito, Stone - Voucher e Stone - Pix. Se esta não for a primeira integração Stone da empresa, a conta pode ser criada com o Stone code no nome, e as formas herdam esse nome. É também criada uma notificação no sistema avisando que a integração foi ativada. A tela de Início deixa de mostrar aviso e passa a exibir os atalhos de Vender, Recebimentos, Configurações e Usuários. O que cada uma dessas quatro formas faz, como elas nascem e o que acontece se alguma for excluída estão no conteúdo sobre a conta bancária e as formas de pagamento da Stone.

Essas quatro formas de pagamento não podem ser editadas na tela de formas de pagamento do ERP: o botão de editar fica desabilitado e, se a edição for forçada, o sistema responde que essa forma de pagamento não pode ser editada. Elas pertencem à integração. O conceito de forma de pagamento e conta bancária é do ERP e está explicado no conteúdo do próprio ERP; aqui só vale saber que estas quatro nascem prontas e travadas.

POR QUE RECEBIMENTOS SOME ANTES DE ATIVAR

Enquanto a integração não está ativa, as telas próprias do aplicativo Stone ficam restritas a Início e Configurações. Recebimentos, por exemplo, é redirecionado de volta para o Início. É por isso que ele parece ter sumido, ou que o link do menu não leva a lugar nenhum. Não é falta de permissão do usuário, não é o plano e não adianta mexer em grupos de usuários: é a trava de status da própria integração, e ela cai sozinha quando a integração é ativada. Telas gerais do ERP abertas por dentro do aplicativo — Usuários, Grupos de usuários, Clientes, Planos e Ajuda — continuam abrindo normalmente mesmo antes da ativação, o que às vezes confunde: o menu não está todo travado, só a parte da integração.

Vale notar o que é do aplicativo e o que é do ERP. Recebimentos e Configurações são telas do aplicativo Stone. O atalho Vender leva para o PDV do ERP, que é a tela de sempre e continua funcionando normalmente — só as formas de pagamento da Stone é que ainda não existem lá antes da ativação. Usuários, Clientes e Planos, quando abertos por dentro do aplicativo, são as telas do próprio ERP. O mapa completo de telas está no conteúdo sobre as telas da Stone.

O QUE COSTUMA DAR ERRADO

Configurei de novo depois da reprovação e continua dizendo que não foi aprovada. É o caso mais frequente e é assim mesmo: gravar a configuração não mexe no status. Salvar de novo atualiza os dados, mas a integração segue como não aprovada até que a equipe faça uma nova validação e reative. Além disso, salvar de novo só dispara um novo aviso para a equipe quando você marca Atualizar Stone code e envia o código outra vez — se você corrigiu apenas maquininhas ou Parcelado por, ninguém é avisado automaticamente. Corrija o que foi apontado na terceira linha da tela e fale com o atendimento informando que já corrigiu; não fique salvando a tela repetidamente esperando o texto mudar sozinho.

Salvei de novo e uma maquininha sumiu do PDV. Cada gravação apaga a lista inteira de maquininhas e recria a partir do que está na tela naquele instante. Se você removeu uma linha, ou abriu a tela e salvou sem conferir, o aparelho que não estava ali some. Confira a tabela completa antes de clicar em Atualizar.

Troquei de aparelho e a venda continua sem chegar. O PDV guarda no navegador a última maquininha usada e volta a usá-la nas próximas vendas. Depois de trocar o aparelho ou o número de série, se houver mais de uma maquininha escolha a correta no seletor do PDV; se só houver uma, teste em outra aba ou em outro navegador para descartar essa memória do navegador. O detalhe completo está no conteúdo sobre o envio do pagamento no PDV.

O Stone code está certo, salvei, mas a maquininha não responde no PDV. Se a integração ainda está em processamento, é exatamente o esperado: as formas de pagamento da Stone só são criadas na ativação, então não existe no PDV forma de pagamento apontando para a integração e não há o que enviar para o aparelho. Confira em Início qual das telas de status aparece antes de tratar como defeito.

Estou vendo asteriscos no lugar do meu código. É o mascaramento descrito acima. Só marque Atualizar Stone code se você realmente quiser trocar o número.

Não acho o campo Chave secreta. Ele não existe na sua tela — é exclusivo de usuário de Suporte. Não é você quem preenche.

A integração ativou mas o PDV não mostra a forma da Stone. Antes de qualquer integração de pagamento funcionar precisa existir uma forma de pagamento apontando para ela; no caso da Stone essas formas nascem na ativação. Se a forma que você espera não aparece na lista, ela já está vinculada a outra integração. O roteiro comum de integrar meio de pagamento está no conteúdo de Meios de pagamento, e o vínculo da integração por loja, o efeito de remover e o Gerar venda estão no conteúdo geral de Integrações.