Conectores
E-commerce
Tray
15 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 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) 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 (incluir aqui a imagem 1) passo produtos tray assim ficará a parametrização do nosso primeiro passo (incluir aqui a imagem 2) exemplo de conexão (incluir aqui a imagem 3) 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
