Sankhya (Legado)

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 acesso ao ambiente sankhya ter um usuário com permissões administrativas ou de desenvolvedor para acessar o console de apis credenciais de integração possuir as chaves appkey e o token de acesso (ou bearer token) gerados no ambiente sankhya definição de parâmetros identificar se o seu tenant utiliza o padrão de cabeçalho token ou authorization bearer \<token> configuração de rede certificar se de que a url base do sankhya está acessível para a fluid (verificar necessidade de proxy/whitelist) como configurar no painel da fluid acesse conexões > nova conexão > sankhya em autenticação http , selecione a opção api key em definir parâmetros em , escolha a opção cabeçalho (header) em chaves , adicione os seguintes parâmetros appkey → insira o valor da sua appkey registrada no sankhya token → insira o valor do token de acesso observação caso seu ambiente utilize o padrão bearer, use a chave authorization com o valor bearer \<seu token> (opcional) requisição deixe sem preenchimento no cadastro da conexão os passos do conector definem verbo, url, corpo e cabeçalhos para cada operação (opcional) cache mantenha desabilitado por padrão ative somente para consultas; defina expiração e caminho no response para armazenamento (opcional) opções avançadas e proxy configure apenas se sua rede exigir clique em salvar conexão e utilize o botão testar para validar a comunicação campos de entrada (conexão) campo obrigatório onde informar descrição token sim chaves (header) token de acesso do sankhya preferir token de serviço com permissões mínimas appkey sim chaves (header) chave do aplicativo registrada na plataforma sankhya usuário quando exigido corpo do passo utilizado apenas em ambientes que requerem sessão por login direto senha quando exigido corpo do passo utilizado apenas em ambientes que requerem sessão por login direto 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/