TenkaTenka
Entrar

Central de Ajuda Tenka › Integrações › Conector de integração

Conector de integração

Conecta o Tenka a um ERP que CONTINUA dono da operação — o Tenka espelha os dados e entrega a leitura: painéis, margem, caixa, metas e o Tenkai respondendo sobre o negócio. Ninguém redigita nada: o que existe lá aparece aqui, conferido.

🕒 Atualizado em 30 de out. de 2026📖 ~4 min de leitura

A tela

A tela real, no tema que você escolheu aqui em cima.

Conector de integração

O que você encontra nesta tela

Um retrato da tela, lido dela mesma — muda quando a tela muda.

Ações disponíveis

Novo conectorSalvarTestar conexãoRemover appkey própriaDescobrir empresasCriar todas a partir da origemVincularCriarIgnorarReverterUsar as empresas confirmadasBuscar campos no ERP+5

A lista mostra

Código láNome na origemCNPJMatriz láEmpresa no TenkaSituaçãoLocal na origemDescriçãoDepósito no TenkaTOPTrilhoTipo+2

Campos do cadastro

NomeComo este conector é chamado. É o nome que aparece no acompanhamento das rodadas.
TipoQual sistema de origem este conector sabe conversar.
AmbienteSe aponta para o ambiente de produção do cliente ou para homologação.
Modo de autenticaçãoForma de autenticar na origem. Muda quais credenciais o conector exige para rodar.
URL baseEndereço do serviço de origem consultado pelo conector.
URL do clienteEndereço do ambiente do cliente, quando a instalação é própria e não em nuvem.
Usuário de serviçoUsuário usado para ler a origem. Bloqueado na origem, todas as rodadas param.
AtivoConector inativo não agenda rodada nova, e o espelho para de receber dado.
Frequência (horas)De quantas em quantas horas a rodada se repete.
RecursosQuais recursos este conector traz: parceiros, produtos, notas.
Escopo de TOPsRecorte de TOPs a trazer. Vazio traz tudo, e é aí que a carga fica grande demais para ativar.
Escopo de empresasCódigos de empresa na origem que devem ser trazidos. Vazio traz todas.
Data de corteA partir de que data o histórico é trazido. Antes dela o conector ignora o movimento.
Último sincronismoÚltima vez que este conector sincronizou com sucesso.

Comece aqui

O que esta tela responde
O seu ERP continua tocando a operação — e o Tenka enxerga tudo? Aqui você liga a ponte: informa a credencial (que fica cifrada), confirma quais empresas de lá correspondem a quais empresas daqui, escolhe o que sincronizar e classifica os tipos de operação. Depois disso, o conector roda sozinho na agenda.
O passo mais importante é a classificação (passo 5)
O sistema de origem marca cada nota com um "tipo de operação" — e nem tudo que parece venda É venda: transferência entre filiais, remessa para beneficiamento e brinde emitem nota igualzinha. Você diz o que cada tipo significa: venda, devolução, compra, produção ou ignorar. Tipo sem classificação NÃO entra — a nota fica pendente, à vista, até você decidir. É isso que impede a transferência de virar receita falsa no seu painel.

Regras

O Tenka lê e analisa; quem age é o ERP de origem
Com o conector, os títulos espelhados NÃO entram na régua de cobrança do Tenka (o seu ERP já cobra — cobrar duas vezes é o pior erro possível), notas espelhadas não geram faturamento e documentos espelhados não movimentam o estoque local (o saldo vem de lá, com o custo médio de lá). Se um dia a operação migrar para o Tenka, isso muda por decisão sua — nunca por acidente.
Empresa nunca nasce da sincronização
O conector DESCOBRE as empresas do seu ERP e as lista para você confirmar uma a uma — vincular a uma empresa existente, criar a partir dos dados de lá, ou ignorar. Registro que chegar de uma empresa não confirmada fica pendente; nada é jogado na matriz por padrão.
Escrita no ERP: o pedido do Tenka vai para o ERP
Ligue "Ligar a escrita do pedido no ERP" e informe a TOP do pedido (a de homologação primeiro), o tipo de negociação padrão e o local de estoque. A partir daí o pedido confirmado entra na fila (Integrações ▸ Pedidos enviados ao ERP), é reconferido no ERP (saldo e limite) e incluído pelo serviço Incluir Movimentos. Campo de status do pedido (opcional) é o campo próprio da TGFCAB que diz em separação, expedido, entregue; View do programa é a view que o integrador cria com o saldo de pontos/cashback de cada cliente. Sem TOP, a escrita não liga.
Onde nasce a cobrança da compra
O parâmetro Portal: forma de pagamento da compra online decide onde a cobrança nasce. Em AUTO (padrão), com a escrita no ERP ligada vale ERP: o pedido vai ao ERP, o boleto nasce lá e chega ao Tenka pela leitura do financeiro — por isso o faturamento local de um pedido já escrito no ERP não gera título (cobraria duas vezes). Sem escrita, vale ASAAS. ERP, ASAAS e AMBOS também podem ser escolhidos à mão em Configurações ▸ Parâmetros.
O ERP de ensaio (stub)
O tipo "ERP de ensaio" existe para demonstração e teste: não conversa com ERP nenhum, devolve número e status inventados de forma previsível e gera boleto com banco fictício. Os campos de servidor e credencial do Sankhya não se aplicam a ele — o aviso "falta preencher o endereço" pode ser ignorado nesse tipo. Em produção, use o tipo do ERP real com a TOP de homologação primeiro.

Perguntas frequentes

O conector vai alterar dados no meu ERP?
Não: o Tenka LÊ o ERP e espelha os dados — o ERP continua dono da operação. O que o Tenka entrega é a leitura (painéis, margem, cobrança, Tenkai). O passo mais importante é a classificação (passo 5): é ela que diz o que cada dado do ERP significa aqui.
O que é o de-para das OS importadas?
É a tabela que diz quem é, no Tenka, cada consultor, projeto e fase que o Sankhya mandou. Sugerir automaticamente casa pelo código, e-mail e nome — só quando um cadastro só confere. Salvar e ligar as OS grava as escolhas e liga, na hora, as OS que estavam esperando.
Este artigo foi útil?

No mesmo módulo: Integrações3

Academia Tenka

Trilhas de aprendizado do seu ramo, passo a passo, dentro da plataforma.

Conhecer a Academia