Mudanças entre as edições de "Integrações"

De ContaHUB
Ir para navegaçãoIr para pesquisar
 
(4 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 49: Linha 49:
  
  
−
== Efí (GerênciaNet) ==
+
== Efí (GerenciaNet) ==
  
−
Para cobrar com PIX e integrar o ContaHUB diretamente com o Banco, abra uma conta no App do GerenciaNet.
+
Para cobrar com PIX e integrar o ContaHUB diretamente com o Banco, abra uma conta no App do EFI para Android ou iPhone: https://sejaefi.com.br/
  
−
GerenciaNet é uma fintech inovadora e praticamente a única que permitiu a integração automática.
+
EFI (Antigo GerenciaNet) é uma fintech inovadora e praticamente a única que permitiu a integração automática.
  
  
 
O que você precisa:
 
O que você precisa:
−
# Chave Pix (gerado no App GN)
+
# Chave Pix (gerado no App EFI)
−
# Configurar a Forma de Pagamento (no ContaHUB)
+
# App ContaHUB (criado no site EFI - utilize um computador)
−
# App ContaHUB (criado no site GN)
+
# Dar as permissões para o ContaHUB acessar o Pix e os Extratos (no site EFI)
−
# Dar as permissões para o ContaHUB acessar o Pix GN (no site GN)
+
# Client Id + Client Secret do APP (pegar no site EFI)
−
# Client Id + Client Secret do APP (pegar no site GN)
+
# Certificado digital GN (criação e download no site EFI)
−
# Certificado digital GN (download no site GN)
+
# Incluir a Integração EFI no ContaHUB (Configurações... Plataformas Abertas)
  
  
 
Para abrir a conta, instale o App (Android [https://play.google.com/store/apps/details?id=br.com.gerencianet.app&hl=pt_BR&gl=US] ou iPhone [https://apps.apple.com/br/app/gerencianet/id1443363326])
 
Para abrir a conta, instale o App (Android [https://play.google.com/store/apps/details?id=br.com.gerencianet.app&hl=pt_BR&gl=US] ou iPhone [https://apps.apple.com/br/app/gerencianet/id1443363326])
  
−
'''Toda a abertura de conta deve ser feita em nome do Sócio Administrador'''
+
'''Toda a abertura de conta deve ser feita pelo Sócio Administrador'''
  
  
Linha 73: Linha 73:
 
=== EFÍ - criar a chave Pix ===
 
=== EFÍ - criar a chave Pix ===
  
−
* No Aplicativo de Celular do EFÍ-GerenciaNet, crie uma chave (aleatória de preferencia):
+
* No Aplicativo de Celular do EFÍ-GerenciaNet, crie uma chave (aleatória de preferencia para evitar que o cliente utilize seu CNPJ e só consiga pagar o valor das comandas):
 
:[[File:ClipCapIt-210316-152524.PNG|400px]]
 
:[[File:ClipCapIt-210316-152524.PNG|400px]]
  
−
=== Configurar a chave Pix em uma forma de pagamento ===
 
  
−
* Configure, no ContaHUB, uma forma de pagamento para o PIX com as seguintes informações: (Configuracoes - Tabelas - Formas de Pagamento)
 
  
−
:[[File:ClipCapIt-210316-152747.PNG|400px]]
+
Acesse o site do EFI e siga os passos abaixo:
  
−
(o Código tPAG do Pix é 17)
+
=== EFI - configurações do App ===
  
 +
* Crie a Aplicação "ContaHUB" em sua conta EFI:
  
 +
:[[File:ClipCapIt-230728-085652.PNG|400px]]
  
−
Na coluna integração utilize:
 
  
−
<code>
+
:[[File:ClipCapIt-230728-085803.PNG|400px]]
−
{"pix":{"x":"GerenciaNet","chave":"PONHA_SUA_CHAVE_AQUI"}}
 
−
</code>
 
  
  
 +
:[[File:ClipCapIt-230728-085915.PNG|300px]]
  
−
Acesse o site do GerenciaNET e siga os passos abaixo:
 
  
−
=== GerenciaNet - configurações da integração ===
+
:[[File:ClipCapIt-230728-090342.PNG|300px]]
−
 
 
−
* Crie a Aplicação "ContaHUB" em sua conta GerenciaNET:
 
−
 
 
−
:[[File:ClipCapIt-210316-110744.PNG|400px]]
 
  
  
  
−
* Após a criação da aplicação, copie as credenciais para o ContaHUB (Configurações - Variaveis - Meios de Pagamento) [https://sp.contahub.com/#config.var#_tab=Meios]
+
* Após a criação da aplicação, copie as credenciais CLIENT SECRET e CLIENT ID
  
−
:[[File:ClipCapIt-210316-113114.PNG|400px]]
+
:[[File:ClipCapIt-241106-165950.PNG]]
  
  
  
−
* O próximo passo é gerar um certificado digital junto à GerenciaNet:
+
* O próximo passo é gerar um certificado digital junto à EFI:
  
 
:[[File:ClipCapIt-210316-112207.PNG|400px]]
 
:[[File:ClipCapIt-210316-112207.PNG|400px]]
Linha 116: Linha 109:
  
  
−
* E fazer o upload desde clicando sobre o campo:
+
=== EFÍ - configurar o ContaHUB ===
−
 
 
−
:[[File:ClipCapIt-210316-160139.PNG|400px]]
 
−
 
 
−
 
 
−
 
 
−
 
 
−
:[[File:ClipCapIt-230728-085652.PNG|400px]]
 
−
 
 
−
 
 
−
:[[File:ClipCapIt-230728-085803.PNG|400px]]
 
−
 
 
−
 
 
−
:[[File:ClipCapIt-230728-085915.PNG|300px]]
 
−
 
 
  
−
:[[File:ClipCapIt-230728-090342.PNG|300px]]
+
* E fazer o upload desde junto com os dados das credenciais e a chave em CONFIGURAÇÕES ... PLATAFORMAS ABERTAS:
  
 +
:[[File:ClipCapIt-241106-165927.PNG|400px]]
  
 
== Banco Inter Empresas ==
 
== Banco Inter Empresas ==
Linha 199: Linha 179:
 
== Beer Pass ==
 
== Beer Pass ==
  
−
Configure seu Beerpass com os códigos de produtos no ContaHUB e certifique-se que o prduto está Ativo, é para Venda, e está com Entrega Imediata ativada, além do '''preço unitário de venda''', que deve ser igual:
+
Configure seu Beerpass com os códigos de produtos no ContaHUB e certifique-se que o prduto está Ativo, é para Venda, e está com Entrega Imediata ativada, além do '''preço unitário de venda''', que deve ser igual (verifique mais adiante uma alternativa para preços variáveis):
  
 
:[[File:ClipCapIt-210521-105739.PNG|400px]]
 
:[[File:ClipCapIt-210521-105739.PNG|400px]]
Linha 272: Linha 252:
  
 
:[[File:ClipCapIt-210520-131236.PNG|400px]]
 
:[[File:ClipCapIt-210520-131236.PNG|400px]]
 +
 +
 +
=== Erro de Preço Divergente ===
 +
 +
Ao chegar um lançamento de um item, o ContaHUB verifica se os preços são os mesmos, a fim de garantir que os dois sistemas não tenham divergências.
 +
 +
Em alguns casos, pode ser interessante controlar isso somente pelo Beer Pass (exemplo: Happy Hour).
 +
 +
Nesse caso, utilize o campo IdExterno no produto do ContaHUB e coloque os preços que serão aceitados (utilizando "." como ponto decimal - não use vírgula).
 +
 +
Exemplo: um produto tem preço normal de R$25, mas em alguns horários, pode ter preço promocional. Nesse caso, preencha o IdExterno com "preco:10,16.80".
 +
 +
Para aceitar qualquer preço que venha do BeerPass, utilize "preco:?".
 +
 +
:[[File:ClipCapIt-240127-180420.PNG|400px]]
 +
 +
 +
*É importante manter os 2 sistemas com o mesmo preço, pois existem casos excepcionais que será necessário lançar na comanda de forma manual.

Edição atual tal como às 17h42min de 7 de novembro de 2024

Stone

O ContaHUB concilia automaticamente os pagamentos recebidos via maquininha Stone.

O extrato é baixado diariamente às 07:00 e processado. Aqueles lançamentos que tenham sido alimentados via App ContaHUB serão praticamente todos conciliados. Aqueles que não puderem ser conciliados automaticamente já estarão no sistema e poderão ser conciliados manualmente nas rotinas do Financeiro.

Para habilitar a Integração acesse: Configurações ... Plataformas Abertas e siga as instruções na tela. Será preciso ter acesso ao e-mail que a Stone utiliza para se comunicar com a empresa.

ClipCapIt-230714-102126.PNG


O e-mail que a Stone enviará é esse:

ClipCapIt-230727-102504.PNG


Na próxima sincronização, que ocorre sempre às 07:00, o ContaHUB baixará os extratos do mes corrente.

É possível rodar a sincronização manualmente, inclusive de meses anteriores:

ClipCapIt-230714-102551.PNG


Os efeitos são observados na tela Gerência ... Pagamentos no Turno.

Os relatórios de Fluxo financeiro serão sensibilizados por essa rotinas e será possível ver as taxas aplicadas, as datas de crédito, etc:

ClipCapIt-230714-102915.PNG


Não é necessário Processar as transações. Isso é feito automaticamente à medida que os arquivos são baixados.

iFood

No iFood, possuimos 2 tipos de integração.

Você pode copiar e colar os pedidos diretamente do Gestor de Pedidos, ou pode receber e confirmar os pedidos diretamente no ContaHUB.

O primeiro tipo de integração, mais indicado para casas com pouco volume, é gratuito, pois não gera custos adicionais em uso de banda dos servidores do sistema.

O segundo tipo tem uma taxa pequena de R$50 por loja integrada.


Integrações :: iFood :: Como configurar o iFood no modo Copiar/Colar

Integrações :: iFood :: Como configurar o iFood no modo Servidor/Servidor

Integrações :: iFood :: Códigos PDV


Efí (GerenciaNet)

Para cobrar com PIX e integrar o ContaHUB diretamente com o Banco, abra uma conta no App do EFI para Android ou iPhone: https://sejaefi.com.br/

EFI (Antigo GerenciaNet) é uma fintech inovadora e praticamente a única que permitiu a integração automática.


O que você precisa:

  1. Chave Pix (gerado no App EFI)
  2. App ContaHUB (criado no site EFI - utilize um computador)
  3. Dar as permissões para o ContaHUB acessar o Pix e os Extratos (no site EFI)
  4. Client Id + Client Secret do APP (pegar no site EFI)
  5. Certificado digital GN (criação e download no site EFI)
  6. Incluir a Integração EFI no ContaHUB (Configurações... Plataformas Abertas)


Para abrir a conta, instale o App (Android [1] ou iPhone [2])

Toda a abertura de conta deve ser feita pelo Sócio Administrador


EFÍ - criar a chave Pix

  • No Aplicativo de Celular do EFÍ-GerenciaNet, crie uma chave (aleatória de preferencia para evitar que o cliente utilize seu CNPJ e só consiga pagar o valor das comandas):
ClipCapIt-210316-152524.PNG


Acesse o site do EFI e siga os passos abaixo:

EFI - configurações do App

  • Crie a Aplicação "ContaHUB" em sua conta EFI:
ClipCapIt-230728-085652.PNG


ClipCapIt-230728-085803.PNG


ClipCapIt-230728-085915.PNG


ClipCapIt-230728-090342.PNG


  • Após a criação da aplicação, copie as credenciais CLIENT SECRET e CLIENT ID
ClipCapIt-241106-165950.PNG


  • O próximo passo é gerar um certificado digital junto à EFI:
ClipCapIt-210316-112207.PNG


EFÍ - configurar o ContaHUB

  • E fazer o upload desde junto com os dados das credenciais e a chave em CONFIGURAÇÕES ... PLATAFORMAS ABERTAS:
ClipCapIt-241106-165927.PNG

Banco Inter Empresas

Crie o ContaHUB como um App no seu internet banking:

ClipCapIt-230213-124301.PNG


ClipCapIt-230213-124345.PNG


ClipCapIt-230213-124457.PNG


ClipCapIt-230213-124534.PNG


ClipCapIt-230213-124606.PNG


Para que o ContaHUB possa acessar sua conta, é necessário dar as permissões e baixar os certificados:

ClipCapIt-230213-124643.PNG


Os certificados gerados pelo Inter (vem em um arquivo ZIP) têm validade de 1 ano e só podem ser baixados uma única vez, entao, assegure-se que saberá localizar o arquivo no seu computador:

ClipCapIt-230213-124709.PNG


Envie-nos esse arquivo:

ClipCapIt-230213-124811.PNG


O App ficará em VALIDAÇÃO até que o Inter libere. Copie as Chaves e insira no ContaHUB:

ClipCapIt-230213-130551.PNG
ClipCapIt-230213-130739.PNG


O certificado será carregado pelo suporte do ContaHUB.


Por fim, configure a forma de pagamento:

{"pix":{"x":"Inter","chave":"COLOQUE A CHAVE AQUI"}}

ClipCapIt-230213-134358.PNG


Os pagamentos passarao a ser alimentados automaticamente:

ClipCapIt-230213-134838.PNG


  • Com o Inter, não é possível fazer DEVOLUÇÃO


Beer Pass

Configure seu Beerpass com os códigos de produtos no ContaHUB e certifique-se que o prduto está Ativo, é para Venda, e está com Entrega Imediata ativada, além do preço unitário de venda, que deve ser igual (verifique mais adiante uma alternativa para preços variáveis):

ClipCapIt-210521-105739.PNG


ClipCapIt-210520-130327.PNG
ClipCapIt-210520-130217.PNG



Configure, no Beerpass, o Servidor do ContaHUB e a Chave de Integração.

Solicite a URL ao Suporte do ContaHUB.

Normalmente é: https://sp.contahub.com/rest/contahub.a.BeerCmd/beerpass

ClipCapIt-240119-101628.PNG

Configure o Token de Acesso no ContaHUB:


ClipCapIt-210520-123319.PNG


ClipCapIt-210520-125230.PNG



Ao chegar um Consumo do Beerpass, você pode analisar seu conteúdo e resultado em Gerencia > Integrações:

ClipCapIt-210520-123610.PNG


E isso se reflete em uma Venda no sistema, que, caso não esteja, será aberta e lançado o produto:

ClipCapIt-210520-123903.PNG




Erro de Turno Fechado

Caso o Turno não esteja aberto no estabelecimento, o Consumo não será lançado e é possível ver as mensagens de erro aqui:

ClipCapIt-210520-122637.PNG

Para corrigir, só é necessário abri o Turno. O Beerpass reenviará automaticamente a mensagem e, com o Turno aberto, o consumo será registrado.


Erro de Produto Inexistente

Em caso de um produto cujo código de integração colocado no Beerpass não corresponde a um produto no ContaHUB, haverá um erro irrecuperável nesse consumo e será apontado por:

ClipCapIt-210520-122211.PNG

Ao clicar sobre o registro, é possível ver os dados do consumo e lançar manualmente:

ClipCapIt-210520-122345.PNG


No Beerpass, libere a torneira:

ClipCapIt-210520-131236.PNG


Erro de Preço Divergente

Ao chegar um lançamento de um item, o ContaHUB verifica se os preços são os mesmos, a fim de garantir que os dois sistemas não tenham divergências.

Em alguns casos, pode ser interessante controlar isso somente pelo Beer Pass (exemplo: Happy Hour).

Nesse caso, utilize o campo IdExterno no produto do ContaHUB e coloque os preços que serão aceitados (utilizando "." como ponto decimal - não use vírgula).

Exemplo: um produto tem preço normal de R$25, mas em alguns horários, pode ter preço promocional. Nesse caso, preencha o IdExterno com "preco:10,16.80".

Para aceitar qualquer preço que venha do BeerPass, utilize "preco:?".

ClipCapIt-240127-180420.PNG


  • É importante manter os 2 sistemas com o mesmo preço, pois existem casos excepcionais que será necessário lançar na comanda de forma manual.