Conectores
E-commerce
Tray
20 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 schemas utilizados schema do conector /mnt/data/schema conector tray json schema da conexão /mnt/data/schema conexao tray json 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 api address url da api tray, obtida do aplicativo de integração dentro da tray consumer key chave da aplicação consumer secret chave secreta (sensível) code código de autorização aplicativo de integração dentro da tray segurança nunca registrar consumer secret em logs usar sempre https configuração de fluxo use os campos da conexão para autenticar parâmetros comuns (dependendo da operação) limit , page , sort , created , modified o conector expõe todos os recursos exatamente conforme o schema mapeamentos recomendados fluid tray product id id product sku reference / ean product price price order id id recursos e operações (extraído do schema oficial) a seguir, resumo das operações conforme schema conector tray json produtos ( products ) listar get search consultar get searchdata (req id ) criar post createprod (req actionoperation ) atualizar put updateprod (req id , actionoperation ) excluir delete deleteprod (req id ) excluir kit delete deletekit (req product parent id ) variações ( productsvariants ) listagem, consulta, criação, atualização e exclusão atenção ao limite limit máx 50 características ( productsproperties ) consultar, criar/atualizar ( property id e id quando aplicável), excluir kits ( productskits ) listar, consultar ( product parent id ), criar, atualizar ( product parent id + product id ) imagens ( productsimages ) criar/atualizar imagem de produto criar/atualizar imagem de variação remover imagens (req images\[] descrition ) pedidos ( orders ) listar consultar ( id ), consultar completo ( id ) criar ( actionoperation ) atualizar ( id + body) incluir item ( id + body) cancelar ( id ) remover item ( order id , product id ) clientes ( customers ) listar, consultar ( id ), criar, atualizar ( id ), excluir endereços listar, consultar, criar, excluir notas fiscais ( invoices ) listagem consultar ( order id + invoice id ) consultar por pedido ( id ) criar ( id + body) atualizar ( id + invoice id + body) na prática exemplo de conexão (fictício) { "api address" "https //app tray com br/web api", "consumer key" "\<customer key>", "consumer secret" "\<customer secret>", "code" "\<auth code preobtido>" } exemplo simples de listagem de produtos get {api address}/products?limit=10\&page=1 ajustar conforme autenticação esperada pela tray 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 observações adicionais verificar rate limits diretamente na documentação tray confirmar versão da api usada 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