Partilhar via


eBay (Editora Independente) (Pré-visualização)

O eBay é uma empresa multinacional americana de comércio eletrônico que facilita as vendas de consumidor para consumidor e de empresa para consumidor através de seu site.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - 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
Editora Artesian Software Technologies LLP
Sítio Web 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

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição 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.

Esta conexão não é compartilhável. Se o aplicativo avançado 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 - O seu clientId do eBay cadeia (de caracteres) Introduza o ID do cliente. Verdade
Segredo do Cliente securestring Introduza o segredo do cliente. Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Atualizar oferta

Esta chamada atualiza uma oferta existente que pode estar em estado publicado ou não publicado.

Criar local de inventário

Use esta chamada para criar um novo local de inventário. Para criar e publicar uma oferta, um vendedor deve ter pelo menos um local de inventário, pois cada oferta deve estar associada a um local.

Criar oferta

Esta chamada cria uma oferta para um item de inventário específico em um mercado específico do eBay.

Criar ou substituir item de inventário

Esta chamada cria um novo registro de item de inventário ou substitui um registro de item de inventário existente.

Excluir oferta

Esta chamada eliminará permanentemente a oferta

GET Item de inventário

Esta chamada recupera o registro de item de inventário para uma determinada SKU.

Obtenha políticas de atendimento

Esse método recupera todas as políticas de atendimento configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id.

Obter aspetos do item para a categoria

Esta chamada retorna uma lista de aspetos que são apropriados ou necessários para descrever com precisão os itens na categoria de folha especificada. Cada aspeto identifica um atributo de item (por exemplo, cor) para o qual o vendedor será solicitado ou incentivado a fornecer um valor (ou valores de variação) ao oferecer um item nessa categoria no eBay.

Obter categoria padrão TreeId

Um determinado mercado do eBay pode usar várias árvores de categoria, mas uma dessas árvores é considerada o padrão para esse mercado. Esta chamada recupera uma referência à árvore de categorias padrão associada ao ID de mercado do eBay especificado.

Obter itens de inventário

Esta chamada recupera todos os registros de itens de estoque definidos para a conta do vendedor.

Obter locais de inventário

Esta chamada recupera todos os detalhes definidos para cada local de inventário associado à conta do vendedor.

Obter localização de inventário

Esta chamada recupera todos os detalhes definidos do local de inventário especificado pelo parâmetro de caminho merchantLocationKey.

Obter Política de Atendimento

Esse método recupera os detalhes completos de uma política de atendimento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho fulfillmentPolicyId.

Obter Política de Devoluções

Esse método recupera os detalhes completos da política de retorno especificada pelo parâmetro de caminho returnPolicyId.

Obter Política de Pagamento

Este 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í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 mercado do eBay.

Obter Políticas de Devolução

Esse método recupera todas as políticas de retorno configuradas para o mercado especificado 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 especificado usando o parâmetro de consulta marketplace_id.

Obter sugestões de categoria

Esta chamada retorna uma matriz de nós de folha de árvore de categorias na árvore de categorias especificada que são considerados pelo eBay como correspondendo mais estreitamente à consulta.

Oferta GET

Esta chamada recupera uma oferta específica publicada ou não publicada.

Ofertas GET

Esta 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 a um mercado específico do eBay ou a um formato de anúncio.

Publicar oferta

Esta 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

Esta chamada é usada para encerrar uma listagem de variação única associada à oferta especificada.

Atualizar oferta

Esta chamada atualiza uma oferta existente que pode estar em estado publicado ou não publicado.

Parâmetros

Name Chave Necessá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 estoque para compra.

ID da categoria
categoryId string

ID de categoria único do eBay em que o produto será listado.

Id de caridade
charityId string

ID exclusivo atribuído pelo eBay de organização de caridade que receberá uma porcentagem das receitas de vendas.

Percentagem de Doação
donationPercentage string

Porcentagem do preço de compra que a organização de caridade receberá por cada venda que a listagem gerar.

ID do Produto do Produtor
producerProductId string

Identificador único do produtor relacionado com o item.

ID do pacote do produto
productPackageId string

ID único do produtor da embalagem do produto adicionada pelo vendedor.

ID do pacote de envio
shipmentPackageId string

ID único do produtor de qualquer embalagem usada pelo vendedor para enviar o item.

ID da documentação do produto
productDocumentationId string

Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor.

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

Valor
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

Este campo é incluído se o vendedor pretender criar um anúncio privado.

Incluir detalhes do produto do catálogo
includeCatalogProductDetails boolean

Indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem.

Descrição do anúncio
listingDescription string

Descrição da listagem do eBay.

Duração do anúncio
listingDuration string

Número de dias em que o anúncio estará ativo.

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Melhor Oferta Ativada
bestOfferEnabled boolean

Indica se o recurso Melhor Oferta está ou não habilitado para a listagem.

eBay Plus se elegível
eBayPlusIfEligible boolean

Este campo está incluído numa oferta se um vendedor de Top-Rated optar pelo programa eBay Plus.

ID da Política de Cumprimento
fulfillmentPolicyId string

O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay.

ID da Política de Pagamento
paymentPolicyId string

O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay.

Ids da política de conformidade do produto
productCompliancePolicyIds array of string

Este 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 devolução
returnPolicyId string

Devolver o ID exclusivo da política comercial que será usado assim 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.

Valor
value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Priority
priority integer

O valor inteiro inserido neste campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio nacional ou internacional na política de atendimento será modificada com custos de envio atualizados.

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

Valor
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

Este valor indica se o serviço de envio especificado no campo de prioridade é uma opção de serviço de transporte nacional ou internacional.

Retomar ID da política
takeBackPolicyId string

ID do vendedor que criou a política de retomada.

Data de início do anúncio
listingStartDate string

Este campo pode ser utilizado se o vendedor pretender especificar uma hora no futuro em que o anúncio ficará ativo no eBay.

Tamanho do Lote
lotSize integer

Este campo só é aplicável se a listagem for uma listagem de lotes. O valor inteiro passado para este campo é o número total de itens no lote.

Chave de localização do comerciante
merchantLocationKey string

Identificador exclusivo da localização do 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.

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

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

Valor
value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Originalmente vendido pelo preço de varejo em
originallySoldForRetailPriceOn string

Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
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

Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta.

Limite de quantidade por comprador
quantityLimitPerBuyer integer

Este campo só é aplicável e definido se o vendedor desejar definir uma restrição à quantidade de compra por vendedor.

ID da categoria secundária
secondaryCategoryId string

ID de categoria secundária única e aplicável se o vendedor decidir listar o item em duas categorias.

Nomes de categorias de lojas
storeCategoryNames array of string

Nomes de categorias de lojas

Aplicar Imposto
applyTax boolean

Esse contêiner só é aplicável e usado se uma tabela de imposto, uma taxa de imposto de Value-Added ou um código de categoria de exceção de imposto forem aplicados à oferta.

Categoria de Imposto de Terceiros
thirdPartyTaxCategory string

O código da categoria de exceção de imposto. Se este 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.

Percentagem de IVA
vatPercentage number

Este valor é a taxa de IVA para o item, se houver. Quando uma porcentagem de IVA é especificada, as informações de IVA do item aparecem na página Exibir item do anúncio.

Devoluções

Name Caminho Tipo Description
ID da oferta
offerId string

Identificador único da oferta

Advertências
warnings array of object

Esse contêiner retornará quando uma chamada for feita e ocorrerem 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 ocorreu o erro ou aviso.

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 um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou 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 um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou 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 aviso.

nome
warnings.parameters.name string

nome

valor
warnings.parameters.value string

valor

Subdomain
warnings.subdomain string

Nome do subdomínio no qual ocorreu o erro ou aviso.

Criar local de inventário

Use esta chamada para criar um novo local de inventário. Para criar e publicar uma oferta, um vendedor deve ter pelo menos um local de inventário, pois cada oferta deve estar associada a um local.

Parâmetros

Name Chave Necessário Tipo Description
Chave de localização do comerciante
merchantLocationKey True string

Chave exclusiva definida pelo comerciante para um local de inventário.

Linha de Endereço 1
addressLine1 string

Primeira linha de um endereço.

Endereço Linha 2
addressLine2 string

Segunda linha de um endereço.

City
city string

Cidade em que reside o local de inventário.

Country
country string

Código do país de residência.

Concelho
county string

Condado em que o endereço reside.

Código Postal
postalCode string

Código postal/postal da morada.

Estado Ou Província
stateOrProvince string

Estado/província em que reside o local de inventário.

Latitude
latitude string

Componente Latitude da coordenada geográfica.

Longitude
longitude string

Componente de longitude da coordenada geográfica.

Informação Adicional de Localização
locationAdditionalInformation string

Informações adicionais sobre um local de inventário.

Instruções de localização
locationInstructions string

Instruções especiais de recolha para um local de inventário da loja.

locationTypes
locationTypes array of string

Tipos de localização

Localização Web Url
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 ser ativado ou desativado.

Nome
name string

Nome do local do inventário.

Dia da Semana
dayOfWeekEnum string

Dia em que o local da loja tem horário normal de funcionamento.

fechar
close string

Hora de fecho da loja.

aberto
open string

Horário de abertura da loja.

Telemóvel
phone string

Número de telefone para um local de inventário da loja.

Date
date string

Valor de data específico que o local da loja tem horário especial de funcionamento.

fechar
close string

Hora de fecho da loja.

aberto
open string

Horário de abertura da loja.

Devoluções

response
string

Criar oferta

Esta chamada cria uma oferta para um item de inventário específico em um mercado específico do eBay.

Parâmetros

Name Chave Necessário Tipo Description
Quantidade disponível
availableQuantity integer

Quantidade disponível de estoque para compra.

ID da categoria
categoryId string

ID de categoria único do eBay em que o produto será listado.

Id de caridade
charityId string

ID exclusivo atribuído pelo eBay de organização de caridade que receberá uma porcentagem das receitas de vendas.

Percentagem de Doação
donationPercentage string

Porcentagem do preço de compra que a organização de caridade receberá por cada venda que a listagem gerar.

ID do Produto do Produtor
producerProductId string

Identificador único do produtor relacionado com o item.

ID do pacote do produto
productPackageId string

ID único do produtor da embalagem do produto adicionada pelo vendedor.

ID do pacote de envio
shipmentPackageId string

ID único do produtor de qualquer embalagem usada pelo vendedor para enviar o item.

ID da documentação do produto
productDocumentationId string

Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor.

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

Valor
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

Este campo é incluído se o vendedor pretender criar um anúncio privado.

Incluir detalhes do produto do catálogo
includeCatalogProductDetails boolean

Indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem.

Descrição do anúncio
listingDescription string

Descrição da listagem do eBay.

Duração do anúncio
listingDuration string

Número de dias em que o anúncio estará ativo.

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Melhor Oferta Ativada
bestOfferEnabled boolean

Indica se o recurso Melhor Oferta está ou não habilitado para a listagem.

eBay Plus se elegível
eBayPlusIfEligible boolean

Este campo está incluído numa oferta se um vendedor de Top-Rated optar pelo programa eBay Plus.

ID da Política de Cumprimento
fulfillmentPolicyId string

O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay.

ID da Política de Pagamento
paymentPolicyId string

O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay.

Ids da política de conformidade do produto
productCompliancePolicyIds array of string

Este 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 devolução
returnPolicyId string

Devolver o ID exclusivo da política comercial que será usado assim 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.

Valor
value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Priority
priority integer

O valor inteiro inserido neste campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio nacional ou internacional na política de atendimento será modificada com custos de envio atualizados.

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

Valor
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

Este valor indica se o serviço de envio especificado no campo de prioridade é uma opção de serviço de transporte nacional ou internacional.

Retomar ID da política
takeBackPolicyId string

ID do vendedor que criou a política de retomada.

Data de início do anúncio
listingStartDate string

Este campo pode ser utilizado se o vendedor pretender especificar uma hora no futuro em que o anúncio ficará ativo no eBay.

Tamanho do Lote
lotSize integer

Este campo só é aplicável se a listagem for uma listagem de lotes. O valor inteiro passado para este campo é o número total de itens no lote.

ID do mercado
marketplaceId string

ID exclusivo do site do eBay para o qual a oferta será disponibilizada.

Chave de localização do comerciante
merchantLocationKey string

Identificador exclusivo da localização do 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.

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

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

Valor
value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Originalmente vendido pelo preço de varejo em
originallySoldForRetailPriceOn string

Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro

Moeda
currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
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

Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta.

Limite de quantidade por comprador
quantityLimitPerBuyer integer

Este campo só é aplicável e definido se o vendedor desejar definir uma restrição à quantidade de compra por vendedor.

ID da categoria secundária
secondaryCategoryId string

ID de categoria secundária única 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 categorias de lojas
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, uma taxa de imposto de Value-Added ou um código de categoria de exceção de imposto forem aplicados à oferta.

Categoria de Imposto de Terceiros
thirdPartyTaxCategory string

O código da categoria de exceção de imposto. Se este 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.

Percentagem de IVA
vatPercentage number

Este valor é a taxa de IVA para o item, se houver. Quando uma porcentagem de IVA é especificada, as informações de IVA do item aparecem na página Exibir item do anúncio.

Devoluções

Name Caminho Tipo Description
ID da oferta
offerId string

Identificador único da oferta

Advertências
warnings array of object

Esse contêiner retornará quando uma chamada for feita e ocorrerem 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 ocorreu o erro ou aviso.

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 um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou 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 um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou 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 aviso.

nome
warnings.parameters.name string

nome

valor
warnings.parameters.value string

valor

Subdomain
warnings.subdomain string

Nome do subdomínio no qual ocorreu o erro ou aviso.

Criar ou substituir item de inventário

Esta chamada cria um novo registro de item de inventário ou substitui um registro de item de inventário existente.

Parâmetros

Name Chave Necessário Tipo Description
SKU
sku True string

Valor definido pelo vendedor para o item de inventário.

Linguagem de conteúdo
Content-Language True string

O cabeçalho define a linguagem natural que será usada nos valores de campo da carga útil da solicitação.

Tipo
availabilityType string

Status de disponibilidade do item de estoque na loja física do comerciante.

Unidade
unit string

Unidade de tempo usada para especificar o tempo de preenchimento.

Valor
value integer

Valor do tempo de cumprimento.

Chave de localização do comerciante
merchantLocationKey string

ID exclusivo da loja do comerciante onde In-Store item de inventário de retirada está atualmente localizado ou para o qual será enviado.

Quantidade
quantity integer

Quantidade de item de estoque disponível para In-Store Pickup.

Unidade
unit string

Unidade de tempo usada para especificar o tempo de preenchimento.

Valor
value integer

Valor do tempo de cumprimento.

Chave de localização do comerciante
merchantLocationKey string

ID exclusivo da loja do comerciante onde In-Store item de inventário de retirada está atualmente localizado ou para o qual 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 itens de inventário 'ship-to-home' que estarão disponíveis para compra através de uma ou mais ofertas publicadas.

Condition
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 embalagem
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.

Valor
value number

O peso real do pacote de envio.

Aspetos
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 pelos 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 ISBN
isbn array of string

ISBN [en]

MPN
mpn string

Número de peça 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 com os 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

Devoluções

Name Caminho Tipo Description
Advertências
warnings array of object

Esse contêiner será retornado em uma carga útil de resposta de chamada se um ou mais avisos ou erros forem acionados.

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 ocorreu o erro ou aviso.

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 um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou 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 um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou 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 aviso.

nome
warnings.parameters.name string

nome

valor
warnings.parameters.value string

valor

Subdomain
warnings.subdomain object

Uma descrição da condição que causou o erro ou aviso.

Excluir oferta

Esta chamada eliminará permanentemente a oferta

Parâmetros

Name Chave Necessário Tipo Description
ID da oferta
offerId True string

Identificador único da oferta a eliminar.

Devoluções

response
string

GET Item de inventário

Esta chamada recupera o registro de item de inventário para uma determinada SKU.

Parâmetros

Name Chave Necessário Tipo Description
SKU
sku True string

Valor definido pelo vendedor do produto cujo registro de item de estoque você deseja recuperar.

Devoluções

Name Caminho Tipo Description
PickupAtLocationDisponibilidade
availability.pickupAtLocationAvailability array of object

Esse contêiner consiste em uma variedade de lojas físicas do comerciante onde o item de estoque está disponível para retirada na loja.

Tipo de disponibilidade
availability.pickupAtLocationAvailability.availabilityType string

Este campo indica o estado de disponibilidade do item de inventário na loja física do comerciante.

Unidade
availability.pickupAtLocationAvailability.fulfillmentTime.unit string

O valor indica a unidade de tempo usada para especificar o tempo de cumprimento

Valor
availability.pickupAtLocationAvailability.fulfillmentTime.value integer

O valor inteiro neste campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de preenchimento.

Chave de localização do comerciante
availability.pickupAtLocationAvailability.merchantLocationKey string

Identificador exclusivo da loja do comerciante onde o item de inventário de retirada de In-Store está atualmente localizado ou para o qual será enviado.

Quantidade
availability.pickupAtLocationAvailability.quantity integer

Esse valor inteiro indica a quantidade do item de estoque que está disponível para In-Store Coleta

Leilão
availability.shipToLocationAvailability.allocationByFormat.auction integer

Este valor inteiro indica a quantidade do item de inventário que está 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 estoque que está disponível para as ofertas de preço fixo da SKU.

DisponibilidadeDistribuições
availability.shipToLocationAvailability.availabilityDistributions array of object

Esse contêiner é usado para definir a quantidade disponível do item de estoque em um ou mais locais de depósito.

Unidade
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

O valor indica a unidade de tempo usada para especificar o tempo de cumprimento

Valor
availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

O valor inteiro neste campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de preenchimento.

Chave de localização do comerciante
availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

Identificador exclusivo de um local de inventário onde 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

Este contentor é utilizado para definir a quantidade total "ship-to-home" do item de inventário que estará disponível para compra através de uma ou mais ofertas publicadas.

Condition
condition string

Esse valor indica a condição do item

Descrição da condição
conditionDescription string

Este campo string é 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.

Localidade
locale string

Este campo retorna a linguagem natural que foi fornecida nos valores de campo da carga útil 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 transporte.

Largura
packageWeightAndSize.dimensions.width number

A largura real do pacote de envio.

Tipo de embalagem
packageWeightAndSize.packageType string

Esse valor indica o tipo de pacote de remessa usado para enviar o item de estoque.

Unidade
packageWeightAndSize.weight.unit string

A unidade de medida usada para especificar o peso de um pacote de envio.

Valor
packageWeightAndSize.weight.value number

O peso real do pacote de envio.

Aspetos
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 pelos 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 de artigo europeu/Número internacional de artigo (EAN) para o produto.

ePID
product.epid string

O eBay Product Identifier (ePID) do 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 contabilístico normalizado internacional para o produto.

MPN
product.mpn string

O número de peça do fabricante (MPN) de um produto.

Subtítulo
product.subtitle string

Uma legenda é um recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar com os 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 contabilístico normalizado 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 Unidade de Stock-Keeping (SKU) definida pelo vendedor do item de inventário. O vendedor deve ter um valor de SKU único para cada produto que vende.

Obtenha políticas de atendimento

Esse método recupera todas as políticas de atendimento configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id.

Parâmetros

Name Chave Necessário Tipo Description
ID do mercado
marketplace_id True string

ID do mercado do eBay das políticas que você deseja recuperar.

Devoluções

Name Caminho Tipo Description
fulfillmentPolíticas de cumprimento
fulfillmentPolicies array of object

Lista de políticas de atendimento do vendedor definidas para o mercado especificado.

Tipos de Categoria
fulfillmentPolicies.categoryTypes array of object

Este contentor indica se a política de cumprimento se aplica a anúncios de veículos a motor 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.

Frete
fulfillmentPolicies.freightShipping boolean

Se devolvido como verdadeiro, o vendedor oferece frete para itens grandes acima de 150 libras.

ID da Política de Cumprimento
fulfillmentPolicies.fulfillmentPolicyId string

ID exclusivo atribuído pelo eBay para a política de atendimento.

Envios Globais
fulfillmentPolicies.globalShipping boolean

Se devolvido 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.

Valor
fulfillmentPolicies.handlingTime.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Recolha Local
fulfillmentPolicies.localPickup boolean

Se retornado como verdadeiro, o recebimento local estará disponível para esta política.

ID do mercado
fulfillmentPolicies.marketplaceId string

ID do mercado do eBay ao qual esta política de atendimento se aplica.

Nome
fulfillmentPolicies.name string

Um nome definido pelo vendedor para esta política de cumprimento. Os nomes devem ser exclusivos para políticas atribuídas ao mesmo mercado.

Recolha Drop Off
fulfillmentPolicies.pickupDropOff boolean

Se devolvido como verdadeiro, o vendedor oferece a opção "Clique e Colete".

envioOpções
fulfillmentPolicies.shippingOptions array of object

A matriz fornece informações detalhadas sobre as opções de envio nacional e internacional disponíveis para a apólice.

Tipo de Custo
fulfillmentPolicies.shippingOptions.costType string

Este 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 montante monetário.

Valor
fulfillmentPolicies.shippingOptions.insuranceFee.value string

O montante monetário na moeda especificada.

optionType
fulfillmentPolicies.shippingOptions.optionType string

optionType

moeda
fulfillmentPolicies.shippingOptions.packageHandlingCost.currency string

moeda

valor
fulfillmentPolicies.shippingOptions.packageHandlingCost.value string

valor

rateTableId
fulfillmentPolicies.shippingOptions.rateTableId string

rateTableId

serviços de envio
fulfillmentPolicies.shippingOptions.shippingServices array of object

serviços de envio

moeda
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.currency string

moeda

valor
fulfillmentPolicies.shippingOptions.shippingServices.additionalShippingCost.value string

valor

compradorResponsibleForPickup
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForPickup boolean

compradorResponsibleForPickup

compradorResponsávelporEnvio
fulfillmentPolicies.shippingOptions.shippingServices.buyerResponsibleForShipping boolean

compradorResponsávelporEnvio

moeda
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.currency string

moeda

valor
fulfillmentPolicies.shippingOptions.shippingServices.cashOnDeliveryFee.value string

valor

frete grátis
fulfillmentPolicies.shippingOptions.shippingServices.freeShipping boolean

frete grátis

shippingCarrierCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingCarrierCode string

shippingCarrierCode

moeda
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.currency string

moeda

valor
fulfillmentPolicies.shippingOptions.shippingServices.shippingCost.value string

valor

shippingServiceCode
fulfillmentPolicies.shippingOptions.shippingServices.shippingServiceCode string

shippingServiceCode

regiãoExcluído
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regiãoExcluído

nome_da_região
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

nome_da_região

regionType [en]
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType [en]

regiãoIncluído
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regiãoIncluído

nome_da_região
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

nome_da_região

regionType [en]
fulfillmentPolicies.shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType [en]

sortOrder
fulfillmentPolicies.shippingOptions.shippingServices.sortOrder integer

sortOrder

moeda
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.currency string

moeda

valor
fulfillmentPolicies.shippingOptions.shippingServices.surcharge.value string

valor

Região excluída
fulfillmentPolicies.shipToLocations.regionExcluded array of object

Uma matriz de valores regionName que especifica as áreas para as quais um vendedor não envia.

nome_da_região
fulfillmentPolicies.shipToLocations.regionExcluded.regionName string

nome_da_região

regionType [en]
fulfillmentPolicies.shipToLocations.regionExcluded.regionType string

regionType [en]

Região Incluída
fulfillmentPolicies.shipToLocations.regionIncluded array of object

Uma matriz de campos regionName que especificam as áreas para onde um vendedor envia.

nome_da_região
fulfillmentPolicies.shipToLocations.regionIncluded.regionName string

nome_da_região

regionType [en]
fulfillmentPolicies.shipToLocations.regionIncluded.regionType string

regionType [en]

Href
href string

Este campo é para uso futuro.

Limite
limit integer

Este campo é para uso futuro.

Next
next string

Este campo é para uso futuro.

Compensação
offset integer

Este campo é para uso futuro.

Anterior
prev string

Este campo é para uso futuro.

Total
total integer

Número total de políticas de atendimento recuperadas no conjunto de resultados.

Obter aspetos do item para a categoria

Esta chamada retorna uma lista de aspetos que são apropriados ou necessários para descrever com precisão os itens na categoria de folha especificada. Cada aspeto identifica um atributo de item (por exemplo, cor) para o qual o vendedor será solicitado ou incentivado a fornecer um valor (ou valores de variação) ao oferecer um item nessa categoria no eBay.

Parâmetros

Name Chave Necessário Tipo Description
ID da árvore de categorias
category_tree_id True string

Árvore de categorias do eBay ID único a partir do qual os aspetos da categoria especificada estão sendo solicitados.

ID da categoria
category_id True string

Identificador único da categoria folha para os quais os aspetos estão sendo solicitados.

Devoluções

Name Caminho Tipo Description
Aspetos
aspects array of object

Lista de aspetos do item que são apropriados para descrever itens em uma determinada categoria de folha

Aspeto aplicável a
aspects.aspectConstraint.aspectApplicableTo array of string

Esse valor indica se o aspeto identificado pelo campo aspects.localizedAspectName é um aspeto do produto ou um aspeto do item/instância, que é um aspeto cujo valor variará com base em uma instância específica do produto.

Tipo de dados de aspeto
aspects.aspectConstraint.aspectDataType string

Tipo de dados de aspeto.

Aspeto ativado para variações
aspects.aspectConstraint.aspectEnabledForVariations boolean

Um valor true indica que esse aspeto pode ser usado para ajudar a identificar variações de itens.

Formato de aspeto
aspects.aspectConstraint.aspectFormat string

Retornado somente se o valor de aspectDataType identificar um tipo de dados que requer formatação específica.

Comprimento máximo do aspeto
aspects.aspectConstraint.aspectMaxLength integer

Comprimento máximo do valor do aspeto do item.

Modo de aspeto
aspects.aspectConstraint.aspectMode string

Maneira pela qual os valores deste aspeto devem ser especificados pelo vendedor.

Aspeto Necessário
aspects.aspectConstraint.aspectRequired boolean

Um valor true indica que esse aspeto é necessário ao oferecer itens na categoria especificada.

Uso do aspeto
aspects.aspectConstraint.aspectUsage string

O valor indica se o aspeto correspondente é recomendado ou opcional.

Esperada por data exigida
aspects.aspectConstraint.expectedRequiredByDate string

Data prevista após a qual o aspeto será exigido.

Cardinalidade do Item ao Aspeto
aspects.aspectConstraint.itemToAspectCardinality string

Indica se esse aspeto pode aceitar valores únicos ou múltiplos para itens na categoria especificada.

aspectValores
aspects.aspectValues array of object

Uma lista de valores válidos, juntamente com quaisquer restrições para este aspeto.

localizadoValor
aspects.aspectValues.localizedValue string

O valor localizado deste aspeto.

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 aspeto atual.

applicableForLocalizedAspectName
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectName string

O nome do aspeto de controle do qual depende o valor do aspeto atual.

applicableForLocalizedAspectValues
aspects.aspectValues.valueConstraints.applicableForLocalizedAspectValues array of string

Contém uma lista dos valores do aspeto de controle do qual o valor desse aspeto depende.

Nome do aspeto localizado
aspects.localizedAspectName string

Nome localizado deste aspeto.

Contagem de pesquisas
aspects.relevanceIndicator.searchCount integer

Número de pesquisas recentes para o aspeto.

Obter categoria padrão TreeId

Um determinado mercado do eBay pode usar várias árvores de categoria, mas uma dessas árvores é considerada o padrão para esse mercado. Esta chamada recupera uma referência à árvore de categorias padrão associada ao ID de mercado do eBay especificado.

Parâmetros

Name Chave Necessário Tipo Description
Marketplace ID
marketplace_id True string

ID do mercado do eBay para o qual o ID da árvore de categorias está sendo solicitado.

Accept-Language
Accept-Language True string

Um cabeçalho usado para indicar a linguagem natural que o vendedor prefere para a resposta.

Devoluções

Name Caminho Tipo Description
ID da árvore de categoria
categoryTreeId string

ID da árvore de categorias exclusiva do eBay para o mercado especificado.

Versão da árvore de categorias
categoryTreeVersion string

A versão da árvore de categorias identificada por categoryTreeId.

Obter itens de inventário

Esta chamada recupera todos os registros de itens de estoque definidos para a conta do vendedor.

Parâmetros

Name Chave Necessário Tipo Description
Limite
limit string

Número máximo de registos a devolver por página de dados.

Compensação
offset string

O número da página a ser recuperada.

Devoluções

Name Caminho Tipo Description
Href
href string

Este é o 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.

pickupAtLocationDisponibilidade
inventoryItems.availability.pickupAtLocationAvailability array of object

Esse contêiner consiste em uma variedade de lojas físicas do comerciante onde o item de estoque 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

valor
inventoryItems.availability.pickupAtLocationAvailability.fulfillmentTime.value integer

O valor inteiro neste campo, juntamente com a unidade de tempo no campo de unidade, indicará o tempo de preenchimento.

merchantLocationKey
inventoryItems.availability.pickupAtLocationAvailability.merchantLocationKey string

Loja do comerciante Identificador exclusivo onde o item de inventário In-Store Pickup está atualmente localizado ou para o qual será enviado.

quantidade
inventoryItems.availability.pickupAtLocationAvailability.quantity integer

quantidade

Leilão
inventoryItems.availability.shipToLocationAvailability.allocationByFormat.auction integer

Este valor inteiro indica a quantidade do item de inventário que está 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 estoque que está disponível para as ofertas de preço fixo da SKU.

disponibilidadeDistribuições
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions array of object

Esse contêiner é usado para definir a quantidade disponível do item de estoque em um ou mais locais de depósito.

unidade
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.unit string

unidade

valor
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.fulfillmentTime.value integer

valor

merchantLocationKey
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.merchantLocationKey string

merchantLocationKey

quantidade
inventoryItems.availability.shipToLocationAvailability.availabilityDistributions.quantity integer

quantidade

Quantidade
inventoryItems.availability.shipToLocationAvailability.quantity integer

Este contentor é utilizado para definir a quantidade total "ship-to-home" do item de inventário que estará disponível para compra através de uma ou mais ofertas publicadas

Condition
inventoryItems.condition string

Esse valor indica a condição do item.

Descrição da condição
inventoryItems.conditionDescription string

Este campo string é 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.

Localidade
inventoryItems.locale string

Este campo retorna a linguagem natural que foi fornecida nos valores de campo da carga útil da solicitação.

Altura
inventoryItems.packageWeightAndSize.dimensions.height number

Altura real do pacote de envio.

Length
inventoryItems.packageWeightAndSize.dimensions.length number

Duração real do pacote de envio.

Unidade
inventoryItems.packageWeightAndSize.dimensions.unit string

Unidade de medida usada para especificar as dimensões de um pacote de transporte.

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 utilizada para especificar o peso de uma encomenda de envio.

Valor
inventoryItems.packageWeightAndSize.weight.value number

O peso real do pacote de envio.

Aspetos
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 pelos compradores.

Marca
inventoryItems.product.brand string

A marca do produto. Este campo é frequentemente emparelhado com o campo mpn para identificar um produto específico por Número de Peça 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 do produto.

ePID
inventoryItems.product.epid string

O eBay Product Identifier (ePID) do 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 contabilístico normalizado internacional para o produto.

MPN
inventoryItems.product.mpn string

Número de peça do fabricante de um produto.

Subtítulo
inventoryItems.product.subtitle string

Uma legenda é um recurso de listagem opcional que permite ao vendedor fornecer mais informações sobre o produto, possivelmente incluindo palavras-chave que podem ajudar com os 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 do Código Universal 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.

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

Anterior
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 total de itens de inventário que existem para a conta do vendedor.

Obter locais de inventário

Esta chamada recupera todos os detalhes definidos para cada local de inventário associado à conta do vendedor.

Parâmetros

Name Chave Necessário Tipo Description
Compensação
offset string

Especifica o número de locais a serem ignorados no conjunto de resultados antes de retornar o primeiro local.

Limite
limit string

Número máximo de registos a devolver por página de dados.

Devoluções

Name Caminho Tipo Description
Href
href string

URI da página atual de resultados do conjunto de resultados.

Limite
limit integer

Número de itens retornados em uma única página do conjunto de resultados.

Next
next string

URI para a seguinte página de resultados.

Compensação
offset string

Número de resultados ignorados no conjunto de resultados antes de listar o primeiro resultado retornado.

Anterior
prev string

URI para a página de resultados anterior.

Total
total integer

Número total de itens recuperados no conjunto de resultados.

localizações
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.

Endereço Linha 2
locations.location.address.addressLine2 string

Segunda linha de um endereço.

City
locations.location.address.city string

Cidade em que reside o local de inventário.

Country
locations.location.address.country string

Código do país em que o endereço reside.

Concelho
locations.location.address.county string

Condado em que o endereço reside.

Código Postal
locations.location.address.postalCode string

Código postal/postal da morada.

Estado Ou Província
locations.location.address.stateOrProvince string

Estado/província em que reside o local de inventário.

Latitude
locations.location.geoCoordinates.latitude string

Componente Latitude da coordenada geográfica.

Longitude
locations.location.geoCoordinates.longitude string

Componente de longitude da coordenada geográfica.

ID da localização
locations.location.locationId string

ID exclusivo atribuído pelo eBay para o local.

Informação Adicional de Localização
locations.locationAdditionalInformation string

Este campo fornece informações adicionais sobre um local de inventário.

Instruções de localização
locations.locationInstructions string

Este campo é utilizado pelo comerciante para fornecer instruções especiais de levantamento para a localização da loja.

locationTypes
locations.locationTypes array of string

Esse contêiner define a função do local do inventário.

Localização Web Url
locations.locationWebUrl string

Este campo mostra o endereço do 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

Este campo indica se a localização do inventário está ativada ou desativada.

Nome
locations.name string

Nome do local do inventário.

operandoHoras
locations.operatingHours array of object

Este contentor mostra o horário normal de funcionamento de uma loja durante os dias da semana.

diadesemanaenum
locations.operatingHours.dayOfWeekEnum string

diadesemanaenum

intervalos
locations.operatingHours.intervals array of object

Este contentor é utilizado para definir os horários de abertura/fecho do dia de trabalho de uma loja.

fechar
locations.operatingHours.intervals.close string

fechar

aberto
locations.operatingHours.intervals.open string

aberto

Telemóvel
locations.phone string

O número de telefone de um local de inventário.

specialHours [en]
locations.specialHours array of object

Este contêiner mostra o horário de funcionamento especial para um local de loja em uma data ou datas específicas.

date
locations.specialHours.date string

date

intervalos
locations.specialHours.intervals array of object

Este contentor é utilizado para definir os horários de abertura e fecho de uma loja numa data específica.

fechar
locations.specialHours.intervals.close string

fechar

aberto
locations.specialHours.intervals.open string

aberto

Obter localização de inventário

Esta chamada recupera todos os detalhes definidos do local de inventário especificado pelo parâmetro de caminho merchantLocationKey.

Parâmetros

Name Chave Necessário Tipo Description
Chave de localização do comerciante
merchantLocationKey True string

Uma chave (ID) exclusiva definida pelo comerciante para um local de inventário.

Devoluções

Name Caminho Tipo Description
Linha de Endereço 1
location.address.addressLine1 string

Primeira linha de um endereço.

Endereço Linha 2
location.address.addressLine2 string

Segunda linha de um endereço.

CIty
location.address.city string

Cidade em que reside o local de inventário.

Country
location.address.country string

Código do país em que reside o endereço

Concelho
location.address.county string

Condado em que o endereço reside.

Código Postal
location.address.postalCode string

Código postal/postal da morada.

Estado Ou Província
location.address.stateOrProvince string

Estado/província em que reside o local de inventário.

Latitude
location.geoCoordinates.latitude string

Componente Latitude da coordenada geográfica.

Longitude
location.geoCoordinates.longitude string

Componente de longitude da coordenada geográfica.

ID da localização
location.locationId string

ID exclusivo atribuído pelo eBay para o local.

Informação Adicional de Localização
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 da loja.

locationTypes
locationTypes array of string

Esse contêiner define a função do local do inventário.

Localização Web Url
locationWebUrl string

O campo mostra o endereço do 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 do inventário está habilitado ou desativado

Nome
name string

Nome do local do inventário.

operandoHoras
operatingHours array of object

Este contentor mostra o horário normal de funcionamento de uma loja durante os dias da semana.

Semana Enum
operatingHours.dayOfWeekEnum string

É necessário um valor para cada dia da semana em que o local da loja tenha horário normal de funcionamento.

intervalos
operatingHours.intervals array of object

Este contentor é utilizado para definir os horários de abertura/fecho do dia de trabalho de uma loja.

fechar
operatingHours.intervals.close string

fechar

aberto
operatingHours.intervals.open string

aberto

Telemóvel
phone string

Número de telefone para um local de inventário.

Horário Especial
specialHours array of object

Este contêiner mostra o horário de funcionamento especial para um local de loja 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 da loja tem horários especiais de funcionamento.

intervalos
specialHours.intervals array of object

Este contentor é utilizado para definir os horários de abertura/fecho de uma loja numa data específica.

fechar
specialHours.intervals.close string

fechar

aberto
specialHours.intervals.open string

aberto

Obter Política de Atendimento

Esse método recupera os detalhes completos de uma política de atendimento. Forneça a ID da política que você deseja recuperar usando o parâmetro de caminho fulfillmentPolicyId.

Parâmetros

Name Chave Necessário Tipo Description
ID da Política de Cumprimento
fulfillmentPolicyId True string

ID da política de atendimento que você deseja recuperar

Devoluções

Name Caminho Tipo Description
categoriaTipos
categoryTypes array of object

Este contentor indica se a política de cumprimento se aplica a listagens de veículos a motor 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.

Frete
freightShipping boolean

Se devolvido como verdadeiro, o vendedor oferece frete de frete.

Id da Política de Cumprimento
fulfillmentPolicyId string

ID exclusivo atribuído pelo eBay para a política de atendimento.

Envios Globais
globalShipping boolean

Se devolvido 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.

Valor
handlingTime.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Recolha Local
localPickup boolean

Se retornado como verdadeiro, o recebimento local estará disponível para esta política.

ID do mercado
marketplaceId string

ID do mercado do eBay ao qual esta política de atendimento se aplica.

Nome
name string

Nome exclusivo definido pelo vendedor para esta política de cumprimento.

Recolha Drop Off
pickupDropOff boolean

Se devolvido como verdadeiro, o vendedor oferece a opção "Clique e Colete".

envioOpções
shippingOptions array of object

Esta matriz é usada para fornecer informações detalhadas sobre as opções de envio nacionais e internacionais disponíveis para a apólice.

Tipo de Custo
shippingOptions.costType string

Este campo define se o modelo de custo de envio é FLAT_RATE ou CALCULADO

Tipo de opção
shippingOptions.optionType string

Este campo é utilizado para indicar se as opções de serviço de transporte correspondentes são nacionais ou internacionais.

Moeda
shippingOptions.packageHandlingCost.currency string

A moeda base aplicada ao campo de valor para estabelecer um montante monetário.

Valor
shippingOptions.packageHandlingCost.value string

O montante monetário na moeda especificada.

ID da tabela de taxas
shippingOptions.rateTableId string

Este campo é usado se o vendedor quiser associar uma tabela de taxas de envio nacional ou internacional à política comercial de cumprimento.

serviços de envio
shippingOptions.shippingServices array of object

Essa matriz consiste nas opções de serviços de envio nacionais ou internacionais definidas para a política.

moeda
shippingOptions.shippingServices.additionalShippingCost.currency string

moeda

valor
shippingOptions.shippingServices.additionalShippingCost.value string

valor

compradorResponsibleForPickup
shippingOptions.shippingServices.buyerResponsibleForPickup boolean

Este campo deve ser incluído para uma listagem de veículos a motor se for da responsabilidade do comprador levantar o veículo automóvel comprado após o pagamento integral ser feito.

compradorResponsávelporEnvio
shippingOptions.shippingServices.buyerResponsibleForShipping boolean

Este campo deve ser incluído para uma listagem de veículos a motor se for da responsabilidade do comprador providenciar o envio de um veículo a motor comprado após o pagamento integral ser feito

moeda
shippingOptions.shippingServices.cashOnDeliveryFee.currency string

moeda

valor
shippingOptions.shippingServices.cashOnDeliveryFee.value string

valor

frete grátis
shippingOptions.shippingServices.freeShipping boolean

Este campo está incluído se o vendedor oferecer uma opção de envio gratuito ao comprador.

shippingCarrierCode
shippingOptions.shippingServices.shippingCarrierCode string

Este campo define/indica a transportadora.

moeda
shippingOptions.shippingServices.shippingCost.currency string

moeda

valor
shippingOptions.shippingServices.shippingCost.value string

valor

shippingServiceCode
shippingOptions.shippingServices.shippingServiceCode string

Este campo define/indica a opção de serviço de transporte nacional ou internacional.

regiãoExcluído
shippingOptions.shippingServices.shipToLocations.regionExcluded array of object

regiãoExcluído

nome_da_região
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionName string

nome_da_região

regionType [en]
shippingOptions.shippingServices.shipToLocations.regionExcluded.regionType string

regionType [en]

regiãoIncluído
shippingOptions.shippingServices.shipToLocations.regionIncluded array of object

regiãoIncluído

nome_da_região
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionName string

nome_da_região

regionType [en]
shippingOptions.shippingServices.shipToLocations.regionIncluded.regionType string

regionType [en]

sortOrder
shippingOptions.shippingServices.sortOrder integer

O valor inteiro definido neste campo controla a ordem do serviço de envio.

regiãoExcluído
shipToLocations.regionExcluded array of object

Uma matriz de valores regionName que especifica as áreas para as quais 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.

regiãoIncluído
shipToLocations.regionIncluded array of object

Uma matriz de campos regionName que especificam as áreas para onde um vendedor envia.

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 Devoluções

Esse método recupera os detalhes completos da política de retorno especificada pelo parâmetro de caminho returnPolicyId.

Parâmetros

Name Chave Necessário Tipo Description
ID da política de devolução
return_policy_id True string

ID da política de retorno que você deseja recuperar.

Devoluções

Name Caminho Tipo Description
categoriaTipos
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 comercial de devolução.

Método de retorno
internationalOverride.returnMethod string

Este campo define/indica se o vendedor oferece artigos de substituição ao comprador em caso de devolução internacional.

Unidade
internationalOverride.returnPeriod.unit string

Unidade de medição de tempo, como DAY.

Valor
internationalOverride.returnPeriod.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Devoluções Aceites
internationalOverride.returnsAccepted boolean

Valor unitário de medição do tempo especificado no campo da unidade.

Pagador do Custo de Envio de Devolução
internationalOverride.returnShippingCostPayer string

Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos.

ID do mercado
marketplaceId string

ID do mercado eBay ao qual se aplica esta política comercial de devolução.

Nome
name string

Um nome definido pelo vendedor para esta política comercial de pagamento.

Método de reembolso
refundMethod string

Se um vendedor indicar que aceitará devoluções do comprador, este valor será definido como MONEY_BACK.

Instruções de devolução
returnInstructions string

Este campo baseado em texto fornece mais detalhes sobre as instruções de devolução especificadas pelo vendedor. Este campo só é devolvido se definido para a política comercial de devolução.

Método de retorno
returnMethod string

Este campo só é devolvido se o vendedor estiver disposto a oferecer um artigo de substituição como alternativa ao 'Dinheiro de Volta'

Unidade
returnPeriod.unit string

Unidade de medição de tempo, como DAY.

Valor
returnPeriod.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

ID da política de devolução
returnPolicyId string

ID exclusivo atribuído pelo eBay para uma política comercial de devolução. Esse ID é gerado quando a política é criada.

Devoluções Aceites
returnsAccepted boolean

Se este campo for devolvido como verdadeiro, o vendedor aceita devoluções.

Pagador do Custo de Envio de Devolução
returnShippingCostPayer string

Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos.

Obter Política de Pagamento

Este 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

Name Chave Necessário Tipo Description
ID da Política de Pagamento
payment_policy_id True string

ID da política de pagamento que você deseja recuperar.

Devoluções

Name Caminho Tipo Description
categoriaTipos
categoryTypes array of object

Este contentor indica se a política de cumprimento se aplica a anúncios de veículos a motor 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 montante monetário.

Valor
deposit.amount.value string

O montante monetário na moeda especificada.

Unidade
deposit.dueIn.unit string

Unidade de medição de tempo, como DAY.

Valor
deposit.dueIn.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Description
description string

Uma descrição da política de pagamento definida pelo vendedor.

Unidade
fullPaymentDueIn.unit string

Unidade de medição de tempo, como DAY.

Valor
fullPaymentDueIn.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Pagamento Imediato
immediatePay boolean

Se este campo for devolvido como verdadeiro, é necessário o pagamento imediato por parte do comprador

ID do mercado
marketplaceId string

ID do mercado eBay ao qual se aplica a política comercial de pagamentos.

Nome
name string

ID do mercado eBay ao qual se aplica a política comercial de pagamentos.

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 pelas políticas comerciais de pagamento

paymentMethods
paymentMethods array of object

Esse contêiner é retornado para mostrar os métodos de pagamento aceitos para a política comercial 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

Um ID exclusivo atribuído ao eBay para uma política comercial de pagamento.

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 mercado do eBay.

Parâmetros

Name Chave Necessário Tipo Description
ID do mercado
marketplace_id True string

ID do mercado do eBay para o 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 categorias.

Devoluções

Name Caminho Tipo Description
itemConditionPolicies
itemConditionPolicies array of object

Uma lista de IDs de categoria e as políticas de como indicar a condição de um item em cada uma das categorias listadas.

ID da categoria
itemConditionPolicies.categoryId string

ID da categoria à qual a política de condição do item se aplica.

ID da árvore de categorias
itemConditionPolicies.categoryTreeId string

Um valor que indica o nó raiz da árvore de categorias 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.

itemCondições
itemConditionPolicies.itemConditions array of object

Os valores de condição de item permitidos na categoria.

condiçãoDescrição
itemConditionPolicies.itemConditions.conditionDescription string

O rótulo legível por humanos para a condição.

condiçãoId
itemConditionPolicies.itemConditions.conditionId string

Valor de ID da condição do item selecionado.

utilização
itemConditionPolicies.itemConditions.usage string

utilização

Advertências
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-200 caracteres, mas não é necessária para ser tal.

Message
warnings.message string

Uma mensagem agnóstica de dispositivo amigável para o usuário final e desenvolvedor de aplicativos.

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

nome
warnings.parameters.name string

nome

valor
warnings.parameters.value string

valor

Subdomain
warnings.subdomain string

Nome do subsistema ou subdivisão do domínio.

Obter Políticas de Devolução

Esse método recupera todas as políticas de retorno configuradas para o mercado especificado usando o parâmetro de consulta marketplace_id.

Parâmetros

Name Chave Necessário Tipo Description
Marketplace ID
marketplace_id True string

ID do mercado do eBay da política que pretende recuperar.

Devoluções

Name Caminho Tipo Description
Href
href string

Este campo é para uso futuro.

Limite
limit integer

Este campo é para uso futuro.

Next
next string

Este campo é para uso futuro.

Compensação
offset integer

Este campo é para uso futuro.

Anterior
prev string

Este campo é para uso futuro.

devoluçãoPolíticas
returnPolicies array of object

Lista das políticas comerciais de devolução do vendedor definidas para o mercado especificado.

categoriaTipos
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 comercial de devolução.

Método de retorno
returnPolicies.internationalOverride.returnMethod string

Este campo define/indica se o vendedor oferece artigos de substituição ao comprador em caso de devolução internacional.

Unidade
returnPolicies.internationalOverride.returnPeriod.unit string

Esses valores de enum representam a unidade de medida de tempo, como DAY.

Valor
returnPolicies.internationalOverride.returnPeriod.value integer

Unidade de medição de tempo, como DAY.

Devoluções Aceites
returnPolicies.internationalOverride.returnsAccepted boolean

Se definido como true, o vendedor aceita devoluções internacionais.

Pagador do Custo de Envio de Devolução
returnPolicies.internationalOverride.returnShippingCostPayer string

Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos.

ID do mercado
returnPolicies.marketplaceId string

ID do mercado do eBay ao qual esta política de negócios de devolução se aplica.

Nome
returnPolicies.name string

Um nome definido pelo vendedor para esta política comercial de pagamento.

Método de reembolso
returnPolicies.refundMethod string

Se um vendedor indicar que aceitará devoluções do comprador, este valor será definido como MONEY_BACK.

Instruções de devolução
returnPolicies.returnInstructions string

Este campo baseado em texto fornece mais detalhes sobre as instruções de devolução especificadas pelo vendedor.

Método de retorno
returnPolicies.returnMethod string

Este campo só é devolvido se o vendedor estiver disposto a oferecer um artigo de substituição como alternativa ao 'Dinheiro de Volta'.

Unidade
returnPolicies.returnPeriod.unit string

Unidade de medição de tempo, como DAY.

Valor
returnPolicies.returnPeriod.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

ID da política de devolução
returnPolicies.returnPolicyId string

Um ID exclusivo atribuído pelo eBay para uma política comercial de devolução.

Devolução Aceite
returnPolicies.returnsAccepted boolean

Se este campo for devolvido como verdadeiro, o vendedor aceita devoluções.

Pagador do Custo de Envio de Devolução
returnPolicies.returnShippingCostPayer string

Este campo indica quem é responsável pelo pagamento das despesas de envio dos artigos devolvidos.

Total
total integer

Número total de políticas de negócios de retorno recuperadas no conjunto de resultados.

Obter Políticas de Pagamento

Esse método recupera todas as políticas de pagamento configuradas para o marketplace especificado usando o parâmetro de consulta marketplace_id.

Parâmetros

Name Chave Necessário Tipo Description
ID do mercado
marketplace_id string

ID do mercado do eBay das políticas que você deseja recuperar.

Devoluções

Name Caminho Tipo Description
Href
href string

Este campo é para uso futuro.

Limite
limit integer

Este campo é para uso futuro.

Next
next string

Este campo é para uso futuro.

Compensação
offset integer

Este campo é para uso futuro.

paymentPolíticas
paymentPolicies array of object

Lista de políticas comerciais de pagamento do vendedor definidas para o mercado especificado.

categoriaTipos
paymentPolicies.categoryTypes array of object

Este contentor indica se a política de cumprimento se aplica a anúncios de veículos a motor ou não motorizados.

predefinição
paymentPolicies.categoryTypes.default boolean

predefinição

nome
paymentPolicies.categoryTypes.name string

nome

Moeda
paymentPolicies.deposit.amount.currency string

A moeda base aplicada ao campo de valor para estabelecer um montante monetário.

Valor
paymentPolicies.deposit.amount.value string

O montante monetário na moeda especificada.

Unidade
paymentPolicies.deposit.dueIn.unit string

Esses valores representam a unidade de medida de tempo, como DAY.

Valor
paymentPolicies.deposit.dueIn.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Description
paymentPolicies.description string

Uma descrição da política de pagamento definida pelo vendedor.

Unidade
paymentPolicies.fullPaymentDueIn.unit string

Unidade de medição de tempo, como DAY.

Valor
paymentPolicies.fullPaymentDueIn.value integer

Valor unitário de medição do tempo especificado no campo da unidade.

Pagamento Imediato
paymentPolicies.immediatePay boolean

Se este campo for devolvido como verdadeiro, é necessário o pagamento imediato por parte do comprador

ID do mercado
paymentPolicies.marketplaceId string

ID do mercado eBay ao qual se aplica a política comercial de pagamento.

Nome
paymentPolicies.name string

Um nome definido pelo vendedor para esta 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 pelas políticas comerciais de pagamento. Se este campo for devolvido, pode ser ignorado e estas instruções de pagamento não aparecerão em quaisquer anúncios que utilizem a política comercial correspondente.

paymentMethods
paymentPolicies.paymentMethods array of object

Esse contêiner é retornado para mostrar os métodos de pagamento aceitos para a política comercial de pagamento.

paymentMethodType
paymentPolicies.paymentMethods.paymentMethodType string

Tipo de Método de Pagamento

ID da Política de Pagamento
paymentPolicies.paymentPolicyId string

ID exclusivo atribuído ao eBay para uma política comercial de pagamento.

Anterior
prev string

Este campo é para uso futuro.

Total
total integer

Número total de políticas comerciais de pagamento recuperadas no conjunto de resultados.

Obter sugestões de categoria

Esta chamada retorna uma matriz de nós de folha de árvore de categorias na árvore de categorias especificada que são considerados pelo eBay como correspondendo mais estreitamente à consulta.

Parâmetros

Name Chave Necessário Tipo Description
ID da árvore de categorias
category_tree_id True string

Identificador único da árvore de categorias 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 colocado à venda.

Devoluções

Name Caminho Tipo Description
categorySugestões
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 único da categoria do eBay na sua árvore de categorias.

Nome da categoria
categorySuggestions.category.categoryName string

Nome da categoria identificada por categoryId.

Categoria: Árvore Nó Ancestrais
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 categorias especificada.

categoryId
categorySuggestions.categoryTreeNodeAncestors.categoryId string

Identificador único da categoria de antepassados do eBay.

categoryName
categorySuggestions.categoryTreeNodeAncestors.categoryName string

Nome da categoria ancestral identificada por categoryId.

categoriaSubtreeNodeHref
categorySuggestions.categoryTreeNodeAncestors.categorySubtreeNodeHref string

A parte href da chamada getCategorySubtree que recupera a subárvore abaixo do nó da categoria ancestral.

categoryTreeNodeLevel
categorySuggestions.categoryTreeNodeAncestors.categoryTreeNodeLevel integer

Nível absoluto do nó da categoria ancestral na hierarquia de sua árvore de categorias.

Nível do nó da árvore de categorias
categorySuggestions.categoryTreeNodeLevel integer

Nível absoluto do nó da categoria ancestral na hierarquia de sua árvore de categorias.

Relevância
categorySuggestions.relevancy string

Este campo está reservado para uso interno ou futuro.

ID da árvore de categorias
categoryTreeId string

Identificador exclusivo da árvore de categorias do eBay a partir da qual as sugestões são retornadas.

Versão da árvore de categorias
categoryTreeVersion string

A versão da árvore de categorias identificada por categoryTreeId.

Oferta GET

Esta chamada recupera uma oferta específica publicada ou não publicada.

Parâmetros

Name Chave Necessário Tipo Description
ID da oferta
offerId True string

Identificador exclusivo da oferta a ser recuperada.

Devoluções

Name Caminho Tipo Description
Quantidade disponível
availableQuantity integer

Quantidade do item de estoque que estará disponível para compra pelos compradores.

ID da categoria
categoryId string

Identificador exclusivo da categoria principal do eBay na qual o item de inventário está listado.

Id de caridade
charity.charityId string

Identificador único atribuído pelo eBay da organização de caridade que receberá uma porcentagem das receitas de vendas.

Percentagem de Doação
charity.donationPercentage string

Percentagem do preço de compra que a organização de caridade receberá por cada venda que o anúncio gerar.

ID do Produto do Produtor
extendedProducerResponsibility.producerProductId string

Identificador único do produtor relacionado com o item.

ID do pacote do produto
extendedProducerResponsibility.productPackageId string

ID único do produtor de qualquer embalagem relacionada com o produto adicionado pelo vendedor.

ID do pacote de envio
extendedProducerResponsibility.shipmentPackageId string

Identificador único do produtor de qualquer embalagem utilizada pelo vendedor para enviar o artigo.

ID da documentação do produto
extendedProducerResponsibility.productDocumentationId string

Identificador único do produtor de qualquer papel adicionado à encomenda do artigo pelo vendedor.

Moeda
extendedProducerResponsibility.ecoParticipationFee.currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

Valor
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 do anúncio da oferta

Ocultar detalhes do comprador
hideBuyerDetails boolean

Este campo é retornado como true se o recurso de listagem privada tiver sido ativado para a oferta.

Incluir detalhes do produto do catálogo
includeCatalogProductDetails boolean

Este campo indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem.

ID do anúncio
listing.listingId string

Identificador único da listagem do eBay associada à oferta publicada.

Estado do anúncio
listing.listingStatus string

Status do anúncio associado à oferta publicada.

Quantidade vendida
listing.soldQuantity integer

Quantidade de produto que foi vendida para a oferta publicada.

Descrição do anúncio
listingDescription string

Descrição da listagem do eBay

Duração do anúncio
listingDuration string

Este campo indica o número de dias em que o anúncio estará ativo.

Moeda
listingPolicies.bestOfferTerms.autoAcceptPrice.currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
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 Ativada
listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Este contentor é utilizado se o vendedor pretender suportar a funcionalidade Melhor Oferta no seu anúncio.

eBay Plus se elegível
listingPolicies.eBayPlusIfEligible boolean

Este campo está incluído numa oferta se um vendedor de Top-Rated optar pelo programa eBay Plus.

ID da Política de Cumprimento
listingPolicies.fulfillmentPolicyId string

O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay.

ID da Política de Pagamento
listingPolicies.paymentPolicyId string

O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay.

productCompliancePolicyIds
listingPolicies.productCompliancePolicyIds array of string

Este 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 devolução
listingPolicies.returnPolicyId string

O identificador único indica a política comercial de devolução que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay.

shippingCostOverrides
listingPolicies.shippingCostOverrides array of object

Este contentor é utilizado se o vendedor pretender substituir os custos de envio por uma ou mais opções de serviço de envio nacional ou internacional definidas na política de listagem de cumprimentos.

Moeda
listingPolicies.shippingCostOverrides.additionalShippingCost.currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

Valor
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

O valor inteiro inserido neste campo, juntamente com o valor shippingServiceType, define qual opção de serviço de envio nacional ou internacional na política de atendimento será modificada com 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.

Valor
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

Este valor indica se o serviço de envio é uma opção de serviço de transporte nacional ou internacional.

Retomar ID da política
listingPolicies.takeBackPolicyId string

O ID do vendedor criou uma política de retomada.

Data de início do anúncio
listingStartDate string

Este carimbo de data/hora é a data/hora que o vendedor definiu para o anúncio agendado.

Tamanho do Lote
lotSize integer

Este campo só é aplicável se a listagem for uma listagem de lotes. Uma listagem de lotes é uma listagem que tem várias quantidades do mesmo produto.

ID do mercado
marketplaceId string

Identificador único 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 único da oferta.

Moeda
pricingSummary.auctionReservePrice.currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

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

Valor
pricingSummary.minimumAdvertisedPrice.value string

Uma representação de cadeia de caracteres de um valor em dólar expresso no campo de moeda.

Originalmente vendido pelo preço de varejo em
pricingSummary.originallySoldForRetailPriceOn string

Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro.

Moeda
pricingSummary.originalRetailPrice.currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
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

Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta.

Limite de quantidade por comprador
quantityLimitPerBuyer integer

Este campo só é aplicável se o vendedor desejar definir uma restrição à quantidade de compra de um item de inventário por vendedor.

ID da categoria secundária
secondaryCategoryId string

Identificador único 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 categorias de lojas
storeCategoryNames array of string

Nome da categoria da loja

Aplicar Imposto
tax.applyTax boolean

Este campo será incluído se o vendedor pretender fazer referência ao seu Imposto sobre Vendas ao nível da conta

Categoria de Imposto de Terceiros
tax.thirdPartyTaxCategory string

O código da categoria de exceção de imposto. Se este 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.

Percentagem de IVA
tax.vatPercentage number

Este valor é a taxa de IVA para o item, se houver. Quando uma porcentagem de IVA é especificada, as informações de IVA do item aparecem na página Exibir item do anúncio.

Ofertas GET

Esta 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 a um mercado específico do eBay ou a um formato de anúncio.

Parâmetros

Name Chave Necessário Tipo Description
SKU
sku True string

Valor de SKU definido pelo vendedor

ID do mercado
marketplace_id string

Identificador único do mercado eBay.

Formato
format string

Formato do anúncio da oferta.

Limite
limit string

Número máximo de registos a devolver por página de dados.

Compensação
offset string

Número da página a recuperar.

Devoluções

Name Caminho Tipo Description
Href
href string

URL para a página atual de ofertas.

Limite
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

Este contêiner é uma matriz de ofertas de um ou mais vendedores para o valor de SKU.

Quantidade disponível
offers.availableQuantity integer

Quantidade de item de estoque que estará disponível para compra.

ID da categoria
offers.categoryId string

ID exclusivo da categoria do eBay em que o item de inventário está listado.

Id de caridade
offers.charity.charityId string

Identificador único atribuído pelo eBay da organização de caridade que receberá uma percentagem das receitas das vendas.

Percentagem de Doação
offers.charity.donationPercentage string

Percentagem do preço de compra que a organização de caridade receberá por cada venda.

ID do Produto do Produtor
offers.extendedProducerResponsibility.producerProductId string

Identificador único do produtor relacionado com o item.

ID do pacote do produto
offers.extendedProducerResponsibility.productPackageId string

ID exclusivo do produto embalado adicionado pelo vendedor.

ID do pacote de envio
offers.extendedProducerResponsibility.shipmentPackageId string

Identificador único do produtor de qualquer embalagem utilizada pelo vendedor para enviar o artigo.

ID da documentação do produto
offers.extendedProducerResponsibility.productDocumentationId string

Identificador único do produtor de qualquer papel adicionado à encomenda do artigo 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.

Valor
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

Este valor define o formato de listagem para a oferta

Ocultar detalhes do comprador
offers.hideBuyerDetails boolean

Este campo é retornado como true se o recurso de listagem privada tiver sido ativado para a oferta.

Incluir detalhes do produto do catálogo
offers.includeCatalogProductDetails boolean

Este campo indica se os detalhes do catálogo de produtos do eBay são ou não aplicados a uma listagem.

ID do anúncio
offers.listing.listingId string

Identificador único da listagem do eBay associada à oferta publicada.

Estado do anúncio
offers.listing.listingStatus string

Status do anúncio associado à oferta publicada.

Quantidade vendida
offers.listing.soldQuantity integer

Quantidade de produto que foi vendida para a oferta publicada.

Descrição do anúncio
offers.listingDescription string

Descrição do anúncio do eBay.

Duração do anúncio
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.

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

Valor
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 Ativada
offers.listingPolicies.bestOfferTerms.bestOfferEnabled boolean

Este campo indica se a funcionalidade Melhor Oferta está ou não ativada para o anúncio.

eBay Plus se elegível
offers.listingPolicies.eBayPlusIfEligible boolean

Este campo é incluído numa oferta e definido como true se um vendedor Top-Rated optar pelo programa eBay Plus

ID da Política de Cumprimento
offers.listingPolicies.fulfillmentPolicyId string

O identificador exclusivo indica a política comercial de atendimento que será usada assim que uma oferta for publicada e convertida em uma listagem do eBay.

ID da Política de Pagamento
offers.listingPolicies.paymentPolicyId string

O identificador único indica a política comercial de pagamento que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay.

productCompliancePolicyIds
offers.listingPolicies.productCompliancePolicyIds array of string

Este 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 devolução
offers.listingPolicies.returnPolicyId string

O identificador único indica a política comercial de devolução que será utilizada assim que uma oferta for publicada e convertida numa listagem do eBay.

shippingCostOverrides
offers.listingPolicies.shippingCostOverrides array of object

Este contêiner é usado se o vendedor desejar substituir os custos de envio ou 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

valor
offers.listingPolicies.shippingCostOverrides.additionalShippingCost.value string

valor

priority
offers.listingPolicies.shippingCostOverrides.priority integer

priority

moeda
offers.listingPolicies.shippingCostOverrides.shippingCost.currency string

moeda

valor
offers.listingPolicies.shippingCostOverrides.shippingCost.value string

valor

shippingServiceType
offers.listingPolicies.shippingCostOverrides.shippingServiceType string

shippingServiceType

Retomar ID da política
offers.listingPolicies.takeBackPolicyId string

ID do vendedor que criou a política de retomada.

Data de início do anúncio
offers.listingStartDate string

Data/hora que o vendedor definiu para o anúncio agendado.

Tamanho do Lote
offers.lotSize integer

Este campo só é aplicável e devolvido se a listagem for uma listagem de lotes.

ID do mercado
offers.marketplaceId string

Identificador único 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 único 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.

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

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

Valor
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 pelo preço de varejo em
offers.pricingSummary.originallySoldForRetailPriceOn string

Este campo é necessário se o recurso Preços riscados for usado na oferta. Este campo indica que o produto foi vendido pelo preço no campo RetailPrice original num site do eBay ou vendido por esse preço por um retalhista terceiro.

Moeda
offers.pricingSummary.originalRetailPrice.currency string

Um valor de cadeia de caracteres de três dígitos que representa o tipo de moeda.

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

Valor
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

Este campo é necessário se o recurso Preço Mínimo Anunciado for usado na oferta.

Limite de quantidade por comprador
offers.quantityLimitPerBuyer integer

Este campo só é aplicável e definido se o vendedor desejar definir uma restrição à 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.

storeCategoryNomes
offers.storeCategoryNames array of string

Este recipiente é devolvido se o vendedor optar por colocar o item de inventário em uma ou duas categorias de lojas do eBay que o vendedor tenha configurado para sua loja do eBay

Aplicar Imposto
offers.tax.applyTax boolean

Este campo será incluído se o vendedor pretender consultar a Tabela de Impostos sobre Vendas ao nível da conta para calcular o imposto sobre vendas de uma encomenda.

Categoria de Imposto de Terceiros
offers.tax.thirdPartyTaxCategory string

Código da categoria de exceção fiscal.

Percentagem de IVA
offers.tax.vatPercentage number

Valor da taxa de Imposto sobre Valor Agregado (IVA) para o item, se houver.

Anterior
prev string

URL para a página anterior de ofertas.

Tamanho
size integer

Número de ofertas exibidas na página atual de resultados.

Total
total integer

Número total de ofertas existentes para o valor de SKU especificado.

Publicar oferta

Esta 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

Name Chave Necessário Tipo Description
ID da oferta
offerId True string

Identificador único da oferta a publicar.

Devoluções

Name Caminho Tipo Description
ID do anúncio
listingId string

Identificador único da listagem recém-criada do eBay.

Advertências
warnings array of object

Este contentor será devolvido 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 ocorreu o erro ou aviso.

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 um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou 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 um ou mais IDs de referência que identificam o(s) elemento(s) de resposta específico(s) mais estreitamente associado ao erro ou 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 aviso.

nome
warnings.parameters.name string

nome

valor
warnings.parameters.value string

valor

Subdomain
warnings.subdomain string

O nome do subdomínio no qual ocorreu o erro ou aviso.

Retirar Oferta

Esta chamada é usada para encerrar uma listagem de variação única associada à oferta especificada.

Parâmetros

Name Chave Necessário Tipo Description
ID da oferta
offerId True string

Identificador único da oferta a retirar.

Devoluções

Name Caminho Tipo Description
ID do anúncio
listingId string

Identificador único da listagem do eBay associada à oferta que foi retirada.

Advertências
warnings array of object

Este contentor será devolvido 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 um ou mais IDs de referência que identificam o(s) elemento(s) de solicitação específico(s) mais estreitamente associado ao erro ou 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

Este contentor será devolvido 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 aviso.

nome
warnings.parameters.name string

nome

valor
warnings.parameters.value string

valor

Subdomain
warnings.subdomain string

O nome do subdomínio no qual ocorreu o erro ou aviso.

Definições

cadeia (de caracteres)

Este é o tipo de dados básico 'string'.