Conectores
CRM
Clint
14 min
objetivo o conector tray integra a plataforma fluid com a api da tray, permitindo operações de leitura, criação, atualização e exclusão sobre recursos de catálogo, pedidos e clientes documentação oficial da api para mais informações, acesse o portal de desenvolvedores do conector https //developers tray com br/#como integrar requisitos (conexão) método de autenticação a tray utiliza consumer key , consumer secret e um code código do aplicativo, obtido pelo cliente campos obrigatórios (schema da conexão) campo descrição endereço api tray url da api tray, obtida do aplicativo de integração dentro da tray chave da aplicação chave da aplicação (customer key) chave secreta da aplicação chave secreta (sensível) código de autorização código de autorização aplicativo de integração dentro da tray configuração de fluxo use os campos da conexão para autenticar parâmetros comuns (dependendo da operação) limite de registros , página corrente , ordenação , data de criação , data de modificação recursos e operações a seguir, resumo das operações disponíveis no conector produtos listagem de produtos lista dos produtos cadastrados consultar dados do produto consultar dados do produto pelo código (obrigatório informar o código do produto ) cadastrar produto cadastrar um novo produto atualizar dados do produto atualizar dados do produto pelo código (obrigatório informar o código do produto ) exclusão de produto exclusão de produto pelo código (obrigatório informar o código do produto ) exclusão de kit exclusão de kit de um produto (obrigatório informar o código do produto pai ) variação de produtos listagem de variações listagem das variações consultar dados da variação consultar dados da variação pelo código (obrigatório informar o código da variação do produto ) cadastrar variação cadastrar variação do produto atualizar dados da variação atualizar dados da variação (obrigatório informar o código da variação do produto ) excluir variação excluir variação do produto (obrigatório informar o código da variação do produto ) atenção ao limite limit máx 50 características de produtos consultar características do produto consultar características do produto cadastrar/atualizar características de produtos cadastrar/atualizar características de produtos (obrigatório informar o código do produto e código da característica do produto ) criar característica criar característica excluir característica excluir característica (obrigatório informar o código da característica ) kits de produtos listagem geral de kits listagem geral de kits consultar dados do kit consultar dados do kit (obrigatório informar o código do kit ) cadastrar kit cadastrar kit atualizar dados do kit atualizar dados do kit (obrigatório informar o código do kit e código do produto principal ) imagem de produto cadastro e atualização de imagem de produto cadastro e atualização de imagem de produto (obrigatório preencher o campo incluir imagens ) cadastro e atualização de imagem da variação cadastro e atualização de imagem da variação (obrigatório preencher o campo incluir imagens ) remoção de imagens remoção de imagens (obrigatório preencher o campo incluir a remover ) pedidos listagem de pedidos listagem de pedidos consultar dados do pedido consultar dados do pedido (obrigatório informar o código do pedido ) consultar dados completo do pedido consultar dados completo do pedido (obrigatório informar o código do pedido ) cadastrar pedido cadastrar pedido atualizar dados do pedido atualizar dados do pedido (obrigatório informar o código do pedido ) incluir produtos no pedido incluir produtos no pedido (obrigatório informar o código do pedido ) cancelar pedido cancelar pedido (obrigatório informar o código do pedido ) exclusão produto do pedido exclusão produto do pedido (obrigatório informar o código do pedido e código do produto ) clientes listagem de clientes listagem de clientes consultar dados do cliente consultar dados do cliente (obrigatório informar o código do cliente ) cadastrar cliente cadastrar cliente atualizar dados do cliente atualizar dados do cliente (obrigatório informar o código do cliente ) excluir cliente excluir cliente (obrigatório informar o código do cliente ) listagem de endereços de cliente listagem de endereços de cliente obrigatório informar o atributos do endereço do cliente ) consultar dados do endereço de um cliente consultar dados do endereço de um cliente (obrigatório informar o código do endereço do cliente ) cadastrar endereço cadastrar endereço (obrigatório informar o código do cliente ) excluir endereço excluir endereço (obrigatório informar o código do endereço do cliente ) nota fiscal listagem de notas fiscais listagem de notas fiscais consultar dados da nota fiscal consultar dados da nota fiscal (obrigatório informar o código do pedido e código da nota fiscal ) consultar nota por pedido consultar nota por pedido (obrigatório informar o código do pedido ) cadastrar nota fiscal cadastrar nota fiscal (obrigatório informar o código do pedido ) atualizar dados da nota fiscal atualizar dados da nota fiscal (obrigatório informar o código do pedido e código da nota fiscal ) na prática neste tópico criaremos um fluxo utilizando o conetor tray o fluxo terá somente um passo, onde o objetivo será listar os produtos criados na tray passo produtos tray assim ficará a parametrização do nosso primeiro passo exemplo de conexão boas práticas validar formatos de data usar ids retornados para futuras operações aplicar retry/backoff disparo do fluxo pode ser acionado via eventos, webhooks, agendamentos ou manualmente (conforme fluid) recomendações de teste iniciar com limit=1 e validar headers e body conclusão o conector tray fornece integração completa entre a fluid e a api tray, permitindo sincronização de catálogo, pedidos e clientes com controles detalhados
