Perguntas frequentes

Perguntas frequentes sobre a API Product Type Definitions.

Perguntas Frequentes

Esta documentação abrange perguntas e detalhes comuns para a API Product Type Definitions. Para dúvidas ou preocupações não cobertas por esta documentação, entre em contato com o [Suporte ao Vendedor no Seller Central] (https://sellercentral.amazon.com.br/cu/help/contact-us?) ou publique sua dúvida na nossa página da [Comunidade Brasil para SP-API] (https://github.com/AmzBR-Developer/Selling-Partner-API/discussions).

Quão atualizadas são as definições de tipo de produto da Amazon?

A menos que seja especificado um productTypeVersion anterior na requisição, as definições de tipo de produto da Amazon sempre descrevem os requisitos de catálogo da Amazon mais recentes e atualizados.

Todos os tipos de produtos da Amazon estão disponíveis com a API Product Type Definitions?

Não.

Amazon está expandindo continuamente o suporte para tipos de produtos novos e existentes da Amazon na API Product Type Definitions. Para obter a lista atualizada de tipos de produtos da Amazon disponíveis, use a API Product Type Definitions.

Qual versão do esquema JSON é usada?

Os JSON Schemas da definição de tipo de produto da Amazon estendem o esquema JSON 2019-09. Consulte a documentação do Meta-Schema de definição de tipo de produto da Amazon (v1) para obter mais detalhes.

Como as versões futuras do JSON Schema serão aproveitadas?

À medida que as versões futuras do JSON Schema forem adotadas pela API Product Type Definitions, elas serão acompanhadas por uma nova versão da API Product Type Definitions e Meta-Schema de definição de tipo de produto da Amazon (v1).

Versões futuras do JSON Schema não serão adotadas por versões existentes da API de definições de tipo de produto ou meta-esquema de definição de tipo de produto da Amazon.

Os JSON Schemas de definição de tipo de produto incluem vocabulário personalizado?

A maioria dos requisitos de catálogo da Amazon são descritos utilizando o vocabulário JSON Schema 2019-09 padrão. No entanto, existem alguns requisitos que exigem a extensão do esquema JSON com vocabulário personalizado. Consulte a documentação do Meta-Schema de definição de tipo de produto da Amazon (v1) para obter mais detalhes.

Sou obrigado a implementar a validação para vocabulário personalizado?

Não.

O Meta-Schema de definição de tipo de produto da Amazon (v1) usa vocabulário personalizado para descrever completamente os requisitos do catálogo da Amazon. A validação de dados com dados personalizados permite que você evite a ocorrência da maioria dos problemas relacionados a listagens antes de enviar para a Amazon. No entanto, cabe a você implementar essa validação. Sem implementar essa validação, o envio de dados à Amazon pode gerar problemas relacionados a listagens após o envio à Amazon.

Preciso de código personalizado para usar JSON Schemas?

Sim.

A quantidade de código personalizado depende do seu aplicativo. Cenários de exemplo:

• Usando biblioteca de código aberto com validação de vocabulário personalizado: Aproveitar uma biblioteca de código aberto para lidar com a maioria das validações de esquema JSON significa que o código personalizado é necessário para recuperar esquemas da API de definições de tipo de produto, implementar a validação de vocabulário personalizado e integrar com o biblioteca de código aberto.

• Usando biblioteca de código aberto sem validação de vocabulário personalizado: Aproveitar uma biblioteca de código aberto para lidar com a maioria das validações de esquema JSON significa que o código personalizado é necessário para recuperar esquemas da API Product Type Definitions e integrá-lo à biblioteca de código aberto.

Quais bibliotecas de código aberto estão disponíveis?

Dezenas de bibliotecas e implementações de código aberto estão disponíveis para validar dados, renderizar interfaces de usuário e gerar código. Consulte Implementações de esquema JSON para obter uma lista completa.

A Amazon não oferece suporte ou endossa diretamente nenhuma biblioteca e implementação específica de código aberto ou comercial. Os exemplos fornecidos nesta documentação são apenas para referência.

Quais exemplos estão disponíveis para validar dados com esquemas de tipo de produto?

A documentação do Amazon Product Type Definition Meta-Schema (v1) inclui exemplos de integrações com bibliotecas de código aberto para validar dados com vocabulário personalizado em .NET (C#), Java e JavaScript (Node.js).

Como faço para relatar problemas com as definições de tipo de produto da Amazon?

Você pode solicitar auxílio direto no Suporte ao Vendedor no Seller Central ou contatar seu gerente de contas.

👍

Suporte técnico do Seller Central!

Caso tenha ficado alguma dúvida que não tenha encontrado nos tópicos acima, entre em contato com o suporte técnico.