Conectores
ERP
Sankhya
11 min
introdução o conector sankhya integra a fluid à api do sankhya , permitindo automatizar cadastros, consultas e atualizações de dados (clientes, produtos, pedidos e outros) pré requisitos para conectar o sankhya à fluid, certifique se de possuir os seguintes itens e acessos acesso à área do desenvolvedor sankhya necessário para gerar o client id e o client secret da sua aplicação credenciais do gateway acesso à tela configurações gateway dentro do sankhya om (ou sistemas do grupo sankhya) para obter o x token permissões de usuário o usuário vinculado às chaves deve ter permissões ativas no sankhya para os recursos que serão manipulados (ex clientes, pedidos) definição de ambiente identificar se a conexão será feita em ambiente de testes ( sandbox ) ou em operação real ( produção ) como configurar no painel da fluid acesse conexões > nova conexão > sankhya em chaves , adicione id do client → valor do client id chave secreta do cliente → valor do client secret x token → token obtido na tela configurações gateway do sankhya om (ou de outros sistemas do grupo sankhya) ambiente → tipo de ambiente sandbox ou produção observação client id e client secret podem ser gerados na área do desenvolvedor da sankhya (opcional) opções avançadas e proxy configure apenas se sua rede exigir clique em salvar conexão e utilize testar para validar campos de entrada (conexão) campo obrigatório origem do dado descrição id do client sim área do desenvolvedor sankhya o identificador único ( client id ) da sua aplicação chave secreta sim área do desenvolvedor sankhya a senha de acesso ( client secret ) da sua aplicação x token sim configurações gateway (sankhya om) token de autenticação para comunicação com o gateway ambiente sim seleção no sistema define o destino das requisições sandbox ou produção nota verbo, url, corpo e cabeçalhos específicos são definidos por passo conforme o recurso/ação campos de saída o passo sankhya retorna o corpo de resposta da api do sankhya estrutura comum { "status" "success|error", "data" { / objeto ou lista retornada pelo recurso / }, "errors" \[ { "code" " ", "message" " " } ] } a estrutura exata pode variar por recurso/versão da api utilize o transform da fluid para normalizar o retorno conforme seu domínio recursos e operações lista consolidada dos recursos suportados e suas operações recurso operações bairro cadastro, consulta banco consulta centro de resultados consulta cidade cadastro, consulta cfop consulta clientes consulta contato clientes cadastro, consulta como fazer alteração/inclusão de dados? altera/inclui como fazer consulta de dados? consulta tabela de preço consulta usuário consulta consulta de histórico de logs consulta empresa consulta endereço cadastro, consulta estoque consulta fornecedores cadastro, consulta kit de produtos cadastro, consulta motorista cadastro, consulta inclusão e alteração do item do pedido inclusão/alteração natureza consulta pedidos cadastro, consulta observação recursos e escopos dependem da habilitação no seu ambiente sankhya exemplo de uso aguardando exemplos reais para publicação assim que fornecidos, serão incluídos os cenários mínimos clientes > consulta com filtros e paginação pedidos > cadastro com itens (arrays) e observações possíveis erros código/tipo causa provável ação sugerida 401 não autorizado token/appkey inválidos ou expirados revogue e gere novo token confira usuário/senha e appkey 403 proibido usuário sem permissão para o recurso ajuste perfis no sankhya ou solicite liberação do módulo 404 não encontrado recurso/registro inexistente valide chaves (ex código do cliente) e filtros 409 conflito duplicidade em cadastro inclua lógica de upsert/consulta prévia 422 dados inválidos esquema incompatível, campos obrigatórios ausentes aplique validação json no passo e corrija o payload 429 limite de requisições rate limit do ambiente implemente retries exponenciais e backoff 5xx erro no provedor indisponibilidade momentânea re tente, acione monitoramento e fallback boas práticas segurança restrinja o acesso às credenciais e faça rotação periódica do token observabilidade habilite logs de requisição/resposta e correle ids de execução do fluxo paginação padronize limit e offset para grandes volumes resiliência implemente retries com backoff e circuit breaker em integrações críticas normalização use o transformer da fluid para mapear campos sankhya → domínio do seu negócio validações e conformidade o passo suporta corpo dinâmico , template e validação json para objetos e arrays aninhados recomenda se validar tipos, obrigatoriedade e formatos (datas, cnpj/cpf, cep) antes do envio referências api oficial sankhya https //developer sankhya com br/