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:
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.