TrayCommerce
A integração com o TrayCommerce conecta a sua conta ao idworks e sincroniza os fluxos correspondentes ao canal — credenciais, regras de sincronização de produtos, importação de pedidos, conciliação financeira e demais ações específicas dele. A configuração reúne 38 parâmetros distribuídos em 5 grupo(s).
Antes de configurar, ative a integração em Configurações → Integrações (aba Integrações Disponíveis), preencha o nome interno e (quando o tipo exigir) passe pelo fluxo de autenticação. A partir daí, os parâmetros abaixo ficam disponíveis em Configurar parâmetros.
Categoria no catálogo do idworks: E-commerce.
Índice
Conceito
Cadastro e autenticação
- Como ativar a integração?
- Como autenticar e validar as credenciais?
- Troquei a senha da Tray (ou o anúncio exporta mas não reflete): como reautenticar?
Parâmetros por grupo
- Credenciais de Acesso
- Integração de Vendas
- Integração de Produtos
- Importação de Anúncios
- Configurações Gerais
Pedidos
Referência rápida
O que é a integração TrayCommerce?
É a conexão entre o canal TrayCommerce e o idworks. Ela controla como dados fluem entre os dois sistemas — depende do tipo da integração (a categoria neste caso é E-commerce), mas em geral cobre uma combinação de credenciais, regras de sincronização, gatilhos automáticos e parâmetros de conciliação.
📍 Onde: menu lateral → Configurações → Integrações → aba Integrações Disponíveis → TrayCommerce.
Como ativar a integração?
- Acesse Configurações → Integrações.
- Na aba Integrações Disponíveis, busque por TrayCommerce e clique no botão +.
- Preencha:
- Conta (apenas multi-conta) — empresa dona da integração.
- Nome da Integração — texto livre. Útil para distinguir várias instâncias do mesmo tipo.
- Clique em Salvar.
A integração aparece imediatamente em Minhas Integrações. Dependendo do tipo, o status inicial é Ativo (quando só requer credencial fixa) ou Não Autenticado (quando depende de autenticação externa).
Pré-requisito: privilégio Criar parametrizações empresa.
Como autenticar e validar as credenciais?
Preencha o grupo Credenciais de Acesso (ver tabela abaixo). Quando a integração pede uma autorização externa (o canal abre a tela de login dele para você liberar o acesso), clique em Autenticar Integração na linha da integração (ícone de cadeado) — uma nova aba abre o login do canal e, ao confirmar, a conexão fica liberada. Para integrações com credencial fixa (usuário/senha/chave), basta preencher os campos e salvar.
Depois de salvar, use a ação Validar credenciais (quando disponível) para confirmar que o canal responde. O status na listagem reflete o resultado: Ativo = OK, Erro = credencial inválida ou revogada, Não Autenticado = falta concluir o fluxo de autorização.
Pré-requisito: privilégio Editar parametrizações empresa.
Troquei a senha da Tray (ou o anúncio exporta mas não reflete): como reautenticar?
Dois sintomas comuns indicam que a integração com a Tray precisa ser autenticada de novo:
- você trocou a senha da sua loja na Tray (a cada troca de senha a autorização cai); ou
- o anúncio exporta como "concluído" no idworks, mas não aparece na sua loja Tray.
Em ambos os casos, abra Configurações → Integrações → Minhas Integrações e confira o Status da integração Tray. Quando estiver em Erro ou Não Autenticado, refaça a autenticação:
- Na linha da integração Tray, clique em Autenticar Integração (ícone de cadeado).
- Vai abrir uma página com a mensagem "Forbidden" — isso é esperado neste momento, não é um erro.
- Olhe a barra de endereços do navegador dessa página. Por padrão, o endereço começa com um subdomínio do idworks (algo como
nomedaloja.api-idworks.com.br). - Edite esse endereço trocando essa primeira parte pelo endereço do seu próprio site na Tray (por exemplo:
www.minhaloja.com.br). Mantenha o restante do endereço como está. - Pressione Enter.
- Você será redirecionado corretamente para a sua loja na Tray, onde conclui a autorização da integração.
- Volte ao idworks e confirme que o Status da integração voltou para Ativo.
Depois disso, os anúncios voltam a exportar de verdade para a Tray e as demais ações automáticas voltam a funcionar. Você não precisa recadastrar a integração nem refazer os mapeamentos — eles continuam preservados. Como a troca de senha derruba a autorização, repita esse processo sempre que mudar a senha da Tray.
Credenciais de Acesso
2 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Código da empresa na plataforma | Inteiro | Código da empresa na plataforma, o número na URL do painel admin |
| Validar credenciais | Botão | Clique para validar as credenciais informadas |
Integração de Vendas
15 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Empresa Faturadora | Lista | Empresa responsável pelo faturamento dos pedidos, caso seja diferente da principal. |
| Importar pedidos | Sim/Não | Ative se quiser que a idworks integre os pedidos feitos no canal de vendas. |
| Lista de status para importar pedido | Texto | Informar os status que deve baixar pedidos. Informar separado por vírgula. Exemplo: A Enviar,Enviado,etc |
| ID status para mudar após envio | Texto | Informar o ID (código) do status para mudar o pedido após expedição |
| Incluir valor de juros no pedido | Sim/Não | Ative se quiser Incluir valor de juros no pedido |
| Utilizar o código de referência na importação | Sim/Não | Utilizar o código de referência ao invés do código da plataforma ao importar e criar um novo pedido |
| Excluir valor frete na NF para PF | Sim/Não | Ative se quiser excluir o valor do frete na Nota Fiscal quando a venda por para pessoa física (PF) |
| ID status após importar pedido | Texto | Informar o ID (código) do status após importar o pedido |
| ID Status pedido Entregue | Texto | Informar o ID (código) do status para mudar o pedido após entrega |
| Fechar pedido automaticamente | Sim/Não | Quando marcado, o idworks fecha o pedido integrado do canal de vendas através do hub. Se desmarcado, o pedido quando integrado permanece com o status de aberto para atualização manual. |
| Incluir valor de desconto por cupons | Sim/Não | Ative se quiser incluir o valor de desconto aplicado por cupons ao pedido. |
| Incluir valor de desconto por método de pagamento | Sim/Não | Ative se quiser incluir o valor de desconto aplicado por método de pagamento ao pedido |
| Utilizar o id da transportadora da cotação | Sim/Não | Ative para utilizar o código da transportadora da cotação ao importar o pedido |
| Margem mínima desejável | % | Percentual mínimo de margem de contribuição para os pedidos desta integração. Quando a margem do pedido fica abaixo do valor configurado, o pedido é enviado para aprovação de margem em vez de seguir o fluxo automático. |
| Checar taxa/imposto efetivo do pedido | Sim/Não | Ao ativar, o sistema valida a margem de contribuição no fechamento do pedido. Exige que a Margem mínima desejável (ou a taxa efetiva) esteja preenchida. |
Integração de Produtos
16 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Valor de ajuste no preço | Decimal | Valor em R$ fixo a ser somado ao preço por (base / original) para compor o preço de venda, se existir cobrança de frete |
| Percentual de ajuste no preço | % | Valor percentual a ser somado ao preço por (base / original) para compor o preço de venda, se existir cobrança de frete |
| Arredondamento dos centavos do preço | Decimal | Valor em centavos para arredondar o preço de venda. Preencha entre 0,01 e 0,99. |
| Atualizar saldo estoque | Sim/Não | Ative se quiser enviar a atualização de saldo de estoque na integração. |
| Atualizar descrição | Sim/Não | Ative se quiser enviar a atualização da descrição do produto na integração |
| Atualizar Imagem | Sim/Não | Ative se quiser enviar a atualização de imagem na integração |
| Atualizar preço | Sim/Não | Ative se quiser enviar a atualização de preço na integração |
| Atualizar produto | Sim/Não | Ative se quiser enviar a atualização de produto na integração |
| Atualizar Especificações (atributos) | Sim/Não | Ative se quiser enviar a atualização de especificações na integração |
| Atualizar categoria | Sim/Não | Ative se quiser enviar a atualização de categoria na integração |
| Atualizar marca | Sim/Não | Ative se quiser enviar atualização de marca na integração |
| Iframe para video | Texto | Insira o iframe para que seja enviada a URL do video. Utilize a variável {{url}} para substituir pela URL no cadastro do produto |
| Incluir palavras chaves substitutas geradas | Sim/Não | Ative se quiser incluir palavras chaves substitutas geradas automaticamente para erro de digitação |
| Utilizar título como nome SKU | Sim/Não | Utilizar o campo título como nome do SKU ao enviar para o canal |
| Armazéns para somar quantidade | Lista múltipla | Selecionar os armazéns que deve somar a quantidade para enviar aos canais de venda. Caso não seja preenchido, será enviado a quantidade do armazém que esta no de/para |
| Percentual disponibilidade de estoque | % | Valor base para utilizar do estoque em percentual. Ex. se tiver 100 unidades disponíveis e o percentual for 80% será enviado 80 para o canal |
Importação de Anúncios
4 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Incluir Preços na ficha do Anúncio | Sim/Não | Traz o preço do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado preço definido pela política comercial do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Título na ficha do Anúncio | Sim/Não | Traz o título do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Nome do cadastro do produto no momento da sincronização do anúncio. |
| Incluir Descrição na Ficha do Anúncio. | Sim/Não | Traz o descrição do anúncio publicado para dentro da ficha do anúncio no sistema. Caso não habilite, será utilizado o campo Descrição do cadastro do produto no momento da sincronização do anúncio. |
| **Importar somente anúncios inexistente dentro da ** | Sim/Não | Só importa anúncios que ainda não estão cadastrados no sistema. |
Configurações Gerais
1 parâmetro(s).
| Parâmetro | Tipo | Para que serve |
|---|---|---|
| Url para cotação de frete | Cópia | URL para enviar ao canal de vendas para cotação de frete com as regras e tabelas na idworks |
Quais pedidos a importação automática varre?
Com Importar pedidos ativo, cada rodada da importação consulta a Tray pelos status informados em Lista de status para importar pedido e percorre os pedidos do mais recente para o mais antigo, em blocos de 50, até o limite de 500 pedidos por rodada. Os que já existem no idworks são ignorados; os novos entram na fila de criação do pedido.
Na sequência, a mesma rodada reprocessa os pedidos incompletos da integração — aqueles que já apareceram na listagem da Tray mas ainda não viraram pedido no idworks. Por isso um pedido que falhou por dado faltando volta a ser tentado sozinho, sem você precisar reimportá-lo.
O que costuma explicar um pedido que não entrou:
| Situação | O que acontece |
|---|---|
| Lista de status para importar pedido em branco | A Tray é consultada apenas pelo status A Enviar. |
| Status do pedido fora da lista configurada | O pedido não é consultado — inclua o status na parametrização. |
| Pedido mais antigo que os 500 varridos na rodada | Não entra pela importação automática. |
Falta uma forma de pagamento da Tray no Hub Pagamento?
Ao criar o mapeamento em Integrações → Hub Pagamento, a lista de formas de pagamento do lado da Tray é buscada na hora, direto na sua loja. Ela traz as formas ativas na Tray — tanto as de cartão de crédito quanto as demais formas aceitas no pedido (boleto, Pix, depósito, pagamento na entrega) — e cada uma aparece com o mesmo nome exibido na Tray.
Se uma forma de pagamento não aparecer na lista:
- Confirme no painel da Tray que ela está ativa — formas desativadas não são listadas.
- Confira o Status da integração em Configurações → Integrações → Minhas Integrações. Com a autorização vencida, a lista volta vazia; veja Troquei a senha da Tray....
- Depois de ativar a forma na Tray, reabra a tela para a lista ser buscada de novo.
Sem o mapeamento da forma de pagamento, o pedido fica retido na integração acusando tipo de pagamento não mapeado.
Privilégios da tela
Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.
| Privilégio | Libera |
|---|---|
| Visualizar integrações | Acesso à tela de Integrações e a esta página de configuração. |
| Criar parametrizações empresa | Ativar a integração (botão + no catálogo). |
| Editar parametrizações empresa | Configurar parâmetros, editar nome e status, autenticar e validar credenciais. |
| Deletar parametrizações empresa | Excluir a integração. |