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

De ContaHUB
Ir para navegaçãoIr para pesquisar
 
(24 revisões intermediárias por 2 usuários não estão sendo mostradas)
Linha 1: Linha 1:
 +
== 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.
 +
 +
:[[File:ClipCapIt-230714-102126.PNG|450px]]
 +
 +
 +
O e-mail que a Stone enviará é esse:
 +
:[[File:ClipCapIt-230727-102504.PNG|250px]]
 +
 +
 +
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:
 +
 +
:[[File:ClipCapIt-230714-102551.PNG|400px]]
 +
 +
 +
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:
 +
 +
:[[File:ClipCapIt-230714-102915.PNG|400px]]
 +
 +
 +
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:
 +
# Chave Pix (gerado no App EFI)
 +
# App ContaHUB (criado no site EFI - utilize um computador)
 +
# Dar as permissões para o ContaHUB acessar o Pix e os Extratos (no site EFI)
 +
# Client Id + Client Secret do APP (pegar no site EFI)
 +
# Certificado digital GN (criação e download no site EFI)
 +
# 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])
 +
 +
'''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):
 +
:[[File:ClipCapIt-210316-152524.PNG|400px]]
 +
 +
 +
 +
Acesse o site do EFI e siga os passos abaixo:
 +
 +
=== EFI - configurações do App ===
 +
 +
* Crie a Aplicação "ContaHUB" em sua conta EFI:
 +
 +
:[[File:ClipCapIt-230728-085652.PNG|400px]]
 +
 +
 +
:[[File:ClipCapIt-230728-085803.PNG|400px]]
 +
 +
 +
:[[File:ClipCapIt-230728-085915.PNG|300px]]
 +
 +
 +
:[[File:ClipCapIt-230728-090342.PNG|300px]]
 +
 +
 +
 +
* Após a criação da aplicação, copie as credenciais CLIENT SECRET e CLIENT ID
 +
 +
:[[File:ClipCapIt-241106-165950.PNG]]
 +
 +
 +
 +
* O próximo passo é gerar um certificado digital junto à EFI:
 +
 +
:[[File:ClipCapIt-210316-112207.PNG|400px]]
 +
 +
 +
 +
=== EFÍ - configurar o ContaHUB ===
 +
 +
* 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 ==
 +
 +
 +
Crie o ContaHUB como um App no seu internet banking:
 +
 +
:[[File:ClipCapIt-230213-124301.PNG|400px]]
 +
 +
 +
:[[File:ClipCapIt-230213-124345.PNG|400px]]
 +
 +
 +
:[[File:ClipCapIt-230213-124457.PNG|400px]]
 +
 +
 +
:[[File:ClipCapIt-230213-124534.PNG|300px]]
 +
 +
 +
:[[File:ClipCapIt-230213-124606.PNG|300px]]
 +
 +
 +
Para que o ContaHUB possa acessar sua conta, é necessário dar as permissões e baixar os certificados:
 +
 +
:[[File:ClipCapIt-230213-124643.PNG|400px]]
 +
 +
 +
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:
 +
 +
:[[File:ClipCapIt-230213-124709.PNG|200px]]
 +
 +
 +
 +
Envie-nos esse arquivo:
 +
 +
:[[File:ClipCapIt-230213-124811.PNG|200px]]
 +
 +
 +
O App ficará em VALIDAÇÃO até que o Inter libere.
 +
Copie as Chaves e insira no ContaHUB:
 +
 +
:[[File:ClipCapIt-230213-130551.PNG|400px]]
 +
 +
:[[File:ClipCapIt-230213-130739.PNG|400px]]
 +
 +
 +
 +
O certificado será carregado pelo suporte do ContaHUB.
 +
 +
 +
Por fim, configure a forma de pagamento:
 +
 +
{"pix":{"x":"Inter","chave":"COLOQUE A CHAVE AQUI"}}
 +
 +
:[[File:ClipCapIt-230213-134358.PNG|400px]]
 +
 +
 +
Os pagamentos passarao a ser alimentados automaticamente:
 +
:[[File:ClipCapIt-230213-134838.PNG|250px]]
 +
 +
 +
* Com o Inter, não é possível fazer DEVOLUÇÃO
 +
 +
 
== 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 9: Linha 187:
  
 
:[[File:ClipCapIt-210520-130217.PNG|400px]]
 
:[[File:ClipCapIt-210520-130217.PNG|400px]]
 +
 +
<hr>
 +
  
  
 
<hr>
 
<hr>
  
−
Configure o Token de segurança (chave-integração) igual, tanto no ContaHUB como no Beerpass:
+
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
 +
 
 +
:[[File:ClipCapIt-240119-101628.PNG|400px]]
 +
 
 +
<hr>
 +
 
 +
Configure o Token de Acesso no ContaHUB:
 +
 
  
 
:[[File:ClipCapIt-210520-123319.PNG|400px]]
 
:[[File:ClipCapIt-210520-123319.PNG|400px]]
Linha 61: Linha 253:
 
:[[File:ClipCapIt-210520-131236.PNG|400px]]
 
:[[File:ClipCapIt-210520-131236.PNG|400px]]
  
−
== Cielo LIO ==
 
  
 +
=== Erro de Preço Divergente ===
  
−
== iFood ==
+
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.
  
−
No iFood, possuimos 2 tipos de integração.
+
Em alguns casos, pode ser interessante controlar isso somente pelo Beer Pass (exemplo: Happy Hour).
  
−
Você pode copiar e colar os pedidos diretamente do Gestor de Pedidos, ou pode receber e confirmar os pedidos diretamente no ContaHUB.
+
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).
  
−
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.
+
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".
  
−
O segundo tipo tem uma taxa pequena de R$50 por loja integrada.
+
Para aceitar qualquer preço que venha do BeerPass, utilize "preco:?".
  
 +
:[[File:ClipCapIt-240127-180420.PNG|400px]]
  
−
[[Integrações :: iFood :: Como configurar o iFood no modo Copiar/Colar]]
 
−
 
−
[[Integrações :: iFood :: Como configurar o iFood no modo Servidor/Servidor]]
 
  
−
== GerênciaNet ==
+
*É 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.
Disponível em “https://wiki.contahub.com/index.php?title=Integrações&oldid=2933”