È possibile interfacciarsi con l'e-commerce tramite i servizi REST esposti per effettuare chiamate ad hoc per ogni esigenza
Specifiche e autenticazione:
Content-Type: application/json
Basic Auth
base url: domain.com/api/v1/
Ottiene il catalogo mappature
input es:
{
"api_key": ""
}
output es:
{
"sizes": [
{
"name": "XS", (nome misura pubblico e-commerce)
"id": 2, (codice identificativo sistema e-commerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
}
],
"collections": [
{
"name": "Autunno / Inverno 17-18", (nome collezion pubblico e-commerce)
"id": 1, (codice identificativo sistema e-commerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
}
],
"categories": [
{
"name": "UOMO", (nome misura pubblico e-commerce)
"id": 1, (codice identificativo sistema e-commerce)
"api_identifiers": [
{
"api_identifier": "98" (codice identificativo di mappatura gestionale esterno)
}
],
}
],
"brands": [
{
"name": "FAY", (nome misura pubblico e-commerce)
"id": 1, (codice identificativo sistema e-commerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
}
],
"languages": [
{
"identifier": "it",
"name": "ITALIANO",
"id": 1, (codice identificativo sistema e-commerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
}
],
"sexs": [
{
"name": "Uomo", (nome misura pubblico e-commerce)
"id": 1, (codice identificativo sistema e-commerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
}
]
}
Ottiene uno o più prodotti già presenti.
I campi in imput ai fini di ricerca prodotto sono sku, product, store_id, main_digital_code usati singolarmente o in combinazione. Se viene usato il campo product gli altri sono ignorati.
input es:
{
"api_key": "",
"main_digital_code": null, (codice a barre prodotto generale produttore, e non di variante)
"sku": "ABC001", (codice prodotto fornitore)
"product": null (identificativo prodotto sistema ecommerce, se usato tutti gli altri parametri vengono ignorati),
"store_id": null (identificativo prodotto sistema esterno)
}
output es:
[
{
"id": 2, (identificativo sistema ecommerce)
"date_add": "2017-09-15T13:56:24.150199",
"date_update": "2017-09-15T14:09:06.848000",
"sku": "l1312-00", (codice prodotto fornitore),
"store_id": "l1312-00", (codice prodotto univoco gestionale esterno)
"brand": {
"id": 10, (identificativo sistema ecommerce)
"name": "Hogan",
},
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
"sex": {
"id": 1 ,(identificativo sistema ecommerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
},
"composition": "CO 100”, (campo testo custom ecommerce)
"category": {
"id": 35 (identificativo sistema ecommerce)
"api_identifiers": [
{
"api_identifier": "98" (codice identificativo di mappatura gestionale esterno)
}
]
},
"collection": {
"id": 4, (identificativo sistema ecommerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
},
"main_digital_code": null, (codice a barre prodotto generale produttore, e non di variante)
"variants": [
{
"id": 3, (identificativo sistema ecommerce)
"date_add": "2017-09-15T14:01:43.272040",
"date_update": "2017-09-22T20:34:59.292953",
"color": {
"id": 5, (identificativo sistema ecommerce)
"color_code": null, (codice del colore fornitore)
"translations": [
{
"name": "Nero", (nome colore pubblico e-commerce)
"language": {
"id": 1, (identificativo sistema ecommerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
}
}
]
},
"size": {
"id": 2, (identificativo sistema ecommerce)
"name": "XS", (nome misura pubblico e-commerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
},
"quantity": 0,
"variant_price": "105.00", (prezzo di vendita al pubblico)
"buy_price": "60.00", (prezzo di acquisto)
"spec_digital_code": null, (codice a barre della variante da gestionale interno)
"supplier_bar_code": null (codice a barre della variante del produttore)
}
],
"translations": [
{
"id": 2, (identificativo sistema ecommerce)
"date_add": "2017-09-15T13:58:09.577867",
"date_update": "2017-09-15T13:58:09.578635",
"name": "POLO LACOSTE DI TAGLIO CLASSICO CON MANICHE LUNGHE IN PETIT PIQUÉ", (titolo prodotto)
"description": "Caratterizzata dalle maniche lunghe e dallo spesso piqué di….", (descrizione prodotto)
"language": {
"id": 1, (identificativo sistema ecommerce)
"api_identifier": "XYZ" (codice identificativo di mappatura gestionale esterno)
},
}
]
}
]
Crea un prodotto
input es:
{
"api_key": "",
"sku": "XYZ", (codice prodotto fornitore),
"store_id": "123ABC", (codice prodotto univoco gestionale esterno)
"main_digital_code": "", (codice a barre prodotto generale produttore, e non di variante)
"brand": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"category": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"sex": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"composition": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"collection": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"translations": [
{
"language": "1", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"name": "Nome prodotto",
"description": "Descrizione prodotto"
}
],
"colors_translations": [
{
"color_code": "COL01", (codice identificativo fornitore)
"language": "1", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"name": "Nero"
}
],
"variants": [
{
"color_code": "COL01", (codice identificativo fornitore)
"size": "1", (codice identificativo di mappatura gestionale esterno)
"quantity": 1,
"spec_digital_code": "324324002382", (codice a barre della variante da gestionale interno)
"supplier_bar_code": "0088123452", (codice a barre della variante del produttore)
"variant_price": 45.50, (prezzo di vendita al pubblico)
"buy_price": 25.00, (prezzo di acquisto della variante)
}
]
}
output es:
{
"message": "Product Created",
"product_id": 5 (codice identificativo sistema e-commerce)
}
Agiorna il dati del prodotto, aggiorna o crea nuove varianti, aggiorna le traduzioni prodotto / colori e la categoria se il prodotto non è stato ancora finalizzato sull'ecommerce. Aggiorna sempre prezzi e bar code, brand, collezione ed altri campi funzionali.
I campi utilizzati ai fini di ricerca prodotto sono sku, product, store_id, main_digital_code usati singolarmente o in combinazione. Se viene usato il campo product gli altri sono ignorati.
input es:
{
"api_key": "",
"main_digital_code": null, (codice a barre prodotto generale produttore, e non di variante)
"sku": "ABC001", (codice prodotto fornitore)
"product": null (identificativo prodotto sistema ecommerce, se usato tutti gli altri parametri vengono ignorati),
"store_id": null (identificativo prodotto sistema esterno)
"main_digital_code": "", (codice a barre prodotto generale produttore, e non di variante)
"brand": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"category": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"sex": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"composition": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"collection": "", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"translations": [
{
"language": "1", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"name": "Nome prodotto",
"description": "Descrizione prodotto"
}
],
"colors_translations": [
{
"color_code": "COL01", (codice identificativo fornitore)
"language": "1", (codice identificativo sistema ecommerce, o codice identificativo di mappatura gestionale esterno)
"name": "Nero"
}
],
"variants": [
{
"color_code": "COL01", (codice identificativo fornitore)
"size": "1", (codice identificativo di mappatura gestionale esterno)
"quantity": 1,
"spec_digital_code": "324324002382", (codice a barre della variante da gestionale interno)
"supplier_bar_code": "0088123452", (codice a barre della variante del produttore)
"variant_price": 45.50, (prezzo di vendita al pubblico)
"buy_price": 25.00, (prezzo di acquisto della variante)
}
]
}
output es:
{
"message": "Product Updated",
"product_id": 5 (codice identificativo sistema e-commerce)
}
Modifica quantità di una variante/prodotto. Uno dei campi non obbligatori deve essere inviato in input. Si possono usare più campi contemporaneamente. Se viene utilizzato il campo “variant” vengono ignorati gli altri campi non obbligatori.
input es:
{
"api_key": "”",
"update_type": "remove", (possibili valori: “add”, “remove”)
"store_id": "1234", (codice univoco da gestionale esterno)
"spec_digital_code": "0384327480", (codice a barre della variante),
"supplier_bar_code": "1234567891234", (codice a barre della variante fornitore)
"variant": "", (identificativo sistema ecommerce)
"main_digital_code": "", (codice a barre prodotto, non codice variante)
"sku": "", (codice prodotto fornitore)
"color_code": "", (codice identificativo fornitore)
"color": "", (codice identificativo del colore da sistema e-commerce)
"size": "", (codice identificativo di mappatura gestionale esterno)
"quantity": 1 (quantità da sottrarre o da aggiungere)
}
output es:
{
"new_quantity": 1,
"message": "Variant Updated. Quantity added 1"
}
Aggiorna la quantità di una variante/prodotto. Uno dei campi non obbligatori deve essere inviato in input. Si possono usare più campi contemporaneamente. Se viene utilizzato il campo “variant” vengono ignorati gli altri campi non obbligatori.
input es:
{
"api_key": "",
"store_id": "1234", (codice univoco da gestionale esterno)
"spec_digital_code": "0384327480", (codice a barre della variante),
"supplier_bar_code": "1234567891234", (codice a barre della variante fornitore)
"variant": "", (identificativo sistema ecommerce)
"main_digital_code": "", (codice a barre prodotto, non codice variante)
"sku": "", (codice prodotto fornitore)
"color_code": "", (codice identificativo fornitore)
"color": "", (codice identificativo del colore da sistema e-commerce)
"size": "", (codice identificativo di mappatura gestionale esterno)
"quantity": 1 (quantità da sovrascrivere)
}
output es:
{
"new_quantity": 10,
"message": ""
}
Aggiorna la quantità di una variante/prodotto. Uno dei campi non obbligatori deve essere inviato in input. Si possono usare più campi contemporaneamente. Se viene utilizzato il campo “variant” vengono ignorati gli altri campi non obbligatori.
input es:
{
"api_key": "", (codice univoco del supplier)
"store_id": "1234", (codice univoco da gestionale marketplace)
"spec_digital_code": "0384327480", (codice a barre della variante),
"supplier_bar_code": "1234567891234", (codice a barre della variante fornitore)
"variant": "", (identificativo variante da gestionale marketplace)
"main_digital_code": "", (codice a barre prodotto, non codice variante da gestionale marketplace)
"sku": "", (codice prodotto fornitore)
"color_code": "", (codice colore sec da gestionale marketplace)
"color_brand_code": "", (codice colore identificativo fornitore)
"color": "", (codice identificativo del colore da gestionale marketplace)
"size": "", (codice identificativo di mappatura da gestionale marketplace)
"quantity": 1 (quantità da sovrascrivere)
}
output es:
{
"new_quantity": 10,
"message": ""
}
2017 / 2024 © Coralmond | P.IVA/VAT 06865720822 | Via G. Meli 7 90015 Cefalù (PA) Italy | info@coralmond.com