Sankhya

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) true 133,102 1974000962927,212 25809360758817,213 54450629611918 left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 true 330,331left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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 true 220,220,221left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type 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/