API de itens para parceiros do Marketplace

requests

O método e os campos para cada produto em uma série de produtos.

data

As informações sobre o produto que será criado, atualizado ou excluído.

title

String (limite de caracteres: 200)

Obrigatório

O título do item de produto que aparece no classificado do Marketplace.

Este texto aparecerá no Marketplace. Não inclua tags HTML.

condition

Enum {new, refurbished, used, used_like_new, used_good, used_fair, cpo, open_box_new}

Obrigatório

A condição do item de produto.

partner_product_condition

Enum {acceptable, brand_new, certified_pre_owned, certified_refurbished, damaged, digital_good, excellent_refurbished, for_parts_or_not_working, good, good_refurbished, graded, like_new, new, new_other, new_other_see_details, new_with_box, new_with_defects, new_with_tags, open_box, others, pre_owned, remanufactured, retread, seller_refurbished, ungraded, used, very_good, very_good_refurbished, new_open_box, open_box_used, new_factory_sealed, unknown}

Opcional

Condições do produto. Campo opcional que será sobreposto ao campo de condição. Use se quiser mais especificidade para a condição do produto.

price

String (limite de caracteres: 9999)

Obrigatório

O formato do preço deve conter um número, seguido por um espaço e por um código de moeda ISO 4217 de três letras. Exemplo: 10,99 EUR

Se o tipo de classificado for ‘auction’, este é o preço de lance do produto. O formato do preço deve conter um número, seguido por um espaço e por um código de moeda ISO 4217 de três letras.

link

String

Obrigatório

Link da web do URL móvel para a página de detalhes do produto.

partner_product_html_desc_uri

String

Opcional

Link do URL para o site com a descrição completa do produto. Usado se a descrição do produto contiver mais do que pode caber no campo de texto "description". Como opção, o Marketplace fornecerá um link para a descrição completa.

partner_seller_id

String (limite máximo de caracteres: 100)

Obrigatório

Identificador único do vendedor. Precisa corresponder a partner_seller_id nas informações do vendedor.

Exemplo: “partner_seller_id”: “great_seller_inc”

fb_product_category

String

Opcional

Categoria de produto do Facebook para o item. A categoria de produto do Facebook mais específica possível desta lista: planilha (.csv) ou texto simples (.txt).

sale_price

String

Opcional

O formato do preço deve conter um número, seguido por um espaço e por um código de moeda ISO 4217 de três letras. Exemplo: 10,99 EUR. Mesmo formato do campo de preço. Use em conjunto com o campo price para mostrar descontos.

additional_image_link

String (limite de caracteres: 2000)

Opcional

URLs para até 20 imagens adicionais do seu item, separadas por vírgula (,), ponto e vírgula (;), espaço () ou barra vertical (|). Siga as mesmas especificações de imagem que image_link.

partner_attribute_data

Objeto JSON que permite valor nulo { “color”: “blue” }

Chaves disponíveis: aspect_ratio, band_material, bike_type, brand, break_type, cable_length, capacity, case_size, certification, character, circulated_uncirculated, closure, color, compatible_bike_type, compatible_brand, compatible_model, compatible_operating_system, compatible_product, connectivity, credit_included, denomination, department, display_technology, dress_length, exterior_color, exterior_material, fabric_type, features, film_format, fit, focal_length, focus_type, form_factor, format, frame_color, game_name, game, gauge, golf_club_type, handedness, inseam, internet_connectivity, item_height, item_length, item_weight, item_width, items_included, main_stone, manufacturer_part_number, manufacturer, material, maximum_aperture, maximum_magnification, maximum_resolution, memory_cards_supported, metal_purity, metal, model, mount, mpn, network, number_of_items, occasion, outer_shell_material, package_quantity, part_type, pattern, performance_activity, platform, processor, publication_name, quantity, rack_type, rim_diameter, rim_width, ring_size, screen_size, section_width, series, set_includes, set, size_type, size, skirt_length, sleeve_length, sport_activity, sport, storage_capacity, style, type, unit_quantity, unit_type, upper_material, us_shoe_size, vintage, voltage, volume, waist_size, wheel_diameter, year

Opcional

Uma lista de valores-chave de atributos que serão exibidos na seção de detalhes do produto. Os valores são no formato de string.

Chaves aplicáveis a aluguéis/imóveis: property_type (required), sale_type, bed_bath, area_size, pet_friendly, ac_type, heating_type, laundry_type, parking_type, parkingSpace, furnishing_type, garden_type, tenure_type, listed_by, property_tax_and_condo_fee, construction_status, lease_duration, energy_rating_eu, co2_emission_rating

Chaves aplicáveis a veículos: vehicle_type, year, make, model, number_of_owners, trim, body_style, exterior_color, interior_color, transmission, fuel_type, mileage, money_still_owed, motorcycle_type, engine_size

partner_product_location

String

Opcional

Localização do item como string a ser exibida. Exemplo: "Paris, França". Pode ser específico ou amplo, não há restrições.

partner_delivery_method

Matriz de enums de string {shipping, in_person}

Opcional

Mostra como o produto pode ser entregue a um comprador. Se um produto puder ser enviado e retirado pessoalmente, inclua as duas opções.
Exemplo: [“shipping”,”in_person”]

Padrão: [“shipping”]

partner_item_longitude

Flutuação

Opcional

Longitude do item. Necessário se o método de entrega incluir “in_person”.

partner_shipping_cost

Flutuação

Opcional

Obrigatório se partner_shipping_type for ‘fixed’.
Exemplo: “14.95”

partner_auction_bid_close_time

Registro de data e hora UNIX em segundos UTC (número)

Opcional

Campo obrigatório se o partner_listing_type for 'auction'. É quando os lances para o produto são encerrados. Exemplo: “partner_auction_bid_close_time”: 1713917255

additional_fields

Objeto JSON que permite valor nulo

Forma livre (sem enumeração/chaves definidas)

{ “revised_title”: “Premium Blue T-Shirt” }

Opcional

Um campo JSON de forma livre para parceiros enviarem campos adicionais.