Get started

    API Endpoint

        https://api.semplisio.it/

Le API Semplisio permettono di accedere alle entità gestite dalla piattaforma ed interagire con esse

Per utilizzare le API, è necessario un access token. Contattare clienti@hquadro.it per ricevere informazioni su come avere un'attivazione e le relative credenziali e access token.

Autenticazione

L’autenticazione è effettuata tramite la richiesta di un token-user , password e codice attivazione nell’header.
Tale header va utilizzato in ogni chiamata.

HEADER PARAMETERS

Field	Type	Description
token-user	String	token di accesso.
token-pass	String	password
code-app	String	codice attivazione
Content-Type	String	application/json

Post Cliente

Consente di creare un cliente:
POST https://api.semplisio.it/api/v1/customers


    Json example :

    {
       "plat_name": "plat1",
       "id": "121112",
       "name": "anna",
       "surname": "Bianchi",
       "address": [
          {
             "address": "via aldo pini",
             "house_number": "10",
             "address_row_2": "secondo piano",
             "city": "Avellino",
             "state_province_region": "Avellino",
             "zip_code": "83100",
             "country": "IT"
          },
          {
             "address": "via roma",
             "house_number": "1",
             "address_row_2": "interno 7",
             "city": "Avellino",
             "state_province_region": "AV",
             "zip_code": "83100",
             "country": "IT"
          }
       ],
       "personal_data": {
          "phone": [
             "3334567899",
             "33333333333"
          ],
          "email": [
             "annabianchi999@gmail.com",
             "abianchi999@gmail.com"
          ],
          "pec": [
             "annabianchi999@pec.com"
          ],
          "fiscal_code": "1234567890123456",
          "iban": "BBBBBBBBBB",
          "birth_data": "1980-12-04 00:00:00"
       },
       "business_information": {
          "name_company": "bianchi srl",
          "piva": "99999999999",
          "iban": [
             "aaaaaaaaaaaaaaaaa",
             "xxxxxxxxxxxxxxxxxxxxxxxxx"
          ],
          "ateco_code": [
             "4444444444",
             "73"
          ],
          "annual_revenue": "1.000.000",
          "recipient_code": "ssssssssss",
          "website": [
             {
                "website": "www.bianchi9999.it"
             }
          ],
          "role": "manager",
          "sector": "commercio",
          "email": [
             "annabianchi999@gmail.com"
          ],
          "phone": [
             "4444444444444"
          ],
          "pec": [
             "annabianchi999@pec.com"
          ],
          "fax": "3333333333333",
          "number_employees": 10
       },
       "extra_info": {
          "attivita_marketing": true,
          "ricerche_mercato": true
       },
       "origin": "banca_dati_esterna",
       "is_company": true
    }


     Response success :
        {
          "access": true,
          "data": {
            "_id": "6049db98d5cc55701b1ccc42"   //Id univoco in Semplisio
           }
         }

JSON PARAMETERS

Field	Type	Required	Description
id	String	si	Id piattaforma
plat_name	String	si	Nome piattaforma
name	String	si	Nome(is_company false)
address	Array of Object	no	Indirizzo "address": (String) indirizzo, "house_number": (String) numero civico, "address_row_2": (String) piano/scala, "city": (String) nome città, "state_province_region": (String) nome provincia, "zip_code": (String) codice postale, "country": (String) codice ISO Nazione
personal_data	Object	no	Dati persona fisica: "phone": (array) numeri di telefono, "email": (array) email, "pec": (array) pec, "fiscal_code": (String) codice fiscale , "iban": (String) iban, "birth_data": (date) data di nascita
business_information	Object	no	Dati azienda: "name_company": (String) nome azienda, "piva": (String) partita Iva, "iban": (array) iban, "ateco_code": (array) codice ateco, "annual_revenue": (string)entrate annuali, "recipient_code": (string) Codice destinatario, "website": (array) sito, "role": (string) ruolo, "sector": (string) settore, "email": (array) mail, "phone": (array) telefono, "pec": (array) pec, "fax": (string) fax, "number_employees": (integer) numero dipendenti
extra_info	Object	no	Consenso per attività di marketing e di ricerca di mercato "attivita_marketing": (boolean), "ricerche_mercato": (boolean)
origin	string	no	Provenienza contatto (es. banca dati esterna)
is_company	boolean	si	Persona fisica : (boolean) false Azienda : (boolean) true

PUT Cliente

Consente di modificare un cliente:
PUT https://api.semplisio.it/api/v1/customers/{idsemplisio}


    Json example :

    {
       "name": "anna",
       "surname": "Bianchi",
       "address": [
          {
             "address": "via aldo pini",
             "house_number": "10",
             "address_row_2": "secondo piano",
             "city": "Avellino",
             "state_province_region": "Avellino",
             "zip_code": "83100",
             "country": "IT"
          },
          {
             "address": "via roma",
             "house_number": "1",
             "address_row_2": "interno 7",
             "city": "Avellino",
             "state_province_region": "AV",
             "zip_code": "83100",
             "country": "IT"
          }
       ],
       "personal_data": {
          "phone": [
             "3334567899",
             "33333333333"
          ],
          "email": [
             "annabianchi999@gmail.com",
             "abianchi999@gmail.com"
          ],
          "pec": [
             "annabianchi999@pec.com"
          ],
          "fiscal_code": "1234567890123456",
          "iban": "BBBBBBBBBB",
          "birth_data": "1980-12-04 00:00:00"
       },
       "business_information": {
          "name_company": "bianchi srl",
          "piva": "99999999999",
          "iban": [
             "aaaaaaaaaaaaaaaaa",
             "xxxxxxxxxxxxxxxxxxxxxxxxx"
          ],
          "ateco_code": [
             "4444444444",
             "73"
          ],
          "annual_revenue": "1.000.000",
          "recipient_code": "ssssssssss",
          "website": [
             {
                "website": "www.bianchi9999.it"
             }
          ],
          "role": "manager",
          "sector": "commercio",
          "email": [
             "annabianchi999@gmail.com"
          ],
          "phone": [
             "4444444444444"
          ],
          "pec": [
             "annabianchi999@pec.com"
          ],
          "fax": "3333333333333",
          "number_employees": 10
       },
       "extra_info": {
          "attivita_marketing": true,
          "ricerche_mercato": true
       },
       "origin": "banca_dati_esterna",
       "is_company": true
    }


     Response success :
        {
          "access": true,
          "data": {
            "_id": "6049db98d5cc55701b1ccc42"   //Id univoco in Semplisio
           }
         }

JSON PARAMETERS

Field	Type	Required	Description
name	String	si	Nome(is_company false)
address	Array of Object	no	Indirizzo "address": (String) indirizzo, "house_number": (String) numero civico, "address_row_2": (String) piano/scala, "city": (String) nome città, "state_province_region": (String) nome provincia, "zip_code": (String) codice postale, "country": (String) codice ISO Nazione
personal_data	Object	no	Dati persona fisica: "phone": (array) numeri di telefono, "email": (array) email, "pec": (array) pec, "fiscal_code": (String) codice fiscale , "iban": (String) iban, "birth_data": (date) data di nascita
business_information	Object	no	Dati azienda: "name_company": (String) nome azienda, "piva": (String) partita Iva, "iban": (array) iban, "ateco_code": (array) codice ateco, "annual_revenue": (string)entrate annuali, "recipient_code": (string) Codice destinatario, "website": (array) sito, "role": (string) ruolo, "sector": (string) settore, "email": (array) mail, "phone": (array) telefono, "pec": (array) pec, "fax": (string) fax, "number_employees": (integer) numero dipendenti
extra_info	Object	no	Consenso per attività di marketing e di ricerca di mercato "attivita_marketing": (boolean), "ricerche_mercato": (boolean)
origin	string	no	Provenienza contatto (es. banca dati esterna)
is_company	boolean	si	Persona fisica : (boolean) false Azienda : (boolean) true

Get Clienti

Ritorna tutti i clienti:
GET https://api.semplisio.it/api/v1/customers


    Response succes example :
    {
        "access": true,
        "data": [
            {
              "_id": "607eb46348b32a10b17981c3",
              "name": "Giovanni",
              "surname": "ApiTest",
              "address": [
                {
                  "address": "via aldo pini",
                  "house_number": "10",
                  "address_row_2": "secondo piano",
                  "city": "Avellino",
                  "state_province_region": "Avellino",
                  "zip_code": "83100",
                  "country": "IT"
                },
                {
                  "address": "via roma",
                  "house_number": "1",
                  "address_row_2": "interno 7",
                  "city": "Avellino",
                  "state_province_region": "AV",
                  "zip_code": "83100",
                  "country": "IT"
                }
              ],
              "personal_data": {
                "phone": [
                  "3334567899",
                  "33333333333"
                ],
                "email": [
                  "annabianchi999@gmail.com",
                  "abianchi999@gmail.com"
                ],
                "pec": [
                  "annabianchi999@pec.com"
                ],
                "fiscal_code": "1234567890123456",
                "iban": "BBBBBBBBBB",
                "birth_data": {
                  "$date": {
                    "$numberLong": "344732400000"
                  }
                }
              },
              "business_information": {
                "name_company": "bianchi srl",
                "piva": "99999999999",
                "iban": [
                  "aaaaaaaaaaaaaaaaa",
                  "xxxxxxxxxxxxxxxxxxxxxxxxx"
                ],
                "ateco_code": [
                  "4444444444",
                  "73"
                ],
                "annual_revenue": "1.000.000",
                "recipient_code": "ssssssssss",
                "website": [
                  {
                    "website": "www.bianchi9999.it"
                  }
                ],
                "role": "manager",
                "sector": "commercio",
                "email": [
                  "annabianchi999@gmail.com"
                ],
                "phone": [
                  "4444444444444"
                ],
                "pec": [
                  "annabianchi999@pec.com"
                ],
                "fax": "3333333333333",
                "number_employees": 10
              },
              "extra_info": {
                "attivita_marketing": true,
                "ricerche_mercato": true
              },
              "origin": "banca_dati_esterna",
              "is_company": true,
              "user_definition": "customer",
              "info": {
                "created_at": "2021-04-20 13:00:51",
                "updated_at": "2021-04-20 13:04:52"
              }
            },
            {
              "_id": "607eb5f2418c857c1e37ab93",
              "name": "anna",
              "surname": "Bianchi",
              "address": [
                {
                  "address": "via aldo pini",
                  "house_number": "10",
                  "address_row_2": "secondo piano",
                  "city": "Avellino",
                  "state_province_region": "Avellino",
                  "zip_code": "83100",
                  "country": "IT"
                },
                {
                  "address": "via roma",
                  "house_number": "1",
                  "address_row_2": "interno 7",
                  "city": "Avellino",
                  "state_province_region": "AV",
                  "zip_code": "83100",
                  "country": "IT"
                }
              ],
              "personal_data": {
                "phone": [
                  "3334567899",
                  "33333333333"
                ],
                "email": [
                  "annabianchi999@gmail.com",
                  "abianchi999@gmail.com"
                ],
                "pec": [
                  "annabianchi999@pec.com"
                ],
                "fiscal_code": "1234567890123456",
                "iban": "BBBBBBBBBB",
                "birth_data": {
                  "$date": {
                    "$numberLong": "344732400000"
                  }
                }
              },
              "business_information": {
                "name_company": "bianchi srl",
                "piva": "99999999999",
                "iban": [
                  "aaaaaaaaaaaaaaaaa",
                  "xxxxxxxxxxxxxxxxxxxxxxxxx"
                ],
                "ateco_code": [
                  "4444444444",
                  "73"
                ],
                "annual_revenue": "1.000.000",
                "recipient_code": "ssssssssss",
                "website": [
                  {
                    "website": "www.bianchi9999.it"
                  }
                ],
                "role": "manager",
                "sector": "commercio",
                "email": [
                  "annabianchi999@gmail.com"
                ],
                "phone": [
                  "4444444444444"
                ],
                "pec": [
                  "annabianchi999@pec.com"
                ],
                "fax": "3333333333333",
                "number_employees": 10
              },
              "extra_info": {
                "attivita_marketing": true,
                "ricerche_mercato": true
              },
              "origin": "banca_dati_esterna",
              "is_company": true,
              "user_definition": "customer",
              "info": {
                "updated_at": "2021-04-20 13:07:30",
                "created_at": "2021-04-20 13:07:30"
              }
            }
  ]
}

JSON PARAMETERS

Field	Type	Description
_id	String	Identificativo semplisio
name	String	Nome(is_company false)
surname	String	Cognome(is_company false)
address	Array of Object	Indirizzo "address": (String) indirizzo, "house_number": (String) numero civico, "address_row_2": (String) piano/scala, "city": (String) nome città, "state_province_region": (String) nome provincia, "zip_code": (String) codice postale, "country": (String) codice ISO Nazione
personal_data	Object	Dati persona fisica: "phone": (Array) numeri di telefono, "email": (Array) email, "pec": (Array) pec, "fiscal_code": (String) codice fiscale , "iban": (String) iban, "birth_data": (date) data di nascita
business_information	Object	Dati azienda: "name_company": (String) nome azienda, "piva": (String) partita Iva, "iban": (Array) iban, "ateco_code": (Array) codice ateco, "annual_revenue": (string)entrate annuali, "recipient_code": (String) Codice destinatario, "website": (Array) sito, "role": (String) ruolo, "sector": (String) settore, "email": (Array) mail, "phone": (Array) telefono, "pec": (Array) pec, "fax": (String) fax, "number_employees": (Integer) numero dipendenti
extra_info	Object	Consenso per attività di marketing e di ricerca di mercato "attivita_marketing": (boolean), "ricerche_mercato": (boolean)
origin	String	Provenienza contatto (es. banca dati esterna)
is_company	Boolean	Persona fisica : (Boolean) false Azienda : (Boolean) true
user_definition	String	tipologia di utente
info	Object	created_at : (data) data di creazione updated_at : (data) data di modifica

Get Cliente

Ritorna il cliente:
GET https://api.semplisio.it/api/v1/customers/{idSemplisio}


    Response succes example :
    {
        "access": true,
        "data": [
            {
              "_id": "607eb46348b32a10b17981c3",
              "name": "Giovanni",
              "surname": "ApiTest",
              "address": [
                {
                  "address": "via aldo pini",
                  "house_number": "10",
                  "address_row_2": "secondo piano",
                  "city": "Avellino",
                  "state_province_region": "Avellino",
                  "zip_code": "83100",
                  "country": "IT"
                },
                {
                  "address": "via roma",
                  "house_number": "1",
                  "address_row_2": "interno 7",
                  "city": "Avellino",
                  "state_province_region": "AV",
                  "zip_code": "83100",
                  "country": "IT"
                }
              ],
              "personal_data": {
                "phone": [
                  "3334567899",
                  "33333333333"
                ],
                "email": [
                  "annabianchi999@gmail.com",
                  "abianchi999@gmail.com"
                ],
                "pec": [
                  "annabianchi999@pec.com"
                ],
                "fiscal_code": "1234567890123456",
                "iban": "BBBBBBBBBB",
                "birth_data": {
                  "$date": {
                    "$numberLong": "344732400000"
                  }
                }
              },
              "business_information": {
                "name_company": "bianchi srl",
                "piva": "99999999999",
                "iban": [
                  "aaaaaaaaaaaaaaaaa",
                  "xxxxxxxxxxxxxxxxxxxxxxxxx"
                ],
                "ateco_code": [
                  "4444444444",
                  "73"
                ],
                "annual_revenue": "1.000.000",
                "recipient_code": "ssssssssss",
                "website": [
                  {
                    "website": "www.bianchi9999.it"
                  }
                ],
                "role": "manager",
                "sector": "commercio",
                "email": [
                  "annabianchi999@gmail.com"
                ],
                "phone": [
                  "4444444444444"
                ],
                "pec": [
                  "annabianchi999@pec.com"
                ],
                "fax": "3333333333333",
                "number_employees": 10
              },
              "extra_info": {
                "attivita_marketing": true,
                "ricerche_mercato": true
              },
              "origin": "banca_dati_esterna",
              "is_company": true,
              "user_definition": "customer",
              "info": {
                "created_at": "2021-04-20 13:00:51",
                "updated_at": "2021-04-20 13:04:52"
              }
            }
        ]
    }

JSON PARAMETERS

Field	Type	Description
_id	String	Identificativo semplisio
name	String	Nome(is_company false)
surname	String	Cognome(is_company false)
address	Array of Object	Indirizzo "address": (String) indirizzo, "house_number": (String) numero civico, "address_row_2": (String) piano/scala, "city": (String) nome città, "state_province_region": (String) nome provincia, "zip_code": (String) codice postale, "country": (String) codice ISO Nazione
personal_data	Object	Dati persona fisica: "phone": (array) numeri di telefono, "email": (array) email, "pec": (array) pec, "fiscal_code": (String) codice fiscale , "iban": (String) iban, "birth_data": (date) data di nascita
business_information	Object	Dati azienda: "name_company": (String) nome azienda, "piva": (String) partita Iva, "iban": (array) iban, "ateco_code": (array) codice ateco, "annual_revenue": (string)entrate annuali, "recipient_code": (string) Codice destinatario, "website": (array) sito, "role": (string) ruolo, "sector": (string) settore, "email": (array) mail, "phone": (array) telefono, "pec": (array) pec, "fax": (string) fax, "number_employees": (integer) numero dipendenti
extra_info	Object	Consenso per attività di marketing e di ricerca di mercato "attivita_marketing": (boolean), "ricerche_mercato": (boolean)
origin	String	Provenienza contatto (es. banca dati esterna)
is_company	Boolean	Persona fisica : (Boolean) false Azienda : (Boolean) true
user_definition	String	tipologia di utente
info	Object	created_at : (data) data di creazione updated_at : (data) data di modifica

Post Prodotto

Post Prodotto consente di creare un prodotto:
POST https://api.semplisio.it/api/v1/products


    Json example :
    {
       "plat_name": "plat1",
       "id": "322223",
       "languages_text": [
          {
             "language_id": "IT",
             "name": "jeans scuro",
             "description": "jeans slim fit black denim"
          },
          {
             "language_id": "EN",
             "name": "jenas black denim",
             "description": "jeans slim fit black denim"
          }
       ],
       "images": [
          {
             "src": "http://www.eeeee.it",
             "name": "",
             "id": ""
          }
       ],
       "variants": [
          {
             "ean": "wwwwww",
             "barcode": "bbbbbbb",
             "stock": 10,
             "net_price": 50,
             "gross_price": 60.3,
             "vat_amount": 10.3,
             "purchase_price": 15.5,
             "regular_price": 50,
             "attributes": [
                {
                   "name": "colore",
                   "option": "verde"
                },
                {
                   "name": "taglia",
                   "option": "XL"
                }
             ]
          }
       ],
       "category_id": null,
       "draft": false,
       "features": {
          "weight": 0,
          "height": 0,
          "width": 0,
          "depth": 0
       },
       "ean": "123456",
       "barcode": "",
       "manufacturer": "HQuadro",
       "secondary_code": "",
       "type": "",
       "note": "note",
       "net_price": 52,
       "gross_price": 60.3,
       "vat_amount": 10.3,
       "purchase_price": 15.5,
       "regular_price": 50,
       "price": 50,
       "sale_price": 45,
       "salesPriceIncludeVat": 48,
       "sales_tax_rate": "22",
       "enabled": true
    }



     Response success :
        {
          "access": true,
          "data": {
            "_id": "6049db98d5cc55701b1ccc42"   //Id univoco in Semplisio
           }
         }

JSON PARAMETERS

Field	Type	Required	Description
id	String	si	Id piattaforma
plat_name	String	si	Nome piattaforma
languages_text	Array of Object	si	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
images	Array of Object	no	immagini prodotto: "src": (String) url immagine, "name": (String) nome, "id": (String) identificativo,
variants	Object	no	Varianti prodotto: "ean": (String) codice ean, "barcode": (String) codice barcode, "stock": (Integer) scorte, "net_price": (Double) Required prezzo al netto iva, "gross_price": (Double) Required prezzo lordo", "vat_amount": (Double)Required importo IVA, "purchase_price": (Double) Requiredprezzo acquisto, "regular_price": (Double) Required prezzo al netto iva impostare, "Attributes" : (Array of Object ) "name" : (String) Requirednome attributo, "option" : (String) Requiredvalore attributo
category_id	String	si	Id categoria semplisio
draft	Boolean	si	Stato prodotto in bozza
manufacturer	String	si	Produttore
features	Object	si	Caratteristiche prodotto: "weight": (Double) Required peso, "height": (Double) Required altezza, "width": (Double) Required larghezza, "depth": (Double) Required profondità
ean	String	no	Codice EAN/SKU
barcode	String	no	Codice Barcode
secondary_code	String	no	Codice secondario
type	String	no	Tipo prodotto
note	String	no	Note
net_price	Double	si	Prezzo al netto iva
gross_price	Double	si	Prezzo lordo
vat_amount	Double	si	Importo IVA
purchase_price	Double	si	Prezzo acquisto
price	Double	si	Prezzo al netto iva
regular_price	Double	si	Prezzo al netto iva
sale_price	Double	si	Prezzo vendita al netto iva
salesPriceIncludeVat	Double	no	Prezzo vendita lordo
sales_tax_rate	String	si	Percentuale iva – string es.”22”

Put Prodotto

Put Prodotto consente di modificare un prodotto:
PUT https://api.semplisio.it/api/v1/products/{idsemplisio}


    Json example :
    {
    "languages_text": [
          {
             "language_id": "IT",
             "name": "jeans scuro",
             "description": "jeans slim fit black denim"
          },
          {
             "language_id": "EN",
             "name": "jenas black denim",
             "description": "jeans slim fit black denim"
          }
       ],
       "images": [
          {
             "src": "http://www.eeeee.it",
             "name": "",
             "id": ""
          }
       ],
       "variants": [
          {
             "ean": "wwwwww",
             "barcode": "bbbbbbb",
             "stock": 10,
             "net_price": 50,
             "gross_price": 60.3,
             "vat_amount": 10.3,
             "purchase_price": 15.5,
             "regular_price": 50,
             "attributes": [
                {
                   "name": "colore",
                   "option": "verde"
                },
                {
                   "name": "taglia",
                   "option": "XL"
                }
             ]
          }
       ],
       "category_id": null,
       "draft": false,
       "features": {
          "weight": 0,
          "height": 0,
          "width": 0,
          "depth": 0
       },
       "ean": "123456",
       "barcode": "",
       "manufacturer": "HQuadro",
       "secondary_code": "",
       "type": "",
       "note": "note",
       "net_price": 52,
       "gross_price": 60.3,
       "vat_amount": 10.3,
       "purchase_price": 15.5,
       "regular_price": 50,
       "price": 50,
       "sale_price": 45,
       "salesPriceIncludeVat": 48,
       "sales_tax_rate": "22",
       "enabled": true
    }



     Response success :
        {
          "access": true,
          "data": {
            "_id": "6049db98d5cc55701b1ccc42"   //Id univoco in Semplisio
           }
         }

JSON PARAMETERS

Field	Type	Required	Description
languages_text	Array of Object	si	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
images	Array of Object	no	immagini prodotto: "src": (String) url immagine, "name": (String) nome, "id": (String) identificativo,
variants	Object	no	Varianti prodotto: "ean": (String) codice ean, "barcode": (String) codice barcode, "stock": (Integer) scorte, "net_price": (Double) Required prezzo al netto iva, "gross_price": (Double) Required prezzo lordo", "vat_amount": (Double)Required importo IVA, "purchase_price": (Double) Required prezzo acquisto, "regular_price": (Double) Required prezzo al netto iva impostare, "Attributes" : (Array of Object ) "name" : (String)Required nome attributo, "option" : (String) Required valore attributo
category_id	String	si	Id categoria semplisio
draft	Boolean	si	Stato prodotto in bozza
manufacturer	String	si	Produttore
features	Object	si	Caratteristiche prodotto: "weight": (Double) Required peso, "height": (Double) Required altezza, "width": (Double) Required larghezza, "depth": (Double) Required profondità
ean	String	no	Codice EAN/SKU
barcode	String	no	Codice Barcode
secondary_code	String	no	Codice secondario
type	String	no	Tipo prodotto
note	String	no	Note
net_price	Double	si	Prezzo al netto iva
gross_price	Double	si	Prezzo lordo
vat_amount	Double	si	Importo IVA
purchase_price	Double	si	Prezzo acquisto
price	Double	si	Prezzo al netto iva
regular_price	Double	si	Prezzo al netto iva
sale_price	Double	si	Prezzo vendita al netto iva
salesPriceIncludeVat	Double	si	prezzo vendita lordo
sales_tax_rate	String	si	Percentuale iva – string es.”22”

Get Prodotti

Ritorna tutti i prodotti:
GET https://api.semplisio.it/api/v1/products


    Response success example :
    {
  "access": true,
  "data": [
    {
      "_id": "6048dd0b5563a41bc36f78a4",
      "languages_text": [
        {
          "language_id": "IT",
          "name": "jeans scuro",
          "description": "jeans slim fit black denim"
        },
        {
          "language_id": "EN",
          "name": "jenas black denim",
          "description": "jeans slim fit black denim"
        }
      ],
      "images": [
        {
          "src": "eeeee",
          "name": null,
          "id": null
        }
      ],
      "variants": [
        {
          "ean": "wwwwww",
          "barcode": "bbbbbbb",
          "stock": 10,
          "net_price": 50,
          "gross_price": 60.3,
          "vat_amount": 10.3,
          "purchase_price": 15.5,
          "regular_price": 50,
          "attributes": [
            {
              "name": "colore",
              "option": "verde"
            },
            {
              "name": "taglia",
              "option": "XL"
            }
          ]
        }
      ],
      "category_id": "607fdb3228dc3838dca7d85b",
      "draft": false,
      "ean": "123456",
      "secondary_code": null,
      "type": null,
      "note": "note",
      "net_price": 50,
      "gross_price": 60.3,
      "vat_amount": 10.3,
      "purchase_price": 15.5,
      "regular_price": 50,
      "price": 50,
      "sale_price": 45,
      "salesPriceIncludeVat": 48,
      "sales_tax_rate": "22"
    },
    {
      "_id": "607fdc096c5b4c052806f436",
      "languages_text": [
        {
          "language_id": "IT",
          "name": "mocassino",
          "description": "mocassino uomo"
        }
      ],
      "images": [
        {
          "src": "http:\/\/www.mocassino.it",
          "name": null,
          "id": null
        }
      ],
      "variants": [
        {
          "ean": "0923424",
          "barcode": "83249234",
          "stock": 13,
          "net_price": 52,
          "gross_price": 62.3,
          "vat_amount": 12.3,
          "purchase_price": 12.5,
          "regular_price": 50,
          "attributes": [
            {
              "name": "colore",
              "option": "verde"
            },
            {
              "name": "numero",
              "option": "45"
            }
          ]
        }
      ],
      "category_id": "607fdb3228dc3838dca7d85b",
      "draft": null,
      "ean": "123456",
       "barcode": "",
       "manufacturer": "HQuadro",
      "secondary_code": null,
      "type": null,
      "note": "note",
      "net_price": 52,
      "gross_price": 60.3,
      "vat_amount": 10.3,
      "purchase_price": 15.5,
      "regular_price": 50,
      "price": 50,
      "sale_price": 45,
      "salesPriceIncludeVat": 48,
      "sales_tax_rate": "22"
    }
    ]
	}

JSON PARAMETERS

Field	Type	Description
_id	String	identificativo Semplisio
languages_text	Array of Object	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
images	Array of Object	immagini prodotto: "src": (String) url immagine, "name": (String) nome, "id": (String) identificativo,
variants	Object	Varianti prodotto: "ean": (String) codice ean, "barcode": (String) codice barcode, "stock": (Integer) scorte, "net_price": (Double) prezzo al netto iva, "gross_price": (Double) prezzo lordo", "vat_amount": (Double) importo IVA, "purchase_price": (Double) prezzo acquisto, "regular_price": (Double) prezzo al netto iva impostare, "Attributes" : (Array of Object ) "name" : (String) nome attributo, "option" : (String) valore attributo
category_id	String	Id categoria semplisio
draft	Boolean	si	Stato prodotto in bozza
manufacturer	String	si	Produttore
features	Object	si	Caratteristiche prodotto: "weight": (Double) Required peso, "height": (Double) Required altezza, "width": (Double) Required larghezza, "depth": (Double) Required profondità
ean	String	no	Codice EAN/SKU
barcode	String	no	Codice Barcode
secondary_code	String	no	Codice secondario
type	String	no	Tipo prodotto
note	String	no	Note
net_price	Double	Prezzo al netto iva
gross_price	Double	Prezzo lordo
vat_amount	Double	Importo IVA
purchase_price	Double	Prezzo acquisto
price	Double	Prezzo al netto iva
regular_price	Double	Prezzo al netto iva
sale_price	Double	Prezzo vendita al netto iva
salesPriceIncludeVat	Double	Prezzo vendita lordo
sales_tax_rate	String	Percentuale iva – string es.”22”

Get Prodotto

Ritorna il prodotto:
GET https://api.semplisio.it/api/v1/products/{idSemplisio}


    Response success example :
    {
  "access": true,
  "data": {
    "_id": "6048dd0b5563a41bc36f78a4",
    "languages_text": [
      {
        "language_id": "IT",
        "name": "jeans scuro",
        "description": "jeans slim fit black denim"
      },
      {
        "language_id": "EN",
        "name": "jenas black denim",
        "description": "jeans slim fit black denim"
      }
    ],
    "images": [
      {
        "src": "eeeee",
        "name": null,
        "id": null
      }
    ],
    "variants": [
      {
        "ean": "wwwwww",
        "barcode": "bbbbbbb",
        "stock": 10,
        "net_price": 50,
        "gross_price": 60.3,
        "vat_amount": 10.3,
        "purchase_price": 15.5,
        "regular_price": 50,
        "attributes": [
          {
            "name": "colore",
            "option": "verde"
          },
          {
            "name": "taglia",
            "option": "XL"
          }
        ]
      }
    ],
    "category_id": null,
    "draft": false,
    "ean": "123456",
    "secondary_code": null,
    "type": null,
    "note": "note",
    "net_price": 50,
    "gross_price": 60.3,
    "vat_amount": 10.3,
    "purchase_price": 15.5,
    "regular_price": 50,
    "price": 50,
    "sale_price": 45,
    "salesPriceIncludeVat": 48,
    "sales_tax_rate": "22"
  }
}

JSON PARAMETERS

Field	Type	Description
_id	String	identificativo Semplisio
languages_text	Array of Object	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
images	Array of Object	immagini prodotto: "src": (String) url immagine, "name": (String) nome, "id": (String) identificativo,
variants	Object	Varianti prodotto: "ean": (String) codice ean, "barcode": (String) codice barcode, "stock": (Integer) scorte, "net_price": (Double) prezzo al netto iva, "gross_price": (Double) prezzo lordo", "vat_amount": (Double) importo IVA, "purchase_price": (Double) prezzo acquisto, "regular_price": (Double) Required prezzo al netto iva impostare, "Attributes" : (Array of Object ) "name" : (String) nome attributo, "option" : (String) valore attributo
category_id	String	Id categoria semplisio
draft	Boolean	si	Stato prodotto in bozza
manufacturer	String	si	Produttore
features	Object	si	Caratteristiche prodotto: "weight": (Double) Required peso, "height": (Double) Required altezza, "width": (Double) Required larghezza, "depth": (Double) Required profondità
ean	String	no	Codice EAN/SKU
barcode	String	no	Codice Barcode
secondary_code	String	no	Codice secondario
type	String	no	Tipo prodotto
note	String	no	Note
net_price	Double	Prezzo al netto iva
gross_price	Double	Prezzo lordo
vat_amount	Double	Importo IVA
purchase_price	Double	Prezzo acquisto
price	Double	Prezzo al netto iva
regular_price	Double	Prezzo al netto iva
sale_price	Double	Prezzo vendita al netto iva
salesPriceIncludeVat	Double	Prezzo vendita lordo
sales_tax_rate	String	Percentuale iva – string es.”22”

POST Categoria

Post Categoria consente di creare una categoria:
GET https://api.semplisio.it/api/v1/productcategory


    Json example :
    {
      "plat_name": "plat1",
      "id": "123",
      "languages_text": [
        {
            "language_id": "IT",
            "name": "pantaloni da lavoro",
            "description": "pantalone jeans 5 tasche"
        },
        {
          "language_id": "EN",
          "name": "work pants",
          "description": "work jeans 5 pocket"
        }
      ],
      "father_id": "5fbbc8bb1e524b24c43c92c9",
      "enabled": true
}
 Response success :
   {
     "access": true,
      "data": {
         "_id": "6049db98d5cc55701b1ccc42"   //Id univoco in Semplisio
      }
   }

JSON PARAMETERS

Field	Type	Required	Description
id	String	si	Id piattaforma
plat_name	String	si	Nome piattaforma
languages_text	Array of Object	si	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
father_id	String	no	Id semplisio categoria padre
enabled	Boolean	si

PUT Categoria

Put Categoria consente di modificare una categoria:
PUT https://api.semplisio.it/api/v1/productcategory/{idsemplisio}


    Json example :
    {
      "languages_text": [
        {
            "language_id": "IT",
            "name": "pantaloni da lavoro",
            "description": "pantalone jeans 5 tasche"
        },
        {
          "language_id": "EN",
          "name": "work pants",
          "description": "work jeans 5 pocket"
        }
      ],
      "father_id": "5fbbc8bb1e524b24c43c92c9",
      "enabled": true
}
 Response success :
   {
     "access": true,
      "data": {
         "_id": "6049db98d5cc55701b1ccc42"   //Id univoco in Semplisio
      }
   }

JSON PARAMETERS

Field	Type	Required	Description
languages_text	Array of Object	si	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
father_id	String	no	Id semplisio categoria padre
enabled	Boolean	si

Get Categorie

Ritorna tutte le categoria:
GET https://api.semplisio.it/api/v1/productcategory


   Response success example :
    {
  "access": true,
  "data": [
    {
      "_id": "607febcd40031735912ab228",
      "languages_text": [
        {
          "language_id": "IT",
          "name": "pantaloni da lavoro",
          "description": "pantalone jeans 5 tasche"
        },
        {
          "language_id": "EN",
          "name": "work pants",
          "description": "work jeans 5 pocket"
        }
      ],
      "enabled": true
    },
    {
      "_id": "607febf7418c857c1e37ab9b",
      "languages_text": [
        {
          "language_id": "IT",
          "name": "camice da lavoro",
          "description": "camice 5 tasche"
        }
      ],
      "father_id": "607febcd40031735912ab228",
      "enabled": true
    }
  ]
}

JSON PARAMETERS

Field	Type	Description
_id	String	identificativo Semplisio
languages_text	Array of Object	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
father_id	String	Id semplisio categoria padre
enabled	Boolean

Get Categoria

Ritorna una categoria:
GET https://api.semplisio.it/api/v1/productcategory/{idSemplisio}


   Response success example :
    {
  "access": true,
  "data": [
    {
      "_id": "607febcd40031735912ab228",
      "languages_text": [
        {
          "language_id": "IT",
          "name": "pantaloni da lavoro",
          "description": "pantalone jeans 5 tasche"
        },
        {
          "language_id": "EN",
          "name": "work pants",
          "description": "work jeans 5 pocket"
        }
      ],
      "enabled": true
    }
  ]
}

JSON PARAMETERS

Field	Type	Description
_id	String	identificativo Semplisio
languages_text	Array of Object	Nome e Descrizione multilingua: "language_id" : (String) codice ISO Nazione "name" : (String) nome prodotto "description" : (String) descrizione prodotto
father_id	String	Id semplisio categoria padre
enabled	Boolean

Post Stato Ordine

Post Stato Ordine consente di inserire stato ordine:
POST https://api.semplisio.it/api/v1/state-orders


   Json example :
    {
	"plat_name": "plat1",
	"id": "1",
	"name":"inoltrato"
    }

     Response success :
     {
        "access": true,
        "data": {
           "_id": "607ffca402f8493b01332496"
         }
     }

JSON PARAMETERS

Field	Type	Required	Description
id	String	si	Id piattaforma
plat_name	String	si	Nome piattaforma
name	String	si	nome stato ordine

Put Stato Ordine

Put Stato Ordine consente di modificare uno stato ordine:
PUT https://api.semplisio.it/api/v1/state-orders/{idSemplisio}


   Json example :
    {
     "name":"inoltrato"
    }

     Response success :
     {
        "access": true,
        "data": {
           "_id": "607ffca402f8493b01332496"
         }
     }

JSON PARAMETERS

Field	Type	Required	Description
name	String	si	nome stato ordine

Get Stati Ordine

Get Stati Ordine restituisce tutti stato ordine:
GET https://api.semplisio.it/api/v1/state-orders


   Response success :
 {
  "access": true,
  "data": [
    {
      "_id": "607ffca402f8493b01332496",
      "name": "inoltrato",
      "platforms_ids": {
        "plat1": "1"
      }
    },
    {
      "_id": "607fffb640031735912ab22d",
      "name": "verificato",
      "platforms_ids": {
        "plat1": "2"
      }
    }
  ]
}

JSON PARAMETERS

Field	Type	Description
_id	String	identificativo Semplisio
name	String	nome stato ordine

Get Stato Ordine

Get Stato Ordine Ordine restituisce stato ordine:
GET https://api.semplisio.it/api/v1/state-orders/{idSemplisio}


   Response success :
 {
  "access": true,
  "data": [
    {
      "_id": "607ffca402f8493b01332496",
      "name": "inoltrato",
      "platforms_ids": {
        "plat1": "1"
      }
    }
  ]
}

JSON PARAMETERS

Field	Type	Description
_id	String	identificativo Semplisio
name	String	nome stato ordine

Post Ordine

Post Ordine consente di inserire ordine:
POST https://api.semplisio.it/api/v1/orders


   {
	"plat_name": "plat1",
	"id": "3",
	 "billing_address": [
     {
       "first_name": "Antonio",
        "last_name": "Rossi",
        "company": "",
        "city": "TORINO",
        "country": "IT",
        "email": "arossi365@gmail.com",
        "phone": "33333333333",
        "address": "Via baltimora, 21",
        "zip_code": "10137",
        "state_province_region": "TO"
     }

    ],
    "shipping_address": [
      {
       "first_name": "Sabina",
       "last_name": "Rossi",
       "company": "",
       "city": "TORINO",
       "country": "IT",
       "email": "arossi365@gmail.com",
       "address": "Via roma, 13",
       "zip_code": "10137",
       "state_province_region": "TO"
      }
  ],
	"order_details": [
     {
        "name": "Pantaloni sportivi",
		"sku": "sku",
        "price": 100.00,
		"total": 200.00,
		"subtotal": 200.00,
		"total_tax": 40.00,
		"single_item_tax": 22.00,
		"sales_tax_rate": "22",
        "quantity": 2,
		"variant_id": "33333",
        "obj_product_id": "607fdd9a8e3fd947c2328033",
			  "attributes": [
					{
						"name": "colore",
						"option":"nero"
					},
					{
						"name": "taglia",
						"option":"XL"
					}
				]
      }
    ],
    "created_order": "2019-10-04 12:28:39",
    "date_paid": "2019-11-22 12:00:00",
    "order_states_id": "607ffca402f8493b01332496",
    "customer_id": "607eb5f2418c857c1e37ab93",
	"total": 200.00,
    "subtotal":200.00,
    "total_tax": 44.00,
	"shipping_total": 7.38,
    "shipping_tax": 1.62,
    "discounts": [
       {
		 "discount_total": 0.00,
		 "discount_tax": 0.00,
		 "discount_name": "",
         "discount_percentage_1" :"",
         "discount_percentage_2": "",
         "discount_percentage_3": "",
         "discount_percentage_4": ""
       }
     ],
     "currency":"EURO",
     "payment": "paypal",
     "payment_method_title":"pagamento tramite paypal",
     "payment_transaction_id":"XXXXXXXXXXXX",
     "invoice_type":"invoice",
     "invoice_fiscal_code":"AAABBB80A01A509Z",
     "invoice_piva":"99999999999",
     "total_shipping_price": [
      {
          "price": 10,
          "total": 10,
          "total_tax": 2.2,
          "title": "Tariffa Italia",
          "tax_percentage": 22,
          "total_with_tax": 12.2
            }
        ]
}

     Response success :
     {
        "access": true,
        "data": {
           "_id": "607ffca402f8493b01332496"
         }
     }

JSON PARAMETERS

Field	Type	Required	Description
id	String	si	Id piattaforma
plat_name	String	si	Nome piattaforma
billing_address	Array of Object	si	Indirizzo di fatturazione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
shipping_address	Array of Object	si	Indirizzo di spedizione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
order_details	Array of Object	si	prodotti ordine "name": (String) nome, "sku": (String) codice sku, "price": (Double) prezzo unitario iva esclusa, "total": (Double) prezzi totali comprensivi di tasse + spese di spedizione + commissioni + tasse sulle commissioni - sconto, "subtotal": (Double) prezzi totali IVA inclusa "total_tax": (Double) totale iva "single_item_tax": (Double) iva unitaria "sales_tax_rate": (String) percentuale iva, "quantity": (Integer) quantità prodotto ordinata, "variant_id": (String) Id variante piattaforma che genera ordine, "obj_product_id": (String) identificativo prodotto Semplisio "attributes":(Array of Object ) "name" : (String) nome attributo, "option" : (String) valore attributo
created_order	Date	si	Data creazione ordine
date_paid	Date	si	Data pagamento ordine
order_states_id	(String)	si	identificativo cliente Semplisio
total	(Double)	si	totale ordine comprensivo iva e spedizione
subtotal	(Double)	si	totale ordine comprensivo iva e spedizione prima dello sconto
total_tax	(Double)	si	totale iva ordine
shipping_total	(Double)	si	totale spese spedizione senza iva
shipping_tax	(Double)	si	totale iva spese spedizione
discounts	Array of Object	no	sconti ordine "discount_total": (Double) sconto totale, "discount_tax": (Double) totale iva sconto, "discount_name": (String) nome sconto, "discount_percentage_1": (String) percentuale sconto,
currency	String	no	valuta
payment	String	no	metodo pagemento
payment_method_title	String	no	descrizione metodo pagamento
payment_transaction_id	String	no	id transazione pagamento
invoice_type	String	no	Fattura/Ricevuta – string "es.receipt,private,invoice"
invoice_fiscal_code	String	no	Codice fiscale ricevuta – string ”16”
invoice_piva	String	no	Partita iva fattura – string "11"
total_shipping_price	Array of Object	no	metodi di spedizione "price": (Double) prezzo senza iva, "total": (Double) totale senza iva, "total_tax": (Double) importo iva, "title": (String) titolo spedizione, "tax_percentage": (Integer) percentuale iva, "total_with_tax": (Double) totale iva compresa,

Put Ordine

Put Ordine consente di modificare ordine:
PUT https://api.semplisio.it/api/v1/orders/{idSemplisio}


   {
   "billing_address": [
     {
       "first_name": "Antonio",
        "last_name": "Rossi",
        "company": "",
        "city": "TORINO",
        "country": "IT",
        "email": "arossi365@gmail.com",
        "phone": "33333333333",
        "address": "Via baltimora, 21",
        "zip_code": "10137",
        "state_province_region": "TO"
     }

    ],
    "shipping_address": [
      {
       "first_name": "Sabina",
       "last_name": "Rossi",
       "company": "",
       "city": "TORINO",
       "country": "IT",
       "email": "arossi365@gmail.com",
       "address": "Via roma, 13",
       "zip_code": "10137",
       "state_province_region": "TO"
      }
  ],
	"order_details": [
     {
        "name": "Pantaloni sportivi",
		"sku": "sku",
        "price": 100.00,
		"total": 200.00,
		"subtotal": 200.00,
		"total_tax": 40.00,
		"single_item_tax": 22.00,
		"sales_tax_rate": "22",
        "quantity": 2,
		"variant_id": "33333",
        "obj_product_id": "607fdd9a8e3fd947c2328033",
			  "attributes": [
					{
						"name": "colore",
						"option":"nero"
					},
					{
						"name": "taglia",
						"option":"XL"
					}
				]
      }
    ],
    "created_order": "2019-10-04 12:28:39",
    "date_paid": "2019-11-22 12:00:00",
    "order_states_id": "607ffca402f8493b01332496",
    "customer_id": "607eb5f2418c857c1e37ab93",
	"total": 200.00,
    "subtotal":200.00,
    "total_tax": 44.00,
	"shipping_total": 7.38,
    "shipping_tax": 1.62,
    "discounts": [
       {
		 "discount_total": 0.00,
		 "discount_tax": 0.00,
		 "discount_name": "",
         "discount_percentage_1" :"",
         "discount_percentage_2": "",
         "discount_percentage_3": "",
         "discount_percentage_4": ""
       }
     ],
     "currency":"EURO",
     "payment": "paypal",
     "payment_method_title":"pagamento tramite paypal",
     "payment_transaction_id":"XXXXXXXXXXXX",
     "invoice_type":"invoice",
     "invoice_fiscal_code":"AAABBB80A01A509Z",
     "invoice_piva":"99999999999",
     "total_shipping_price": [
      {
          "price": 10,
          "total": 10,
          "total_tax": 2.2,
          "title": "Tariffa Italia",
          "tax_percentage": 22,
          "total_with_tax": 12.2
            }
        ]
}

     Response success :
     {
        "access": true,
        "data": {
           "_id": "607ffca402f8493b01332496"
         }
     }

JSON PARAMETERS

Field	Type	Required	Description
_id	String	si	identificativo Semplisio
billing_address	Array of Object	si	Indirizzo di fatturazione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
shipping_address	Array of Object	si	Indirizzo di spedizione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
order_details	Array of Object	si	prodotti ordine "name": (String) nome, "sku": (String) codice sku, "price": (Double) prezzo unitario iva esclusa, "total": (Double) prezzi totali comprensivi di tasse + spese di spedizione + commissioni + tasse sulle commissioni - sconto, "subtotal": (Double) prezzi totali IVA inclusa "total_tax": (Double) totale iva "single_item_tax": (Double) iva unitaria "sales_tax_rate": (String) percentuale iva, "quantity": (Integer) quantità prodotto ordinata, "variant_id": (String) Id variante piattaforma che genera ordine, "obj_product_id": (String) identificativo prodotto Semplisio "attributes":(Array of Object ) "name" : (String) nome attributo, "option" : (String) valore attributo
created_order	Date	si	Data creazione ordine
date_paid	Date	no	Data pagamento ordine
order_states_id	String	si	identificativo cliente Semplisio
total	Double	si	totale ordine comprensivo iva e spedizione
subtotal	Double	si	totale ordine comprensivo iva e spedizione prima dello sconto
total_tax	Double	si	totale iva ordine
shipping_total	Double	si	totale spese spedizione senza iva
shipping_tax	Double	si	totale iva spese spedizione
discounts	Array of Object	no	sconti ordine "discount_total": (Double) sconto totale, "discount_tax": (Double) totale iva sconto, "discount_name": (String) nome sconto, "discount_percentage_1": (String) percentuale sconto,
currency	String	no	valuta
payment	String	no	metodo pagemento
payment_method_title	String	no	descrizione metodo pagamento
payment_transaction_id	String	no	id transazione pagamento
invoice_type	String	no	Fattura/Ricevuta – string "es.receipt,private,invoice"
invoice_fiscal_code	String	no	Codice fiscale ricevuta – string ”16”
invoice_piva	String	no	Partita iva fattura – string "11"
total_shipping_price	Array of Object	no	metodi di spedizione "price": (Double) prezzo senza iva, "total": (Double) totale senza iva, "total_tax": (Double) importo iva, "title": (String) titolo spedizione, "tax_percentage": (Integer) percentuale iva, "total_with_tax": (Double) totale iva compresa,

Get Ordini

Ritorna tutti gli ordini:
GET https://api.semplisio.it/api/v1/orders


   Response success
   {
  "access": true,
  "data": [
    {
      "_id": "60802e1d84c3c731c90e252a",
      "billing_address": [
        {
          "first_name": "Antonio",
          "last_name": "Rossi",
          "company": null,
          "city": "TORINO",
          "country": "IT",
          "email": "arossi365@gmail.com",
          "phone": "33333333333",
          "address": "Via baltimora, 21",
          "zip_code": "10137",
          "state_province_region": "TO"
        }
      ],
      "shipping_address": [
        {
          "first_name": "Sabina",
          "last_name": "Rossi",
          "company": null,
          "city": "TORINO",
          "country": "IT",
          "email": "arossi365@gmail.com",
          "address": "Via roma, 13",
          "zip_code": "10137",
          "state_province_region": "TO"
        }
      ],
      "order_details": [
        {
          "name": "Pantaloni sportivi",
          "sku": "sku",
          "price": 100,
          "total": 200,
          "subtotal": 200,
          "total_tax": 40,
          "single_item_tax": 22,
          "sales_tax_rate": "22",
          "quantity": 2,
          "variant_id": "33333",
          "obj_product_id": {
            "$oid": "607fdd9a8e3fd947c2328033"
          },
          "attributes": [
            {
              "name": "colore",
              "option": "nero"
            },
            {
              "name": "taglia",
              "option": "XL"
            }
          ]
        }
      ],
      "created_order": "2019-10-04 10:28:39",
      "date_paid": "2019-11-22 11:00:00",
      "order_states_id": "607ffca402f8493b01332496",
      "customer_id": "607eb5f2418c857c1e37ab93",
      "total": 200,
      "subtotal": 200,
      "total_tax": 44,
      "shipping_total": 7.38,
      "shipping_tax": 1.62,
      "discounts": [
        {
          "discount_total": 1,
          "discount_tax": 2,
          "discount_name": "sconto",
          "discount_percentage_1": "1",
          "discount_percentage_2": null,
          "discount_percentage_3": null,
          "discount_percentage_4": null
        }
      ],
      "invoice_type":"invoice",
      "invoice_fiscal_code":"AAABBB80A01A509Z",
      "invoice_piva":"99999999999",
      "currency": "EURO",
      "payment": "paypal"
    }
  ]
}

JSON PARAMETERS

Field	Type	Description
billing_address	Array of Object	Indirizzo di fatturazione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
shipping_address	Array of Object	Indirizzo di spedizione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
order_details	Array of Object	prodotti ordine "name": (String) nome, "sku": (String) codice sku, "price": (Double) prezzo unitario iva esclusa, "total": (Double) prezzi totali comprensivi di tasse + spese di spedizione + commissioni + tasse sulle commissioni - sconto, "subtotal": (Double) prezzi totali IVA inclusa "total_tax": (Double) totale iva "single_item_tax": (Double) iva unitaria "sales_tax_rate": (String) percentuale iva, "quantity": (Integer) quantità prodotto ordinata, "variant_id": (String) Id variante piattaforma che genera ordine, "obj_product_id": (String) identificativo prodotto Semplisio "attributes":(Array of Object ) "name" : (String) nome attributo, "option" : (String) valore attributo
created_order	Date	Data creazione ordine
date_paid	Date	Data pagamento ordine
order_states_id	(String)	identificativo cliente Semplisio
total	(Double)	totale ordine comprensivo iva e spedizione
subtotal	(Double)	totale ordine comprensivo iva e spedizione prima dello sconto
total_tax	(Double)	totale iva ordine
shipping_total	(Double)	totale spese spedizione senza iva
shipping_tax	(Double)	totale iva spese spedizione
discounts	Array of Object	sconti ordine "discount_total": (Double) sconto totale, "discount_tax": (Double) totale iva sconto, "discount_name": (String) nome sconto, "discount_percentage_1": (String) percentuale sconto,
currency	(String)	valuta
payment	(String)	metodo pagemento
payment_method_title	(String)	descrizione metodo pagamento
payment_transaction_id	(String)	id transazione pagamento
invoice_type	String	Fattura/Ricevuta – string "es.receipt,private,invoice"
invoice_fiscal_code	String	Codice fiscale ricevuta – string ”16”
invoice_piva	String	Partita iva fattura – string "11"
total_shipping_price	Array of Object	metodi di spedizione "price": (Double) prezzo senza iva, "total": (Double) totale senza iva, "total_tax": (Double) importo iva, "title": (String) titolo spedizione, "tax_percentage": (Integer) percentuale iva, "total_with_tax": (Double) totale iva compresa,

Get Ordine

Ritorna un solo ordine:
GET https://api.semplisio.it/api/v1/orders/{idSemplisio}


   Response success
   {
  "access": true,
  "data": [
    {
      "_id": "60802e1d84c3c731c90e252a",
      "billing_address": [
        {
          "first_name": "Antonio",
          "last_name": "Rossi",
          "company": null,
          "city": "TORINO",
          "country": "IT",
          "email": "arossi365@gmail.com",
          "phone": "33333333333",
          "address": "Via baltimora, 21",
          "zip_code": "10137",
          "state_province_region": "TO"
        }
      ],
      "shipping_address": [
        {
          "first_name": "Sabina",
          "last_name": "Rossi",
          "company": null,
          "city": "TORINO",
          "country": "IT",
          "email": "arossi365@gmail.com",
          "address": "Via roma, 13",
          "zip_code": "10137",
          "state_province_region": "TO"
        }
      ],
      "order_details": [
        {
          "name": "Pantaloni sportivi",
          "sku": "sku",
          "price": 100,
          "total": 200,
          "subtotal": 200,
          "total_tax": 40,
          "single_item_tax": 22,
          "sales_tax_rate": "22",
          "quantity": 2,
          "variant_id": "33333",
          "obj_product_id": {
            "$oid": "607fdd9a8e3fd947c2328033"
          },
          "attributes": [
            {
              "name": "colore",
              "option": "nero"
            },
            {
              "name": "taglia",
              "option": "XL"
            }
          ]
        }
      ],
      "created_order": "2019-10-04 10:28:39",
      "date_paid": "2019-11-22 11:00:00",
      "order_states_id": "607ffca402f8493b01332496",
      "customer_id": "607eb5f2418c857c1e37ab93",
      "total": 200,
      "subtotal": 200,
      "total_tax": 44,
      "shipping_total": 7.38,
      "shipping_tax": 1.62,
      "discounts": [
        {
          "discount_total": 1,
          "discount_tax": 2,
          "discount_name": "sconto",
          "discount_percentage_1": "1",
          "discount_percentage_2": null,
          "discount_percentage_3": null,
          "discount_percentage_4": null
        }
      ],
      "invoice_type":"invoice",
      "invoice_fiscal_code":"AAABBB80A01A509Z",
      "invoice_piva":"99999999999",
      "currency": "EURO",
      "payment": "paypal"
    }
  ]
}

JSON PARAMETERS

Field	Type	Description
billing_address	Array of Object	Indirizzo di fatturazione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
shipping_address	Array of Object	Indirizzo di spedizione "first_name": (String) nome, "last_name": (String) cognome, "company": (String) azienda, "city": (String) nome città, "country": (String) codice ISO Nazione "email": (String) email "phone": (String) telefono "address": (String) indirizzo, "zip_code": (String) codice postale, "state_province_region": (String) nome provincia,
order_details	Array of Object	prodotti ordine "name": (String) nome, "sku": (String) codice sku, "price": (Double) prezzo unitario iva esclusa, "total": (Double) prezzi totali comprensivi di tasse + spese di spedizione + commissioni + tasse sulle commissioni - sconto, "subtotal": (Double) prezzi totali IVA inclusa "total_tax": (Double) totale iva "single_item_tax": (Double) iva unitaria "sales_tax_rate": (String) percentuale iva, "quantity": (Integer) quantità prodotto ordinata, "variant_id": (String) Id variante piattaforma che genera ordine, "obj_product_id": (String) identificativo prodotto Semplisio "attributes":(Array of Object ) "name" : (String) nome attributo, "option" : (String) valore attributo
created_order	Date	Data creazione ordine
date_paid	Date	Data pagamento ordine
order_states_id	(String)	identificativo cliente Semplisio
total	(Double)	totale ordine comprensivo iva e spedizione
subtotal	(Double)	totale ordine comprensivo iva e spedizione prima dello sconto
total_tax	(Double)	totale iva ordine
shipping_total	(Double)	totale spese spedizione senza iva
shipping_tax	(Double)	totale iva spese spedizione
discounts	Array of Object	sconti ordine "discount_total": (Double) sconto totale, "discount_tax": (Double) totale iva sconto, "discount_name": (String) nome sconto, "discount_percentage_1": (String) percentuale sconto,
currency	(String)	valuta
payment	(String)	metodo pagemento
payment_method_title	(String)	descrizione metodo pagamento
payment_transaction_id	(String)	id transazione pagamento
invoice_type	String	Fattura/Ricevuta – string "es.receipt,private,invoice"
invoice_fiscal_code	String	Codice fiscale ricevuta – string ”16”
invoice_piva	String	Partita iva fattura – string "11"
total_shipping_price	Array of Object	metodi di spedizione "price": (Double) prezzo senza iva, "total": (Double) totale senza iva, "total_tax": (Double) importo iva, "title": (String) titolo spedizione, "tax_percentage": (Integer) percentuale iva, "total_with_tax": (Double) totale iva compresa,

Errors

Le API di Semplisio restituiscono i seguenti errori:

Codice errore	Significato
401	Autenticazione fallita.
422	Uno o più parametri mandatori non son stati inviati.
500	Errore generico. Probabilmente un parametro è stato trasferito in modo errato.
404	L'endpoint richiesto non è presente