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) true 94,100 59475806451613,159 498081327356,306 9071606081279 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,331 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type 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,221 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type 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/