Erro "Array to string conversion" ao criar anúncios na Shopee

Base de Conhecimento Tray
Base de Conhecimento Tray
Atualizado 

Se você está tentando publicar um produto na Shopee pela Tray e recebe a mensagem "Array to string conversion", o erro indica que alguma informação necessária para o anúncio está vazia, ausente ou configurada de forma incompatível com o que a Shopee espera receber. O anúncio não é criado e o envio é bloqueado.

Este artigo explica o que verificar antes de acionar o suporte e como abrir o chamado com as informações certas.


O que significa esse erro?

Em termos práticos: a Shopee esperava receber um valor específico em algum campo do produto — como uma característica obrigatória, atributo de categoria ou informação de variação — e esse valor não foi encontrado ou chegou em formato inesperado. O sistema não conseguiu montar o anúncio e retornou o erro.

Não é necessário entender a parte técnica. O que importa é identificar qual campo está faltando ou mal configurado.


O que verificar antes de acionar o suporte

Percorra os pontos abaixo na ordem. Eles cobrem as causas mais comuns desse erro na integração Tray > Shopee.

1. Relacionamento de características obrigatórias

Antes de criar anúncios, é obrigatório relacionar as características do produto Tray aos campos correspondentes da Shopee. As características obrigatórias aparecem expandidas na tela de relacionamento — as opcionais ficam agrupadas em um bloco recolhido.

Verifique: todas as características marcadas como obrigatórias estão relacionadas e preenchidas no produto? Há algum campo obrigatório em branco ou sem correspondência configurada?

2. Relacionamento de categorias

O relacionamento entre categorias da sua loja Tray e as categorias da Shopee é obrigatório e precisa estar feito antes da publicação. Cada categoria da Shopee pode ter atributos obrigatórios diferentes — e se o produto estiver em uma categoria sem esse vínculo configurado, o envio falha.

Verifique: a categoria do produto tem relacionamento ativo com uma categoria da Shopee? A categoria está disponível e aceita pelo marketplace?

3. Variações incompletas

A Shopee aceita produtos com até 50 variações. Se o produto tem variações, todas precisam ter preço e estoque definidos. Uma variação sem esses dados pode impedir o envio de todo o anúncio.

Verifique: todas as variações do produto têm preço e estoque preenchidos? O número de variações não ultrapassa 50?

4. Imagem e preço no produto

Produtos sem imagem ou sem preço são bloqueados automaticamente antes mesmo de chegar à Shopee. Confirme que o produto tem ao menos uma imagem e um preço cadastrado na Tray.


Se as verificações acima não resolverem

O erro "Array to string conversion" pode indicar um comportamento inesperado na integração que exige análise técnica pelo time de suporte. Nesse caso, abra um chamado informando:

  • Nome e número do produto que gerou o erro
  • Categoria do produto na Tray e a categoria da Shopee à qual está relacionada
  • Print da mensagem de erro na tela
  • O que você estava fazendo quando o erro apareceu (criando anúncio manualmente, publicando em lote, etc.)
  • Se o erro ocorre com um produto específico ou com todos ao tentar publicar na Shopee

Para abrir o chamado, acesse os canais de atendimento da Tray em tray.com.br/contato ou consulte este artigo.

Descreva exatamente o produto afetado e qual etapa do processo gerou o erro. Quanto mais contexto o suporte receber, mais rápido o time de integração consegue identificar e resolver o problema.


Perguntas frequentes

Confira as respostas para as principais dúvidas sobre a publicação e correção de erros de produtos na Shopee:

  • Se acontece apenas com determinados produtos, a causa provavelmente está no cadastro daquele produto — um campo vazio, variação incompleta ou característica obrigatória sem relacionamento. Se ocorre com todos ao tentar publicar, pode ser um problema na configuração geral da integração.
  • Sim. Corrija o que foi identificado e tente criar o anúncio novamente em Marketplaces > Shopee > Criar anúncio. Se o erro persistir mesmo após as correções, acione o suporte.
  • Não. O erro acontece apenas no momento de criação de novos anúncios. Produtos já publicados e ativos na Shopee continuam funcionando normalmente.
  • São atributos exigidos pela Shopee para a categoria do produto — como marca, material ou outras informações específicas. O relacionamento é feito em Marketplaces > Shopee, na seção de relacionamento de características. As obrigatórias aparecem expandidas na tela; as opcionais ficam recolhidas.

Boas vendas!

Equipe Tray.