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:
-
Quais parceiros são importados
-
Campos padrão e seus nomes técnicos
-
Como solicitar campos adicionais
-
Campos de outras tabelas
-
Passo a passo: campo UF (Estado)
-
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 |
||
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. 💬