Itens — Atributos de envio e dimensões

Última atualização em 05/05/2026

FAQs › Itens — Atributos de envio e dimensões

Itens — Atributos de envio e dimensões

Quais atributos devo enviar para que a API aceite dimensões e peso do pacote (seller_package_*) e em quais unidades?

As dimensões devem ser enviadas como valores numéricos com unidades: height/width/length em centímetros e weight em gramas (inteiro). Em shipping.dimensions costuma-se usar o formato AxBxC, peso, com dimensões em cm e peso em gramas. A API valida limites e formatos; em alguns sites enviar o peso em gramas inteiro evita erros por frações.

Recomendação

Normalize as unidades em sua integração (cm e g), converta frações para inteiros quando necessário e valide contra os limites da API antes de enviar.

Por que recebo o erro "seller_package dimensions are too small / invalid" se envio dimensões reais muito pequenas (ex. delineadores)?

O sistema valida o realismo das dimensões e pode rejeitar medidas extremamente pequenas; a validação espera dimensões de embalagem (caixa ou envelope) e não medidas do produto bruto se a categoria exige mínimos.

Recomendação

Envie as dimensões da embalagem real utilizada (caixa ou envelope) e ajuste aos mínimos de categoria quando necessário.

Ao atualizar um item com ME2 aparecem warnings e as dimensões não mudam. Por quê?

Para logística ME2/fulfillment, certas dimensões são gerenciadas pela operação logística e nem sempre são modificáveis via API; a plataforma pode impor valores ou considerar algumas medidas como read-only até o ingresso físico no depósito.

Recomendação

Se o item estiver no modo fulfillment, considere que algumas dimensões serão gerenciadas pela logística e planeje atualizações coordenadas com o fluxo operacional.