Principal Campanhas Guia técnico de campos | Integração Sankhya

Guia técnico de campos | Integração Sankhya

Última atualização em Oct 22, 2026

Este guia é para o administrador ou time de TI do Sankhya da sua empresa. Se você só quer saber quais informações vêm para a Flowbiz e como pedir novas, veja Entendendo os campos da integração com o Sankhya.

Aqui você encontra:

  1. Quais parceiros são importados

  2. Campos padrão e seus nomes técnicos

  3. Como solicitar campos adicionais

  4. Campos de outras tabelas

  5. Passo a passo: campo UF (Estado)

  6. Checklist da solicitação

1. Quais parceiros são importados

A integração lê a tabela de parceiros (TGFPAR) e importa os registros que atendem a estas condições:

Campo Condição Significado
CLIENTE = 'S' Parceiro marcado como cliente
ATIVO = 'S' Parceiro ativo
DTCAD = data atual Parceiro cadastrado no dia

🔄 Importar também os parceiros alterados? Por padrão, a integração considera a data de cadastro (DTCAD). Se você precisa que os parceiros alterados no dia também sejam enviados, a data de alteração (DTALTER) pode ser usada no lugar. Peça esse ajuste ao time Flowbiz.

Nesse modo:

  • cada sincronização traz os parceiros criados ou alterados desde a última sincronização concluída com sucesso;

  • excluir um contato da lista na Flowbiz não faz ele voltar na próxima sincronização. Ele só volta se o cadastro for alterado no Sankhya ou por uma nova importação via arquivo.

2. Campos padrão e seus nomes técnicos

Campos que viram coluna na lista da Flowbiz

Estas colunas são criadas na lista de clientes durante a implantação:

Campo técnico (TGFPAR) Descrição Coluna na Flowbiz
NOMEPARC Nome do parceiro Nome
EMAIL E-mail E-mail
TELEFONE Telefone Telefone
TIPPESSOA Tipo de pessoa (F/J) Tipo de pessoa
CEP CEP CEP
CODCID/NOMECID Cidade Cidade
DTNASC Data de nascimento Data de nascimento
SEXO Sexo Genero

ℹ️ Sobre a cidade: o CODCID é um código. O nome que chega à Flowbiz é o campo de apresentação da cidade, configurado no Dicionário de Dados do seu Sankhya. Se a cidade estiver vindo num formato inesperado, confira essa configuração.

Campos de uso interno

Por padrão, estes campos são lidos em nossa integração para identificar o parceiro e filtrar a importação, mas não aparecem como coluna na lista:

Campo técnico Para que é usado
CODPARC Identificar o parceiro (chave)
CLIENTE Filtrar só clientes
ATIVO Filtrar só ativos
DTCAD Selecionar os cadastrados no dia
DTALTER Disponível para trocar o critério para “alterados no dia”

Se quiser algum deles como coluna (ex.: o código do parceiro), solicite como campo adicional.

3. Como solicitar campos adicionais

Qualquer outro campo da TGFPAR pode ser solicitado, inclusive os campos personalizados criados pela sua empresa, que no Sankhya geralmente começam com AD_.

A lista completa de campos padrão da tabela está na documentação oficial: Tabela TGFPAR (Sankhya) ou conforme a parametrização realizada pelo TI em sua base.

Formato da solicitação

Envie cada campo no formato:

Campo técnico no Sankhya = Nome da coluna na Flowbiz

Exemplos:

CODPARC = Código do Parceiro
RAZAOSOCIAL = Razão Social
AD_SEGMENTO = Segmento

Importante:

  • O mapeamento é sempre feito pelo nome técnico do campo no Sankhya.

  • Na Flowbiz, a coluna pode ter o nome que fizer mais sentido para a sua operação.

  • Para campos AD_, informe o nome técnico completo, com o prefixo.

4. Campos de outras tabelas

Existir uma relação com a TGFPAR não basta para que a informação de outra tabela possa ser integrada. O que importa é quantos registros existem por parceiro:

Tipo de relação Exemplo Pode ser integrado?
Um registro por parceiro Cidade do parceiro → UF (TSICID → TSIUFS) ✅ Sim
Vários registros por parceiro Contatos (TGFCTT), endereços, pedidos ⚠️ Só se houver uma regra que defina qual registro usar (ex.: o mais recente, o principal)

Caminho recomendado: campo calculado na TGFPAR

Para relações de um registro por parceiro, a forma mais simples é criar no Sankhya um campo adicional na TGFPAR que busca a informação na outra tabela. Ele passa a ser um campo AD_ do parceiro e pode ser solicitado normalmente, como na seção 3.

O exemplo mais comum é o Estado (UF), detalhado a seguir.

5. Passo a passo: campo UF (Estado)

No Sankhya, a UF não fica no cadastro do parceiro: o caminho é parceiro → cidade → UF. Para trazer essa informação:

Passo 1. Crie o campo calculado seguindo o tutorial oficial
👉 Como personalizar criando um campo UF no cadastro de Parceiro? (Ajuda Sankhya)

Passo 2. Ajuste a expressão para retornar só a sigla
A expressão do tutorial retorna o Estado no formato MG-MINAS GERAIS. Para segmentação, recomendamos só a sigla (MG). Use esta expressão no campo calculado:

$sql.select("UFS.UF", "TSIUFS UFS INNER JOIN TSICID CID ON CID.UF = UFS.CODUF", "CID.CODCID = {CODCID}")

Passo 3. Reinicie a Unidade de Dados
Depois de salvar ou editar o campo, reinicie a Unidade de Dados para a alteração valer.

Passo 4. Confira e solicite
Abra alguns parceiros e confira se o campo mostra a sigla correta. Depois envie a solicitação com o nome técnico final do campo, por exemplo:

AD_UF = Estado

💡 O nome final do campo depende de como ele foi criado. O Sankhya acrescenta o prefixo AD_ ao nome informado. Confira no Dicionário de Dados antes de enviar.

6. Checklist da solicitação

Campo da TGFPAR (padrão ou AD_):

  • Nome técnico do campo

  • Nome desejado para a coluna na Flowbiz

Campo de outra tabela:

  • Nome técnico do campo

  • Tabela de origem

  • Como a tabela se relaciona com a TGFPAR

  • Se existe um ou vários registros por parceiro (e, se forem vários, qual regra usar)

  • Nome desejado para a coluna na Flowbiz

Se o campo estiver em outra tabela e for um registro por parceiro, considere criar um campo novo na TGFPAR (seção 4). Normalmente é o caminho mais rápido.

Envie a solicitação ao analista da sua implantação ou pelo chat da ferramenta. Nosso time avalia a viabilidade e cria a coluna na lista. 💬