Compartilhar via


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
Email 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 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.

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'.