Especificações da API
O Selling Partner API para Listings Items (Listings Items API) fornece acesso programático para vender listagens de parceiros na Amazon.
Casos de uso
Usando o Selling Partner API para Listings Items (Listings Items API), você pode criar, editar, excluir e recuperar detalhes sobre as listagens da Amazon (SKUs) para um parceiro de vendas.
Erros
Resposta de erro retornada quando a solicitação não é bem-sucedida.
| Valor | Descrição |
|---|---|
| code Obrigatório Tipo: String | Um código de erro que identifica o tipo de erro ocorrido. |
| message Obrigatório Tipo: String | Uma mensagem que descreve a condição de erro. |
| message Opcional Tipo: String | Detalhes adicionais que podem ajudar o chamador a entender ou corrigir o problema. |
Lista de Erros
Uma lista de respostas de erro retornadas quando uma solicitação é malsucedida.
| Valor | Schema |
|---|---|
| errors Obrigatório Tipo: String | < Error > array |
Issue
Um problema com um item da lista.
| Name | Description | Schema |
|---|---|---|
| code required | An issue code that identifies the type of issue. | string |
| message required | A message that describes the issue. | string |
| severity required | The severity of the issue. | enum (Severity) |
| attributeName optional | Name of the attribute associated with the issue, if applicable. | string |
| code Obrigatório Tipo: String | Um código de problema que identifica o tipo de problema. |
| message Obrigatório Tipo: String | Uma mensagem que descreve o problema. |
| severity Obrigatório Tipo: Severity | A gravidade do problema. |
| attributeName Opcional Tipo: String | Nome do atributo associado ao problema, se aplicável. |
PatchOperation
Operação de patch JSON individual para uma solicitação HTTP PATCH.
| Valor | Descrição |
|---|---|
| op Obrigatório Tipo: enum (Op) | Tipo de operação de patch JSON. As operações de patch JSON com suporte incluem adicionar, substituir e excluir. Consulte https://tools.ietf.org/html/rfc6902. |
| path Obrigatório Tipo: String | Caminho do ponteiro JSON do elemento a ser corrigido. Consulte https://tools.ietf.org/html/rfc6902. |
| value Opcional Tipo: < object > array | Valor JSON para adicionar, substituir ou excluir. |
ListingsItemPatchRequest
O esquema do corpo da solicitação para a operação patchListingsItem.
| Valor | Descrição |
|---|---|
| productType Obrigatório Tipo: String | O tipo de produto da Amazon do item da lista. |
| patches Obrigatório Tipo: < PatchOperation > array | Uma ou mais operações de patch JSON para executar no item de listagens. |
ListingsItemPutRequest
O esquema do corpo da solicitação para a operação putListingsItem.
| Valor | Descrição |
|---|---|
| productType Obrigatório Tipo: String | O tipo de produto da Amazon do item da lista. |
| requirements Opcional Tipo: enum Requirements | O nome dos requisitos definidos para os dados fornecidos. |
| attributes Obrigatório Tipo: Object | Objeto JSON contendo dados de atributo de item de listagens estruturadas codificados por nome de atributo. |
ListingsItemSubmissionResponse
Resposta contendo os resultados de um envio à API do parceiro de vendas para itens de listagem.
| Valor | Descrição |
|---|---|
| sku Obrigatório Tipo: String | Um parceiro de vendas forneceu identificador para uma lista da Amazon. |
| status Obrigatório Tipo: enum (Status) | O status do envio do item de listagens. |
| submissionId Obrigatório Tipo: String | O identificador exclusivo do envio do item de listagem. |
| issues Opcional Tipo: < Issue > array | Problemas dos itens de listagens relacionados ao envio do item de listagens. |
Status
O status do envio do item de listagens.
Tipo: enum
| Valor | Descrição |
|---|---|
| ACCEPTED | O envio das listagens foi aceito para processamento. |
| INVALID | O envio de listagens não era válido e não foi aceito para processamento. |
Op
Tipo de operação de patch JSON. As operações de patch JSON com suporte incluem adicionar, substituir e excluir. Consulte https://tools.ietf.org/html/rfc6902.
Tipo: enum
| Valor | Descrição |
|---|---|
| add | A operação "add" adiciona ou substitui a propriedade de destino. |
| replace | A operação "substituir" adiciona ou substitui a propriedade de destino. |
| delete | A operação "delete" remove a propriedade de destino. |
Severity
A gravidade do problema.
Tipo: enum
| Valor | Descrição |
|---|---|
| ERROR | Indica que ocorreu um problema que impede o processamento do envio, como um erro de validação. |
| WARNING | Indica que ocorreu um problema que deve ser revisado, mas não impediu o processamento do envio. |
| INFO | Indica que informações adicionais foram fornecidas e devem ser revisadas. |
Requirements
O nome dos requisitos definidos para os dados fornecidos.
Tipo: enum
| Valor | Descrição |
|---|---|
| LISTING | Indica que os dados enviados contêm fatos e termos de vendas do produto. |
| LISTING_PRODUCT_ONLY | Indica que os dados enviados contêm apenas fatos do produto. |
| LISTING_OFFER_ONLY | Indica que os dados enviados contêm apenas os termos de venda. |