erp4me.one

Integrar Stone no erp4me.one

Este guia orienta a configuração das integrações POS no erp4me.one, incluindo Stone, Banrisul e Smart TEF. As configurações de Stone e Banrisul agora são feitas pelo Marketplace de Integrações (Store), com abertura de um Modal Wizard ao clicar no card da integração.

Use o Detalhamento de Campos de cada etapa para conferir quais dados devem ser preenchidos antes de gravar a configuração.

Antes de Começar

  • Ter acesso ao erp4me.one com permissão para acessar Integrações, Marketplace de Integrações (Store) e Formas de Pagamento.
  • Confirmar com a adquirente os dados necessários da integração, como SecretKey, CNPJ do Beneficiário, número máximo de parcelas e regra de parcelamento.
  • Identificar os terminais que serão usados e confirmar o serial de cada maquininha.
  • Definir quais Formas de Pagamento serão integradas ao POS.

Onde localizar o serial? Na própria maquininha, geralmente em um adesivo na parte traseira do equipamento.

Cadastrar ou validar o acesso Stone

Antes de ativar a integração, confirme se o cliente já possui cadastro e acesso aos canais da Stone.

  1. Acesse o site da Stone.

  2. Clique em Login.

  3. Se ainda não for cliente, clique em Seja Stone para adquirir sua maquininha.

  4. Preencha os dados solicitados e avance para concluir o cadastro.

Unknown Attachment

Dica: Para mais detalhes, entre em contato com o Atendimento Stone.

📋 Detalhamento de Campos — Cadastro Stone

Campo

Obrigatório?

Descrição

Login Stone

Sim

Acesso do cliente ao portal ou aplicativo da Stone.

Dados cadastrais

Sim

Informações solicitadas pela Stone para habilitar a conta e a maquininha.

Serial da maquininha

Sim

Identificador físico do terminal que será usado na integração.

Consultar terminais Stone

Consulte as maquininhas disponíveis pelo aplicativo ou pelo site da Stone antes de cadastrar os terminais no erp4me.one.

  1. No aplicativo Stone, acesse Máquinas.

  2. Toque em Minhas máquinas.

  3. Confira a lista de máquinas instaladas no cadastro.

  4. Se preferir consultar pelo computador, acesse a Stone com e-mail e senha cadastrados.

  5. Clique em Máquinas e bandeiras e confira os terminais disponíveis.

Dica: A Stone possui suporte 24 horas. O cliente pode entrar em contato por telefone, chat ou WhatsApp.

📋 Detalhamento de Campos — Terminais Stone

Campo

Obrigatório?

Descrição

Serial

Sim

Número de identificação da maquininha.

Descrição

Recomendado

Nome amigável para facilitar a identificação do terminal na operação.

Status do terminal

Sim

Indica se o terminal ficará ativo ou inativo para uso na integração.

Ativar Stone pelo Marketplace de Integrações (Store)

A configuração da Stone é centralizada no Marketplace de Integrações (Store). Ao clicar no card da Stone, o sistema abre um Modal Wizard para informar os dados da integração e gerenciar os terminais.

Unknown Attachment

Informação: A configuração da Stone e o gerenciamento dos terminais ficam no mesmo fluxo do Modal Wizard. Use esse assistente para ativar, desativar ou revisar os terminais Stone cadastrados.

  1. No menu lateral do erp4me.one, acesse Integrações.

  2. Abra o Marketplace de Integrações (Store).

  3. Clique no card da integração Stone.

  4. No Modal Wizard, informe os dados solicitados da Stone.

  5. Na etapa de Terminais, adicione, ative ou desative cada terminal conforme a operação do cliente.

  6. Revise as informações e clique em Gravar ou Concluir.

Atenção: Se os dados da Stone estiverem incorretos ou um terminal estiver inativo, a venda poderá apresentar falha ou divergência no envio do pagamento.

Detalhamento de Campos — Marketplace Stone

Campo

Obrigatório?

Descrição

Integração Stone

Sim

Card da Stone disponível no Marketplace de Integrações (Store).

CNPJ do Beneficiário

Sim

CNPJ vinculado ao recebimento das vendas pela Stone.

SecretKey / Chave

Sim

Credencial fornecida ou gerada para autenticar a integração Stone.

Terminal

Sim

Maquininha Stone cadastrada para receber pagamentos.

Ativar / Desativar terminal

Sim

Controle centralizado para liberar ou bloquear o uso de cada terminal Stone.

Cadastrar ou editar Formas de Pagamento

Após ativar a integração, vincule as Formas de Pagamento que serão usadas nas vendas com POS.

  1. Acesse erp4me.one > Financeiro > Cadastros > Formas de Pagamento.

  2. Clique em Criar nova ou no ícone de Editar no menu de Ações da lista de Formas de Pagamento.

  3. Selecione o tipo de pagamento desejado: Cartão de Crédito, Cartão de Débito, Vale-alimentação, Vale-refeição, Vale Combustível ou Pagamento Instantâneo (PIX).

  4. Marque a opção Integrado com o POS. O texto exibido no sistema pode refletir o provedor ativo, como Integrado com o POS Stone ou Integrado com o POS Banrisul.

  5. Para formas de pagamento de Cartão, informe se o parcelamento será pela Administradora ou pela Loja.

  6. Clique em Gravar.

📋 Detalhamento de Campos — Formas de Pagamento

Campo

Obrigatório?

Descrição

Tipo de pagamento

Sim

Define a modalidade usada na venda.

Integrado com o POS

Sim

Marca a forma de pagamento para uso com a integração POS.

Responsável pelo parcelamento

Quando aplicável

Define se o parcelamento será feito pela Administradora ou pela Loja.

Máximo de parcelas

Quando aplicável

Quantidade máxima permitida para pagamento em crédito.

Emitir a nota e enviar pagamento ao terminal

Com a integração configurada, conclua a venda e envie o pagamento para o terminal POS correspondente.

  1. Acesse erp4me.one > Movimentos > Vendas > Nova.

  2. Faça o lançamento do movimento.

  3. Na opção Pagamento, escolha a forma de pagamento integrada.

  4. Envie a nota para a SEFAZ.

  5. Grave o movimento e selecione o Terminal, caso exista mais de um cadastrado.

  6. Se houver apenas um terminal ativo, confirme o envio do pagamento para o terminal cadastrado.

Você tem até 3 minutos para finalização dos pagamentos na POS. Se passar desse prazo, os pagamentos serão cancelados automaticamente. Você pode reenviar os pagamentos para a POS.

Autorização da Nota Fiscal: A autorização ocorre quando o pagamento é concluído na POS. O sistema preenche automaticamente as tags do XML com as informações exigidas pela SEFAZ, por isso a nota é autorizada apenas após a aprovação do pagamento.

📋 Detalhamento de Campos — Emissão de Notas

Campo

Obrigatório?

Descrição

Forma de pagamento

Sim

Forma configurada para integração com POS.

Terminal

Sim

Maquininha que receberá a solicitação de pagamento.

Prazo de pagamento

Sim

Tempo máximo de 3 minutos para concluir o pagamento na POS.

SEFAZ

Sim

Serviço que autoriza a nota após a confirmação do pagamento.