eBay (Editor Independente) (versão prévia)
O eBay é uma empresa multinacional americana de comércio eletrônico que facilita as vendas entre consumidores e empresas e consumidores por meio de seu site.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Artesian Software Technologies LLP |
| URL | https://artesian.io |
| amit.sharma@artesian.io |
| Metadados do conector | |
|---|---|
| Publicador | Artesian Software Technologies LLP |
| Site | https://www.ebay.com/ |
| Política de Privacidade | https://www.ebay.com/help/policies/member-behaviour-policies/user-privacy-notice-privacy-policy?id=4260 |
| Categorias | Comércio; Vendas e CRM |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| ID do cliente – Sua clientId do eBay | cadeia | Insira a ID do cliente. | Verdade |
| Segredo de Cliente | secureString | Insira o segredo do cliente. | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar oferta |
Essa chamada atualiza uma oferta existente que pode estar em publicação ou em um estado não publicado. |
| Criar local de inventário |
Use essa chamada para criar um novo local de inventário. Para criar e publicar uma oferta, um vendedor deve ter um local de inventário de lançamento, pois cada oferta deve ser associada a um local. |
| Criar Oferta |
Essa chamada cria uma oferta para um item de inventário específico em um marketplace específico do eBay. |
| Criar ou substituir item de inventário |
Essa chamada cria um novo registro de item de inventário ou substitui um registro de item de inventário existente. |
| Excluir Oferta |
Essa chamada excluirá permanentemente a oferta |
| Item de Inventário GET |
Essa chamada recupera o registro de item de inventário de uma determinada SKU. |
| Obter aspectos de item para categoria |
Essa chamada retorna uma lista de aspectos apropriados ou necessários para descrever com precisão os itens na categoria folha especificada. Cada aspecto identifica um atributo de item (por exemplo, cor) para o qual o vendedor será necessário ou incentivado a fornecer um valor (ou valores de variação) ao oferecer um item nessa categoria no eBay. |
| Obter itens de inventário |
Essa chamada recupera todos os registros de item de inventário definidos para a conta do vendedor. |
| Obter locais de inventário |
Essa chamada recupera todos os detalhes definidos para cada local de inventário associado à conta do vendedor. |
| Obter o local do inventário |
Essa chamada recupera todos os detalhes definidos do local de inventário especificado pelo parâmetro de caminho merchantLocationKey. |
| Obter política de cumprimento |
Esse método recupera os detalhes completos de uma política de cumprimento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho fulfillmentPolicyId. |
| Obter política de pagamento |
Esse método recupera os detalhes completos de uma política de pagamento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho paymentPolicyId. |
| Obter política de retorno |
Esse método recupera os detalhes completos da política de retorno especificada pelo parâmetro de caminho returnPolicyId. |
| Obter políticas de condição de item |
Esse método retorna metadados de condição de item em uma, várias ou todas as categorias do eBay em um marketplace do eBay. |
| Obter políticas de cumprimento |
Esse método recupera todas as políticas de atendimento configuradas para o marketplace que você especificar usando o parâmetro de consulta marketplace_id. |
| Obter políticas de pagamento |
Esse método recupera todas as políticas de pagamento configuradas para o marketplace que você especificar usando o parâmetro de consulta marketplace_id. |
| Obter políticas de retorno |
Esse método recupera todas as políticas de retorno configuradas para o marketplace que você especificar usando o parâmetro de consulta marketplace_id. |
| Obter sugestões de categoria |
Essa chamada retorna uma matriz de nós folha de árvore de categoria na árvore de categoria especificada que são consideradas pelo eBay para corresponder mais de perto à consulta. |
|
Obter Tree |
Um determinado marketplace do eBay pode usar várias árvores de categoria, mas uma dessas árvores é considerada o padrão para esse marketplace. Essa chamada recupera uma referência à árvore de categoria padrão associada à ID do marketplace do eBay especificada. |
| Oferta GET |
Essa chamada recupera uma oferta publicada ou não publicada específica. |
| Ofertas GET |
Essa chamada recupera todas as ofertas existentes para o valor de SKU especificado. O vendedor tem a opção de limitar as ofertas que são recuperadas para um marketplace específico do eBay ou para um formato de listagem. |
| Publicar Oferta |
Essa chamada é usada para converter uma oferta não publicada em uma oferta publicada ou listagem ao vivo do eBay. O identificador exclusivo da oferta (offerId) é passado no final do URI de chamada. |
| Retirar oferta |
Essa chamada é usada para encerrar uma listagem de variação única associada à oferta especificada. |
Atualizar oferta
Essa chamada atualiza uma oferta existente que pode estar em publicação ou em um estado não publicado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
offerId | True | string |
Identificador exclusivo da oferta que você deseja atualizar. |
|
Quantidade Disponível
|
availableQuantity | integer |
Quantidade disponível de inventário para compra. |
|
|
ID da categoria
|
categoryId | string |
ID de categoria exclusiva do eBay na qual o produto será listado. |
|
|
ID de caridade
|
charityId | string |
ID exclusiva atribuída ao eBay da organização de caridade que receberá uma porcentagem dos lucros das vendas. |
|
|
Percentual de doação
|
donationPercentage | string |
Percentual de preço de compra que a organização de caridade receberá para cada venda gerada pela listagem. |
|
|
ID do produto produtor
|
producerProductId | string |
Identificador exclusivo do produtor relacionado ao item. |
|
|
ID do pacote do produto
|
productPackageId | string |
ID exclusiva do produtor de empacotamento de produtos adicionado pelo vendedor. |
|
|
ID do pacote de remessa
|
shipmentPackageId | string |
ID exclusiva do produtor de qualquer empacotamento usado pelo vendedor para enviar item. |
|
|
ID da Documentação do Produto
|
productDocumentationId | string |
Identificador exclusivo do produtor de qualquer papel adicionado ao pacote do item pelo vendedor. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Ocultar detalhes do comprador
|
hideBuyerDetails | boolean |
Esse campo será incluído se o vendedor quiser criar uma listagem privada. |
|
|
Incluir detalhes do produto do catálogo
|
includeCatalogProductDetails | boolean |
Indica se os detalhes do catálogo de produtos do eBay são aplicados ou não a uma listagem. |
|
|
Descrição da listagem
|
listingDescription | string |
Descrição da listagem do eBay. |
|
|
Duração da listagem
|
listingDuration | string |
Número de dias em que a listagem estará ativa. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Melhor oferta habilitada
|
bestOfferEnabled | boolean |
Indica se o recurso melhor oferta está habilitado ou não para a listagem. |
|
|
eBay Plus se qualificado
|
eBayPlusIfEligible | boolean |
Esse campo será incluído em uma oferta se um vendedor de Top-Rated for optado pelo programa eBay Plus. |
|
|
ID da política de cumprimento
|
fulfillmentPolicyId | string |
O identificador exclusivo indica a política de negócios de atendimento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
ID da Política de Pagamento
|
paymentPolicyId | string |
O identificador exclusivo indica a política de negócios de pagamento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
IDs da Política de Conformidade do Produto
|
productCompliancePolicyIds | array of string |
Esse campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
|
ID da política de retorno
|
returnPolicyId | string |
Retorne a ID exclusiva da política de negócios que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Priority
|
priority | integer |
A entrada de valor inteiro nesse campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio doméstico ou internacional na política de cumprimento será modificada com os custos de envio atualizados. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Tipo de Serviço
|
shippingServiceType | string |
Esse valor indica se o serviço de envio especificado no campo de prioridade é uma opção de serviço de envio doméstico ou internacional. |
|
|
Retome a ID da política
|
takeBackPolicyId | string |
ID do vendedor que criou a política de reposição. |
|
|
Data de início da listagem
|
listingStartDate | string |
Esse campo poderá ser usado se o vendedor quiser especificar uma hora no futuro em que a listagem se tornará ativa no eBay. |
|
|
Tamanho do Lote
|
lotSize | integer |
Esse campo só será aplicável se a listagem for muito listagem. O valor inteiro passado para esse campo é o número total de itens no lote. |
|
|
Chave de Localização do Comerciante
|
merchantLocationKey | string |
Identificador exclusivo do local de inventário de um comerciante |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Originalmente vendido por preço de varejo em
|
originallySoldForRetailPriceOn | string |
Esse campo será necessário se o recurso Preços de Strikethrough for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original em um site do eBay, ou vendido por esse preço por um varejista de terceiros |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Visibilidade de preços
|
pricingVisibility | string |
Esse campo será necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
|
Limite de quantidade por comprador
|
quantityLimitPerBuyer | integer |
Esse campo só é aplicável e definido se o vendedor deseja definir uma restrição na quantidade de compra por vendedor. |
|
|
ID da categoria secundária
|
secondaryCategoryId | string |
ID de categoria secundária exclusiva e aplicável se o vendedor decidir listar o item em duas categorias. |
|
|
Nomes de categoria de repositório
|
storeCategoryNames | array of string |
Nomes de categoria de repositório |
|
|
Aplicar Imposto
|
applyTax | boolean |
Esse contêiner só é aplicável e usado se uma tabela de imposto sobre vendas, uma taxa de imposto Value-Added ou um código de categoria de exceção fiscal forem aplicados à oferta. |
|
|
Categoria de imposto de terceiros
|
thirdPartyTaxCategory | string |
O código da categoria de exceção fiscal. Se esse campo for usado, o imposto sobre vendas também se aplicará a um serviço/taxa e não apenas ao preço do item. |
|
|
Percentual de IVA
|
vatPercentage | number |
Esse valor é a taxa de IVA do item, se houver. Quando um percentual de IVA é especificado, as informações de IVA do item são exibidas na página Item de Exibição da listagem. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da Oferta
|
offerId | string |
Identificador exclusivo da oferta |
|
Avisos
|
warnings | array of object |
Esse contêiner retornará quando uma chamada for feita e ocorrerão erros e/ou avisos. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
Domínio
|
warnings.domain | string |
Nome de domínio no qual o erro ou aviso ocorreu. |
|
ID do erro
|
warnings.errorId | integer |
Código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de solicitação específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de resposta específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou o aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Nome do subdomínio no qual o erro ou aviso ocorreu. |
Criar local de inventário
Use essa chamada para criar um novo local de inventário. Para criar e publicar uma oferta, um vendedor deve ter um local de inventário de lançamento, pois cada oferta deve ser associada a um local.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de Localização do Comerciante
|
merchantLocationKey | True | string |
Chave definida pelo comerciante exclusiva para um local de inventário. |
|
Linha de endereço 1
|
addressLine1 | string |
Primeira linha de um endereço de rua. |
|
|
Linha de endereço 2
|
addressLine2 | string |
Segunda linha de um endereço de rua. |
|
|
City
|
city | string |
Cidade na qual o local do inventário reside. |
|
|
País
|
country | string |
Código do país no qual o endereço reside. |
|
|
Município
|
county | string |
Condado no qual reside o endereço. |
|
|
Código postal
|
postalCode | string |
Cep/cep do endereço. |
|
|
Estado ou província
|
stateOrProvince | string |
Estado/província no qual reside o local do inventário. |
|
|
Latitude
|
latitude | string |
Componente de latitude da coordenada geográfica. |
|
|
Longitude
|
longitude | string |
Componente longitude da coordenada geográfica. |
|
|
Informações adicionais sobre o local
|
locationAdditionalInformation | string |
Informações adicionais sobre um local de inventário. |
|
|
Instruções de localização
|
locationInstructions | string |
Instruções especiais de retirada para um local de inventário de repositório. |
|
|
locationTypes
|
locationTypes | array of string |
Tipos de localização |
|
|
Url da Web de localização
|
locationWebUrl | string |
Endereço do site associado ao local do inventário. |
|
|
Status da Localização do Comerciante
|
merchantLocationStatus | string |
O status do local do inventário pode estar habilitado ou desabilitado. |
|
|
Nome
|
name | string |
Nome do local do inventário. |
|
|
Dia da Semana
|
dayOfWeekEnum | string |
Dia em que o local do repositório tem horários de operação regulares. |
|
|
fechar
|
close | string |
Hora de fechamento da loja. |
|
|
em aberto
|
open | string |
Hora de abertura da loja. |
|
|
Telefone
|
phone | string |
Número de telefone para um local de inventário de repositório. |
|
|
Date
|
date | string |
Valor de data específico que o local do repositório tem horas de operação especiais. |
|
|
fechar
|
close | string |
Hora de fechamento da loja. |
|
|
em aberto
|
open | string |
Hora de abertura da loja. |
Retornos
- response
- string
Criar Oferta
Essa chamada cria uma oferta para um item de inventário específico em um marketplace específico do eBay.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Quantidade Disponível
|
availableQuantity | integer |
Quantidade disponível de inventário para compra. |
|
|
ID da categoria
|
categoryId | string |
ID de categoria exclusiva do eBay na qual o produto será listado. |
|
|
ID de caridade
|
charityId | string |
ID exclusiva atribuída ao eBay da organização de caridade que receberá uma porcentagem dos lucros das vendas. |
|
|
Percentual de doação
|
donationPercentage | string |
Percentual de preço de compra que a organização de caridade receberá para cada venda gerada pela listagem. |
|
|
ID do produto produtor
|
producerProductId | string |
Identificador exclusivo do produtor relacionado ao item. |
|
|
ID do pacote do produto
|
productPackageId | string |
ID exclusiva do produtor de empacotamento de produtos adicionado pelo vendedor. |
|
|
ID do pacote de remessa
|
shipmentPackageId | string |
ID exclusiva do produtor de qualquer empacotamento usado pelo vendedor para enviar item. |
|
|
ID da Documentação do Produto
|
productDocumentationId | string |
Identificador exclusivo do produtor de qualquer papel adicionado ao pacote do item pelo vendedor. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Formato
|
format | string |
Formato de listagem da oferta. |
|
|
Ocultar detalhes do comprador
|
hideBuyerDetails | boolean |
Esse campo será incluído se o vendedor quiser criar uma listagem privada. |
|
|
Incluir detalhes do produto do catálogo
|
includeCatalogProductDetails | boolean |
Indica se os detalhes do catálogo de produtos do eBay são aplicados ou não a uma listagem. |
|
|
Descrição da listagem
|
listingDescription | string |
Descrição da listagem do eBay. |
|
|
Duração da listagem
|
listingDuration | string |
Número de dias em que a listagem estará ativa. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Melhor oferta habilitada
|
bestOfferEnabled | boolean |
Indica se o recurso melhor oferta está habilitado ou não para a listagem. |
|
|
eBay Plus se qualificado
|
eBayPlusIfEligible | boolean |
Esse campo será incluído em uma oferta se um vendedor de Top-Rated for optado pelo programa eBay Plus. |
|
|
ID da política de cumprimento
|
fulfillmentPolicyId | string |
O identificador exclusivo indica a política de negócios de atendimento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
ID da Política de Pagamento
|
paymentPolicyId | string |
O identificador exclusivo indica a política de negócios de pagamento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
IDs da Política de Conformidade do Produto
|
productCompliancePolicyIds | array of string |
Esse campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
|
ID da política de retorno
|
returnPolicyId | string |
Retorne a ID exclusiva da política de negócios que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Priority
|
priority | integer |
A entrada de valor inteiro nesse campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio doméstico ou internacional na política de cumprimento será modificada com os custos de envio atualizados. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Tipo de Serviço
|
shippingServiceType | string |
Esse valor indica se o serviço de envio especificado no campo de prioridade é uma opção de serviço de envio doméstico ou internacional. |
|
|
Retome a ID da política
|
takeBackPolicyId | string |
ID do vendedor que criou a política de reposição. |
|
|
Data de início da listagem
|
listingStartDate | string |
Esse campo poderá ser usado se o vendedor quiser especificar uma hora no futuro em que a listagem se tornará ativa no eBay. |
|
|
Tamanho do Lote
|
lotSize | integer |
Esse campo só será aplicável se a listagem for muito listagem. O valor inteiro passado para esse campo é o número total de itens no lote. |
|
|
Marketplace Id
|
marketplaceId | string |
ID exclusiva do site do eBay para a qual a oferta será disponibilizada. |
|
|
Chave de Localização do Comerciante
|
merchantLocationKey | string |
Identificador exclusivo do local de inventário de um comerciante |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Originalmente vendido por preço de varejo em
|
originallySoldForRetailPriceOn | string |
Esse campo será necessário se o recurso Preços de Strikethrough for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original em um site do eBay, ou vendido por esse preço por um varejista de terceiros |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Moeda
|
currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
|
Value
|
value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
|
Visibilidade de preços
|
pricingVisibility | string |
Esse campo será necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
|
Limite de quantidade por comprador
|
quantityLimitPerBuyer | integer |
Esse campo só é aplicável e definido se o vendedor deseja definir uma restrição na quantidade de compra por vendedor. |
|
|
ID da categoria secundária
|
secondaryCategoryId | string |
ID de categoria secundária exclusiva e aplicável se o vendedor decidir listar o item em duas categorias. |
|
|
SKU
|
sku | string |
Valor de SKU definido pelo vendedor do produto que será listado no site do eBay. |
|
|
Nomes de categoria de repositório
|
storeCategoryNames | array of string |
Nome da categoria da loja |
|
|
Aplicar Imposto
|
applyTax | boolean |
Esse contêiner só é aplicável e usado se uma tabela de imposto sobre vendas, uma taxa de imposto Value-Added ou um código de categoria de exceção fiscal forem aplicados à oferta. |
|
|
Categoria de imposto de terceiros
|
thirdPartyTaxCategory | string |
O código da categoria de exceção fiscal. Se esse campo for usado, o imposto sobre vendas também se aplicará a um serviço/taxa e não apenas ao preço do item. |
|
|
Percentual de IVA
|
vatPercentage | number |
Esse valor é a taxa de IVA do item, se houver. Quando um percentual de IVA é especificado, as informações de IVA do item são exibidas na página Item de Exibição da listagem. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da Oferta
|
offerId | string |
Identificador exclusivo da oferta |
|
Avisos
|
warnings | array of object |
Esse contêiner retornará quando uma chamada for feita e ocorrerão erros e/ou avisos. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
Domínio
|
warnings.domain | string |
Nome de domínio no qual o erro ou aviso ocorreu. |
|
ID do erro
|
warnings.errorId | integer |
Código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de solicitação específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de resposta específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou o aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Nome do subdomínio no qual o erro ou aviso ocorreu. |
Criar ou substituir item de inventário
Essa chamada cria um novo registro de item de inventário ou substitui um registro de item de inventário existente.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
Valor definido pelo vendedor para o item de inventário. |
|
Content-Language
|
Content-Language | True | string |
O cabeçalho define a linguagem natural que será usada nos valores de campo do conteúdo da solicitação. |
|
Tipo
|
availabilityType | string |
Status de disponibilidade do item de inventário no repositório físico do comerciante. |
|
|
Unidade
|
unit | string |
Unidade de tempo usada para especificar o tempo de cumprimento. |
|
|
Value
|
value | integer |
Valor de tempo de cumprimento. |
|
|
Chave de Localização do Comerciante
|
merchantLocationKey | string |
ID exclusiva da loja do Comerciante para a qual In-Store item de inventário de retirada está localizado ou será enviado. |
|
|
Quantidade
|
quantity | integer |
Quantidade de item de inventário disponível para In-Store Pickup. |
|
|
Unidade
|
unit | string |
Unidade de tempo usada para especificar o tempo de cumprimento. |
|
|
Value
|
value | integer |
Valor de tempo de cumprimento. |
|
|
Chave de Localização do Comerciante
|
merchantLocationKey | string |
A ID exclusiva da loja do Comerciante na qual In-Store item de inventário de retirada está atualmente localizado ou será enviado. |
|
|
Quantidade
|
quantity | integer |
Quantidade do item de inventário que está disponível neste local de inventário. |
|
|
Quantidade
|
quantity | integer |
Quantidade total de item de inventário 'ship-to-home' que estará disponível para compra por meio de uma ou mais ofertas publicadas. |
|
|
Condição
|
condition | string |
Condição do item. |
|
|
Descrição da condição
|
conditionDescription | string |
Descrição da condição de um item de inventário. |
|
|
Altura
|
height | number |
Altura real do pacote de envio. |
|
|
Length
|
length | number |
Comprimento real do pacote de envio. |
|
|
Unidade
|
unit | string |
A unidade de medida usada para especificar as dimensões de um pacote de envio. |
|
|
Largura
|
width | number |
A largura real do pacote de envio. |
|
|
Tipo de pacote
|
packageType | string |
Valor do pacote de envio usado para enviar o item de inventário. |
|
|
Unidade
|
unit | string |
A unidade de medida usada para especificar o peso de um pacote de envio. |
|
|
Value
|
value | number |
O peso real do pacote de envio. |
|
|
Aspectos
|
aspects | object |
Esta é uma coleção de pares nome-valor específicos do item que fornecem mais informações sobre o produto e podem facilitar a localização dos compradores. |
|
|
Marca
|
brand | string |
Marca do produto. |
|
|
Description
|
description | string |
Descrição do produto. |
|
|
Itens EAN
|
ean | array of string |
EAN |
|
|
ePID
|
epid | string |
Identificador de produto do eBay para o produto. |
|
|
URLs de imagem
|
imageUrls | array of string |
URLs de imagem |
|
|
Itens do ISBN
|
isbn | array of string |
ISBN |
|
|
MPN
|
mpn | string |
Número de parte do fabricante de um produto. |
|
|
Subtítulo
|
subtitle | string |
Recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar nos resultados da pesquisa. |
|
|
Title
|
title | string |
O título de um item de inventário pode ser adicionado ou modificado. |
|
|
Itens UPC
|
upc | array of string |
Upc |
|
|
IDs de vídeo
|
videoIds | array of string |
videoIds |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Avisos
|
warnings | array of object |
Esse contêiner será retornado em um conteúdo de resposta de chamada se um ou mais avisos ou erros forem disparados. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro. |
|
Domínio
|
warnings.domain | string |
O nome do domínio no qual o erro ou aviso ocorreu. |
|
ID do erro
|
warnings.errorId | integer |
Um código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de solicitação específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de resposta específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou o aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | object |
Uma descrição da condição que causou o erro ou aviso. |
Excluir Oferta
Essa chamada excluirá permanentemente a oferta
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
offerId | True | string |
Identificador exclusivo da oferta a ser excluída. |
Retornos
- response
- string
Item de Inventário GET
Essa chamada recupera o registro de item de inventário de uma determinada SKU.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
Valor definido pelo vendedor do produto cujo registro de item de inventário você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
PickupAtLocationAvailability
|
availability.pickupAtLocationAvailability | array of object |
Esse contêiner consiste em uma matriz de repositórios físicos do comerciante em que o item de inventário está disponível para retirada na loja. |
|
Tipo de disponibilidade
|
availability.pickupAtLocationAvailability.availabilityType | string |
Esse campo indica o status de disponibilidade do item de inventário no repositório físico do comerciante. |
|
Unidade
|
availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
O valor indica a unidade de tempo usada para especificar o tempo de cumprimento |
|
Value
|
availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
O valor inteiro nesse campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de atendimento. |
|
Chave de Localização do Comerciante
|
availability.pickupAtLocationAvailability.merchantLocationKey | string |
Identificador exclusivo da loja do Comerciante para o qual o item de inventário In-Store Pickup está localizado no momento ou será enviado. |
|
Quantidade
|
availability.pickupAtLocationAvailability.quantity | integer |
Esse valor inteiro indica a quantidade do item de inventário disponível para In-Store Pickup |
|
Leilão
|
availability.shipToLocationAvailability.allocationByFormat.auction | integer |
Esse valor inteiro indica a quantidade do item de inventário reservado para as ofertas de formato de leilão publicadas da SKU. |
|
Preço Fixo
|
availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
Esse valor inteiro indica a quantidade do item de inventário que está disponível para as ofertas de preço fixo da SKU. |
|
AvailabilityDistributions
|
availability.shipToLocationAvailability.availabilityDistributions | array of object |
Esse contêiner é usado para definir a quantidade disponível do item de inventário em um ou mais locais de armazém. |
|
Unidade
|
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
O valor indica a unidade de tempo usada para especificar o tempo de cumprimento |
|
Value
|
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
O valor inteiro nesse campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de atendimento. |
|
Chave de Localização do Comerciante
|
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
Identificador exclusivo de um local de inventário em que a quantidade está disponível para o item de inventário. |
|
Quantidade
|
availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
Quantidade do item de inventário que está disponível neste local de inventário. |
|
Quantidade
|
availability.shipToLocationAvailability.quantity | integer |
Esse contêiner é usado para definir a quantidade total de 'ship-to-home' do item de inventário que estará disponível para compra por meio de uma ou mais ofertas publicadas. |
|
Condição
|
condition | string |
Esse valor indica a condição do item |
|
Descrição da condição
|
conditionDescription | string |
Esse campo de cadeia de caracteres é usado pelo vendedor para descrever mais claramente a condição de itens usados ou itens que não são 'Brand New', 'New with tags' ou 'New in box'. |
|
IDs de grupo
|
groupIds | array of string | |
|
inventoryItemGroupKeys
|
inventoryItemGroupKeys | array of string |
Essa matriz será retornada se o item de inventário estiver associado a qualquer grupo de itens de inventário. |
|
Local
|
locale | string |
Esse campo retorna a linguagem natural fornecida nos valores de campo do conteúdo da solicitação |
|
Altura
|
packageWeightAndSize.dimensions.height | number |
A altura real do pacote de envio. |
|
Length
|
packageWeightAndSize.dimensions.length | number |
O comprimento real do pacote de envio. |
|
Unidade
|
packageWeightAndSize.dimensions.unit | string |
Unidade de medida usada para especificar as dimensões de um pacote de envio. |
|
Largura
|
packageWeightAndSize.dimensions.width | number |
A largura real do pacote de envio. |
|
Tipo de pacote
|
packageWeightAndSize.packageType | string |
Esse valor indica o tipo de pacote de envio usado para enviar o item de inventário. |
|
Unidade
|
packageWeightAndSize.weight.unit | string |
A unidade de medida usada para especificar o peso de um pacote de envio. |
|
Value
|
packageWeightAndSize.weight.value | number |
O peso real do pacote de envio. |
|
Aspectos
|
product.aspects | object |
Esta é uma coleção de pares nome-valor específicos do item que fornecem mais informações sobre o produto e podem facilitar a localização dos compradores. |
|
Marca
|
product.brand | string |
A marca do produto. |
|
Description
|
product.description | string |
A descrição do produto. |
|
Ean
|
product.ean | array of string |
Número do Artigo Europeu/Número do Artigo Internacional (EAN) para o produto. |
|
ePID
|
product.epid | string |
O ePID (Identificador de Produto) do eBay para o produto. |
|
imageUrls
|
product.imageUrls | array of string |
Uma matriz de um ou mais links para imagens do produto. |
|
Isbn
|
product.isbn | array of string |
Valor do Número do Livro Padrão Internacional para o produto. |
|
MPN
|
product.mpn | string |
O MPN (Número de Parte do Fabricante) de um produto. |
|
Subtítulo
|
product.subtitle | string |
Um subtítulo é um recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar nos resultados da pesquisa. |
|
Title
|
product.title | string |
O título de um item de inventário pode ser adicionado ou modificado com uma chamada createOrReplaceInventoryItem. |
|
Upc
|
product.upc | array of string |
Valor do Número do Livro Padrão Internacional para o produto. |
|
videoIds
|
product.videoIds | array of string |
Uma matriz de um ou mais valores VideoId para o produto. |
|
SKU
|
sku | string |
A SKU (Unidade de Stock-Keeping) definida pelo vendedor do item de inventário. O vendedor deve ter um valor de SKU exclusivo para cada produto que vender. |
Obter aspectos de item para categoria
Essa chamada retorna uma lista de aspectos apropriados ou necessários para descrever com precisão os itens na categoria folha especificada. Cada aspecto identifica um atributo de item (por exemplo, cor) para o qual o vendedor será necessário ou incentivado a fornecer um valor (ou valores de variação) ao oferecer um item nessa categoria no eBay.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da árvore de categoria
|
category_tree_id | True | string |
ID exclusiva da árvore de categorias do eBay da qual os aspectos da categoria especificada estão sendo solicitados. |
|
ID da categoria
|
category_id | True | string |
Identificador exclusivo da categoria Folha para quais aspectos estão sendo solicitados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Aspectos
|
aspects | array of object |
Lista de aspectos de item apropriados para descrever itens em uma categoria folha específica |
|
Aspecto aplicável a
|
aspects.aspectConstraint.aspectApplicableTo | array of string |
Esse valor indica se o aspecto identificado pelo campo aspects.localizedAspectName é um aspecto do produto ou um aspecto item/instância, que é um aspecto cujo valor variará com base em uma instância específica do produto. |
|
Tipo de dados aspect
|
aspects.aspectConstraint.aspectDataType | string |
Tipo de dados de aspecto. |
|
Aspecto habilitado para variações
|
aspects.aspectConstraint.aspectEnabledForVariations | boolean |
Um valor verdadeiro indica que esse aspecto pode ser usado para ajudar a identificar variações de item. |
|
Formato de aspecto
|
aspects.aspectConstraint.aspectFormat | string |
Retornado somente se o valor de aspectDataType identificar um tipo de dados que exija formatação específica. |
|
Comprimento máximo do aspecto
|
aspects.aspectConstraint.aspectMaxLength | integer |
Comprimento máximo do valor do aspecto do item. |
|
Modo de Aspecto
|
aspects.aspectConstraint.aspectMode | string |
Maneira em que os valores desse aspecto devem ser especificados pelo vendedor. |
|
Aspecto necessário
|
aspects.aspectConstraint.aspectRequired | boolean |
Um valor verdadeiro indica que esse aspecto é necessário ao oferecer itens na categoria especificada. |
|
Uso do aspecto
|
aspects.aspectConstraint.aspectUsage | string |
O valor indica se o aspecto correspondente é recomendado ou opcional. |
|
Espera-se que seja necessário por data
|
aspects.aspectConstraint.expectedRequiredByDate | string |
Data esperada após a qual o aspecto será necessário. |
|
Item para cardinalidade de aspecto
|
aspects.aspectConstraint.itemToAspectCardinality | string |
Indica se esse aspecto pode aceitar valores únicos ou múltiplos para itens na categoria especificada. |
|
aspectValues
|
aspects.aspectValues | array of object |
Uma lista de valores válidos junto com quaisquer restrições para esse aspecto. |
|
localizedValue
|
aspects.aspectValues.localizedValue | string |
O valor localizado desse aspecto. |
|
valueConstraints
|
aspects.aspectValues.valueConstraints | array of object |
Contém uma lista das dependências que identificam quando o valor do campo LocalizedValue está disponível para o aspecto atual. |
|
applicableForLocalizedAspectName
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName | string |
O nome do aspecto de controle do qual o valor do aspecto atual depende. |
|
applicableForLocalizedAspectValues
|
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues | array of string |
Contém uma lista dos valores do aspecto de controle do qual o valor desse aspecto depende. |
|
Nome do aspecto localizado
|
aspects.localizedAspectName | string |
Nome localizado desse aspecto. |
|
Contagem de Pesquisa
|
aspects.relevanceIndicator.searchCount | integer |
Número de pesquisas recentes para o aspecto. |
Obter itens de inventário
Essa chamada recupera todos os registros de item de inventário definidos para a conta do vendedor.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Limit
|
limit | string |
Número máximo de registros a serem retornados por página de dados. |
|
|
Offset
|
offset | string |
O número da página a ser recuperado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
Essa é a URL para a página atual de itens de inventário. |
|
inventoryItems
|
inventoryItems | array of object |
Esse contêiner é uma matriz de um ou mais itens de inventário. |
|
pickupAtLocationAvailability
|
inventoryItems.availability.pickupAtLocationAvailability | array of object |
Esse contêiner consiste em uma matriz de repositórios físicos do comerciante em que o item de inventário está disponível para retirada na loja. |
|
availabilityType
|
inventoryItems.availability.pickupAtLocationAvailability.availabilityType | string |
Status de disponibilidade do item de inventário |
|
unidade
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.unit | string |
Unidade de tempo usada para especificar o tempo de cumprimento |
|
value
|
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value | integer |
O valor inteiro nesse campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de atendimento. |
|
merchantLocationKey
|
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey | string |
Identificador exclusivo da loja do Comerciante para o qual o item de inventário do In-Store Pickup está localizado no momento ou será enviado. |
|
quantidade
|
inventoryItems.availability.pickupAtLocationAvailability.quantity | integer |
quantidade |
|
Leilão
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction | integer |
Esse valor inteiro indica a quantidade do item de inventário reservado para as ofertas de formato de leilão publicadas da SKU. |
|
Preço Fixo
|
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.fixedPrice | integer |
Esse valor indica a quantidade do item de inventário que está disponível para as ofertas de preço fixo da SKU. |
|
availabilityDistributions
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions | array of object |
Esse contêiner é usado para definir a quantidade disponível do item de inventário em um ou mais locais de armazém. |
|
unidade
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit | string |
unidade |
|
value
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value | integer |
value |
|
merchantLocationKey
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey | string |
merchantLocationKey |
|
quantidade
|
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity | integer |
quantidade |
|
Quantidade
|
inventoryItems.availability.shipToLocationAvailability.quantity | integer |
Esse contêiner é usado para definir a quantidade total de 'ship-to-home' do item de inventário que estará disponível para compra por meio de uma ou mais ofertas publicadas |
|
Condição
|
inventoryItems.condition | string |
Esse valor indica a condição do item. |
|
Descrição da condição
|
inventoryItems.conditionDescription | string |
Esse campo de cadeia de caracteres é usado pelo vendedor para descrever mais claramente a condição dos itens |
|
IDs de grupo
|
inventoryItems.groupIds | array of string |
Essa matriz será retornada se o item de inventário estiver associado a qualquer grupo de itens de inventário. |
|
inventoryItemGroupKeys
|
inventoryItems.inventoryItemGroupKeys | array of string |
Essa matriz será retornada se o item de inventário estiver associado a qualquer grupo de itens de inventário. |
|
Local
|
inventoryItems.locale | string |
Esse campo retorna a linguagem natural fornecida nos valores de campo do conteúdo da solicitação. |
|
Altura
|
inventoryItems.packageWeightAndSize.dimensions.height | number |
Altura real do pacote de envio. |
|
Length
|
inventoryItems.packageWeightAndSize.dimensions.length | number |
Comprimento real do pacote de envio. |
|
Unidade
|
inventoryItems.packageWeightAndSize.dimensions.unit | string |
Unidade de medida usada para especificar as dimensões de um pacote de envio. |
|
Largura
|
inventoryItems.packageWeightAndSize.dimensions.width | number |
Largura real do pacote de envio. |
|
Largura
|
inventoryItems.packageWeightAndSize.packageType | string |
Tipo de pacote de envio usado para enviar o item de inventário. |
|
Unidade
|
inventoryItems.packageWeightAndSize.weight.unit | string |
Unidade de medida usada para especificar o peso de um pacote de envio. |
|
Value
|
inventoryItems.packageWeightAndSize.weight.value | number |
O peso real do pacote de envio. |
|
Aspectos
|
inventoryItems.product.aspects | object |
Esta é uma coleção de pares nome-valor específicos do item que fornecem mais informações sobre o produto e podem facilitar a localização dos compradores. |
|
Marca
|
inventoryItems.product.brand | string |
A marca do produto. Esse campo geralmente é emparelhado com o campo mpn para identificar um produto específico por Número de Parte de Fabricação. |
|
Description
|
inventoryItems.product.description | string |
A descrição do produto. |
|
Ean
|
inventoryItems.product.ean | array of string |
Número do Artigo Europeu/Número do Artigo Internacional para o produto. |
|
ePID
|
inventoryItems.product.epid | string |
O ePID (Identificador de Produto) do eBay para o produto. |
|
imageUrls
|
inventoryItems.product.imageUrls | array of string |
Uma matriz de um ou mais links para imagens do produto. |
|
Isbn
|
inventoryItems.product.isbn | array of string |
Valor do Número do Livro Padrão Internacional para o produto. |
|
MPN
|
inventoryItems.product.mpn | string |
Número de parte do fabricante de um produto. |
|
Subtítulo
|
inventoryItems.product.subtitle | string |
Um subtítulo é um recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar nos resultados da pesquisa. |
|
Title
|
inventoryItems.product.title | string |
O título de um item de inventário pode ser adicionado ou modificado |
|
Upc
|
inventoryItems.product.upc | array of string |
Valor universal do Código do Produto para o produto. |
|
videoIds
|
inventoryItems.product.videoIds | array of string |
Uma matriz de um ou mais valores VideoId para o produto. |
|
SKU
|
inventoryItems.sku | string |
Unidade de Stock-Keeping definida pelo vendedor do item de inventário. |
|
Limit
|
limit | integer |
O número de itens de inventário que serão exibidos em cada página de resultados. |
|
Next
|
next | string |
URL para a próxima página de itens de inventário. |
|
Prev
|
prev | string |
URL para a página anterior de itens de inventário. |
|
Tamanho
|
size | integer |
Número total de páginas de resultados disponíveis. |
|
Total
|
total | integer |
Número ttotal de itens de inventário que existem para a conta do vendedor. |
Obter locais de inventário
Essa chamada recupera todos os detalhes definidos para cada local de inventário associado à conta do vendedor.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Offset
|
offset | string |
Especifica o número de locais a serem ignoradas no conjunto de resultados antes de retornar o primeiro local. |
|
|
Limit
|
limit | string |
Número máximo de registros a serem retornados por página de dados. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
URI da página atual de resultados do conjunto de resultados. |
|
Limit
|
limit | integer |
Número de itens retornados em uma única página do conjunto de resultados. |
|
Next
|
next | string |
URI para a página de resultados a seguir. |
|
Offset
|
offset | string |
Número de resultados ignorados no conjunto de resultados antes de listar o primeiro resultado retornado. |
|
Prev
|
prev | string |
URI para a página anterior de resultados. |
|
Total
|
total | integer |
Número total de itens recuperados no conjunto de resultados. |
|
Locais
|
locations | array of object |
Uma matriz de um ou mais locais de inventário do comerciante. |
|
Linha de endereço 1
|
locations.location.address.addressLine1 | string |
Primeira linha de um endereço de rua. |
|
Linha de endereço 2
|
locations.location.address.addressLine2 | string |
Segunda linha de um endereço de rua. |
|
City
|
locations.location.address.city | string |
Cidade na qual reside o local do inventário. |
|
País
|
locations.location.address.country | string |
Código do país no qual o endereço reside. |
|
Município
|
locations.location.address.county | string |
Condado no qual reside o endereço. |
|
Código postal
|
locations.location.address.postalCode | string |
Cep/cep do endereço. |
|
Estado ou província
|
locations.location.address.stateOrProvince | string |
Estado/província no qual reside o local do inventário. |
|
Latitude
|
locations.location.geoCoordinates.latitude | string |
Componente de latitude da coordenada geográfica. |
|
Longitude
|
locations.location.geoCoordinates.longitude | string |
Componente longitude da coordenada geográfica. |
|
ID da localização
|
locations.location.locationId | string |
ID exclusiva atribuída ao eBay para o local. |
|
Informações adicionais sobre o local
|
locations.locationAdditionalInformation | string |
Esse campo fornece informações adicionais sobre um local de inventário. |
|
Instruções de localização
|
locations.locationInstructions | string |
Esse campo é usado pelo comerciante para fornecer instruções especiais de retirada para o local do repositório. |
|
locationTypes
|
locations.locationTypes | array of string |
Esse contêiner define a função do local do inventário. |
|
Url da Web de localização
|
locations.locationWebUrl | string |
Este campo mostra o endereço site associado ao local do inventário. |
|
Chave de Localização do Comerciante
|
locations.merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
Status da Localização do Comerciante
|
locations.merchantLocationStatus | string |
Esse campo indica se o local do inventário está habilitado ou desabilitado. |
|
Nome
|
locations.name | string |
Nome do local do inventário. |
|
operatingHours
|
locations.operatingHours | array of object |
Esse contêiner mostra o horário de operação regular de um local de repositório durante os dias da semana. |
|
dayOfWeekEnum
|
locations.operatingHours.dayOfWeekEnum | string |
dayOfWeekEnum |
|
Intervalos
|
locations.operatingHours.intervals | array of object |
Esse contêiner é usado para definir os horários de abertura/fechamento do dia útil de um repositório. |
|
fechar
|
locations.operatingHours.intervals.close | string |
fechar |
|
em aberto
|
locations.operatingHours.intervals.open | string |
em aberto |
|
Telefone
|
locations.phone | string |
O número de telefone de um local de inventário. |
|
specialHours
|
locations.specialHours | array of object |
Esse contêiner mostra as horas de operação especiais para um local de repositório em uma data ou datas específicas. |
|
date
|
locations.specialHours.date | string |
date |
|
Intervalos
|
locations.specialHours.intervals | array of object |
Esse contêiner é usado para definir os horários de abertura e fechamento de um repositório em uma data específica. |
|
fechar
|
locations.specialHours.intervals.close | string |
fechar |
|
em aberto
|
locations.specialHours.intervals.open | string |
em aberto |
Obter o local do inventário
Essa chamada recupera todos os detalhes definidos do local de inventário especificado pelo parâmetro de caminho merchantLocationKey.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de Localização do Comerciante
|
merchantLocationKey | True | string |
Uma ID (chave definida pelo comerciante) exclusiva para um local de inventário. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Linha de endereço 1
|
location.address.addressLine1 | string |
Primeira linha de um endereço de rua. |
|
Linha de endereço 2
|
location.address.addressLine2 | string |
Segunda linha de um endereço de rua. |
|
Cidade
|
location.address.city | string |
Cidade na qual reside o local do inventário. |
|
País
|
location.address.country | string |
Código do país no qual o endereço reside |
|
Município
|
location.address.county | string |
Condado no qual reside o endereço. |
|
Código postal
|
location.address.postalCode | string |
Cep/cep do endereço. |
|
Estado ou província
|
location.address.stateOrProvince | string |
Estado/província no qual reside o local do inventário. |
|
Latitude
|
location.geoCoordinates.latitude | string |
Componente de latitude da coordenada geográfica. |
|
Longitude
|
location.geoCoordinates.longitude | string |
Componente longitude da coordenada geográfica. |
|
ID da localização
|
location.locationId | string |
ID exclusiva atribuída ao eBay para o local. |
|
Informações adicionais sobre o local
|
locationAdditionalInformation | string |
Este campo de texto fornece informações adicionais sobre um local de inventário. |
|
Instruções de localização
|
locationInstructions | string |
O campo é usado pelo comerciante para fornecer instruções especiais de retirada para o local do repositório. |
|
locationTypes
|
locationTypes | array of string |
Esse contêiner define a função do local do inventário. |
|
Url da Web de localização
|
locationWebUrl | string |
O campo mostra o endereço site associado ao local do inventário. |
|
Chave de Localização do Comerciante
|
merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
Status da Localização do Comerciante
|
merchantLocationStatus | string |
O campo indica se o local de inventário está habilitado ou desabilitado |
|
Nome
|
name | string |
Nome do local do inventário. |
|
operatingHours
|
operatingHours | array of object |
Esse contêiner mostra o horário de operação regular de um local de repositório durante os dias da semana. |
|
Enumeração da semana
|
operatingHours.dayOfWeekEnum | string |
Um valor é necessário para cada dia da semana em que o local do repositório tem horas de operação regulares. |
|
Intervalos
|
operatingHours.intervals | array of object |
Esse contêiner é usado para definir os horários de abertura/fechamento do dia útil de um repositório. |
|
fechar
|
operatingHours.intervals.close | string |
fechar |
|
em aberto
|
operatingHours.intervals.open | string |
em aberto |
|
Telefone
|
phone | string |
Número de telefone para um local de inventário. |
|
SpecialHours
|
specialHours | array of object |
Esse contêiner mostra as horas de operação especiais para um local de repositório em uma data ou datas específicas. |
|
Date
|
specialHours.date | string |
Um valor de data é necessário para cada data específica em que o local do repositório tem horas de operação especiais. |
|
Intervalos
|
specialHours.intervals | array of object |
Esse contêiner é usado para definir os horários de abertura/fechamento de um repositório em uma data específica. |
|
fechar
|
specialHours.intervals.close | string |
fechar |
|
em aberto
|
specialHours.intervals.open | string |
em aberto |
Obter política de cumprimento
Esse método recupera os detalhes completos de uma política de cumprimento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho fulfillmentPolicyId.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da política de cumprimento
|
fulfillmentPolicyId | True | string |
ID da política de cumprimento que você deseja recuperar |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
categoryTypes
|
categoryTypes | array of object |
Esse contêiner indica se a política de cumprimento se aplica a listagens de veículos automotores ou a listagens de veículos não motorizados. |
|
Nome
|
categoryTypes.name | string |
Nome do tipo de categoria ao qual a política se aplica. |
|
Description
|
description | string |
Uma descrição definida pelo vendedor da política de cumprimento. Esta descrição é apenas para uso do vendedor e não é exposta em nenhuma página do eBay. |
|
Envio de frete
|
freightShipping | boolean |
Se retornado como verdadeiro, o vendedor oferece frete. |
|
Fulfillment PolicyId
|
fulfillmentPolicyId | string |
ID exclusiva atribuída ao eBay para a política de cumprimento. |
|
Envio Global
|
globalShipping | boolean |
Se retornado como verdadeiro, o Programa de Envio Global do eBay será usado pelo vendedor para enviar itens para locais internacionais. |
|
Unidade
|
handlingTime.unit | string |
Um período de tempo é definido quando você aplica o valor especificado no campo de valor ao valor especificado para a unidade. |
|
Value
|
handlingTime.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Retirada local
|
localPickup | boolean |
Se retornado como true, a retirada local estará disponível para essa política. |
|
Marketplace Id
|
marketplaceId | string |
ID do marketplace do eBay à qual essa política de cumprimento se aplica. |
|
Nome
|
name | string |
Nome exclusivo definido pelo vendedor para essa política de atendimento. |
|
Entrega de retirada
|
pickupDropOff | boolean |
Se retornado como true, o vendedor oferece a opção "Clicar e Coletar". |
|
shippingOptions
|
shippingOptions | array of object |
Essa matriz é usada para fornecer informações detalhadas sobre as opções de envio nacionais e internacionais disponíveis para a política. |
|
Tipo de Custo
|
shippingOptions.costType | string |
Esse campo define se o modelo de custo de envio é FLAT_RATE ou CALCULADO |
|
Tipo de opção
|
shippingOptions.optionType | string |
Esse campo é usado para indicar se as opções de serviço de envio correspondentes são nacionais ou internacionais. |
|
Moeda
|
shippingOptions.packageHandlingCost.currency | string |
A moeda base aplicada ao campo de valor para estabelecer um valor monetário. |
|
Value
|
shippingOptions.packageHandlingCost.value | string |
O valor monetário na moeda especificada. |
|
ID da Tabela de Taxa
|
shippingOptions.rateTableId | string |
Esse campo será usado se o vendedor quiser associar uma tabela de taxa de remessa nacional ou internacional à política de negócios de cumprimento. |
|
shippingServices
|
shippingOptions.shippingServices | array of object |
Essa matriz consiste nas opções de serviços de remessa nacionais ou internacionais definidas para a política. |
|
moeda
|
shippingOptions.shippingServices.additionalShippingCost.currency | string |
moeda |
|
value
|
shippingOptions.shippingServices.additionalShippingCost.value | string |
value |
|
buyerResponsibleForPickup
|
shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
Este campo deve ser incluído para uma listagem de veículos automotores se for responsabilidade do comprador pegar o veículo adquirido após o pagamento total ser feito. |
|
buyerResponsibleForShipping
|
shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
Este campo deve ser incluído para uma listagem de veículos automotores se for responsabilidade do comprador organizar a remessa de um veículo adquirido após o pagamento total ser feito |
|
moeda
|
shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
moeda |
|
value
|
shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
value |
|
freeShipping
|
shippingOptions.shippingServices.freeShipping | boolean |
Esse campo será incluído se o vendedor oferecer uma opção de envio gratuito para o comprador. |
|
shippingCarrierCode
|
shippingOptions.shippingServices.shippingCarrierCode | string |
Esse campo define/indica a transportadora de remessa. |
|
moeda
|
shippingOptions.shippingServices.shippingCost.currency | string |
moeda |
|
value
|
shippingOptions.shippingServices.shippingCost.value | string |
value |
|
shippingServiceCode
|
shippingOptions.shippingServices.shippingServiceCode | string |
Esse campo define/indica a opção de serviço de envio doméstico ou internacional. |
|
regionExcluded
|
shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
regionExcluded |
|
nome_da_região
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
nome_da_região |
|
regionType
|
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
regionType |
|
regionIncluded
|
shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
regionIncluded |
|
nome_da_região
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
nome_da_região |
|
regionType
|
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
regionType |
|
sortOrder
|
shippingOptions.shippingServices.sortOrder | integer |
O valor inteiro definido neste campo controla a ordem do serviço de envio. |
|
regionExcluded
|
shipToLocations.regionExcluded | array of object |
Uma matriz de valores regionName que especificam as áreas para onde um vendedor não envia. |
|
Nome da região
|
shipToLocations.regionExcluded.regionName | string |
Uma cadeia de caracteres que indica o nome de uma região, conforme definido pelo eBay. |
|
Tipo de região
|
shipToLocations.regionExcluded.regionType | string |
Reservado para uso futuro. |
|
regionIncluded
|
shipToLocations.regionIncluded | array of object |
Uma matriz de campos regionName que especificam as áreas para onde um vendedor é enviado. |
|
Nome da região
|
shipToLocations.regionIncluded.regionName | string |
Uma cadeia de caracteres que indica o nome de uma região, conforme definido pelo eBay. |
|
Tipo de região
|
shipToLocations.regionIncluded.regionType | string |
Reservado para uso futuro. |
Obter política de pagamento
Esse método recupera os detalhes completos de uma política de pagamento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho paymentPolicyId.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Política de Pagamento
|
payment_policy_id | True | string |
ID da política de pagamento que você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
categoryTypes
|
categoryTypes | array of object |
Esse contêiner indica se a política de cumprimento se aplica a listagens de veículos automotores ou não motorizados. |
|
Nome
|
categoryTypes.name | string |
O tipo de categoria ao qual a política se aplica. |
|
Moeda
|
deposit.amount.currency | string |
A moeda base aplicada ao campo de valor para estabelecer um valor monetário. |
|
Value
|
deposit.amount.value | string |
O valor monetário na moeda especificada. |
|
Unidade
|
deposit.dueIn.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
deposit.dueIn.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Description
|
description | string |
Uma descrição definida pelo vendedor da política de pagamento. |
|
Unidade
|
fullPaymentDueIn.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
fullPaymentDueIn.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Pagamento Imediato
|
immediatePay | boolean |
Se esse campo for retornado como verdadeiro, o pagamento imediato será necessário do comprador |
|
Marketplace Id
|
marketplaceId | string |
ID do marketplace do eBay ao qual a política de negócios de pagamento se aplica. |
|
Nome
|
name | string |
ID do marketplace do eBay ao qual a política de negócios de pagamento se aplica. |
|
Instruções de Pagamento
|
paymentInstructions | string |
Embora esse campo possa ser retornado para algumas políticas comerciais de pagamento mais antigas, as instruções de pagamento não são mais suportadas por políticas de negócios de pagamento |
|
paymentMethods
|
paymentMethods | array of object |
Esse contêiner é retornado para mostrar as formas de pagamento que são aceitas para a política de negócios de pagamento. |
|
Tipo de método de pagamento
|
paymentMethods.paymentMethodType | string |
Tipo de método de pagamento para suporte offline |
|
ID da Política de Pagamento
|
paymentPolicyId | string |
Uma ID exclusiva atribuída ao eBay para uma política de negócios de pagamento. |
Obter política de retorno
Esse método recupera os detalhes completos da política de retorno especificada pelo parâmetro de caminho returnPolicyId.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da política de retorno
|
return_policy_id | True | string |
Retornar a ID da política que você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
categoryTypes
|
categoryTypes | array of object |
Esse contêiner indica a qual grupo de categorias a política de retorno se aplica. |
|
Nome
|
categoryTypes.name | string |
O tipo de categoria ao qual a política se aplica |
|
Description
|
description | string |
Uma descrição definida pelo vendedor da política de negócios de retorno. |
|
Método Return
|
internationalOverride.returnMethod | string |
Esse campo define/indica se o vendedor oferece itens de substituição ao comprador no caso de um retorno internacional. |
|
Unidade
|
internationalOverride.returnPeriod.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
internationalOverride.returnPeriod.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Retorna Aceito
|
internationalOverride.returnsAccepted | boolean |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Retornador de Custo de Envio
|
internationalOverride.returnShippingCostPayer | string |
Esse campo indica quem é responsável por pagar os encargos de envio dos itens retornados. |
|
Marketplace Id
|
marketplaceId | string |
ID do marketplace do eBay ao qual essa política de negócios de retorno se aplica. |
|
Nome
|
name | string |
Um nome definido pelo vendedor para essa política de negócios de pagamento. |
|
Método de reembolso
|
refundMethod | string |
Se um vendedor indicar que aceitará o retorno do comprador, esse valor será definido como MONEY_BACK. |
|
Instruções de retorno
|
returnInstructions | string |
Este campo baseado em texto fornece mais detalhes sobre as instruções de retorno especificadas pelo vendedor. Esse campo só será retornado se definido para a política de negócios de retorno. |
|
Método Return
|
returnMethod | string |
Esse campo só será retornado se o vendedor estiver disposto a oferecer um item de substituição como uma alternativa a 'Money Back' |
|
Unidade
|
returnPeriod.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
returnPeriod.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
ID da política de retorno
|
returnPolicyId | string |
ID exclusiva atribuída ao eBay para uma política de negócios de retorno. Essa ID é gerada quando a política é criada. |
|
Retorna Aceito
|
returnsAccepted | boolean |
Se esse campo for retornado como true, o vendedor aceitará o retorno. |
|
Retornador de Custo de Envio
|
returnShippingCostPayer | string |
Esse campo indica quem é responsável por pagar os encargos de envio dos itens retornados. |
Obter políticas de condição de item
Esse método retorna metadados de condição de item em uma, várias ou todas as categorias do eBay em um marketplace do eBay.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Marketplace Id
|
marketplace_id | True | string |
ID do marketplace do eBay para a qual as informações de política são recuperadas. |
|
Filter
|
filter | string |
Limita a resposta retornando informações de política apenas para as seções selecionadas da árvore de categoria. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
itemConditionPolicies
|
itemConditionPolicies | array of object |
Uma lista de IDs de categoria e as políticas para indicar a condição de um item em cada uma das categorias listadas. |
|
ID da categoria
|
itemConditionPolicies.categoryId | string |
ID de categoria à qual a política de condição de item se aplica. |
|
ID da árvore de categoria
|
itemConditionPolicies.categoryTreeId | string |
Um valor que indica o nó raiz da árvore de categoria usada para o conjunto de respostas. |
|
Condição do item necessária
|
itemConditionPolicies.itemConditionRequired | boolean |
Esse sinalizador indica se você deve ou não listar a condição do item em uma listagem para a categoria especificada. |
|
itemConditions
|
itemConditionPolicies.itemConditions | array of object |
Os valores de condição de item permitidos na categoria. |
|
conditionDescription
|
itemConditionPolicies.itemConditions.conditionDescription | string |
O rótulo legível para a condição. |
|
conditionId
|
itemConditionPolicies.itemConditions.conditionId | string |
Valor de ID da condição de item selecionada. |
|
uso
|
itemConditionPolicies.itemConditions.usage | string |
uso |
|
Avisos
|
warnings | array of object |
Lista de avisos que foram gerados como resultado da solicitação. |
|
Categoria
|
warnings.category | string |
Tipo de categoria para este erro ou aviso. |
|
Domínio
|
warnings.domain | string |
Nome de domínio que contém o serviço ou aplicativo. |
|
ID do erro
|
warnings.errorId | integer |
Um inteiro positivo que identifica exclusivamente a condição de erro específica que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Identifica elementos de solicitação específicos associados ao erro, se houver. A resposta de inputRefId é específica do formato. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma versão expandida da mensagem que deve ter cerca de 100 a 200 caracteres, mas não é necessária para ser tal. |
|
Message
|
warnings.message | string |
Uma mensagem independente de dispositivo amigável do usuário final e do desenvolvedor do aplicativo. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Identifica elementos de resposta específicos associados ao erro, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou o aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
Nome do subsistema ou subdivisão do domínio. |
Obter políticas de cumprimento
Esse método recupera todas as políticas de atendimento configuradas para o marketplace que você especificar usando o parâmetro de consulta marketplace_id.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Marketplace Id
|
marketplace_id | True | string |
ID do marketplace do eBay das políticas que você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
fulfillmentPolicies
|
fulfillmentPolicies | array of object |
Lista de políticas de atendimento do vendedor definidas para o marketplace especificado. |
|
Tipos de categoria
|
fulfillmentPolicies.categoryTypes | array of object |
Esse contêiner indica se a política de cumprimento se aplica a listagens de veículos motorizados ou não motorizados. |
|
nome
|
fulfillmentPolicies.categoryTypes.name | string |
O tipo de categoria ao qual a política se aplica |
|
Description
|
fulfillmentPolicies.description | string |
Uma descrição definida pelo vendedor da política de cumprimento. |
|
Envio de frete
|
fulfillmentPolicies.freightShipping | boolean |
Se retornado como verdadeiro, o vendedor oferece frete para itens grandes acima de 150 libras. |
|
ID da política de cumprimento
|
fulfillmentPolicies.fulfillmentPolicyId | string |
ID exclusiva atribuída ao eBay para a política de cumprimento. |
|
Envio Global
|
fulfillmentPolicies.globalShipping | boolean |
Se retornado como verdadeiro, o Programa de Envio Global do eBay será usado pelo vendedor para enviar itens para locais internacionais. |
|
Unidade
|
fulfillmentPolicies.handlingTime.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
fulfillmentPolicies.handlingTime.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Retirada local
|
fulfillmentPolicies.localPickup | boolean |
Se retornado como true, a retirada local estará disponível para essa política. |
|
Marketplace Id
|
fulfillmentPolicies.marketplaceId | string |
ID do marketplace do eBay ao qual essa política de cumprimento se aplica. |
|
Nome
|
fulfillmentPolicies.name | string |
Um nome definido pelo vendedor para essa política de cumprimento. Os nomes devem ser exclusivos para políticas atribuídas ao mesmo marketplace. |
|
Entrega de retirada
|
fulfillmentPolicies.pickupDropOff | boolean |
Se retornado como true, o vendedor oferece a opção "Clicar e Coletar". |
|
shippingOptions
|
fulfillmentPolicies.shippingOptions | array of object |
A matriz fornece informações detalhadas sobre as opções de envio nacionais e internacionais disponíveis para a política. |
|
Tipo de Custo
|
fulfillmentPolicies.shippingOptions.costType | string |
Esse campo define se o modelo de custo de envio é FLAT_RATE ou CALCULADO |
|
Moeda
|
fulfillmentPolicies.shippingOptions.insuranceFee.currency | string |
Moeda base aplicada ao campo de valor para estabelecer um valor monetário. |
|
Value
|
fulfillmentPolicies.shippingOptions.insuranceFee.value | string |
O valor monetário na moeda especificada. |
|
optionType
|
fulfillmentPolicies.shippingOptions.optionType | string |
optionType |
|
moeda
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency | string |
moeda |
|
value
|
fulfillmentPolicies.shippingOptions.packageHandlingCost.value | string |
value |
|
rateTableId
|
fulfillmentPolicies.shippingOptions.rateTableId | string |
rateTableId |
|
shippingServices
|
fulfillmentPolicies.shippingOptions.shippingServices | array of object |
shippingServices |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency | string |
moeda |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value | string |
value |
|
buyerResponsibleForPickup
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup | boolean |
buyerResponsibleForPickup |
|
buyerResponsibleForShipping
|
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping | boolean |
buyerResponsibleForShipping |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency | string |
moeda |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value | string |
value |
|
freeShipping
|
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping | boolean |
freeShipping |
|
shippingCarrierCode
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode | string |
shippingCarrierCode |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency | string |
moeda |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value | string |
value |
|
shippingServiceCode
|
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode | string |
shippingServiceCode |
|
regionExcluded
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded | array of object |
regionExcluded |
|
nome_da_região
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName | string |
nome_da_região |
|
regionType
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType | string |
regionType |
|
regionIncluded
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded | array of object |
regionIncluded |
|
nome_da_região
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName | string |
nome_da_região |
|
regionType
|
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType | string |
regionType |
|
sortOrder
|
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder | integer |
sortOrder |
|
moeda
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency | string |
moeda |
|
value
|
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value | string |
value |
|
Região Excluída
|
fulfillmentPolicies.shipToLocations.regionExcluded | array of object |
Uma matriz de valores regionName que especificam as áreas para onde um vendedor não envia. |
|
nome_da_região
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionName | string |
nome_da_região |
|
regionType
|
fulfillmentPolicies.shipToLocations.regionExcluded.regionType | string |
regionType |
|
Região incluída
|
fulfillmentPolicies.shipToLocations.regionIncluded | array of object |
Uma matriz de campos regionName que especificam as áreas para onde um vendedor é enviado. |
|
nome_da_região
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionName | string |
nome_da_região |
|
regionType
|
fulfillmentPolicies.shipToLocations.regionIncluded.regionType | string |
regionType |
|
Href
|
href | string |
Esse campo é para uso futuro. |
|
Limit
|
limit | integer |
Esse campo é para uso futuro. |
|
Next
|
next | string |
Esse campo é para uso futuro. |
|
Offset
|
offset | integer |
Esse campo é para uso futuro. |
|
Prev
|
prev | string |
Esse campo é para uso futuro. |
|
Total
|
total | integer |
Número total de políticas de atendimento recuperadas no conjunto de resultados. |
Obter políticas de pagamento
Esse método recupera todas as políticas de pagamento configuradas para o marketplace que você especificar usando o parâmetro de consulta marketplace_id.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Marketplace Id
|
marketplace_id | string |
ID do marketplace do eBay das políticas que você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
Esse campo é para uso futuro. |
|
Limit
|
limit | integer |
Esse campo é para uso futuro. |
|
Next
|
next | string |
Esse campo é para uso futuro. |
|
Offset
|
offset | integer |
Esse campo é para uso futuro. |
|
paymentPolicies
|
paymentPolicies | array of object |
Lista de políticas de negócios de pagamento do vendedor definidas para o marketplace especificado. |
|
categoryTypes
|
paymentPolicies.categoryTypes | array of object |
Esse contêiner indica se a política de cumprimento se aplica a listagens de veículos automotores ou não motorizados. |
|
padrão
|
paymentPolicies.categoryTypes.default | boolean |
padrão |
|
nome
|
paymentPolicies.categoryTypes.name | string |
nome |
|
Moeda
|
paymentPolicies.deposit.amount.currency | string |
A moeda base aplicada ao campo de valor para estabelecer um valor monetário. |
|
Value
|
paymentPolicies.deposit.amount.value | string |
O valor monetário na moeda especificada. |
|
Unidade
|
paymentPolicies.deposit.dueIn.unit | string |
Esses valores representam a unidade de medição de tempo, como DAY. |
|
Value
|
paymentPolicies.deposit.dueIn.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Description
|
paymentPolicies.description | string |
Uma descrição definida pelo vendedor da política de pagamento. |
|
Unidade
|
paymentPolicies.fullPaymentDueIn.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
paymentPolicies.fullPaymentDueIn.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
Pagamento Imediato
|
paymentPolicies.immediatePay | boolean |
Se esse campo for retornado como verdadeiro, o pagamento imediato será necessário do comprador |
|
Marketplace Id
|
paymentPolicies.marketplaceId | string |
ID do marketplace do eBay à qual a política de negócios de pagamento se aplica. |
|
Nome
|
paymentPolicies.name | string |
Um nome definido pelo vendedor para essa política de cumprimento. |
|
Instruções de Pagamento
|
paymentPolicies.paymentInstructions | string |
Embora esse campo possa ser retornado para algumas políticas comerciais de pagamento mais antigas, as instruções de pagamento não são mais suportadas por políticas de negócios de pagamento. Se esse campo for retornado, ele poderá ser ignorado e essas instruções de pagamento não aparecerão em nenhuma listagem que use a política de negócios correspondente. |
|
paymentMethods
|
paymentPolicies.paymentMethods | array of object |
Esse contêiner é retornado para mostrar as formas de pagamento que são aceitas para a política de negócios de pagamento. |
|
paymentMethodType
|
paymentPolicies.paymentMethods.paymentMethodType | string |
Tipo de método de pagamento |
|
ID da Política de Pagamento
|
paymentPolicies.paymentPolicyId | string |
ID exclusiva atribuída ao eBay para uma política de negócios de pagamento. |
|
Prev
|
prev | string |
Esse campo é para uso futuro. |
|
Total
|
total | integer |
Número total de políticas de negócios de pagamento recuperadas no conjunto de resultados. |
Obter políticas de retorno
Esse método recupera todas as políticas de retorno configuradas para o marketplace que você especificar usando o parâmetro de consulta marketplace_id.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Marketplace ID
|
marketplace_id | True | string |
ID do marketplace do eBay da política que você deseja recuperar. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
Esse campo é para uso futuro. |
|
Limit
|
limit | integer |
Esse campo é para uso futuro. |
|
Next
|
next | string |
Esse campo é para uso futuro. |
|
Offset
|
offset | integer |
Esse campo é para uso futuro. |
|
Prev
|
prev | string |
Esse campo é para uso futuro. |
|
returnPolicies
|
returnPolicies | array of object |
Lista das políticas de negócios de retorno do vendedor definidas para o marketplace especificado. |
|
categoryTypes
|
returnPolicies.categoryTypes | array of object |
Esse contêiner indica a qual grupo de categorias a política de retorno se aplica. |
|
nome
|
returnPolicies.categoryTypes.name | string |
nome |
|
Description
|
returnPolicies.description | string |
Uma descrição definida pelo vendedor da política de negócios de retorno. |
|
Método Return
|
returnPolicies.internationalOverride.returnMethod | string |
Esse campo define/indica se o vendedor oferece itens de substituição ao comprador no caso de um retorno internacional. |
|
Unidade
|
returnPolicies.internationalOverride.returnPeriod.unit | string |
Esses valores de enumeração representam a unidade de medição de tempo, como DAY. |
|
Value
|
returnPolicies.internationalOverride.returnPeriod.value | integer |
Unidade de medição de tempo, como DAY. |
|
Retorna Aceito
|
returnPolicies.internationalOverride.returnsAccepted | boolean |
Se definido como true, o vendedor aceita retornos internacionais. |
|
Retornador de Custo de Envio
|
returnPolicies.internationalOverride.returnShippingCostPayer | string |
Esse campo indica quem é responsável por pagar os encargos de envio dos itens retornados. |
|
Marketplace Id
|
returnPolicies.marketplaceId | string |
ID do marketplace do eBay à qual essa política de negócios de retorno se aplica. |
|
Nome
|
returnPolicies.name | string |
Um nome definido pelo vendedor para essa política de negócios de pagamento. |
|
Método de reembolso
|
returnPolicies.refundMethod | string |
Se um vendedor indicar que aceitará o retorno do comprador, esse valor será definido como MONEY_BACK. |
|
Instruções de retorno
|
returnPolicies.returnInstructions | string |
Este campo baseado em texto fornece mais detalhes sobre as instruções de retorno especificadas pelo vendedor. |
|
Método Return
|
returnPolicies.returnMethod | string |
Esse campo só será retornado se o vendedor estiver disposto a oferecer um item de substituição como uma alternativa ao 'Money Back'. |
|
Unidade
|
returnPolicies.returnPeriod.unit | string |
Unidade de medição de tempo, como DAY. |
|
Value
|
returnPolicies.returnPeriod.value | integer |
Valor da unidade de medição de tempo especificado no campo de unidade. |
|
ID da política de retorno
|
returnPolicies.returnPolicyId | string |
Uma ID exclusiva atribuída ao eBay para uma política de negócios de retorno. |
|
Retorno Aceito
|
returnPolicies.returnsAccepted | boolean |
Se esse campo for retornado como true, o vendedor aceitará o retorno. |
|
Retornador de Custo de Envio
|
returnPolicies.returnShippingCostPayer | string |
Esse campo indica quem é responsável por pagar os encargos de envio dos itens retornados. |
|
Total
|
total | integer |
Número total de políticas comerciais de retorno recuperadas no conjunto de resultados. |
Obter sugestões de categoria
Essa chamada retorna uma matriz de nós folha de árvore de categoria na árvore de categoria especificada que são consideradas pelo eBay para corresponder mais de perto à consulta.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da árvore de categoria
|
category_tree_id | True | string |
Identificador exclusivo da árvore de categoria do eBay para o qual os nós sugeridos estão sendo solicitados. |
|
Termo de Pesquisa
|
q | True | string |
Um termo de pesquisa que descreve o item que está sendo oferecido para venda. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
categorySuggestions
|
categorySuggestions | array of object |
Contém detalhes sobre uma ou mais categorias sugeridas que correspondem às palavras-chave fornecidas. |
|
ID da categoria
|
categorySuggestions.category.categoryId | string |
Identificador exclusivo da categoria eBay dentro de sua árvore de categoria. |
|
Nome da categoria
|
categorySuggestions.category.categoryName | string |
Nome da categoria identificada por categoryId. |
|
Ancestrais do nó de árvore de categoria
|
categorySuggestions.categoryTreeNodeAncestors | array of object |
Uma matriz de lista ordenada de referências de categoria que descreve o local da categoria sugerida na árvore de categoria especificada. |
|
categoryId
|
categorySuggestions.categoryTreeNodeAncestors.categoryId | string |
Identificador exclusivo da categoria ancestral do eBay. |
|
categoryName
|
categorySuggestions.categoryTreeNodeAncestors.categoryName | string |
Nome da categoria ancestral identificada por categoryId. |
|
categorySubtreeNodeHref
|
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref | string |
A parte href da chamada getCategorySubtree que recupera a subárvore abaixo do nó de categoria ancestral. |
|
categoryTreeNodeLevel
|
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel | integer |
Nível absoluto do nó de categoria ancestral na hierarquia de sua árvore de categoria. |
|
Nível do nó da árvore de categoria
|
categorySuggestions.categoryTreeNodeLevel | integer |
Nível absoluto do nó de categoria ancestral na hierarquia de sua árvore de categoria. |
|
Relevância
|
categorySuggestions.relevancy | string |
Esse campo é reservado para uso interno ou futuro. |
|
ID da árvore de categoria
|
categoryTreeId | string |
Identificador exclusivo da árvore de categorias do eBay da qual as sugestões são retornadas. |
|
Versão da árvore de categoria
|
categoryTreeVersion | string |
A versão da árvore de categoria identificada por categoryTreeId. |
Obter TreeId de categoria padrão
Um determinado marketplace do eBay pode usar várias árvores de categoria, mas uma dessas árvores é considerada o padrão para esse marketplace. Essa chamada recupera uma referência à árvore de categoria padrão associada à ID do marketplace do eBay especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Marketplace ID
|
marketplace_id | True | string |
ID do marketplace do eBay para a qual a ID da árvore de categoria está sendo solicitada. |
|
Accept-Language
|
Accept-Language | True | string |
Um cabeçalho usado para indicar o idioma natural que o vendedor prefere para a resposta. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da árvore de categoria
|
categoryTreeId | string |
ID de árvore de categoria exclusiva do eBay para o marketplace especificado. |
|
Versão da árvore de categoria
|
categoryTreeVersion | string |
A versão da árvore de categoria identificada por categoryTreeId. |
Oferta GET
Essa chamada recupera uma oferta publicada ou não publicada específica.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
offerId | True | string |
Identificador exclusivo da oferta que deve ser recuperada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Quantidade Disponível
|
availableQuantity | integer |
Quantidade do item de inventário que estará disponível para compra por compradores. |
|
ID da categoria
|
categoryId | string |
Identificador exclusivo da categoria primária do eBay na qual o item de inventário está listado. |
|
ID de caridade
|
charity.charityId | string |
Identificador exclusivo atribuído ao eBay da organização de caridade que receberá uma porcentagem dos lucros de vendas. |
|
Percentual de doação
|
charity.donationPercentage | string |
Percentual de preço de compra que a organização de caridade receberá para cada venda gerada pela listagem. |
|
ID do produto produtor
|
extendedProducerResponsibility.producerProductId | string |
Identificador exclusivo do produtor relacionado ao item. |
|
ID do pacote do produto
|
extendedProducerResponsibility.productPackageId | string |
ID exclusiva do produtor de qualquer empacotamento relacionado ao produto adicionado pelo vendedor. |
|
ID do pacote de remessa
|
extendedProducerResponsibility.shipmentPackageId | string |
Identificador exclusivo do produtor de qualquer empacotamento usado pelo vendedor para enviar o item. |
|
ID da Documentação do Produto
|
extendedProducerResponsibility.productDocumentationId | string |
Identificador exclusivo do produtor de qualquer papel adicionado ao pacote do item pelo vendedor. |
|
Moeda
|
extendedProducerResponsibility.ecoParticipationFee.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
extendedProducerResponsibility.ecoParticipationFee.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Formato
|
format | string |
Formato de listagem da oferta |
|
Ocultar detalhes do comprador
|
hideBuyerDetails | boolean |
Esse campo será retornado como true se o recurso de listagem privada tiver sido habilitado para a oferta. |
|
Incluir detalhes do produto do catálogo
|
includeCatalogProductDetails | boolean |
Esse campo indica se os detalhes do catálogo de produtos do eBay são aplicados ou não a uma listagem. |
|
ID de listagem
|
listing.listingId | string |
Identificador exclusivo da listagem do eBay associado à oferta publicada. |
|
Status da listagem
|
listing.listingStatus | string |
Status de listagem associado à oferta publicada. |
|
Quantidade Vendida
|
listing.soldQuantity | integer |
Quantidade de produto que foi vendido para a oferta publicada. |
|
Descrição da listagem
|
listingDescription | string |
Descrição da listagem do eBay |
|
Duração da listagem
|
listingDuration | string |
Esse campo indica o número de dias em que a listagem estará ativa. |
|
Moeda
|
listingPolicies.bestOfferTerms.autoAcceptPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Melhor oferta habilitada
|
listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
Esse contêiner será usado se o vendedor quiser dar suporte ao recurso Melhor Oferta em sua listagem. |
|
eBay Plus se qualificado
|
listingPolicies.eBayPlusIfEligible | boolean |
Esse campo será incluído em uma oferta se um vendedor de Top-Rated for optado pelo programa eBay Plus. |
|
ID da política de cumprimento
|
listingPolicies.fulfillmentPolicyId | string |
O identificador exclusivo indica a política de negócios de atendimento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
ID da Política de Pagamento
|
listingPolicies.paymentPolicyId | string |
O identificador exclusivo indica a política de negócios de pagamento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
productCompliancePolicyIds
|
listingPolicies.productCompliancePolicyIds | array of string |
Esse campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
ID da política de retorno
|
listingPolicies.returnPolicyId | string |
O identificador exclusivo indica a política de negócios de retorno que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
shippingCostOverrides
|
listingPolicies.shippingCostOverrides | array of object |
Esse contêiner será usado se o vendedor quiser substituir os custos de envio de uma ou mais opções de serviço de envio nacionais ou internacionais definidas na política de listagem de cumprimento. |
|
Moeda
|
listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Priority
|
listingPolicies.shippingCostOverrides.priority | integer |
A entrada de valor inteiro nesse campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio doméstico ou internacional na política de cumprimento será modificada com os custos de envio atualizados. |
|
Moeda
|
listingPolicies.shippingCostOverrides.shippingCost.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
listingPolicies.shippingCostOverrides.shippingCost.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Tipo de serviço de envio
|
listingPolicies.shippingCostOverrides.shippingServiceType | string |
Esse valor indica se o serviço de remessa é uma opção de serviço de envio nacional ou internacional. |
|
Retome a ID da política
|
listingPolicies.takeBackPolicyId | string |
A ID do Vendedor criou uma política de reposição. |
|
Data de início da listagem
|
listingStartDate | string |
Esse carimbo de data/hora é a data/hora que o vendedor definiu para a listagem agendada. |
|
Tamanho do Lote
|
lotSize | integer |
Esse campo só será aplicável se a listagem for muito listagem. Muita listagem é uma listagem que tem várias quantidades do mesmo produto. |
|
Marketplace Id
|
marketplaceId | string |
Identificador exclusivo do site do eBay no qual a oferta está disponível ou será disponibilizada. |
|
Chave de Localização do Comerciante
|
merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
ID da Oferta
|
offerId | string |
Identificador exclusivo da oferta. |
|
Moeda
|
pricingSummary.auctionReservePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
pricingSummary.auctionReservePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
pricingSummary.auctionStartPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
pricingSummary.auctionStartPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
pricingSummary.minimumAdvertisedPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
pricingSummary.minimumAdvertisedPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Originalmente vendido por preço de varejo em
|
pricingSummary.originallySoldForRetailPriceOn | string |
Esse campo será necessário se o recurso Preços de Strikethrough for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original em um site do eBay, ou vendido por esse preço por um varejista terceirizado. |
|
Moeda
|
pricingSummary.originalRetailPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
pricingSummary.originalRetailPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
pricingSummary.price.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
pricingSummary.price.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Visibilidade de preços
|
pricingSummary.pricingVisibility | string |
Esse campo será necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
Limite de quantidade por comprador
|
quantityLimitPerBuyer | integer |
Esse campo só será aplicável se o vendedor quiser definir uma restrição na quantidade de compra de um item de inventário por vendedor. |
|
ID da categoria secundária
|
secondaryCategoryId | string |
Identificador exclusivo para uma categoria secundária e aplicável se o vendedor decidir listar o item em duas categorias. |
|
SKU
|
sku | string |
Valor de SKU definido pelo vendedor do produto na oferta. |
|
Situação
|
status | string |
O valor especifica o status da oferta. |
|
Nomes de categoria de repositório
|
storeCategoryNames | array of string |
Nome da categoria da loja |
|
Aplicar Imposto
|
tax.applyTax | boolean |
Esse campo será incluído se o vendedor quiser fazer referência ao imposto sobre vendas no nível da conta |
|
Categoria de imposto de terceiros
|
tax.thirdPartyTaxCategory | string |
O código da categoria de exceção fiscal. Se esse campo for usado, o imposto sobre vendas também se aplicará a um serviço/taxa e não apenas ao preço do item. |
|
Percentual de IVA
|
tax.vatPercentage | number |
Esse valor é a taxa de IVA do item, se houver. Quando um percentual de IVA é especificado, as informações de IVA do item são exibidas na página Item de Exibição da listagem. |
Ofertas GET
Essa chamada recupera todas as ofertas existentes para o valor de SKU especificado. O vendedor tem a opção de limitar as ofertas que são recuperadas para um marketplace específico do eBay ou para um formato de listagem.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
SKU
|
sku | True | string |
Valor de SKU definido pelo vendedor |
|
Marketplace Id
|
marketplace_id | string |
Identificador exclusivo do marketplace do eBay. |
|
|
Formato
|
format | string |
Formato de listagem para a oferta. |
|
|
Limit
|
limit | string |
Número máximo de registros a serem retornados por página de dados. |
|
|
Offset
|
offset | string |
Número da página a ser recuperado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Href
|
href | string |
URL para a página atual de ofertas. |
|
Limit
|
limit | integer |
Número de ofertas que serão exibidas em cada página de resultados. |
|
Next
|
next | string |
URL para a próxima página de ofertas. |
|
offers
|
offers | array of object |
Esse contêiner é uma matriz de uma ou mais ofertas do vendedor para o valor de SKU. |
|
Quantidade Disponível
|
offers.availableQuantity | integer |
Quantidade de item de inventário que estará disponível para compra. |
|
ID da categoria
|
offers.categoryId | string |
ID exclusiva da categoria do eBay na qual o item de inventário está listado. |
|
ID de caridade
|
offers.charity.charityId | string |
Identificador exclusivo atribuído ao eBay da organização de caridade que receberá uma porcentagem dos lucros das vendas. |
|
Percentual de doação
|
offers.charity.donationPercentage | string |
Percentual de preço de compra que a organização de caridade receberá para cada venda. |
|
ID do produto produtor
|
offers.extendedProducerResponsibility.producerProductId | string |
Identificador exclusivo do produtor relacionado ao item. |
|
ID do pacote do produto
|
offers.extendedProducerResponsibility.productPackageId | string |
ID exclusiva do produto empacotado adicionado pelo vendedor. |
|
ID do pacote de remessa
|
offers.extendedProducerResponsibility.shipmentPackageId | string |
Identificador exclusivo do produtor de qualquer empacotamento usado pelo vendedor para enviar o item. |
|
ID da Documentação do Produto
|
offers.extendedProducerResponsibility.productDocumentationId | string |
Identificador exclusivo do produtor de qualquer papel adicionado ao pacote do item pelo vendedor. |
|
Moeda
|
offers.extendedProducerResponsibility.ecoParticipationFee.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.extendedProducerResponsibility.ecoParticipationFee.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Formato
|
offers.format | string |
Esse valor define o formato de listagem da oferta |
|
Ocultar detalhes do comprador
|
offers.hideBuyerDetails | boolean |
Esse campo será retornado como true se o recurso de listagem privada tiver sido habilitado para a oferta. |
|
Incluir detalhes do produto do catálogo
|
offers.includeCatalogProductDetails | boolean |
Esse campo indica se os detalhes do catálogo de produtos do eBay são aplicados ou não a uma listagem. |
|
ID de listagem
|
offers.listing.listingId | string |
Identificador exclusivo da listagem do eBay associada à oferta publicada. |
|
Status da listagem
|
offers.listing.listingStatus | string |
Status de listagem associado à oferta publicada. |
|
Quantidade Vendida
|
offers.listing.soldQuantity | integer |
Quantidade de Produto que foi vendida para a oferta publicada. |
|
Descrição da listagem
|
offers.listingDescription | string |
Descrição da listagem do eBay. |
|
Duração da listagem
|
offers.listingDuration | string |
Indica o número de dias em que a listagem estará ativa. |
|
Moeda
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.listingPolicies.bestOfferTerms.autoAcceptPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.listingPolicies.bestOfferTerms.autoDeclinePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Melhor oferta habilitada
|
offers.listingPolicies.bestOfferTerms.bestOfferEnabled | boolean |
Esse campo indica se o recurso melhor oferta está habilitado ou não para a listagem. |
|
eBay Plus se qualificado
|
offers.listingPolicies.eBayPlusIfEligible | boolean |
Esse campo será incluído em uma oferta e definido como true se um vendedor Top-Rated for optado pelo programa eBay Plus |
|
ID da política de cumprimento
|
offers.listingPolicies.fulfillmentPolicyId | string |
O identificador exclusivo indica a política de negócios de atendimento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
ID da Política de Pagamento
|
offers.listingPolicies.paymentPolicyId | string |
O identificador exclusivo indica a política de negócios de pagamento que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
productCompliancePolicyIds
|
offers.listingPolicies.productCompliancePolicyIds | array of string |
Esse campo contém uma matriz de até cinco IDs especificando as políticas de conformidade criadas pelo vendedor para a listagem. |
|
ID da política de retorno
|
offers.listingPolicies.returnPolicyId | string |
O identificador exclusivo indica a política de negócios de retorno que será usada depois que uma oferta for publicada e convertida em uma listagem do eBay. |
|
shippingCostOverrides
|
offers.listingPolicies.shippingCostOverrides | array of object |
Esse contêiner será usado se o vendedor quiser substituir os custos de envio ou a sobretaxa para uma ou mais opções de serviço de transporte doméstico ou internacional definidas na política de listagem de cumprimento. |
|
moeda
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.currency | string |
moeda |
|
value
|
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value | string |
value |
|
priority
|
offers.listingPolicies.shippingCostOverrides.priority | integer |
priority |
|
moeda
|
offers.listingPolicies.shippingCostOverrides.shippingCost.currency | string |
moeda |
|
value
|
offers.listingPolicies.shippingCostOverrides.shippingCost.value | string |
value |
|
shippingServiceType
|
offers.listingPolicies.shippingCostOverrides.shippingServiceType | string |
shippingServiceType |
|
Retome a ID da política
|
offers.listingPolicies.takeBackPolicyId | string |
ID do vendedor que criou a política de reposição. |
|
Data de início da listagem
|
offers.listingStartDate | string |
Data/hora que o vendedor definiu para a listagem agendada. |
|
Tamanho do Lote
|
offers.lotSize | integer |
Esse campo só será aplicável e retornado se a listagem for muito listagem. |
|
Marketplace Id
|
offers.marketplaceId | string |
Identificador exclusivo do site do eBay no qual a oferta está disponível ou será disponibilizada. |
|
Chave de Localização do Comerciante
|
offers.merchantLocationKey | string |
Identificador exclusivo do local do inventário. |
|
ID da Oferta
|
offers.offerId | string |
Identificador exclusivo da oferta. |
|
Moeda
|
offers.pricingSummary.auctionReservePrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.pricingSummary.auctionReservePrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.pricingSummary.auctionStartPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.pricingSummary.auctionStartPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.pricingSummary.minimumAdvertisedPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.pricingSummary.minimumAdvertisedPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Originalmente vendido por preço de varejo em
|
offers.pricingSummary.originallySoldForRetailPriceOn | string |
Esse campo será necessário se o recurso Preços de Strikethrough for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original em um site do eBay, ou vendido por esse preço por um varejista terceirizado. |
|
Moeda
|
offers.pricingSummary.originalRetailPrice.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.pricingSummary.originalRetailPrice.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Moeda
|
offers.pricingSummary.price.currency | string |
Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda. |
|
Value
|
offers.pricingSummary.price.value | string |
Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda. |
|
Visibilidade de preços
|
offers.pricingSummary.pricingVisibility | string |
Esse campo será necessário se o recurso Preço Mínimo Anunciado for usado na oferta. |
|
Limite de quantidade por comprador
|
offers.quantityLimitPerBuyer | integer |
Esse campo só é aplicável e definido se o vendedor deseja definir uma restrição na quantidade de compra de um item de inventário por vendedor. |
|
ID da categoria secundária
|
offers.secondaryCategoryId | string |
Identificador exclusivo para uma categoria secundária. |
|
SKU
|
offers.sku | string |
Valor de SKU definido pelo vendedor do produto na oferta. |
|
Situação
|
offers.status | string |
O valor especifica o status da oferta. |
|
storeCategoryNames
|
offers.storeCategoryNames | array of string |
Esse contêiner será retornado se o vendedor optar por colocar o item de inventário em uma ou duas categorias de repositório do eBay que o vendedor configurou para sua loja do eBay |
|
Aplicar Imposto
|
offers.tax.applyTax | boolean |
Esse campo será incluído se o vendedor quiser fazer referência à tabela de imposto sobre vendas no nível da conta para calcular o imposto sobre vendas para um pedido. |
|
Categoria de imposto de terceiros
|
offers.tax.thirdPartyTaxCategory | string |
Código de categoria de exceção fiscal. |
|
Percentual de IVA
|
offers.tax.vatPercentage | number |
Valor da taxa de IVA (Imposto sobre Valor Agregado) para o item, se houver. |
|
Prev
|
prev | string |
URL para a página anterior das ofertas. |
|
Tamanho
|
size | integer |
Número de ofertas sendo exibidas na página atual dos resultados. |
|
Total
|
total | integer |
Número total de ofertas que existem para o valor de SKU especificado. |
Publicar Oferta
Essa chamada é usada para converter uma oferta não publicada em uma oferta publicada ou listagem ao vivo do eBay. O identificador exclusivo da oferta (offerId) é passado no final do URI de chamada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
offerId | True | string |
Identificador exclusivo da oferta que deve ser publicada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de listagem
|
listingId | string |
Identificador exclusivo da listagem do eBay recém-criada. |
|
Avisos
|
warnings | array of object |
Esse contêiner será retornado se houver um ou mais avisos associados à tentativa de retirar a oferta. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro. |
|
Domínio
|
warnings.domain | string |
O nome do domínio no qual o erro ou aviso ocorreu. |
|
ID do erro
|
warnings.errorId | integer |
Um código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de solicitação específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de resposta específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou o aviso. |
|
nome
|
warnings.parameters.name | string |
nome |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
O nome do subdomínio no qual o erro ou aviso ocorreu. |
Retirar oferta
Essa chamada é usada para encerrar uma listagem de variação única associada à oferta especificada.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da Oferta
|
offerId | True | string |
Identificador exclusivo da oferta que deve ser retirada. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID de listagem
|
listingId | string |
Identificador exclusivo da listagem do eBay associada à oferta que foi retirada. |
|
Avisos
|
warnings | array of object |
Esse contêiner será retornado se houver um ou mais avisos associados à tentativa de retirar a oferta. |
|
Categoria
|
warnings.category | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
Domínio
|
warnings.domain | string |
Esse valor de cadeia de caracteres indica a categoria de erro |
|
ID do erro
|
warnings.errorId | integer |
Um código exclusivo que identifica o erro ou aviso específico que ocorreu. |
|
inputRefIds
|
warnings.inputRefIds | array of string |
Uma matriz de uma ou mais IDs de referência que identificam os elementos de solicitação específicos mais intimamente associados ao erro ou ao aviso, se houver. |
|
Mensagem Longa
|
warnings.longMessage | string |
Uma descrição detalhada da condição que causou o erro ou aviso e informações sobre o que fazer para corrigir o problema. |
|
Message
|
warnings.message | string |
Uma descrição da condição que causou o erro ou aviso. |
|
outputRefIds
|
warnings.outputRefIds | array of string |
Esse contêiner será retornado se houver um ou mais avisos associados à tentativa de retirar a oferta. |
|
parameters
|
warnings.parameters | array of object |
Várias mensagens de aviso e erro retornam uma ou mais variáveis que contêm informações contextuais sobre o erro ou a guerra. |
|
nome
|
warnings.parameters.name | string |
nome |
|
value
|
warnings.parameters.value | string |
value |
|
Subdomain
|
warnings.subdomain | string |
O nome do subdomínio no qual o erro ou aviso ocorreu. |
Definições
cadeia
Esse é o tipo de dados básico 'string'.