Stone: onde fica cada tela do aplicativo e o que na verdade é do ERP

STONE: ONDE FICA CADA TELA DO APLICATIVO E O QUE NA VERDADE É DO ERP

O QUE É A ÁREA DA STONE
A Stone é um aplicativo acoplado ao ERP. Quando você entra nela, o sistema continua com a mesma cara. É daí que nasce a confusão mais comum: várias telas que você abre "dentro da Stone" não são do aplicativo, são as telas de sempre do ERP, abertas de dentro dele. Este texto separa uma coisa da outra e serve de índice da pasta: cada assunto aprofundado tem fonte própria, e elas estão apontadas aqui.

AS TELAS QUE SÃO MESMO DO APLICATIVO
No uso do dia a dia são quatro: Início, Recebimentos, Configurações e a tela de integração da loja.

Início mostra uma saudação. Se a integração estiver ativa, aparecem quatro cards: Vender, Recebimentos, Configurações e Usuários. Se ainda não estiver ativa, no lugar dos cards aparece o quadro de situação da integração.

Recebimentos lista os recebimentos gerados pela integração, com código Stone, cliente, data, valor, método e situação. Dá para abrir o recebimento; o botão de cancelar só aparece enquanto a situação é "A receber" e pede confirmação; quando o recebimento já foi recebido, aparece o atalho para abrir a venda relacionada ou para sincronizar o recebimento com uma venda. O detalhe dessa tela — filtros, situações, recebimento avulso e como a sincronização procura a venda — está na fonte da lista de Recebimentos.

Configurações é onde ficam o Stone code, o campo Parcelado por e o cadastro das maquininhas. O Stone code é obrigatório, tem nove dígitos e, depois de cadastrado, só pode ser trocado marcando "Atualizar Stone code". Parcelado por escolhe entre Estabelecimento e Emissor. As maquininhas são cadastradas com Nome, Modelo e Número de série, e há um "Clique aqui" que mostra como encontrar o modelo e o número de série do aparelho. Com a integração já ativa, aparece também um bloco de Formas de pagamento com quatro campos (crédito, débito, voucher e Pix): eles são apenas de leitura, servem para mostrar quais formas do ERP a integração usa. O passo a passo do preenchimento e os três estados até a ativação estão na fonte de configuração.

O CARD VENDER NÃO É UMA TELA DA STONE
O card Vender não abre nada dentro do aplicativo: ele joga você para o PDV do ERP, a tela de Vendas › Balcão, já na inclusão de uma venda. Vender é assunto do PDV. Dentro do PDV você escolhe uma forma de pagamento Stone e o pagamento vai para a maquininha. Como esse envio funciona, o que aparece na janela de espera e o que acontece depois da aprovação estão na fonte do envio do pagamento no PDV.

AS TELAS QUE PARECEM DA STONE MAS SÃO DO ERP
Usuários, Permissões, Grupos de usuários, Clientes, Planos, Ajuda, Vídeos tutoriais, Logs de usuários, Notificações, Lojas e Dados da empresa são exatamente as mesmas telas do ERP, reaproveitadas dentro do aplicativo. Não existe versão Stone delas. O que vale nelas é a regra do ERP, e a resposta está nas fontes do ERP sobre cada assunto, não aqui. O card Usuários do Início cai nessa lista: ele abre a tela de usuários do ERP. Qualquer outra tela do ERP aberta de dentro da Stone segue a mesma regra.

A INTEGRAÇÃO É POR LOJA
Os botões da tela de integração mudam conforme a loja já ter ou não a integração. Sem integração vinculada aparecem "Adicionar integração" e "Abrir conta na Stone" (este abre o site da Stone em outra aba). Com integração vinculada aparecem "Remover integração" e "Configurar integração" (este leva para Configurações). Adicionar e remover pedem confirmação antes.

O roteiro comum de integrar um meio de pagamento, o efeito de remover e o funcionamento do vínculo por loja estão na pasta Meios de pagamento e na fonte da raiz de Integrações. Aqui vale só o que é específico: se a loja em que você está logado não tem a integração vinculada, o aplicativo devolve você para a tela de integrações com o aviso "Esta loja não está integrada ao Stone". Esse mesmo aviso aparece sempre que você abre essa tela em uma loja sem integração. Trocar de loja resolve, se a integração estiver em outra. Adicionar e remover a integração ficam registrados em Logs de usuários.

QUANDO O PLANO NÃO COBRE A STONE
Se a Stone não está liberada para a empresa, o próprio serviço responde "O seu plano atual não lhe permite integrar com o Stone. Por favor, contrate outro plano!" e leva você para Meu plano.

Antes de tratar isso como contratação, olhe o botão do card dele em Meus aplicativos › Ver todos os aplicativos. Se estiver escrito TESTAR GRÁTIS, você mesmo liga na hora, por 7 dias, sem falar com ninguém. Se estiver ACESSAR e mesmo assim não abrir, o teste já foi usado ou o prazo acabou — aí sim o caso é de contratação. Esse bloqueio aparece ao adicionar a integração e ao usar os recebimentos; a tela de Configurações não passa por essa verificação. Isso é mensagem de plano. Não é falta de permissão, não é erro da maquininha e não adianta refazer a configuração. Condição comercial se resolve com o comercial.

QUANDO FALTA PERMISSÃO
Adicionar e remover a integração exigem a permissão de gerenciar integrações da Stone. Sem ela a ação falha, e a mensagem que aparece junta as duas partes: a falha ao adicionar (ou remover) a integração e o aviso de que você não possui permissão para adicionar (ou para remover) a integração. Se a loja e o Stone code estão certos e mesmo assim não dá para adicionar nem remover, o caminho é conferir a permissão do usuário. O restante das regras de acesso, grupos e permissões é do ERP e está na fonte de permissões.

A ATIVAÇÃO NÃO É IMEDIATA
Depois de cadastrar as configurações, a integração passa por uma validação que vem de fora, junto à Stone. Enquanto isso, o Início mostra "Sua integração foi configurada com sucesso!" e avisa que a configuração está em processamento e pode levar até 48 horas úteis. Nesse período, dentro do aplicativo, só Início e Configurações abrem: qualquer outra tela da Stone devolve você para o Início. Por isso Recebimentos parece sumir. As telas que são do ERP — Usuários, Grupos de usuários, Clientes, Ajuda, Logs de usuários e Planos — continuam abrindo normalmente nesse período; não é o menu inteiro que trava, só a parte da integração.

Se a validação não passar, o Início mostra "Sua integração não foi aprovada", com o pedido de revisar as informações e configurar de novo, um atalho para Configurações e, no último passo, o motivo informado (ou o aviso para verificar o Stone code). Se a loja está integrada mas ainda não existe configuração cadastrada, o aplicativo leva você direto para Configurações.

O Stone code é dado da Stone, não do ERP: você o encontra no portal da Stone, clicando no nome do estabelecimento, em Meu perfil, na área de tarifas. A chave secreta não é campo do cliente — ela só aparece na tela para usuário de suporte. Nunca peça nem repita chave ou senha no atendimento; se o cliente já mandou, oriente gerar outra no portal do parceiro.

O QUE A ATIVAÇÃO CRIA SOZINHA NO ERP
Quando a integração é aprovada, o aplicativo cria no ERP, sem você pedir, uma conta bancária chamada Stone e quatro formas de pagamento ligadas a essa conta: Crédito, Débito, Voucher e Pix, todas com o nome da conta na frente. Quando não é a primeira integração da empresa, o nome da conta vem com o Stone code junto; se já existe outra integração com o mesmo Stone code, o nome da conta que já existe é reaproveitado. As formas nascem disponíveis no PDV; a de crédito aceita parcelamento e as outras três são à vista. Elas pertencem à integração e não podem ser editadas no cadastro de formas de pagamento do ERP. Também chega uma notificação no sistema avisando que a integração Stone foi ativada, e a ativação fica registrada em Logs de usuários. Conta bancária e forma de pagamento são conceitos do ERP: para entender saldo, conciliação e comportamento delas, use as fontes do ERP. O que a integração faz com elas — nomes, parcelamento e o que acontece se uma for excluída — está na fonte da conta bancária e das formas de pagamento da Stone.

O QUE COSTUMA DAR ERRADO
Entrei na Stone e não achei Recebimentos: ou a conta ainda está em validação, ou não está ativa, e nesse estado só Início e Configurações abrem dentro do aplicativo.
Abri e caí na tela de integrações com o aviso de loja não integrada: você está logado em uma loja sem a integração vinculada.
Entrei na Stone e caí direto em Configurações: a loja está integrada, mas ainda não há configuração cadastrada.
Cliquei em Vender e fui parar no PDV: é o comportamento correto, o card só encaminha.
Mudei algo em Usuários, Permissões, Clientes ou Lojas dentro da Stone e achei que valia só ali: é a tela do ERP, a mudança vale para o sistema inteiro.
Recebi a mensagem de plano: não é configuração. Confira antes o botão do card em Meus aplicativos › Ver todos os aplicativos — TESTAR GRÁTIS liga na hora, por 7 dias; ACESSAR sem abrir é teste já usado, e aí sim é contratação.
Não consigo adicionar nem remover a integração: falta a permissão de gerenciar integrações.
Os campos de forma de pagamento em Configurações estão travados: é assim mesmo, eles são só de leitura e só aparecem depois que a integração fica ativa.