--- title: Clint slug: clint docTags: createdAt: 2025-12-09T12:40:07.895Z --- ## 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 :::hint{type="info"} Para mais informações, acesse o portal de desenvolvedores do conector: - [https://developers.tray.com.br/#como-integrar](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. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/fatW0GHe9mhkKtMkQhCUl-20260108-022402.jpg" size="70" width="480" height="270" position="center" darkWidth="480" darkHeight="270" showCaption="false"} ### Passo produtos-tray Assim ficará a Parametrização do nosso primeiro passo: ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/zmlxMRGUwhx4mEhm5t5wN-20260108-022426.jpg" size="50" width="456" height="917" position="center" darkWidth="456" darkHeight="917" showCaption="false"} ### Exemplo de conexão ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/cEFsEA0wzQUZUyKF7ZKGB-20260108-022446.jpg" size="70" width="785" height="631" position="center" darkWidth="785" darkHeight="631" showCaption="false"} ### 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.