Estrazione prodotti tramite API

SellRapido ti permette di scaricare tutti i prodotti dei tuoi cataloghi tramite API.

Per procedere, utilizza la seguente API:

https://app.sellrapido.com/sr_company_ws/api/export/product/api_key?body={vedi_sotto}

Metodo HTTP: GET

Il body della richiesta deve avere la seguente forma:

{
"catalog": 7, l'id del catalogo per cui si vogliono scaricare i prodotti. Se non specificato saranno estratti i prodotti di tutti i cataloghi.
"published": true, inserisci "true" se vuoi scaricare solo i prodotti pubblicati su almeno un marketplace. Se non specificato saranno estratti i prodotti pubblicati e non.
"zip": false, inserisci "false" se vuoi scaricare il tracciato .csv in un file zip. Se non specificato verrà scaricato un tracciato csv non compresso.
"fields": ["sku", "ean"], elenco delle colonne che compariranno nell'estrazione.
"field_separator": "|", carattere usato per separare i campi del tracciato.
Se non specificato, verrà usato il separatore "|".
"row_separator": "\n", carattere usato per separare le righe del tracciato. Se non specificato, verrà usato il separatore nuova linea \n.
"text_qualifier": "" campo usato come qualificatore delle stringhe del tracciato. Se non specificato, non viene usato nessun qualificatore
}

I parametri catalog e published sono parametri di filtro utilizzati con logica "AND".

I vari parametri sono opzionali e permettono di costruire filtri per selezionare i prodotti da scaricare.

Campi del prodotto

I campi sono valorizzati in base al tipo di catalogo.

È possibile usare il campo di input fields per specificare quali campi estrarre.

Se il campo non viene specificato vengono estratti i seguenti campi:

["sku", "ean", "mpn", "brand", "asin", "catalog_category1", "catalog_category2", "catalog_category3", "quantity", "price1", "price_shipping1", "delivery_days", "title", "description", "url_image1", "url_image2", "url_image3", "url_image4"]

Di seguito l'elenco dei campi disponibili:

id identificativo del prodotto su SellRapido
sku codice univoco del prodotto all'interno del catalogo
catalog_category1 nome categoria catalogo di livello 1
catalog_category2 nome categoria catalogo di livello 2
catalog_category3 nome categoria catalogo di livello 3
channel_categories blob json delle categorie di pubblicazione del prodotto su specifici marketplace (channel); serve a bypassare la compilazione di shop_category_map lavorando direttamente sui singoli prodotti a monte (v. listing.channel_category). La forma del json é {categories: [{channel: channel.id , category_id: ...}, ...]}
condition_code: condizione del prodotto
condition_description: descrizione della condizione
sku_label: sku parlante o alternativo usato in casi rarissimi; non sostituisce lo sku ma può essere usato per l'invio al marketplace al posto di sku; ex-campo: label_input
title: titolo
subtitle: sottotitolo
description: descrizione dettagliata
description_changed: 1 per indicare che il campo description è stato modificato
description_extra: descrizione extra
brand: marca (o produttore), questi valori vanno a popolare catalog_brand
lang: codice ISO 639-1 della lingua
quantity: quantità
availability: 1 indica che il prodotto è disponibile; normalmente è usato in alternativa a quantity ma se sono usati entrambi allora vanno sempre in OR
url: url della scheda prodotto
url_image1: url immagine
url_image2: url immagine
url_image3: url immagine
url_image4: url immagine
url_image5: url immagine
url_image6: url immagine
url_image7: url immagine
url_image8: url immagine
url_image9: url immagine
price1: prezzo
price2: prezzo
price3: prezzo
price4: prezzo
price5: prezzo
price6: prezzo
price_cost: costo del prodotto
price_shipping1: spese spedizione
price_shipping2: spese spedizione
price_shipping3: spese spedizione
price_shipping4: spese spedizione
price_shipping5: spese spedizione
price_shipping6: spese spedizione
fee_additional1: spese spedizione per oggetto aggiuntivo
fee_additional2: spese spedizione per oggetto aggiuntivo
fee_additional3: spese spedizione per oggetto aggiuntivo
fee_additional4: spese spedizione per oggetto aggiuntivo
fee_additional5: spese spedizione per oggetto aggiuntivo
fee_additional6: spese spedizione per oggetto aggiuntivo
vat_perc: iva percentuale
ean: codice ean
isbn: codice isbn
mpn: codice produttore
asin: codice prodotto amazon
fupid: codice prodotto pix_place
weight: peso
weight_um: sigla unità di misura del peso
raee: tassa raee
variations: blob json delle varianti
is_variation: 1 per indicare che il prodotto è parte di un set di varianti
extra1: campo extra
extra2: campo extra
extra3: campo extra
extra4: campo extra
extra5: campo extra
extra6: campo extra
extra7: campo extra
extra8: campo extra
extra9: campo extra
item_note: note oggetto
import_action: azione eseguita in fase di importazione: insert (prodotto nuovo), update (prodotto variato), deplete (prodotto esaurito), delete (prodotto uscito dal listino)
delivery_days: giorni necessari a preparare la spedizione
compatibility: blob json contenente la chiave compatibility che punta ha un array di coppie di attributi name, value
attributes: blob json delle item specifics, attributi aggiuntivi dell''oggetto
on_demand: 1 per indicare che il prodotto non è immediatamente disponibile
on_demand_days: numero di giorni entro cui effettuare la spedizione al buyer, da usare solo se on_demand=1
warehouse: codice del magazzino da cui proviene il prodotto
created: data di inserimento prodotto nel catalogo
modified: data di ultima modifica prodotto