Specifiche per integrazione con Pcommerce il software italiano per ecommerce, in Cloud

Introduzione Ultimo Aggiornamento: 18/05/2022

Attraverso le API potrai interagire con il tuo ecommerce da applicazioni esterne e poter operare in lettura e scrittura

Poter operare con le API è necessaria l'attivazione del modulo e creazione delle Api Key private attraverso il pannello di controllo di Pcommerce.

Puoi creare infinite Api Keys ed eventualmente impostare restrizione su IP di accesso, le chiavi devono essere protette e mantenute segrete

.

Note

Il modulo API deve essere acquistato e attivato dallo staff nel tuo ecommerce. Successivamente potrai operare interagendo e creare le Api Keys. Contattaci per ulteriori info

Creazione Api Keys

Accedere alla propria installazione di Pcommerce, con credenziali di amministratore e portarsi nella sezione Impostazioni > API puoi creare le API keys, revorcarle o sospenderle.

Creare una nuova Api Key, inserendo una descrizione cosi da poterla distinguere da altre.

Per ogni API Key puoi scegliere se limitare l'accesso ad un solo IP, operazione consigliata per integrazione con server o applicazioni esterne

Creazione Api Keys

Permessi

Per ogni API key puoi assegnare i permessi, attraverso il menu Opzioni > Permessi

  • Comandi GET: Visualizza i dati
  • Comandi POST: Crea nuovi dati
  • Comandi PUT: Modifica dati
  • Comandi DELETE: Cancella i dati

Comandi DELETE

Il comando DELETE non è permesso in alcuni casi per evitare records orfani su DBS. Il comando viene eseguito a seguito di validazione e potresti ricevere errore "KO".

Attenzione!

Attivando il permesso su "All" viene attivato anche il permesso "DELETE" che permette la rimozione di record. Prestare attenzione sull'attivazione dei permessi abilitando solo quelli strettamente necessari.

Permessi Api Keys

Elenco Permessi su APIs

Info su Api Key Visualizza informazioni e permessi sull'API key
Gestione Categorie Categorie e sottocategorie impostate con relativi permessi e opzioni
Gestione Corrieri Corrieri con relativi permessi e opzioni
Gestione Pagamenti Modalità di pagamento compreso configurazione e opzioni
Gestione Prodotti Prodotti in categoria e ricerca con relativi permessi e opzioni
Gestione Clienti Operazioni di login, logout, inserimento e modifica cliente
Gestione Ordini Inserimento in carrello e checkout, gestione ordini e pagamento.

Suggerimento su Restrizione su IP in fase di sviluppo

Puoi creare diverse Api Keys con i medesimi permessi e abilitate rispettivamente per il server di produzione e browser dello staff.

Errori

Nella chiamata potresti ricevere uno di questi errori

Esempio Response Error

{
			"result": "KO",
			"IP": "212.66.50.153",
			"error": "No permission for the resource",
			"errorCode": "105",
}

Tabella Errori

Nelle richiesti potresti ricevere uno dei seguenti errori, verificare con errorcode motivazione e suggerimenti.

errorCode error Suggerimento
KO 101 No Plugin

Modulo non attivo

Il modulo "API" non è attivo sul tuo Pcommerce

{
    "result": "KO",
    "error": "No Plugin",
    "errorCode": "101"
}
KO 102 HTTP REQUESTED

Richiesta non valida

Protocollo non valido

{
    "result": "KO",
    "error": "HTTP REQUESTED",
    "errorCode": "102"
}
KO 103 IP not enabled

IP non abilitato

Da pannello di controllo hai impostato una restrizione su IP per l'Api Key,
puoi modificarlo su Configurazioni > API

{
    "result": "KO",
    "IP": "",
    "error": "IP not enabled",
    "errorCode": "103"
}
KO 104 No https request

Errore Https

La risorsa non viene richiamata con protocollo https Configurazioni > API

{
    "result": "KO",
    "error": "No https request",
    "errorCode": "104"
}
KO 105 No permission for the resource

Permesso non abilitato per l'API Key (GET,POST,PUT,DELETE)

Da pannello di controllo non è attivato il permesso necessario al webservice. Imposta il giusto permesso (GET,POST,PUT,DELETE) su Configurazioni > API

{
    "result": "KO",
    "IP": "",
    "error": "No permission for the resource",
    "errorCode": "105"
}
KO 106 Invalid Key

Api Key non valida

L'Api key è errata o mancante, puoi verificare su Configurazioni > API

{
    "result": "KO",
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "error": "Invalid Key",
    "errorCode": "106"
}
KO 107 xxx is empty

Valori mancanti nella richiesta

Uno o più paramentri sono mancanti nella richiesta

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "tipologia": "",
    "error": "ID or tipologia ('categoria', 'scategoria', 'sscategoria') is empty",
    "errorCode": "107"
}
KO 108 Invalid JSON Request

Richiesta JSON non valida

Sono presenti errori nella richiesta JSON, verificare il codice

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "error": "Invalid JSON Request",
    "errorCode": "108"
}
KO 109 Too many failed login attempts (XX attempts to Login)

Troppe richieste fallite

Al superamento del XX login errato il firewall blocca l'acount per alcuni minuti. Configurazioni e limiti sono gestiti nel back-end.
loginDelay indica i secondi rimanenti per il prossimo tentativo di Login.

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "error": "Too many failed login attempts (30 attempts to Login)",
    "loginDelay": "4",
    "errorCode": "109"
}
KO 110 Suspicious login attempt

Login Sospetto

Il firewall ha bloccato il login in quanto rilevato come sospetto.

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "error": "Suspicious login attempt",
    "errorCode": "110"
}
KO 111 Account Error

Problemi durante il login

Pcommerce ha rilevato una problematica sull'account e non può eseguire il Login.

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "error": "Account error",
    "errorCode": "111"
}
KO 112 username OR password is empty

Username o Password mancanti

Verificare la richiesta JSON in quanto sono mancanti uno o entrambi i parametri.

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "stato": "web",
    "error": "userToken is empty",
    "errorCode": "112"
}
KO 113 User Not Found

Login Errato

Utente non trovato in database (verificare i valori)

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "error": "User Not Found",
    "errorCode": "113"
}
KO 114 Invalid userToken

Token autenticazione errato

Il token di autenticazione errato e/o non presente

{
    "result": "KO",
    "API": "",
    "version": "2.0.0",
    "error": "Invalid userToken",
    "errorCode": "114"
}
KO 115 Product Not Found

Prodotto non trovato

Verificare valori di Request

{
    "result": "KO",
    "API": "getProduct",
    "version": "2.0.0",
    "stato": "web",
    "error": "Product Not Found",
    "errorCode": "115"
}
KO 116 Cart Error

Errore inserimento Carrello

Si è verificato un errore in inserimento carrello.

{
    "result": "KO",
    "API": "pushCart",
    "version": "2.0.0",
    "error": "Cart error",
    "errorCode": "116"
}
KO 117 Cart is empty

Carrello Vuoto

Carrello vuoto, non si può procedere al checkout

{
    "result": "KO",
    "API": "pushCheckout",
    "version": "2.0.0",
    "error": "Cart is empty",
    "errorCode": "117"
}
KO 118 User already exists

Cliente già presente

In fase di inserimento nuovo cliente, indica cliente già esistente. Restituisce il campo userToken con il token di autenticazione del cliente trovato ed il campo ErrorDesc identifica il campo trovato in database, ad esempio:

  • email
  • partita_iva
  • codice_fiscale
{
    "result": "KO",
    "API": "pushAccount",
    "version": "2.0.0",
    "error": "User already exists",
    "errorCode": "118",
    "errorDesc": "codice_fiscale",
    "userToken": "b1db40396aa3ea641003060b90a453279066618e"
}

Statistiche

Attraverso la Dashboard di Pcommerce potrai analizzare le statistiche di utilizzo di ogni singola Api Key

Per ogni Api Key potrai visionare l'elenco delle chiamate, IP di provenienza, richieste ecc..

Attraverso il grafico, potrai monitorare l'andamento delle richieste su base giornaliera, filtrabile per range di date

Statistiche Api Keys

Test

Al termine della procedura illustrata potrai testare il corretto accesso alle API, attraverso una delle seguenti procedure:

Verifica da URL

Per verificare la corretta configurazione delle Api Key consigliamo di testare, attraverso browser con il webservice getKeyInfo

Restrizione su IP

Se impostata la restrizione su IP, consigliamo di simulare la chiamata da diversi device e/o server con IP diversi.

Esito Positivo

Se ottieni risposta "OK" l'API Key è perfettamente funzionante

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		
{
    "getKeyInfo": {
        "result": "OK",
        "API": "infoKey",
        "version": "2.0.0",
        "stato": 1,
        "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
        "info": [
            {
                "desc_stato": "attiva",
                "IP": "212.66.99.253",
                "data": "2022-05-02 14:40:00",
                "descrizione": "test App IP staff",
                "num_queries_today": 0,
                "num_queries_all": 0,
                "permessi": [
                    {
                        "risorsa": "0",
                        "desc_risorsa": "Info su Api Key",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "1",
                        "desc_risorsa": "Gestione Categorie",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "2",
                        "desc_risorsa": "Gestione Corrieri",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "3",
                        "desc_risorsa": "Gestione Modalita Pagamenti",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "4",
                        "desc_risorsa": "Gestione Prodotti",
                        "tipologia": "All"
                    }
                ]
            }
        ]
    }
}

Restrizione su IP

Attraverso la dasbhoard di Pcommerce puoi impostare una restrizione su IP per ogni singola Key, operazione consigliata per utilizzi su server esterni.

Restrizione IP

Se tenti l'accesso da IP non abilitato riceverai il seguente errore

Response Body

Se l'indirizzo IP non è abilitato alla richiesta, riceverai il seguente codice di Errore
							
{
"result": "KO",
"IP": "212.237.37.89",
"error": "IP not enabled",
"errorCode": "103"
}

Esempio cUrl e Php

di seguito un esempio di cURL in PHP per effettuare chiamate in GET

							
							

[$url="https://www.nomedominio.it/API/getKeyInfo?key=XXXXXXXXXXXXXXXXXXXX";
$agent= 'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 1.0.3705; .NET CLR 1.1.4322)';

$ch = curl_init();
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($ch, CURLOPT_VERBOSE, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, $agent);
curl_setopt($ch, CURLOPT_URL,$url);
$result=curl_exec($ch);
var_dump($result);






APIs Configurazioni

Attraverso le APIs potrai sincronizzare le tue APP e servizi esterni con il gestionale Pcommerce in Cloud. Sono disponibili diversi webservices attraverso i quali potrai gestire vendite all'esterno della piattaforma Pcommerce o sincronizzare le informazioni pubblicate con il back-end di Pcommerce.

getKeyInfo Info su Api Key

Visualizza le informazioni e permessi dell'API key

GET

https://www.nomedominio.it/API/getKeyInfo?Key=xxxxxxxxxxxxxxxxxxx

Parametri

www.nomedominio.it deve essere sostituito con l'URL della propria installazione di Pcommerce

key * string Api Key abilitata da pannello di controllo
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		
{
    "getKeyInfo": {
        "result": "OK",
        "API": "infoKey",
        "version": "2.0.0",
        "stato": 1,
        "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
        "info": [
            {
                "desc_stato": "attiva",
                "IP": "212.66.99.253",
                "data": "2022-05-02 14:40:00",
                "descrizione": "test App IP staff",
                "num_queries_today": 0,
                "num_queries_all": 0,
                "permessi": [
                    {
                        "risorsa": "0",
                        "desc_risorsa": "Info su Api Key",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "1",
                        "desc_risorsa": "Gestione Categorie",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "2",
                        "desc_risorsa": "Gestione Corrieri",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "3",
                        "desc_risorsa": "Gestione Modalita Pagamenti",
                        "tipologia": "All"
                    },
                    {
                        "risorsa": "4",
                        "desc_risorsa": "Gestione Prodotti",
                        "tipologia": "All"
                    }
                ]
            }
        ]
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

getCategoryList Elenco Categorie

Ottieni l'elenco delle categorie e sottocategorie configurate su Pcommerce

GET

https://www.nomedominio.it/API/getCategoryList?key=xxxxxxxxxxxxxxxxxxx&stato=all&country=IT

Parametri

key * string Api Key abilitata da pannello di controllo
stato * String Permette di filtrare le categorie in funzione dello stato di pubblicazione
  • "all" Visualizza tutte le categorie
  • "web" Visualizza solo visibili nel front-end
  • "admin" Visualizza solo visibili nel back-end
country String
ISO 3166-1 alpha-2 codes
puoi filtrare l'estrapolazione delle lingue secondo una specifica lingua. Verranno restituite esclusivamente le categorie tradotte.
* Parametro obbligatorio

Visibile Web

Una categoria è ritenuta visibile nel front-end se è visibile sia lato web che admin.

Nodi Categorie

I nodi "categorie", "scategorie", "sscategorie" identificano rispettivamente categorie di 1°, 2° e 3° livello

Nodi Categorie

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

[
    {
        "getCategoryList": {
            "result": "OK",
            "API": "getCategoryList",
            "version": "2.0.0",
            "stato": "all",
            "categorie": [
                {
                    "id": 33,
                    "nome": "Notebook",
                    "country": "GB",
                    "id_gruppo": 0,
                    "num_ordinamento": 0,
                    "order_prodotti": 0,
                    "stato_cat": 0,
                    "stato_web": 0,
                    "stato_logo": "false",
                    "stato_protetta": 0,
                    "stato_login": "false",
                    "ricarico": 0,
                    "url_logo": null,
                    "peso_spedizione": 0,
                    "descrizione": ""
                },
                {
                    "id": 32,
                    "nome": "Hard Disk",
                    "country": "IT",
                    "id_gruppo": 21,
                    "num_ordinamento": 1,
                    "order_prodotti": 0,
                    "stato_cat": 0,
                    "stato_web": 1,
                    "stato_logo": "false",
                    "stato_protetta": 0,
                    "stato_login": "false",
                    "ricarico": 10,
                    "url_logo": null,
                    "peso_spedizione": 0,
                    "descrizione": ""
                },
                {
                    "id": 31,
                    "nome": "Stampanti e Scanner",
                    "country": "IT",
                    "id_gruppo": 21,
                    "num_ordinamento": 2,
                    "order_prodotti": 0,
                    "stato_cat": 0,
                    "stato_web": 0,
                    "stato_logo": "true",
                    "stato_protetta": 0,
                    "stato_login": "false",
                    "ricarico": 15,
                    "url_logo": null,
                    "peso_spedizione": 1.5,
                    "descrizione": "",
                    "scategorie": [
                        {
                            "id": 240,
                            "nome": "Stampanti Inkjet",
                            "country": "IT",
                            "id_categoria": 31,
                            "num_ordinamento": 1,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 10,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 239,
                            "nome": "Stampanti Laser",
                            "country": "IT",
                            "id_categoria": 31,
                            "num_ordinamento": 2,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 8,
                            "sscategorie": [
                                {
                                    "id": "29",
                                    "nome": "Laser Monocromatiche",
                                    "country": "IT",
                                    "id_scategoria": "239",
                                    "num_ordinamento": "1",
                                    "order_prodotti": "0",
                                    "stato_cat": "0",
                                    "stato_web": "0",
                                    "stato_logo": "false",
                                    "stato_login": "false",
                                    "ricarico": "0",
                                    "url_logo": "",
                                    "peso_spedizione": "0",
                                    "descrizione": ""
                                },
                                {
                                    "id": "28",
                                    "nome": "Laser Colori",
                                    "country": "IT",
                                    "id_scategoria": "239",
                                    "num_ordinamento": "2",
                                    "order_prodotti": "0",
                                    "stato_cat": "0",
                                    "stato_web": "0",
                                    "stato_logo": "false",
                                    "stato_login": "false",
                                    "ricarico": "0",
                                    "url_logo": "",
                                    "peso_spedizione": "0",
                                    "descrizione": ""
                                }
                            ],
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        }
                    ]
                },
                {
                    "id": 10,
                    "nome": "Informatica",
                    "country": "IT",
                    "id_gruppo": 0,
                    "num_ordinamento": 2,
                    "order_prodotti": 0,
                    "stato_cat": 0,
                    "stato_web": 0,
                    "stato_logo": "false",
                    "stato_protetta": 0,
                    "stato_login": "false",
                    "ricarico": 0,
                    "url_logo": null,
                    "peso_spedizione": 0,
                    "descrizione": "",
                    "scategorie": [
                        {
                            "id": 224,
                            "nome": "Monitor",
                            "country": "IT",
                            "id_categoria": 10,
                            "num_ordinamento": 0,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 225,
                            "nome": "Notebook",
                            "country": "IT",
                            "id_categoria": 10,
                            "num_ordinamento": 0,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 226,
                            "nome": "Smartphone",
                            "country": "IT",
                            "id_categoria": 10,
                            "num_ordinamento": 0,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "sscategorie": [
                                {
                                    "id": "30",
                                    "nome": "Android",
                                    "country": "IT",
                                    "id_scategoria": "226",
                                    "num_ordinamento": "0",
                                    "order_prodotti": "0",
                                    "stato_cat": "0",
                                    "stato_web": "0",
                                    "stato_logo": "false",
                                    "stato_login": "false",
                                    "ricarico": "0",
                                    "url_logo": "",
                                    "peso_spedizione": "0",
                                    "descrizione": ""
                                },
                                {
                                    "id": "31",
                                    "nome": " iOS",
                                    "country": "IT",
                                    "id_scategoria": "226",
                                    "num_ordinamento": "0",
                                    "order_prodotti": "0",
                                    "stato_cat": "0",
                                    "stato_web": "0",
                                    "stato_logo": "false",
                                    "stato_login": "false",
                                    "ricarico": "0",
                                    "url_logo": "",
                                    "peso_spedizione": "0",
                                    "descrizione": ""
                                },
                                {
                                    "id": "32",
                                    "nome": "Tablet",
                                    "country": "IT",
                                    "id_scategoria": "226",
                                    "num_ordinamento": "0",
                                    "order_prodotti": "0",
                                    "stato_cat": "0",
                                    "stato_web": "0",
                                    "stato_logo": "false",
                                    "stato_login": "false",
                                    "ricarico": "0",
                                    "url_logo": "",
                                    "peso_spedizione": "0",
                                    "descrizione": ""
                                }
                            ],
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 227,
                            "nome": "Tablet",
                            "country": "IT",
                            "id_categoria": 10,
                            "num_ordinamento": 0,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        }
                    ]
                },
                {
                    "id": 7,
                    "nome": "Abbigliamento",
                    "country": "IT",
                    "id_gruppo": 0,
                    "num_ordinamento": 3,
                    "order_prodotti": 0,
                    "stato_cat": 0,
                    "stato_web": 0,
                    "stato_logo": "false",
                    "stato_protetta": 0,
                    "stato_login": "false",
                    "ricarico": 0,
                    "url_logo": null,
                    "peso_spedizione": 0,
                    "descrizione": "",
                    "scategorie": [
                        {
                            "id": 219,
                            "nome": "Pantaloni",
                            "country": "IT",
                            "id_categoria": 7,
                            "num_ordinamento": 1,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 220,
                            "nome": "Giacche",
                            "country": "IT",
                            "id_categoria": 7,
                            "num_ordinamento": 2,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 232,
                            "nome": "AAA",
                            "country": "IT",
                            "id_categoria": 7,
                            "num_ordinamento": 3,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "sscategorie": [
                                {
                                    "id": "25",
                                    "nome": "AA",
                                    "country": "IT",
                                    "id_scategoria": "232",
                                    "num_ordinamento": "0",
                                    "order_prodotti": "0",
                                    "stato_cat": "0",
                                    "stato_web": "0",
                                    "stato_logo": "false",
                                    "stato_login": "false",
                                    "ricarico": "0",
                                    "url_logo": "",
                                    "peso_spedizione": "0",
                                    "descrizione": ""
                                }
                            ],
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        },
                        {
                            "id": 218,
                            "nome": "Tshirt",
                            "country": "IT",
                            "id_categoria": 7,
                            "num_ordinamento": 4,
                            "order_prodotti": 0,
                            "stato_cat": 0,
                            "stato_web": 0,
                            "stato_logo": "false",
                            "stato_protetta": 0,
                            "stato_login": "false",
                            "ricarico": 0,
                            "url_logo": null,
                            "peso_spedizione": 0,
                            "descrizione": ""
                        }
                    ]
                }
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

categorie, scategorie, sscategorie

I nodi indentificano rispettivamente categorie di primo, secondo e terzo livello

Descrizione
id int ID univoco della categoria
nome string Nome della Categoria nella lingua selezionata
country String
ISO 3166-1 alpha-2 codes
codice nazione
id_gruppo int Solo per le categorie identifica il gruppo di appartenenza (ulteriore livello)
num_ordinamento int Identifica la sequenza di ordinamento della categoria assegnata manualmente (Drag and drop dal gestionale), se valorizzata su 0 l'ordinamento segue l'impostazione delle configurazioni generali.
order_prodotti int Se valorizzato identifica l'ordinamento automatico dei prodotti contenuti in categoria, se valorizzata su 0 l'ordinamento segue l'impostazione delle configurazioni generali.
  • 1 Più visitati
  • 2 Codice fornitore
  • 3 Codice interno
  • 4 Data inserimento
  • 5 Ultima modifica
  • 6 QT decrescente
  • 7 QT crescente
stato_cat int
  • 0 visibile back-end
  • 1 nascosto back-end
stato_web int
  • 0 visibile front-end
  • 1 nascosto front-end
stato_logo bool È true (valore boolean) se la il logo della categoria è settato come visibile nel front-end
stato_login bool È true (valore boolean) se hai abilitato la visione della categoria solo per utenti loggati
stato_protetta int Se valorizzato con valore superiore a 0 indentifica l'ID della tipologia clienti abilitata alla visione
ricarico int Se Pcommerce è configurato con "prezzo acquisto + ricarico"
identifica la percentuale di maggiorazione applicata in categoria
sconto int Se Pcommerce è configurato con vendita con "sconto su listino"
identifica la percentuale di sconto applicata alla categoria
url_logo string Se impostato, l'URL del logo categoria
peso_spedizione int Se impostato indica il peso medio (in kg) dei prodotti contenuti in categoria
descrizione int Se impostata identifica la descrizione/presentazione (in HTML) della categoria

getCategory Singola Categoria

Ottieni la singola categoria o sottocategoria

GET

https://www.nomedominio.it/API/getCategory?key=xxxxxxxxxxxxxxxxxxx&id=XX&=XX

Parametri

key * string Api Key abilitata da pannello di controllo
id * int Id della categoria/scategoria/sscategoria
tipologia * String Permette di indicare il livello di estrapolazione
  • "categoria" 1° livello
  • "scategoria" 2° livello
  • "sscategoria" 3° livello
* Parametro obbligatorio

Nodi Categorie

I nodi "categoria", "scategoria", "sscategoria" identificano rispettivamente categorie di 1°, 2° e 3° livello

Nodi Categorie

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		
[
    {
        "getCategory": {
            "result": "OK",
            "API": "getCategory",
            "version": "2.0.0",
            "tipologia": "categoria",
            "categorie": [
                [
                    {
                        "id": 31,
                        "nome": "Stampanti e Scanner",
                        "country": "IT",
                        "id_gruppo": 21,
                        "num_ordinamento": 2,
                        "order_prodotti": 0,
                        "stato_cat": 0,
                        "stato_web": 0,
                        "stato_logo": "true",
                        "stato_protetta": 0,
                        "stato_login": "false",
                        "ricarico": 15,
                        "url_logo": null,
                        "peso_spedizione": 1.5,
                        "descrizione": "",
                        "scategorie": [
                            {
                                "id": 240,
                                "nome": "Stampanti Inkjet",
                                "country": "IT",
                                "id_categoria": 31,
                                "num_ordinamento": 1,
                                "order_prodotti": 0,
                                "stato_cat": 0,
                                "stato_web": 0,
                                "stato_logo": "false",
                                "stato_protetta": 0,
                                "stato_login": "false",
                                "ricarico": 10,
                                "url_logo": null,
                                "peso_spedizione": 0,
                                "descrizione": ""
                            },
                            {
                                "id": 239,
                                "nome": "Stampanti Laser",
                                "country": "IT",
                                "id_categoria": 31,
                                "num_ordinamento": 2,
                                "order_prodotti": 0,
                                "stato_cat": 0,
                                "stato_web": 0,
                                "stato_logo": "false",
                                "stato_protetta": 0,
                                "stato_login": "false",
                                "ricarico": 8,
                                "sscategorie": [
                                    {
                                        "id": "29",
                                        "nome": "Laser Monocromatiche",
                                        "country": "IT",
                                        "id_scategoria": "239",
                                        "num_ordinamento": "1",
                                        "order_prodotti": "0",
                                        "stato_cat": "0",
                                        "stato_web": "0",
                                        "stato_logo": "false",
                                        "stato_login": "false",
                                        "ricarico": "0",
                                        "url_logo": "",
                                        "peso_spedizione": "0",
                                        "descrizione": ""
                                    },
                                    {
                                        "id": "28",
                                        "nome": "Laser Colori",
                                        "country": "IT",
                                        "id_scategoria": "239",
                                        "num_ordinamento": "2",
                                        "order_prodotti": "0",
                                        "stato_cat": "0",
                                        "stato_web": "0",
                                        "stato_logo": "false",
                                        "stato_login": "false",
                                        "ricarico": "0",
                                        "url_logo": "",
                                        "peso_spedizione": "0",
                                        "descrizione": ""
                                    }
                                ],
                                "url_logo": null,
                                "peso_spedizione": 0,
                                "descrizione": ""
                            }
                        ]
                    }
                ]
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

I dati forniti sono i medesimi di getCategoryList

getCourierList Elenco Corrieri

Ottieni l'elenco dei corrieri configurati su Pcommerce, con relative opzioni e permessi

GET

https://www.nomedominio.it/API/getCourierList?key=xxxxxxxxxxxxxxxxxxx&stato=all

Parametri

key * string Api Key abilitata da pannello di controllo
stato * String Permette di filtrare i corrieri in funzione dello stato di pubblicazione
  • "all" Visualizza tutti i corrieri
  • "web" Visualizza solo visibili nel front-end
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		

[
    {
        "getCourierList": {
            "result": "OK",
            "API": "getCourierList",
            "version": "2.0.0",
            "stato": "all",
            "corrieri": [
                {
                    "id": 2,
                    "nome": "Bartolini",
                    "codice_cliente": "123",
                    "id_tracking": 1,
                    "predefinito": 0,
                    "stato_contrassegno": 0,
                    "stato_attivazione": 0,
                    "stato_omaggio": 0,
                    "min_ordine": "0.00",
                    "max_ordine": "0.00",
                    "prezzo": "15.20",
                    "stato_assicurazione": 0,
                    "perc_assicurazione": "5.00",
                    "costo_assicurazione": "0.00",
                    "costo_assicurazione_limite": "0.00",
                    "spedizione_logo": "bartolini.gif",
                    "url_logo": "https://www.nomedominio.it/images/img_corrieri/bartolini.gif",
                    "assistenza": "",
                    "tariffe": [
                        {
                            "da_peso": "50.00",
                            "a_peso": "200.00",
                            "euro": "50.00",
                            "country": "IT"
                        },
                        {
                            "da_peso": "200.00",
                            "a_peso": "250.00",
                            "euro": "60.00",
                            "country": "IT"
                        },
                        {
                            "da_peso": "1.00",
                            "a_peso": "10.00",
                            "euro": "12.00",
                            "country": "CH"
                        },
                        {
                            "da_peso": "11.00",
                            "a_peso": "100.00",
                            "euro": "25.35",
                            "country": "CH"
                        }
                    ]
                },
                {
                    "id": 5,
                    "nome": "GLS",
                    "codice_cliente": "A",
                    "id_tracking": 1,
                    "predefinito": 0,
                    "stato_contrassegno": 1,
                    "stato_attivazione": 0,
                    "stato_omaggio": 1,
                    "min_ordine": "10.00",
                    "max_ordine": "50.00",
                    "prezzo": "20.00",
                    "stato_assicurazione": 1,
                    "perc_assicurazione": "10.00",
                    "costo_assicurazione": "50.00",
                    "costo_assicurazione_limite": "60.00",
                    "spedizione_logo": "GLS_Logo.jpg",
                    "url_logo": "https://www.nomedominio.it/images/img_corrieri/GLS_Logo.jpg",
                    "assistenza": "Test",
                    "tariffe": []
                },
                {
                    "id": 4,
                    "nome": "SDA",
                    "codice_cliente": "XXVXXX",
                    "id_tracking": 6,
                    "predefinito": 0,
                    "stato_contrassegno": 0,
                    "stato_attivazione": 0,
                    "stato_omaggio": 0,
                    "min_ordine": "0.00",
                    "max_ordine": "200.00",
                    "prezzo": "15.00",
                    "stato_assicurazione": 0,
                    "perc_assicurazione": "3.00",
                    "costo_assicurazione": "3.00",
                    "costo_assicurazione_limite": "0.00",
                    "spedizione_logo": "02072020171051.png",
                    "url_logo": "https://www.nomedominio.it/images/img_corrieri/02072020171051.png",
                    "assistenza": "",
                    "tariffe": []
                },
                {
                    "id": 13,
                    "nome": "Test Corriere",
                    "codice_cliente": "AAB",
                    "id_tracking": 0,
                    "predefinito": 1,
                    "stato_contrassegno": 0,
                    "stato_attivazione": 0,
                    "stato_omaggio": 1,
                    "min_ordine": "150.00",
                    "max_ordine": "200.00",
                    "prezzo": "150.00",
                    "stato_assicurazione": 0,
                    "perc_assicurazione": "150.00",
                    "costo_assicurazione": "200.00",
                    "costo_assicurazione_limite": "300.00",
                    "spedizione_logo": "logo-pcommerce.png",
                    "url_logo": "https://www.nomedominio.it/images/img_corrieri/logo-pcommerce.png",
                    "assistenza": "dssfdfdsfds",
                    "tariffe": []
                },
                {
                    "id": 3,
                    "nome": "TNT",
                    "codice_cliente": "",
                    "id_tracking": 2,
                    "predefinito": 0,
                    "stato_contrassegno": 0,
                    "stato_attivazione": 1,
                    "stato_omaggio": 1,
                    "min_ordine": "0.00",
                    "max_ordine": "0.00",
                    "prezzo": "15.00",
                    "stato_assicurazione": 1,
                    "perc_assicurazione": "0.00",
                    "costo_assicurazione": "0.00",
                    "costo_assicurazione_limite": "0.00",
                    "spedizione_logo": "TNT.png",
                    "url_logo": "https://www.nomedominio.it/images/img_corrieri/TNT.png",
                    "assistenza": "",
                    "tariffe": []
                },
                {
                    "id": 12,
                    "nome": "UPS",
                    "codice_cliente": "XXX",
                    "id_tracking": 10,
                    "predefinito": 0,
                    "stato_contrassegno": 0,
                    "stato_attivazione": 0,
                    "stato_omaggio": 0,
                    "min_ordine": "0.00",
                    "max_ordine": "0.00",
                    "prezzo": "15.00",
                    "stato_assicurazione": 0,
                    "perc_assicurazione": "3.00",
                    "costo_assicurazione": "2.00",
                    "costo_assicurazione_limite": "0.00",
                    "spedizione_logo": "UPS.png",
                    "url_logo": "https://www.nomedominio.it/images/img_corrieri/UPS.png",
                    "assistenza": "",
                    "tariffe": [
                        {
                            "da_peso": "3.00",
                            "a_peso": "5.00",
                            "euro": "15.00",
                            "country": "IT"
                        },
                        {
                            "da_peso": "6.00",
                            "a_peso": "10.00",
                            "euro": "20.00",
                            "country": "IT"
                        }
                    ]
                }
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Corrieri

I nodi indentificano i corrieri impostati su Pcommerce

Descrizione
id int ID univoco del Corriere
nome string Nome assegnato al corriere
codice_cliente string Se impostato rappresenta il codice cliente del contratto del corriere
codice_qapla string Codice corriere assegnato su Qaplà
id_tracking int

Se impostato il tracking assegnato al corriere

  • 0 Non Impostato
  • 1 Bartolini
  • 2 TNT
  • 4 Paccocelere3
  • 5 Raccomandata
  • 6 SDA
  • 7 Paccocelere1
  • 8 GLS
  • 9 Mail Boxes
  • 10 UPS
predefinito int
  • 0 standard
  • 1 predefinito nel moduli di selezione e carrello
stato_contrassegno int
  • 0 contrassegno accettato per questo corriere
  • 1 contrassegno non previsto per questo corriere
stato_attivazione int
  • 0 visibile nel front-end
  • 1 nascosto nel front-end
stato_omaggio int
  • 0 spedizione omaggio prevista al superamento di una soglia impostata
  • 1 non consente mai spedizione omaggio
min_ordine money(EUR) iva esclusa Se impostato, corriere abilitato per ordini a partire da importo min_ordine
max_ordine money(EUR) iva esclusa Se impostato, corriere abilitato per ordini fino a importo max_ordine
prezzo money(EUR) iva esclusa Costo base della spedizione
stato_assicurazione int
  • 0 calcolo costo assicurazione attivato
  • 1 calcolo costo assicurazione NON attivato
perc_assicurazione int Percentuale costo assicurazione applicata sul totale ordine
costo_assicurazione money(EUR) iva esclusa Costo base dell'assicurazione fisso oltre la percentuale
costo_assicurazione_limite money(EUR) iva esclusa Applica costo assicurazione, sempre dopo il limite in EURO, anche se non attivo
spedizione_logo string Se impostato, nome file del logo Corriere, impostato su Pcommerce
url_logo string Se impostato, URL del logo del corriere
assistenza string Descrizione (in HTML) per l'assistenza clienti sul corriere selezionato
tariffe array

Se impostate, sono indicate le tariffe per peso, il calcolo del peso della merce acquistata viene restituito da apposita Api

  • da_peso tariffa calcolata a partitre da (KG)
  • a_peso tariffa calcolata fino a (KG)
  • euro costo spedizione + IVA
  • country tariffa per specifica zona di spedizione

getCourier Singolo Corriere

Ottieni il singolo corriere

GET

https://www.nomedominio.it/API/getCourier?key=xxxxxxxxxxxxxxxxxxx&id=XX

Parametri

key * string Api Key abilitata da pannello di controllo
id * int Id del corriere
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		

[
    {
        "getCourier": {
            "result": "OK",
            "API": "getCourier",
            "version": "2.0.0",
            "corrieri": [
                [
                    {
                        "id": "2",
                        "nome": "Bartolini",
                        "codice_cliente": "123",
                        "id_tracking": "1",
                        "predefinito": "0",
                        "stato_contrassegno": "0",
                        "stato_attivazione": "0",
                        "stato_omaggio": "0",
                        "min_ordine": "0",
                        "max_ordine": "0",
                        "prezzo": "15.2000",
                        "stato_assicurazione": "0",
                        "perc_assicurazione": "5",
                        "costo_assicurazione": "0",
                        "costo_assicurazione_limite": "0",
                        "spedizione_logo": "bartolini.gif",
                        "url_logo": "https://www.nomedominio.it/images/img_corrieri/bartolini.gif",
                        "assistenza": "",
                        "tariffe": [
                            {
                                "da_peso": "50,00",
                                "a_peso": "200,00",
                                "euro": "50,00",
                                "country": "IT"
                            },
                            {
                                "da_peso": "200,00",
                                "a_peso": "250,00",
                                "euro": "60,00",
                                "country": "IT"
                            },
                            {
                                "da_peso": "1,00",
                                "a_peso": "10,00",
                                "euro": "12,00",
                                "country": "CH"
                            },
                            {
                                "da_peso": "11,00",
                                "a_peso": "100,00",
                                "euro": "25,35",
                                "country": "CH"
                            }
                        ]
                    }
                ]
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

I dati forniti sono i medesimi di getCourierList

getPaymentList Elenco modalità di pagamento

Ottieni l'elenco delle modalità di pagamento configurate su Pcommerce, con relative opzioni e permessi

GET

https://www.nomedominio.it/API/getPaymentList?key=xxxxxxxxxxxxxxxxxxx&stato=all

Parametri

key * string Api Key abilitata da pannello di controllo
stato * String Permette di filtrare le modalità di pagamento in funzione dello stato di pubblicazione
  • "all" Visualizza tutte le modalità di pagamento
  • "web" Visualizza solo visibili nel front-end
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		

[
    {
        "getPaymentList": {
            "result": "OK",
            "API": "getPaymentList",
            "version": "2.0.0",
            "stato": "all",
            "pagamenti": [
                {
                    "id": "18",
                    "nome": "Bollettino postale",
                    "country": "IT",
                    "stato_pagamento": "0",
                    "stato_cliente": "0",
                    "stato_checkout": "0",
                    "pos_virtuale": "0",
                    "ModalitaPagamento": "MP18",
                    "predefinito": "0",
                    "da_euro": "0",
                    "a_euro": "0",
                    "commissione_perc": "0",
                    "commissione_min": "0",
                    "view_coordinate": "0",
                    "dilazione": "",
                    "logo_pagamento": "bollettino-icon.png",
                    "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/bollettino-icon.png",
                    "descrizione": "",
                    "desc_fattura": "",
                    "cc_postale": {
                        "conto_postale_cc": "12345678",
                        "conto_postale_intestato": "Pizzut Test"
                    }
                },
                {
                    "id": "17",
                    "nome": "Bonifico bancario",
                    "country": "IT",
                    "stato_pagamento": "0",
                    "stato_cliente": "0",
                    "stato_checkout": "0",
                    "pos_virtuale": "0",
                    "ModalitaPagamento": "MP05",
                    "predefinito": "1",
                    "da_euro": "0",
                    "a_euro": "0",
                    "commissione_perc": "0",
                    "commissione_min": "0",
                    "view_coordinate": "0",
                    "dilazione": "",
                    "logo_pagamento": "Bank-icon.png",
                    "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/Bank-icon.png",
                    "descrizione": "Puoi pagare con bonifico bancario intestato alla nostra società. Nella pagina successiva riceverai le coordinate bancarie, effettuato il bonifico dovrai inviare copia della contabile via email o FAX. L'ordine sarà evaso non appena l'operazione sarà visibile sul conto (in media 3/4 giorni).",
                    "desc_fattura": "",
                    "coordinate": {
                        "conto_banca_iban": "IT92X0873874130000000019296",
                        "conto_banca_intestato": "Pizzut",
                        "conto_banca_nome": "Pizzut bank test",
                        "conto_banca_indirizzo": "",
                        "conto_banca_abi": "A",
                        "conto_banca_cab": "b",
                        "conto_banca_cin": "c",
                        "conto_banca_bic": "d"
                    }
                },
                {
                    "id": "27",
                    "nome": "Carta di Credito",
                    "country": "IT",
                    "stato_pagamento": "0",
                    "stato_cliente": "0",
                    "stato_checkout": "0",
                    "pos_virtuale": "3",
                    "ModalitaPagamento": "MP08",
                    "predefinito": "0",
                    "da_euro": "0",
                    "a_euro": "500",
                    "commissione_perc": "15",
                    "commissione_min": "5",
                    "view_coordinate": "0",
                    "dilazione": "",
                    "logo_pagamento": "credit-card-icon.png",
                    "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/credit-card-icon.png",
                    "descrizione": "",
                    "desc_fattura": "",
                    "stripeAPI": {
                        "pos_account": "xxxxxxxxxxxxxx",
                        "pos_mac_secret": "xxxxxxxxxxxxxxxxxx"
                    }
                },
                {
                    "id": "21",
                    "nome": "Contanti",
                    "country": "IT",
                    "stato_pagamento": "1",
                    "stato_cliente": "0",
                    "stato_checkout": "0",
                    "pos_virtuale": "0",
                    "ModalitaPagamento": "MP01",
                    "predefinito": "0",
                    "da_euro": "0",
                    "a_euro": "0",
                    "commissione_perc": "0",
                    "commissione_min": "0",
                    "view_coordinate": "0",
                    "dilazione": "",
                    "logo_pagamento": "money-icon.png",
                    "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/money-icon.png",
                    "descrizione": "",
                    "desc_fattura": ""
                },
                {
                    "id": "20",
                    "nome": "Contrassegno",
                    "country": "IT",
                    "stato_pagamento": "0",
                    "stato_cliente": "0",
                    "stato_checkout": "0",
                    "pos_virtuale": "0",
                    "ModalitaPagamento": "MP01",
                    "predefinito": "0",
                    "da_euro": "0",
                    "a_euro": "900",
                    "commissione_perc": "0",
                    "commissione_min": "0",
                    "view_coordinate": "0",
                    "dilazione": "",
                    "logo_pagamento": "money-icon.png",
                    "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/money-icon.png",
                    "descrizione": "Potrai pagare in contanti o con assegno bancario direttamente al corriere al momento del ritiro. Nessun costo aggiuntivo viene applicato per questo tipo di pagamento.",
                    "desc_fattura": "Non si accettano ass. bancari/circolari intestati mittente"
                },
                {
                    "id": "22",
                    "nome": "PayPal",
                    "country": "IT",
                    "stato_pagamento": "0",
                    "stato_cliente": "0",
                    "stato_checkout": "0",
                    "pos_virtuale": "0",
                    "ModalitaPagamento": "MP08",
                    "predefinito": "0",
                    "da_euro": "0",
                    "a_euro": "0",
                    "commissione_perc": "0",
                    "commissione_min": "0",
                    "view_coordinate": "0",
                    "dilazione": "",
                    "logo_pagamento": "paypal-icon.png",
                    "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/paypal-icon.png",
                    "descrizione": "Il circuito Paypal è tra i più sicuri al mondo con più di 50 milioni di clienti. La transazione avviene direttamente nei loro server garantendo piena sicurezza ai tuoi dati.\r\n

Maggiori info: www.paypal.it

\r\n", "desc_fattura": "", "paypal": { "paypal_email": "info@pizzut.it", "paypal_api_username": "", "paypal_api_password": "", "paypal_api_firma": "" } }, { "id": "23", "nome": "Ricarica Postepay", "country": "IT", "stato_pagamento": "0", "stato_cliente": "0", "stato_checkout": "0", "pos_virtuale": "0", "ModalitaPagamento": "MP08", "predefinito": "0", "da_euro": "0", "a_euro": "0", "commissione_perc": "0", "commissione_min": "0", "view_coordinate": "0", "dilazione": "", "logo_pagamento": "postepay-icon.png", "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/postepay-icon.png", "descrizione": "La Postepay è una carta di credito prepagata di Poste Italiane (opera con circuito VISA). Puoi pagare effettuando una ricarica online (se sei possessore della carta) oppure presso un qualsiasi ufficio postale. Dovrai richiedere infatti un modulo per ricaricare la postepay ed inserire i dati che ti forniremo in seguito.\r\n

Maggiori info: www.poste.it

\r\n", "desc_fattura": "", "carta_postepay": { "postepay_numero": "3448348348834", "postepay_intestato": "Pizzut", "postepay_codfiscale": "" } }, { "id": "29", "nome": "Satispay", "country": "IT", "stato_pagamento": "1", "stato_cliente": "", "stato_checkout": "0", "pos_virtuale": "4", "ModalitaPagamento": "MP05", "predefinito": "0", "da_euro": "0", "a_euro": "0", "commissione_perc": "", "commissione_min": "", "view_coordinate": "0", "dilazione": "", "logo_pagamento": "satispay.png", "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/satispay.png", "descrizione": "", "desc_fattura": "", "satispayAPI": { "pos_account": "", "pos_mac_secret": "" } }, { "id": "28", "nome": "ScalaPay", "country": "IT", "stato_pagamento": "0", "stato_cliente": "0", "stato_checkout": "0", "pos_virtuale": "5", "ModalitaPagamento": "MP08", "predefinito": "0", "da_euro": "0", "a_euro": "0", "commissione_perc": "0", "commissione_min": "0", "view_coordinate": "0", "dilazione": "", "logo_pagamento": "logo_scalapay.png", "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/logo_scalapay.png", "descrizione": "", "desc_fattura": "", "scalapayAPI": { "pos_account": "AAA", "pos_mac_secret": "BBBB" } }, { "id": "47", "nome": "Test Pagamento", "country": "IT", "stato_pagamento": "0", "stato_cliente": "1", "stato_checkout": "1", "pos_virtuale": "2", "ModalitaPagamento": "MP05", "predefinito": "0", "da_euro": "10", "a_euro": "15", "commissione_perc": "15", "commissione_min": "150", "view_coordinate": "0", "dilazione": "", "logo_pagamento": "", "url_logo": "", "descrizione": "fdsfsdsfd sdffsdfsd", "desc_fattura": "test", "keyclientAPI": { "pos_account": "xxxxxxxxxxxxxxxxx", "pos_mac_secret": "xxxxxxxxxxxxxxx" } } ] } } ]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Pagamenti

I nodi indentificano le modalità di pagamento impostate su Pcommerce

Descrizione
id int ID univoco del Corriere
nome string nome della modalità di pagamento
country String
ISO 3166-1 alpha-2 codes
codice nazione della modalità di pagamento
stato_pagamento int
  • 0 visibile front-end
  • 2 nascosto front-end
stato_cliente int
  • 0 selezionabile per tutti i clienti
  • 2 solo per clienti con almeno un ordine eseguito
stato_checkout int
  • 0 visibile in tutti i checkout
  • 2 non selezionabile nel checkout
pos_virtuale int

Identifica il POS virtuale assegnato alla modalità di pagamento

  • 0 nessun POS
  • 2 KeyClient
  • 3 Stripe
  • 4 Satispay
  • 5 ScalaPay
ModalitaPagamento String

Codifiche Modalità di pagamento su Fattura Elettronica

  • MP01 contanti
  • MP02 assegno
  • MP03 assegno circolare
  • MP04 contanti presso Tesoria
  • MP05 bonifico
  • MP06 vaglia cambiario
  • MP07 bollettino bancario
  • MP08 carta di pagamento
  • MP09 RID
  • MP10 RID utenze
  • MP11 RID veloce
  • MP12 RIBA
  • MP13 MAV
  • MP14 quietanza erario
  • MP15 giroconto su conti di contabilità speciale
  • MP16 domiciliazione bancaria
  • MP17 domiciliazione postale
  • MP18 bollettino di c/c postale
  • MP19 SEPA Direct
  • MP20 SEPA Direct Debit B2B
  • MP21 SEPA Direct Debit CORE
  • MP22 trattenute su somme già riscosse
predefinito int
  • 0 segue ordine alfabetico
  • 1 predefinito nei form del back-end
da_euro money(EUR) iva esclusa Se impostato, modalità di pagamento disponibile per importi da da_euro
a_euro money(EUR) iva esclusa Se impostato, modalità di pagamento disponibile fino ad importi di a_euro
commissione_perc int Se impostato, rappresenta la percentuale di commissione applicata al totale ordine
commissione_min money(EUR) Se impostato, rappresenta la commissione minima applicata se il calcolo in percentuale è inferiore
view_coordinate int
  • 0 non impostato
  • 1 coordinate o informazioni sul pagamento visibili nei documenti contabili
dilazione int

Espressa in giorni, identifica la dilazione applicata e visibile nei documenti ed in fattura elettronica

logo_pagamento string Icona identificativa della modalità di pagamento
url_logo string URL dell'icona della modalità di pagamento
descrizione string Se impostata identifica la descrizione/presentazione (in HTML) della modalità di pagamento
desc_fattura string Se impostata identifica la descrizione breve visibile nei documenti contabili

Configurazione POS

In funzione della modalità di pagamento, viene indicato il nodo relativo alla configurazione del POS con API esterne.

PaypalPayPal

Descrizione
paypal_email string Email associata al proprio account Paypal
paypal_api_username string Username API
paypal_api_password string Password API
paypal_api_firma string Firma API

Conto corrente bancarioCoordinate (Bonifico Bancario)

Descrizione
conto_banca_iban string IBAN conto corrente
conto_banca_intestato string Intestatario Conto
conto_banca_nome string Nome Banca
conto_banca_indirizzo string Indirizzo Banca
conto_banca_abi string ABI conto
conto_banca_cab string CAB conto
conto_banca_cin string CIN conto
conto_banca_bic string BIC conto

KeyClientKeyclient API

Descrizione
pos_account string Account Public Key
pos_mac_secret string Chiave MAC Secret

StripeStripe API

Descrizione
pos_account string Account Public Key
pos_mac_secret string Chiave MAC Secret

SatispaySatispay API

Descrizione
pos_account string Security Bearer
pos_mac_secret string Satispay Data key

ScalaPayScalaPay API

Descrizione
pos_account string Security Bearer
pos_mac_secret string Data Key

Bollettino PostaleBollettino Postale

Descrizione
conto_postale_cc string Numero Conto corrente postale
conto_postale_intestato string Intestatario del conto

Ricarica PostepayPostepay

Descrizione
postepay_numero string Numero Carta Postepay
postepay_intestato string Intestatario della carta
postepay_codfiscale string Codice fiscale intestatario

getPayment Singola modalità di pagamento

Ottieni le informazioni sulla singola modalità di pagamento

GET

https://www.nomedominio.it/API/getPayment?key=xxxxxxxxxxxxxxxxxxx&id=XX

Parametri

key * string Api Key abilitata da pannello di controllo
id * int Id della modalità di pagamento
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni
		

[
    {
        "getPayment": {
            "result": "OK",
            "API": "getPayment",
            "version": "2.0.0",
            "pagamenti": [
                [
                    {
                        "id": "27",
                        "nome": "Carta di Credito",
                        "country": "IT",
                        "stato_pagamento": "0",
                        "stato_cliente": "0",
                        "stato_checkout": "0",
                        "pos_virtuale": "3",
                        "ModalitaPagamento": "MP08",
                        "predefinito": "0",
                        "da_euro": "0",
                        "a_euro": "500",
                        "commissione_perc": "15",
                        "commissione_min": "5",
                        "view_coordinate": "0",
                        "dilazione": "",
                        "logo_pagamento": "credit-card-icon.png",
                        "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/credit-card-icon.png",
                        "descrizione": "",
                        "desc_fattura": "",
                        "stripeAPI": {
                            "pos_account": "xxxxxxxxxxxxxx",
                            "pos_mac_secret": "xxxxxxxxxxxxxxxxxx"
                        }
                    }
                ]
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

I dati forniti sono i medesimi di getPaymentList

APIs Prodotti

Attraverso queste APIs puoi visualizzare e gestire i prodotti caricati su Pcommerce. Attraverso diversi APIs puoi visionare prodotti in categorie, ricerca, singolo prodotto...

getProductList Elenco Prodotti

Ottieni l'elenco dei prodotti in categoria, o ricerca caricati su Pcommerce, con relative opzioni e permessi

GET

https://www.nomedominio.it/API/getProductList

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getProductList": {
        "rowsPerPage": "20",
        "startingRow": "0",
        "id_categoria": 7,
        "id_scategoria": 220,
        "id_sscategoria": 0,
        "stato": "web",
        "userToken": "",
        "applica_iva": 1,
        "listino": 0,
        "cerca": "giacca"
    }
}
key * string Api Key abilitata da pannello di controllo
rowsPerPage* int Numero prodotti per pagina, di default 30, massimo 30.
startingRow* int Inizia da riga (ad esempio "0", "30", "60") per paginazione
id_categoria int Se impostato filtra i prodotti per id_categoria (tutti i prodotti con id_categoria)
id_scategoria int Se impostato filtra i prodotti per id_scategoria ("AND" tutti i prodotti con id_scategoria)
id_sscategoria int Se impostato filtra i prodotti per id_scategoria ("AND" tutti i prodotti con id_sscategoria)
stato* String

Di default è impostato su "web"

  • "all" Visualizza tutti i prodotti
  • "web" Visualizza solo visibili nel front-end
  • "admin" Visualizza solo visibili nel back-end
userToken int Se impostato restituisce i prezzi assegnati al listino del cliente (individuato con userToken)
applica_iva* String

Visualizza prezzi iva inclusa/esclusa. Se non valorizzato è impostato su "iva inclusa"

  • "0" Visualizza tutti i prezzi "Iva Esclusa"
  • "1" Visualizza tutti i prezzi "iva inclusa"
listino String Se impostato visualizza prezzi di un determinato Listino (individuato con ID listino)
cerca String Se impostato visualizza prodotti con ricerca su Codice prodotto, nome, descrizione
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

[
    {
        "getProductList": {
            "result": "OK",
            "API": "getProductList",
            "version": "2.0.0",
            "stato": "",
            "startingRow": 0,
            "rowsPerPage": 20,
            "recordsTotal": "20",
            "id_categoria": "7",
            "id_scategoria": "0",
            "id_sscategoria": "0",
            "id_prodotto": 0,
            "cerca": "giacca",
            "applica_iva": "1",
            "listino": "0",
            "categoria": null,
            "prodotti": [
                {
                    "id": 52,
                    "nome": "Jeans modello Casuale",
                    "country": "IT",
                    "data": "2020-05-07 11:32:59",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "219",
                        "nome": "Pantaloni"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "true",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_52_Jeans-modello-Casuale.html",
                    "cod_interno": null,
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": ""
                    },
                    "qt_vendibili": -3,
                    "prezzo": {
                        "importo": "36.60",
                        "aliquota_iva": 22,
                        "aggiornamento": "2020-05-07 11:35:42"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 3
                    },
                    "immagini": [
                        {
                            "file": "Jeans-modello-Casuale-924359.jpg",
                            "desc": "AA",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-924359.jpg",
                            "dimensione": "751,2 KB",
                            "formato": "1024 x 682 pixels"
                        },
                        {
                            "file": "Jeans-modello-Casuale-885672.jpg",
                            "desc": "AB",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-885672.jpg",
                            "dimensione": "1 MB",
                            "formato": "1024 x 682 pixels"
                        },
                        {
                            "file": "Jeans-modello-Casuale-932298.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-932298.jpg",
                            "dimensione": "81,26 KB",
                            "formato": "800 x 533 pixels"
                        }
                    ]
                },
                {
                    "id": 177,
                    "nome": "Jeans modello Casuale",
                    "country": "IT",
                    "data": "2022-04-29 17:52:20",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "219",
                        "nome": "Pantaloni"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_177_Jeans-modello-Casuale.html",
                    "cod_interno": null,
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": ""
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "36.60",
                        "aliquota_iva": 22,
                        "aggiornamento": "2020-05-07 11:35:42"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 3
                    },
                    "immagini": [
                        {
                            "file": "Jeans-modello-Casuale-924359.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-924359.jpg",
                            "dimensione": "751,2 KB",
                            "formato": "1024 x 682 pixels"
                        },
                        {
                            "file": "Jeans-modello-Casuale-885672.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-885672.jpg",
                            "dimensione": "1 MB",
                            "formato": "1024 x 682 pixels"
                        },
                        {
                            "file": "Jeans-modello-Casuale-932298.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-932298.jpg",
                            "dimensione": "81,26 KB",
                            "formato": "800 x 533 pixels"
                        }
                    ]
                },
                {
                    "id": 178,
                    "nome": "Jeans modello Casuale",
                    "country": "IT",
                    "data": "2022-04-29 17:52:20",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "219",
                        "nome": "Pantaloni"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_178_Jeans-modello-Casuale.html",
                    "cod_interno": null,
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": ""
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "36.60",
                        "aliquota_iva": 22,
                        "aggiornamento": "2020-05-07 11:35:42"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 3
                    },
                    "immagini": [
                        {
                            "file": "Jeans-modello-Casuale-924359.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-924359.jpg",
                            "dimensione": "751,2 KB",
                            "formato": "1024 x 682 pixels"
                        },
                        {
                            "file": "Jeans-modello-Casuale-885672.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-885672.jpg",
                            "dimensione": "1 MB",
                            "formato": "1024 x 682 pixels"
                        },
                        {
                            "file": "Jeans-modello-Casuale-932298.jpg",
                            "desc": "Jeans modello Casuale",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Jeans-modello-Casuale-932298.jpg",
                            "dimensione": "81,26 KB",
                            "formato": "800 x 533 pixels"
                        }
                    ]
                },
                {
                    "id": 119,
                    "nome": "Test Pcommerce",
                    "country": "IT",
                    "data": "2021-11-08 13:31:11",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "5",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_119_Test-Pcommerce.html",
                    "cod_interno": null,
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": ""
                    },
                    "qt_vendibili": -1,
                    "prezzo": {
                        "importo": "512.88",
                        "aliquota_iva": null,
                        "aggiornamento": "2021-12-03 16:08:13"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "immagini": [
                        {
                            "file": "Test_526693.png",
                            "desc": "Test",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Test_526693.png",
                            "dimensione": "5,9 KB",
                            "formato": "250 x 28 pixels"
                        }
                    ]
                },
                {
                    "id": 131,
                    "nome": "Test Prodotto Pizzut",
                    "country": "IT",
                    "data": null,
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_131_Test-Prodotto-Pizzut.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": ""
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "12.20",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-03-03 17:07:07"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "10.00",
                        "euro_distributori": "30.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 10,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "versioni": [],
                    "immagini": [
                        {
                            "file": "jacket1.png",
                            "desc": "Test Prodotto Pizzut",
                            "url": "https://www.nomedominio.it/images/img_prodotti/jacket1.png",
                            "dimensione": "450,45 KB",
                            "formato": "1024 x 649 pixels"
                        },
                        {
                            "file": "jogging2 (3).png",
                            "desc": "Test Prodotto Pizzut",
                            "url": "https://www.nomedominio.it/images/img_prodotti/jogging2 (3).png",
                            "dimensione": "1,15 MB",
                            "formato": "1024 x 656 pixels"
                        }
                    ]
                },
                {
                    "id": 56,
                    "nome": "Giacca in pelle donna",
                    "country": "IT",
                    "data": "2020-05-07 11:46:24",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_56_Giacca-in-pelle-donna.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "3",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": -1,
                    "prezzo": {
                        "importo": "430.05",
                        "aliquota_iva": 22,
                        "aggiornamento": "2020-05-28 17:16:29"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-06-25 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 3,
                        "tot_versioni": 4,
                        "tot_versioni_web": 4,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "versioni": [
                        {
                            "idVersione": "36",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "28/05/2020",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "-4",
                            "nome_prodotto": "Giacca in pelle donna",
                            "nome_versione": "L nero",
                            "qt_finescorta": "0",
                            "euro_versione": "25.00",
                            "euro_versione_tot": "25.00"
                        },
                        {
                            "idVersione": "35",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "28/05/2020",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca in pelle donna",
                            "nome_versione": "M nero",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "11",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "28/05/2020",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "-1",
                            "nome_prodotto": "Giacca in pelle donna",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "34",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "28/05/2020",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca in pelle donna",
                            "nome_versione": "S nero",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "scontiQt": [
                        {
                            "da_qt": "1",
                            "a_qt": "5",
                            "sconto_perc": "5",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "2",
                            "a_qt": "7",
                            "sconto_perc": "10",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "8",
                            "a_qt": "10",
                            "sconto_perc": "15",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-in-pelle-donna-922477.jpg",
                            "desc": "Giacca in pelle donna",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-in-pelle-donna-922477.jpg",
                            "dimensione": "60,18 KB",
                            "formato": "800 x 800 pixels"
                        }
                    ]
                },
                {
                    "id": 55,
                    "nome": "Giacca sportiva, urban, Casual",
                    "country": "IT",
                    "data": "2020-05-07 11:46:24",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "5",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_55_Giacca-sportiva-urban-Casual.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "3",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 5,
                    "prezzo": {
                        "importo": "183.00",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-02-20 10:33:14"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-08-24 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "immagini": [
                        {
                            "file": "Giacca-sportiva -urban -Casual-334848.jpg",
                            "desc": "Giacca sportiva, urban, Casual",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-sportiva -urban -Casual-334848.jpg",
                            "dimensione": "47,51 KB",
                            "formato": "800 x 450 pixels"
                        }
                    ]
                },
                {
                    "id": 54,
                    "nome": "Giacca Donna Casual",
                    "country": "IT",
                    "data": "2020-05-07 11:46:24",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_54_Giacca-Donna-Casual.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "247.05",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-02-20 10:21:51"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-09-13 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 1,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 3
                    },
                    "versioni": [
                        {
                            "idVersione": "10",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "-2",
                            "nome_prodotto": "Giacca Donna Casual",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Donna-Casual-563855.jpg",
                            "desc": "Giacca Donna Casual Taglia L",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Donna-Casual-563855.jpg",
                            "dimensione": "57,97 KB",
                            "formato": "800 x 534 pixels"
                        }
                    ]
                },
                {
                    "id": 51,
                    "nome": "Tshirt cotone bianca",
                    "country": "IT",
                    "data": "2020-01-31 14:58:39",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "218",
                        "nome": "Tshirt"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_51_Tshirt-cotone-bianca.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "3",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 16,
                    "prezzo": {
                        "importo": "48.31",
                        "aliquota_iva": 22,
                        "aggiornamento": "2020-01-31 14:59:22"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "true",
                        "visibile_home": "true",
                        "visibile_paginaOfferte": "true",
                        "percentuale": 12,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2025-02-12 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 3,
                        "tot_versioni": 4,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 3,
                        "tot_codebar": 0,
                        "tot_relazioni": 3
                    },
                    "versioni": [
                        {
                            "idVersione": "30",
                            "codice_versione": "AA04",
                            "codice_fornitore": "",
                            "data_prezzo": "31/01/2020",
                            "id_categoria": "7",
                            "id_scategoria": "218",
                            "id_fornitore": "0",
                            "qt_versione": "25",
                            "nome_prodotto": "Tshirt cotone bianca",
                            "nome_versione": "2XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "27",
                            "codice_versione": "AA01",
                            "codice_fornitore": "",
                            "data_prezzo": "31/01/2020",
                            "id_categoria": "7",
                            "id_scategoria": "218",
                            "id_fornitore": "0",
                            "qt_versione": "-1",
                            "nome_prodotto": "Tshirt cotone bianca",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "28",
                            "codice_versione": "AA02",
                            "codice_fornitore": "",
                            "data_prezzo": "31/01/2020",
                            "id_categoria": "7",
                            "id_scategoria": "218",
                            "id_fornitore": "0",
                            "qt_versione": "-31",
                            "nome_prodotto": "Tshirt cotone bianca",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "29",
                            "codice_versione": "AA03",
                            "codice_fornitore": "",
                            "data_prezzo": "31/01/2020",
                            "id_categoria": "7",
                            "id_scategoria": "218",
                            "id_fornitore": "0",
                            "qt_versione": "28",
                            "nome_prodotto": "Tshirt cotone bianca",
                            "nome_versione": "Xl",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "scontiQt": [
                        {
                            "da_qt": "1",
                            "a_qt": "5",
                            "sconto_perc": "15",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "30",
                            "a_qt": "60",
                            "sconto_perc": "30",
                            "prezzo_vendita": "50.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "80",
                            "a_qt": "100",
                            "sconto_perc": "0",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Tshirt-cotone-bianca-386897.jpg",
                            "desc": "Tshirt cotone bianca",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Tshirt-cotone-bianca-386897.jpg",
                            "dimensione": "32,95 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 69,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2021-02-19 12:54:53",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_69_Giacca-Casual-modello.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": -5,
                    "prezzo": {
                        "importo": "79.18",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-02-19 12:54:53"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-07-11 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 1,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 6,
                        "tot_versioni_web": 0,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "versioni": [
                        {
                            "idVersione": "70",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "69",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "68",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "71",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "73",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XS",
                            "qt_finescorta": "0",
                            "euro_versione": "15.00",
                            "euro_versione_tot": "15.00"
                        },
                        {
                            "idVersione": "72",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XXL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello_962476.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_962476.jpg",
                            "dimensione": "40,06 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 132,
                    "nome": "Test Prodotto Beta",
                    "country": "IT",
                    "data": null,
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_132_Test-Prodotto-Beta.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "0.00",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-03-03 17:07:46"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 10,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "versioni": [],
                    "immagini": []
                },
                {
                    "id": 134,
                    "nome": "Test Creazione",
                    "country": "IT",
                    "data": "2022-03-03 18:18:22",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "219",
                        "nome": "Pantaloni"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_134_Test-Creazione.html",
                    "cod_interno": "",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "0.00",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-03-03 18:18:22"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "immagini": [
                        {
                            "file": "jogging2 (4).png",
                            "desc": "Test A",
                            "url": "https://www.nomedominio.it/images/img_prodotti/jogging2 (4).png",
                            "dimensione": "1,15 MB",
                            "formato": "1024 x 656 pixels"
                        }
                    ]
                },
                {
                    "id": 66,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2021-02-19 12:54:15",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_66_Giacca-Casual-modello.html",
                    "cod_interno": "968997-743769",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "3",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 33,
                    "prezzo": {
                        "importo": "79.18",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-02-24 12:22:14"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-09-09 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 6,
                        "tot_versioni_web": 0,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 1
                    },
                    "versioni": [
                        {
                            "idVersione": "52",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "51",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "50",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "53",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "35",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "55",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XS",
                            "qt_finescorta": "0",
                            "euro_versione": "15.00",
                            "euro_versione_tot": "15.00"
                        },
                        {
                            "idVersione": "54",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XXL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello_962476.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_962476.jpg",
                            "dimensione": "40,06 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 68,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2021-02-19 12:54:15",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_68_Giacca-Casual-modello.html",
                    "cod_interno": "ABY123",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand 2000"
                    },
                    "qt_vendibili": 0,
                    "prezzo": {
                        "importo": "79.18",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-02-19 12:54:15"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 3,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-12-07 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 6,
                        "tot_versioni_web": 6,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 1
                    },
                    "versioni": [
                        {
                            "idVersione": "64",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "63",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "62",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "65",
                            "codice_versione": "XL123",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "67",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XS",
                            "qt_finescorta": "0",
                            "euro_versione": "15.00",
                            "euro_versione_tot": "15.00"
                        },
                        {
                            "idVersione": "66",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XXL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello_962476.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_962476.jpg",
                            "dimensione": "40,06 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 64,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2021-02-19 12:53:27",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_64_Giacca-Casual-modello.html",
                    "cod_interno": "GIA-009-EYQ",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "2",
                        "nome": "Brand tshirt"
                    },
                    "qt_vendibili": -1,
                    "prezzo": {
                        "importo": "54.90",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-02-24 12:14:25"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "45.00",
                        "euro_distributori": "44.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2022-03-31 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 6,
                        "tot_versioni_web": 0,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "versioni": [
                        {
                            "idVersione": "46",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "74",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "45",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "74",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "44",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "74",
                            "qt_versione": "3",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "47",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "74",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "49",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "74",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XS",
                            "qt_finescorta": "0",
                            "euro_versione": "15.00",
                            "euro_versione_tot": "15.00"
                        },
                        {
                            "idVersione": "48",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "24/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "74",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XXL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello_962476.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_962476.jpg",
                            "dimensione": "40,06 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 65,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2021-02-19 12:53:27",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_65_Giacca-Casual-modello.html",
                    "cod_interno": "GIA-010-TPE",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "2",
                        "nome": "Brand tshirt"
                    },
                    "qt_vendibili": 16,
                    "prezzo": {
                        "importo": "79.18",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-02-19 12:53:27"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2022-03-31 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 1
                    },
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello_962476.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_962476.jpg",
                            "dimensione": "40,06 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 67,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2021-02-19 12:54:15",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_67_Giacca-Casual-modello.html",
                    "cod_interno": "GIA-012-CQB",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand tshirt"
                    },
                    "qt_vendibili": 19,
                    "prezzo": {
                        "importo": "79.18",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-02-19 12:54:15"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-09-01 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 6,
                        "tot_versioni_web": 0,
                        "tot_file": 1,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 1
                    },
                    "versioni": [
                        {
                            "idVersione": "58",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "57",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "56",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "59",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "61",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XS",
                            "qt_finescorta": "0",
                            "euro_versione": "15.00",
                            "euro_versione_tot": "15.00"
                        },
                        {
                            "idVersione": "60",
                            "codice_versione": "",
                            "codice_fornitore": "",
                            "data_prezzo": "19/02/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XXL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello_962476.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_962476.jpg",
                            "dimensione": "40,06 KB",
                            "formato": "1024 x 683 pixels"
                        }
                    ]
                },
                {
                    "id": 133,
                    "nome": "Test Nuovo",
                    "country": "IT",
                    "data": null,
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "true",
                        "visualizza_nascosto": "true",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_133_Test-Nuovo.html",
                    "cod_interno": "e",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "A",
                        "codice2": "B",
                        "codice3": "c",
                        "GTIN-EAN": "d"
                    },
                    "brand": {
                        "id": "5",
                        "nome": "New brand"
                    },
                    "qt_vendibili": 1,
                    "prezzo": {
                        "importo": "20.74",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-03-03 18:13:13"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "17.00",
                        "euro_distributori": "19.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 2,
                        "litri": 3,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "immagini": [
                        {
                            "file": "jacket1 (2) (5).png",
                            "desc": "Test Nuovo",
                            "url": "https://www.nomedominio.it/images/img_prodotti/jacket1 (2) (5).png",
                            "dimensione": "330,83 KB",
                            "formato": "1024 x 649 pixels"
                        },
                        {
                            "file": "resize_jacket-pelle (5) (1).png",
                            "desc": "Test Nuovo",
                            "url": "https://www.nomedominio.it/images/img_prodotti/resize_jacket-pelle (5) (1).png",
                            "dimensione": "661,21 KB",
                            "formato": "1024 x 666 pixels"
                        },
                        {
                            "file": "jogging3 (2).png",
                            "desc": "Test Nuovo",
                            "url": "https://www.nomedominio.it/images/img_prodotti/jogging3 (2).png",
                            "dimensione": "1,15 MB",
                            "formato": "1024 x 693 pixels"
                        },
                        {
                            "file": "pantalone_ jogging (3).png",
                            "desc": "Test Nuovo",
                            "url": "https://www.nomedominio.it/images/img_prodotti/pantalone_ jogging (3).png",
                            "dimensione": "884,34 KB",
                            "formato": "1024 x 581 pixels"
                        }
                    ]
                },
                {
                    "id": 125,
                    "nome": "Pantalone Tuta da Jogging",
                    "country": "IT",
                    "data": null,
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "219",
                        "nome": "Pantaloni"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "true",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_125_Pantalone-Tuta-da-Jogging.html",
                    "cod_interno": "IN-01234",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "AAAA-001",
                        "codice2": "BBBB-001",
                        "codice3": "CCCC-001",
                        "GTIN-EAN": "DDDD-001"
                    },
                    "brand": {
                        "id": "16",
                        "nome": "Brand Demo"
                    },
                    "qt_vendibili": 200,
                    "prezzo": {
                        "importo": "12.20",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-03-03 16:13:47"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "10.00",
                        "euro_distributori": "30.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 0,
                        "visualizza_percentuale": "false",
                        "prezzo_fisso": "0,00",
                        "scadenza": null,
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 2,
                        "litri": 2,
                        "confezione": 0,
                        "tot_sconti": 0,
                        "tot_versioni": 0,
                        "tot_versioni_web": 0,
                        "tot_file": 0,
                        "tot_fotoGallery": 0,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 0
                    },
                    "immagini": []
                },
                {
                    "id": 53,
                    "nome": "Giacca Casual modello",
                    "country": "IT",
                    "data": "2020-05-07 11:34:31",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "false",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_53_Giacca-Casual-modello.html",
                    "cod_interno": "433XXYYy",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "AXXXX15154",
                        "codice2": "",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "0",
                        "nome": "Brand Demo"
                    },
                    "qt_vendibili": 99,
                    "prezzo": {
                        "importo": "79.18",
                        "aliquota_iva": 22,
                        "aggiornamento": "2022-02-20 10:33:09"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "0.00",
                        "euro_distributori": "0.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-06-25 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 4,
                        "tot_versioni": 8,
                        "tot_versioni_web": 8,
                        "tot_file": 22,
                        "tot_fotoGallery": 1,
                        "tot_faq": 2,
                        "tot_codebar": 0,
                        "tot_relazioni": 6
                    },
                    "versioni": [
                        {
                            "idVersione": "4",
                            "codice_versione": "X003",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "45",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "L",
                            "qt_finescorta": "10",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "3",
                            "codice_versione": "X002",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "20",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "M",
                            "qt_finescorta": "10",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "88",
                            "codice_versione": "",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "Rosso",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "2",
                            "codice_versione": "X001",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "10",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "89",
                            "codice_versione": "",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "Verde",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "5",
                            "codice_versione": "X004",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "-2",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "37",
                            "codice_versione": "",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "50",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XS",
                            "qt_finescorta": "0",
                            "euro_versione": "15.00",
                            "euro_versione_tot": "750.00"
                        },
                        {
                            "idVersione": "6",
                            "codice_versione": "X005",
                            "codice_fornitore": "AXXXX15154",
                            "data_prezzo": "20/02/2022",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "0",
                            "nome_prodotto": "Giacca Casual modello",
                            "nome_versione": "XXL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "scontiQt": [
                        {
                            "da_qt": "0",
                            "a_qt": "10",
                            "sconto_perc": "5",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "11",
                            "a_qt": "20",
                            "sconto_perc": "7",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "21",
                            "a_qt": "50",
                            "sconto_perc": "10",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "51",
                            "a_qt": "80",
                            "sconto_perc": "10",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-modello-438786.jpg",
                            "desc": "Giacca Casual",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello-438786.jpg",
                            "dimensione": "82,17 KB",
                            "formato": "800 x 533 pixels"
                        },
                        {
                            "file": "Giacca-Casual-modello_852437-1.jpg",
                            "desc": "Giacca Casual modello",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-modello_852437-1.jpg",
                            "dimensione": "76,44 KB",
                            "formato": "848 x 1024 pixels"
                        }
                    ],
                    "gallery": [
                        {
                            "nome_file": "13052021123718.jpg",
                            "coutry": "IT",
                            "titolo": "Titolo Giacca",
                            "descrizione": "",
                            "data": "13/05/2021 12:37:18",
                            "dimensione": "53,07 KB",
                            "formato": "466 x 691 pixels"
                        }
                    ]
                }
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Prodotti

I nodi indentificano i prodotti impostati su Pcommerce

Descrizione
id int ID univoco del Prodotto
nome string Nome Prodotto
country string
ISO 3166-1 alpha-2 codes
Codice Nazione
data date Data creazione prodotto
categoria array[0] ID e nome "Categoria" assegnata al prodotto
scategoria array[0] ID e nome "Scategoria" assegnata al prodotto
sscategoria array[0] ID e nome "Sscategoria" assegnata al prodotto
permessi array[0]
  • "web" se "true" è visibile nel front-end
  • "admin" se "true" è visibile nel back-end
  • "nascondi_prezzo" se "true" non viene visualizzato il prezzo
  • "id_spedizione" se valorizzato indicato l'unico corriere (ID) con cui poter spedire il prodotto.
url_prodotto string Url del prodotto nel front-end
cod_interno string Codice prodotto interno
fornitore array[0]
  • nome_fornitore Ragione sociale del fornitore assegnato al prodotto
  • codice1 Codice fornitore #1
  • codice2 Codice fornitore #2
  • codice3 Codice fornitore #3
  • GTIN-EAN Codice GTIN/UPC/EAN/JAN/ISBN
brand array[0] ID e nome "Brand" assegnato al prodotto
qt_vendibili int Qt vendibili del prodotto in tempo reale
prezzo array[0]
  • importo Prezzo Prodotto assegnato ad eventuale Listino/Cliente oppure Privato di default
  • aliquota_iva Aliquota IVA assegnata al prodotto
  • aggiornamento Data aggiornamento prezzo
listini array[0]
  • euro_pubblico Eventuale prezzo fisso impostato per listino Privati (se valorizzato viene ignorato listino richiesto)
  • euro_rivenditori Eventuale prezzo fisso impostato per listino Aziende (se valorizzato viene ignorato listino richiesto)
  • euro_distributori Eventuale prezzo fisso impostato per listino Distributori (se valorizzato viene ignorato listino richiesto)
esenzione array Se valorizzato indica Codice e Natura operazione (segue lo standard Fattura Elettronica)
offerta array[0]

Se attiva indica eventuale offerta sul prodotto

  • attiva Se "true" l'offerta è attiva
  • visibile_home Se "true" è visibile nella home del front-end
  • visibile_paginaOfferte Se "true" è visibile nella pagina offerte del front-end
  • percentuale Se valorizzato indica percentuale di sconto
  • visualizza_percentuale Se "true" viene visualizzata la percentuale di sconto
  • prezzo_fisso Se valorizzato indica offerta ad prezzo fisso (valido per tutti i listini)
  • scadenza Data scadenza offerta
  • descrizione Breve descrizione offerta (HTML)
Info array[0]

Informazioni aggiuntive sul prodotto

  • num_ordinamento Se valorizzato indica la posizione di ordinamento del prodotto (se valorizzato su zero segue ordinamento della categoria/scategoria/sscategoria o impostazioni generali)
  • UnitaMisura Unità di misura del prodotto
  • peso Se impostato indica il peso del prodotto (in Kg)
  • litri Se impostato indica litri prodotto
  • confezione Se maggiore di 1 indica i pz contenuti in confezione. Se valorizzato su zero la confezione non è impostata.
  • tot_sconti Numero totale di sconti applicati
  • tot_versioni Numero totale di versioni prodotto
  • tot_versioni_web Numero totale di versioni visibili nel front-end
  • tot_file Numero totale di file allegati al prodotto
  • tot_fotoGallery Numero totale di Foto in gallery prodotto
  • tot_faq Numero totale Faq inserite nel prodotto
  • tot_codebar Numero totale Codici a Barre assegnati al prodotto
  • tot_relazioni Numero totale prodotti consigliati in realazione al prodotto
Versioni array

Indica eventuali versioni del prodotto

  • codice_versione Codice prodotto assegnato alla Versione
  • codice_fornitore Codice fornitore assegnato alla Versione
  • data_prezzo Data aggiornamento prezzo versione
  • qt_versione Se valorizzato indica una versione che include più quantità
  • confezione Se maggiore di 1 indica i pz contenuti in confezione. Se valorizzato su zero la confezione non è impostata.
  • nome_prodotto Nome prodotto della versione (default nome del prodotto)
  • nome_versione Nome aggiuntivo al nome prodotto che identifica la versione (ad esempio "Giacca + XL")
  • qt_finescorta Se impostato indica il limite per alert su "Finescorta"
  • euro_versione Se valorizzato indica prezzo aggiuntivo assegnato per la versione
  • euro_versione_tot Prezzo aggiuntivo in funzione delle quantità versione
scontiQt array

Indica eventuali sconti per quantità assegnati al prodotto

  • da_qt Per ordini da "da_qt" pz
  • a_qt Per ordini fino a "a_qt" pz
  • sconto_perc Se valorizzato indica sconto percentuale
  • prezzo_vendita Se valorizzato indica prezzo fisso (viene ignorato listino richiesto)
  • codice Codice sconto per quantità
  • stato Se valorizzato su "0" lo sconto per quantità è ATTIVO
  • stato_cliente Indica ID Listino dello sconto, se valorizzato su "1000" rappresenta sconto valido per tutti i listini
immagini array

Immagini assegnate al prodotto

  • file Nome file immagine
  • desc Breve descrizione immagine
  • url URL immagine
  • dimensione Dimensione immagine (in Kb)
  • formato Formato immagine (in Px)
gallery array

Immagini Gallery Prodotto

  • nome_file Nome file immagine
  • titolo Titolo Immagine
  • descrizione Breve descrizione immagine
  • data Data inserimento
  • dimensione Dimensione immagine (in Kb)
  • formato Formato immagine (in Px)

getProduct Singolo Prodotto

Ottieni informazioni sul singolo prodotto

GET

https://www.nomedominio.it/API/getProduct

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getProduct": {
        "idProdotto": 57,
        "userToken": "",
        "applica_iva": 1,
        "listino": 0
    }
}
key * string Api Key abilitata da pannello di controllo
idProdotto * int ID prodotto
userToken int Se impostato restituisce i prezzi assegnati al listino del cliente (individuato con userToken)
applica_iva* String

Visualizza prezzi iva inclusa/esclusa. Se non valorizzato è impostato su "iva inclusa"

  • "0" Visualizza tutti i prezzi "Iva Esclusa"
  • "1" Visualizza tutti i prezzi "iva inclusa"
listino String Se impostato visualizza prezzi di un determinato Listino (individuato con ID listino)
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

[
    {
        "getProduct": {
            "result": "OK",
            "API": "getProduct",
            "version": "2.0.0",
            "stato": null,
            "startingRow": null,
            "rowsPerPage": 30,
            "recordsTotal": "1",
            "id_categoria": null,
            "id_scategoria": null,
            "id_sscategoria": null,
            "id_prodotto": 57,
            "cerca": null,
            "applica_iva": "1",
            "listino": "0",
            "categoria": null,
            "prodotti": [
                {
                    "id": 57,
                    "nome": "Giacca Casual",
                    "country": "IT",
                    "data": "2020-05-07 11:46:24",
                    "categoria": {
                        "id": "7",
                        "nome": "Abbigliamento"
                    },
                    "scategoria": {
                        "id": "220",
                        "nome": "Giacche"
                    },
                    "sscategoria": {
                        "id": "0",
                        "nome": null
                    },
                    "permessi": {
                        "categoria": "true",
                        "web": "true",
                        "admin": "false",
                        "nascondi_prezzo": "false",
                        "visualizza_nascosto": "false",
                        "id_spedizione": 0
                    },
                    "url_prodotto": "https://www.nomedominio.it/prodotto_57_Giacca-Casual.html",
                    "cod_interno": "X4545405-XX",
                    "fornitore": {
                        "nome_fornitore": "",
                        "codice1": "XXX-0012",
                        "codice2": "CC-1234566",
                        "codice3": "",
                        "GTIN-EAN": ""
                    },
                    "brand": {
                        "id": "5",
                        "nome": "New brand"
                    },
                    "qt_vendibili": 71,
                    "prezzo": {
                        "importo": "91.50",
                        "aliquota_iva": 22,
                        "aggiornamento": "2021-05-26 17:20:54"
                    },
                    "listini": {
                        "euro_privati": "0.00",
                        "euro_aziende": "75.00",
                        "euro_distributori": "68.00"
                    },
                    "esenzione": {
                        "natura": null,
                        "codice": null
                    },
                    "offerta": {
                        "attiva": "false",
                        "visibile_home": "false",
                        "visibile_paginaOfferte": "false",
                        "percentuale": 10,
                        "visualizza_percentuale": "true",
                        "prezzo_fisso": "0,00",
                        "scadenza": "2021-09-13 00:00:00",
                        "descrizione": ""
                    },
                    "info": {
                        "num_ordinamento ": 0,
                        "unitaMisura": "pz",
                        "peso": 0,
                        "litri": 0,
                        "confezione": 0,
                        "tot_sconti": 2,
                        "tot_versioni": 4,
                        "tot_versioni_web": 4,
                        "tot_file": 1,
                        "tot_fotoGallery": 4,
                        "tot_faq": 0,
                        "tot_codebar": 0,
                        "tot_relazioni": 4
                    },
                    "versioni": [
                        {
                            "idVersione": "13",
                            "codice_versione": "",
                            "codice_fornitore": "XXX-0012",
                            "data_prezzo": "26/05/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "24",
                            "nome_prodotto": "Giacca Casual",
                            "nome_versione": "L",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "12",
                            "codice_versione": "",
                            "codice_fornitore": "XXX-0012",
                            "data_prezzo": "26/05/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "30",
                            "nome_prodotto": "Giacca Casual",
                            "nome_versione": "M",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "9",
                            "codice_versione": "",
                            "codice_fornitore": "XXX-0012",
                            "data_prezzo": "26/05/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "20",
                            "nome_prodotto": "Giacca Casual",
                            "nome_versione": "S",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        },
                        {
                            "idVersione": "14",
                            "codice_versione": "XXYYY",
                            "codice_fornitore": "XXX-0012",
                            "data_prezzo": "26/05/2021",
                            "id_categoria": "7",
                            "id_scategoria": "220",
                            "id_fornitore": "0",
                            "qt_versione": "9",
                            "nome_prodotto": "Giacca Casual",
                            "nome_versione": "XL",
                            "qt_finescorta": "0",
                            "euro_versione": "0.00",
                            "euro_versione_tot": "0.00"
                        }
                    ],
                    "scontiQt": [
                        {
                            "da_qt": "4",
                            "a_qt": "10",
                            "sconto_perc": "10",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        },
                        {
                            "da_qt": "11",
                            "a_qt": "30",
                            "sconto_perc": "20",
                            "prezzo_vendita": "0.00",
                            "codice": "",
                            "stato": "0",
                            "stato_cliente": "1000"
                        }
                    ],
                    "immagini": [
                        {
                            "file": "Giacca-Casual-776982.jpg",
                            "desc": "Giacca Casual",
                            "url": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-776982.jpg",
                            "dimensione": "32,51 KB",
                            "formato": "380 x 600 pixels"
                        }
                    ],
                    "gallery": [
                        {
                            "nome_file": "Giacca-Casual-429839.jpg",
                            "coutry": "IT",
                            "titolo": "Foto Gallery",
                            "descrizione": "",
                            "data": "13/05/2021 12:43:30",
                            "dimensione": "149,4 KB",
                            "formato": "800 x 533 pixels"
                        },
                        {
                            "nome_file": "Giacca-Casual-279987.jpg",
                            "coutry": "IT",
                            "titolo": "Foto con descrizione 2",
                            "descrizione": "",
                            "data": "13/05/2021 12:43:30",
                            "dimensione": "215,02 KB",
                            "formato": "800 x 533 pixels"
                        }
                    ]
                }
            ]
        }
    }
]

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

I dati forniti sono i medesimi di getProductList

APIs Clienti

Attraverso queste APIs puoi gestire gli utenti, eseguire Login, creare e modificare Account.

getUserToken Login Cliente

Esegui il login del cliente e ottieni il TOKEN di autenticazione per future operazioni come modifica account, inserimento prodotti in carrello, checkout.

GET

https://www.nomedominio.it/API/getUserToken

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getUserToken": {
        "username": "XXXXXXX",
        "password": "XXXXXXX"
    }
}
key * string Api Key abilitata da pannello di controllo
username * int Username del Cliente
password * int Username del Cliente
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "getUserToken": {
        "result": "OK",
        "API": "getUserToken",
        "version": "2.0.0",
        "account": {
            "userToken": "0c3154fa57c3154fa57c7f591f6ab7875a7c9",
            "nome": "Giuseppe",
            "cognome": "Colombo",
            "ragione_sociale": "Giuseppe Colombo",
            "listino": "1",
            "partita_iva": "",
            "codice_fiscale": "CLMGPP81M21E472T",
            "email": "staff@pizzut.it"
        }
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Account

Informazioni sull'account ottenuto dal login

Descrizione
userToken * string Token di autenticazione del cliente
nome string Nome del cliente da anagrafica cliente
cognome string Cognome del cliente da anagrafica cliente
ragione_sociale string Se azienda indica ragione sociale del cliente
listino string

Indica il listino applicato al cliente

  • "0" Listino Aziende
  • "1" Listino Privati
  • "2" Listino Distributore
  • >2 Se maggiore di 2 identifica un listino personalizzato presente nelle configurazioni di Pcommerce
codice_fiscale string Codice fiscale del cliente
partita_iva string Partita IVA del cliente

getUserLogout Logout Cliente

Esegue il Logout del cliente, la procedura resetta il token di autenticazione e scollega tutti i device del cliente

GET

https://www.nomedominio.it/API/getUserLogout

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getUserLogout": {
        "userToken": "203683845da2dd16ce629432cbb70954542b93f2",
    }
}
key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "getUserLogout": {
        "result": "OK",
        "API": "getUserLogout",
        "version": "2.0.0",
        "account": {
            "token": "203683845da2dd16ce629432cbb70954542b93f2",
            "logout": "true"
        }
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API
account string
  • logout Restituisce "true" se il logout è avvenuto con successo

getUserAccount Anagrafica Cliente

Restituisce le informazioni in anagrafica del cliente compreso di contatti, indirizzi di spedizione e listino applicato

GET

https://www.nomedominio.it/API/getUserAccount

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getUserAccount": {
        "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
    }
}
key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "getUserAccount": {
        "result": "OK",
        "API": "getUserAccount",
        "version": "2.0.0",
        "account": [
            {
                "ragione_sociale": "Giuseppe Colombo",
                "nome": "Giuseppe",
                "cognome": "Colombo",
                "country": "IT",
                "partita_iva": "",
                "codice_fiscale": "CLMGPP81M21E472T",
                "codice_cliente": "AA00028",
                "iva_esigibile": 0,
                "listino": {
                    "listino": "1",
                    "nome": "Privati",
                    "transazione": "B2C",
                    "sconto": "0",
                    "ricarico": "0"
                },
                "sede": {
                    "indirizzo": "Via del Viminale n. 4",
                    "citta": "Palermo",
                    "cap": "04100",
                    "provincia": "LT",
                    "regione": "Sicilia"
                },
                "destinazione": [
                    {
                        "id": "0",
                        "country": "IT",
                        "ragione_sociale": "Giuseppe Colombo",
                        "indirizzo": "Via del Viminale n. 4",
                        "citta": "Palermo",
                        "cap": "90121",
                        "provincia": "PA"
                    },
                    {
                        "id": "12",
                        "country": "IT",
                        "ragione_sociale": "Pizzut ",
                        "indirizzo": "Via Ufente 20",
                        "citta": "Latina",
                        "cap": "04100",
                        "provincia": "LT"
                    },
                    {
                        "id": "13",
                        "country": "GB",
                        "ragione_sociale": "Pizzut UK",
                        "indirizzo": "Piccadilly Circus, Londra, Regno Unito",
                        "cap": "",
                        "citta": "",
                        "provincia": ""
                    }
                ],
                "preferenze": {
                    "consensi": {
                        "newsletter": "true",
                        "emailAutomatiche": "true",
                        "avvisiCommerciali": "true"
                    },
                    "orarioConsegna": {
                        "consegna_stato": "false",
                        "daOra": "",
                        "aOra": ""
                    }
                },
                "efattura": {
                    "preferenza": "2",
                    "pec": "",
                    "sdi": "0000000",
                    "RiferimentoAmministrazione": ""
                },
                "contatti": [
                    {
                        "stato_rubrica": "false"
                    },
                    {
                        "mobile": {
                            "countryCode": "43",
                            "prefisso": "334",
                            "numero": "1234567"
                        },
                        "principale": {
                            "email": "staff@pizzut.it",
                            "telefono": "",
                            "fax": ""
                        },
                        "amministrazione": {
                            "email": "",
                            "telefono": "",
                            "fax": ""
                        },
                        "respAcquisti": {
                            "email": "",
                            "telefono": "",
                            "fax": ""
                        },
                        "commerciale": {
                            "email": "",
                            "telefono": null,
                            "fax": null
                        },
                        "assistenza": {
                            "email": null,
                            "telefono": null,
                            "fax": null
                        },
                        "produzione": {
                            "email": null,
                            "telefono": null,
                            "fax": null
                        },
                        "respVendite": {
                            "email": null,
                            "telefono": null,
                            "fax": null
                        },
                        "respProduzione": {
                            "email": null,
                            "telefono": null,
                            "fax": null
                        }
                    }
                ],
                "commerciale": {
                    "id": "41",
                    "nome": "Operatore Demo"
                },
                "permessi": {
                    "accountWeb": "true",
                    "accountAdmin": "true",
                    "visualizzaPrezzi": "true",
                    "ban": "false",
                    "downloadCSV": "false",
                    "downloadPDF": "false",
                    "NOlocalizzazione": "false",
                    "NOidCorriere": "0",
                    "NOidPagamento": "0",
                    "idOperatore": ""
                },
                "predefinito": {
                    "idCorriere": "0",
                    "idPagamento": "0"
                },
                "date": {
                    "attivazioneAccount": "2022-05-10 15:03:38",
                    "accessoAccount": "",
                    "modificaAccount": "2022-02-22 18:51:21",
                    "pushCarrello": ""
                },
                "file": [
                    {
                        "tipologia": "0",
                        "nome_file": "ESEMPIO PDF ALLEGATO-BETA.pdf",
                        "descrizione": "",
                        "url_file": "/s3/apri_file?openfile=allegati/16/ESEMPIO PDF ALLEGATO-BETA.pdf&bucket=",
                        "stato": "true"
                    },
                    {
                        "tipologia": "2",
                        "nome_file": "ESEMPIO PDF ALLEGATO.pdf",
                        "descrizione": "",
                        "url_file": "/s3/apri_file?openfile=allegati/17/ESEMPIO PDF ALLEGATO.pdf&bucket=",
                        "stato": "true"
                    },
                    {
                        "tipologia": "4",
                        "nome_file": "ESEMPIO PDF ALLEGATO2.pdf",
                        "descrizione": "",
                        "url_file": "/s3/apri_file?openfile=allegati/18/ESEMPIO PDF ALLEGATO2.pdf&bucket=",
                        "stato": "true"
                    }
                ],
                "sconto": {
                    "scontoA": "0",
                    "scontoB": "0",
                    "scontoC": "0",
                    "scontoD": "0"
                },
                "note": ""
            }
        ]
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API
ragione_sociale string Ragione sociale del cliente. Se privato viene valorizzato con COGNOME + NOME
nome string Nome del cliente
cognome string Cognome del cliente
country String
ISO 3166-1 alpha-2 codes
Codice nazione assegnato al cliente
partita_iva string Partita IVA assegnata al cliente
codice_fiscale string Codice Fiscale assegnato al cliente
codice_cliente string Codice Cliente generato da Pcommerce e assegnato al cliente
iva_esigibile int
  • "0" IVA ad esigibilità immediata
  • "1" IVA ad esigibilità differita
  • "3" Split payment
listino array
  • "listino" Listino di riferimento assegnato al cliente
  • "nome" Nome listino
  • "transazione" Tipologia transazione (B2c,B2B,B2G)
  • "sconto" Sconto in percentuale, applicato al cliente
  • "ricarico" Ricarico in percentuale, applicato al cliente
sede array[0]

Sede legale dell'azienda o indirizzo di residenza per privati

  • "indirizzo" Indirizzo, via del cliente
  • "citta" Città cliente
  • "cap" Cap città
  • "provincia" Provincia cliente
  • "regione" Regione cliente
destinazione array

Elenco di uno o più indirizzi alternativi per la spedizione merce

  • "id" ID indirizzo di destinazione merce. Se Zero rappresenta l'indirizzo di destinazione merce principale.
  • "country" Codice nazione dell'indirizzo di destinazione merce
  • "ragione_sociale" Se valorizzato indica il nominativo per la destinazione merce
  • "indirizzo" Indirizzo, via del cliente
  • "citta" Città cliente
  • "cap" Cap città
  • "provincia" Provincia cliente
preferenze array

Consensi Newsletter

  • "newsletter" È true (valore boolean) se il cliente ha espresso consenso alla ricezione della newsletter
  • "emailAutomatiche" È true (valore boolean) se il cliente ha espresso consenso alla ricezione di email automatiche (schedulate e/o servizi)
  • "avvisiCommerciali" È true (valore boolean) se il cliente ha espresso consenso alla ricezione di avvisi commerciali

Orario Consegna Merce

  • "consegna_stato" È true (valore boolean) se il cliente ha preferenze sulla ricezione merce
  • "daOra" Intervallo orario Dalle Ore
  • "aOra" Intervallo orario Alle Ore
preferenze array

Informazioni sulla ricezione della Fattura Elettronica

  • "preferenza" 0=Non prevista, 1=Email Pec, 2=Codice SDI
  • "pec" Indirizzo Email PEC
  • "sdi" Codice SDI
  • "RiferimentoAmministrazione" Campo da valorizzare per fatture verso PA o se richiesto dal cliente
contatti array

Contatti del cliente

  • "stato_rubrica" È true (valore boolean) se il cliente è presente anche
  • "mobile" CountryCode, prefisso, numero di cellulare
  • "principale" Email, Telefono e Fax. L'email è di riferimento per ricezione Newsletter, Email automatiche e avvisi aziendali.
  • "amministrazione" Recapiti (Email, Telefono, Fax) ufficio amministrazione
  • "respAcquisti" Recapiti (Email, Telefono, Fax) responsabili acquisti
  • "commerciale" Recapiti (Email, Telefono, Fax) commerciale di riferimento
  • "assistenza" Recapiti (Email, Telefono, Fax) assistenza clienti
  • "produzione" Recapiti (Email, Telefono, Fax) ufficio produzione
  • "respVendite" Recapiti (Email, Telefono, Fax) responsabile vendite
  • "respProduzione" Recapiti (Email, Telefono, Fax) responsabile produzione
commerciale int

Se valorizzato indica il commerciale di riferimento assegnato al cliente

  • "id" ID operatore
  • "nome" Nome operatore
permessi bool e int

Permessi assegnati al cliente

  • "accountWeb" È true (valore boolean) se l'account è abilitato al login nel front-end
  • "accountAdmin" È true (valore boolean) se l'account è visibile nel back-end
  • "visualizzaPrezzi" È true (valore boolean) se l'account visualizza i prezzi dei prodotti
  • "ban" È true (valore boolean) se l'account è bannato o sospetto
  • "downloadCSV" È true (valore boolean) se l'account è abilitato alla generazione e download di listini CSV
  • "downloadPDF" È true (valore boolean) se l'account è abilitato alla generazione e download di listini PDF
  • "NOlocalizzazione" È true (valore boolean) se l'account viene ignorato dalla localizzazione
  • "NOidCorriere" Se valorizzato indica l'ID del Corriere non permesso nelle scelte al cliente
  • "NOidPagamento" Se valorizzato indica l'ID della modalità di pagamento non permessa nelle scelte al cliente
  • "idOperatore" Se valorizzato indica la visibilità del cliente Solo ad un determinato operatore
predefinito array[0]

Valori predefiniti sull'account cliente

  • "idCorriere" Se valorizzato indica l'ID del Corriere predefinito nelle scelte al cliente
  • "idPagamento" Se valorizzato indica l'ID della modalità di pagamento predefinita nelle scelte al cliente
date array[0]

Date sull'account

  • "attivazioneAccount" Data attivazione account web (Y-m-d H:i:s)
  • "accessoAccount" Data ultimo accesso account web (Y-m-d H:i:s)
  • "modificaAccount" Data ultima modifica anagrafe (Y-m-d H:i:s)
  • "pushCarrello" Data ultima ricezione notifica PUSH carrelli persi (Y-m-d H:i:s)
file array

Elenco file associati all'account cliente

  • "tipologia" Indica la tipologia del file (vedere tabella sottostante)
  • "nome_file" Nome del file
  • "descrizione" Descrizione file
  • "url_file" URL download del file (può essere sia locale che path su S3 Object Storage)
  • "stato" È true (valore boolean) se il file è visibile

Tipologie File

  • "0" Non impostata
  • "1" Contratto
  • "2" Preventivo
  • "3" Accettazione
  • "4" Contabile
  • "5" Documenti Spedizione
  • "6" Altri File
sconto array[0]

Indica in percentuale i valori della scontistica aggiuntiva applicata al cliente, secondo questa formula:

scontoA + scontoB + scontoC+ scontoD
note string Note aggiuntive (solo testo, no HTML) inserite in anagrafica cliente

pushAccount Inserimento nuovo Cliente

Inserisci un nuovo account cliente

POST

https://www.nomedominio.it/API/pushAccount

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "pushAccount": {
        "country": "IT",
        "ragione_sociale": "Rossi API test SPA",
        "nome": "",
        "cognome": "",
        "partita_iva": "02341560593",
        "codice_fiscale": "02341560593",
        "stato_cliente": "0",
        "ricarico": "0",
        "idCommerciale": "0",
        "note": "Note cliente ecc.",
        "IP" : "212.66.99.153",
        "sede": {
            "indirizzo": "Via ufente 20",
            "citta": "Latina",
            "cap": "04018",
            "provincia": "LT",
            "regione": "Lazio"
        },
        "efattura": {
            "preferenza": "2",
            "pec": "",
            "sdi": "5RUO82D"
        },
        "permessi": {
            "accountWeb": "true",
            "username": "TestPizzuXXXt1234",
            "password": "PassPizzutYYY1234!",
            "stato_invio_email": "true"
        },
        "destinazione": {
            "country": "IT",
            "ragione_sociale": "Giuseppe Colombo",
            "indirizzo": "Via del Viminale n. 4",
            "citta": "Palermo",
            "cap": "90121",
            "provincia": "PA",
            "regione": "Sicilia"
        },
        "contatti": {
            "mobile": {
                "countryCode": "43",
                "prefisso": "334",
                "numero": "1234567"
            },
            "principale": {
                "email": "staff@pizzut.it",
                "telefono": "0773.164.61.65",
                "fax": "0773.187.0106"
            },
            "amministrazione": {
                "email": "info@pizzut.it",
                "telefono": "0773.187.0894",
                "fax": ""
            },
            "respAcquisti": {
                "email": "info@pizzut.it",
                "telefono": "0773.187.0894",
                "fax": ""
            }
        },
        "consensi": {
            "newsletter": "true",
            "emailAutomatiche": "true",
            "avvisiCommerciali": "true"
        }
    }
}

Parametri Request (JSON)

Puoi effettuare una richiesta con le informazioni sull'account utente. Il sistema provvederà alla creazione del nuovo record

key * string Api Key abilitata da pannello di controllo
country * String
ISO 3166-1 alpha-2 codes
Codice nazione del cliente
ragione_sociale string Ragione sociale completa, se privato viene valorizzato con Nome+Cognome
nome string Nome del cliente
cognome string Cognome del cliente
partita_iva string Partita Iva del cliente
codice_fiscale string Codice Fiscale del cliente
stato_cliente int

Listino di riferimento del cliente

  • "0" Listino Aziende
  • "1" Listino Privati
  • "2" Listino Distributore
  • >2 Se maggiore di 2 identifica un listino personalizzato presente nelle configurazioni di Pcommerce
ricarico int Eventuale Ricarico Aggiuntivo applicato al cliente
idCommerciale int ID Operatore Commerciale di riferimento
note string Note interne applicate all'account cliente
IP string IP del cliente in fase di inserimento/modifica.

Sede

Sede legale/Residenza del cliente

indirizzo string Indirizzo/via completo del cliente
citta string Città del cliente
CAP int CAP del cliente
provincia string(2) Sigla Provincia del cliente
regione string Regione del cliente

Efattura

Preferenza ricezione fattura elettronica

preferenza array

Informazioni sulla ricezione della Fattura Elettronica

  • "0" Non prevista
  • "1" Email PEC
  • "2" Codice SDI
pec string Indirizzo PEC ricezione Fattura Elettronica
sdi int Codice SDI ricezione fattura elettronica

Permessi

Permessi Account web

accountWeb bool È true (valore boolean)se il nuovo account è attivo nel front-end
username int Username scelta dal cliente
password int Password scelta dal cliente
stato_invio_email bool È true (valore boolean) per inviare email di benvenuto al cliente

Destinazione

Indirizzo di destinazione Merce

country * String
ISO 3166-1 alpha-2 codes
Codice nazione della destinazione merce
ragione_sociale string Eventuale ragione sociale per destinazione merci
indirizzo string Indirizzo destinazione merce
citta string Città destinazione merce
cap string CAP destinazione merce
provincia string(2) Sigla Provincia destinazione merce
regione string Regione destinazione merce

Contatti

Contatti cliente (email, telefono, fax, mobile...)

mobile string CountryCode, prefisso, numero di cellulare
principale array Email, Telefono e Fax. L'email è di riferimento per ricezione Newsletter, Email automatiche e avvisi aziendali.
amministratore array Recapiti (Email, Telefono, Fax) ufficio amministrazione
respAcquisti array Recapiti (Email, Telefono, Fax) responsabili acquisti

Consensi iscrizione newsletter

Stabilisci le preferenza sulla ricezione di newsletter

newsletter bool È true (valore boolean) se il cliente ha espresso consenso alla ricezione della newsletter
emailAutomatiche array È true (valore boolean) se il cliente ha espresso consenso alla ricezione di email automatiche (schedulate e/o servizi)
avvisiCommerciali array È true (valore boolean) se il cliente ha espresso consenso alla ricezione di avvisi commerciali
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "pushAccount": {
        "result": "OK",
        "API": "pushAccount",
        "version": "2.0.0",
        "pushAccount": {
            "idCliente": "79",
            "country": "IT",
            "transazione": "B2B",
            "ragione_sociale": "Rossi API test SPA",
            "userToken": "b83594765cd0a31869df6b433ff719c9bf6b2575",
            "data_attivazione": "2022-05-17 17:25:33",
            "validazione": {
                "email": "true",
                "partita_iva": "false",
                "codice_fiscale": "true",
                "cap": "true",
                "capProvincia": "true",
                "cap_destinazione": "true"
            }
        }
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Account

Restituisce informazioni sull'account appena creato

,
Descrizione
idCliente int ID sequenziale nuovo cliente
country String
ISO 3166-1 alpha-2 codes
Codice nazione Cliente
transazione string Tipologia transazione (B2c,B2B,B2G)
ragione_sociale string Nominativo cliente (ragione sociale oppure Nome+Cognome)
userToken string Token di autenticazione assegnato al cliente
data_attivazione date(Y-m-d H:i:s) Data Creazione account

Validazione

Validazione automatica alla creazione del nuovo account

,
Descrizione
email bool È true (valore boolean) se email principale formalmente valida
partita_iva bool È true (valore boolean) se partiva iva è formalmente valida (cliente B2b e "IT")
codice_fiscale bool È true (valore boolean) se codice fiscale è formalmente valida (cliente Privato e "IT")
cap bool È true (valore boolean) se cap è formalmente valido ed esiste (cliente "IT")
capProvincia bool È true (valore boolean) se cap e Provincia sono coerenti (cliente "IT")
cap_destinazione bool È true (valore boolean) se cap_destinazione è formalmente valido ed esiste (cliente "IT")

updateAccount Modifica Account Cliente

Modifica un account cliente esistente

PUT

https://www.nomedominio.it/API/updateAccount

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
    "updateAccount": {
        "country": "IT",
        "ragione_sociale": "Rossi API test SPA",
        "nome": "",
        "cognome": "",
        "partita_iva": "023560593",
        "codice_fiscale": "02341560593",
        "stato_cliente": "0",
        "ricarico": "0",
        "idCommerciale": "0",
        "note": "Note cliente ecc.",
        "IP" : "212.66.99.153",
        "sede": {
            "indirizzo": "Via ufente 20",
            "citta": "Latina",
            "cap": "04018",
            "provincia": "LT",
            "regione": "Lazio"
        },
        "efattura": {
            "preferenza": "2",
            "pec": "",
            "sdi": "5RUO82D"
        },
        "permessi": {
            "accountWeb": "true",
            "username": "TestPizzut1234",
            "password": "PassPizzut1234!",
            "stato_invio_email": "true"
        },
        "destinazione": {
            "country": "IT",
            "ragione_sociale": "Giuseppe Colombo",
            "indirizzo": "Via del Viminale n. 4",
            "citta": "Palermo",
            "cap": "90121",
            "provincia": "PA",
            "regione": "Sicilia"
        },
        "contatti": {
            "mobile": {
                "countryCode": "43",
                "prefisso": "334",
                "numero": "1234567"
            },
            "principale": {
                "email": "staff@pizzut.it",
                "telefono": "0773.164.61.65",
                "fax": "0773.187.0106"
            },
            "amministrazione": {
                "email": "info@pizzut.it",
                "telefono": "0773.187.0894",
                "fax": ""
            },
            "respAcquisti": {
                "email": "info@pizzut.it",
                "telefono": "0773.187.0894",
                "fax": ""
            }
        },
        "consensi": {
            "newsletter": "true",
            "emailAutomatiche": "true",
            "avvisiCommerciali": "true"
        }
    }
}

Parametri Request (JSON)

Puoi effettuare una richiesta con le informazioni sull'account utente. Il sistema provvederà alla modifica del record

key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente

Altri dati sono i medesimi di pushAccount

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "updateAccount": {
        "result": "OK",
        "API": "updateAccount",
        "version": "2.0.0",
        "updateAccount": {
            "idCliente": 79,
            "country": "IT",
            "transazione": "B2B",
            "ragione_sociale": "Rossi API test SPA",
            "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
            "data_attivazione": "2022-05-18 11:16:25",
            "validazione": {
                "email": "true",
                "partita_iva": "false",
                "codice_fiscale": "true",
                "cap": "true",
                "capProvincia": "true",
                "cap_destinazione": "true"
            }
        }
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Altri dati sono i medesimi di pushAccount

APIs Ordini

Attraverso queste APIs puoi inserire prodotti in carrello ed eseguire ordini web.

pushCart Inserimento in Carrello

Inserisci prodotti in carrello con calcolo automatico del prezzo sulle quantità.

POST

https://www.nomedominio.it/API/pushCart

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
    "pushCart": [
        {
            "idProdotto": "57",
            "idVersione": "13",
            "qt": "3"
        },
        {
            "idProdotto": "50",
            "idVersione": "0",
            "qt": "2"
        }
    ]
}

Parametri Request (JSON)

Puoi effettuare una richiesta con un array di prodotti da inserire in carrello. Il sistema provvederà ad inserire il prodotto in carrello, o modificarle le quantità precedentemente inserite (se differiscono)

Il calcolo del prezzo viene eseguito in funzione di eventuali sconti per Quantità, impostati nel prodotto

key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
idProdotto * int ID del prodotto che si desidera acquistare
idVersione * int ID della versione che si desidera acquistare
qt * int

Quantità che si desidera acquistare. Se il prodotto è già presente in carrello viene sostuita la quantità in acquisto.

Se la quantità è pari a zero il prodotto viene eliminato dal carrello

* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "pushCart": {
        "result": "OK",
        "API": "pushCart",
        "version": "2.0.0",
        "cart": {
            "totProdotti": "5.00",
            "totEuro": "590.00",
            "aggiornamento": "2022-05-12 14:38:36",
            "prodotti": [
                {
                    "nomeProdotto": "Giacca Casual",
                    "nomeVersione": "L",
                    "qtProdotto": "3",
                    "prezzo": "90.00",
                    "tipologia": "update"
                },
                {
                    "nomeProdotto": "Monitor Esempio 21",
                    "nomeVersione": "L",
                    "qtProdotto": "2",
                    "prezzo": "160.00",
                    "tipologia": "update"
                }
            ]
        }
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Cart

Rappresenta un array dei prodotti inseriti in carrello.

Descrizione
totProdotti int Totali pezzi presenti in carrello
totEuro money Importo totale (IVA ESCLUSA) dei prodotti presenti in carrello
aggiornamento date(Y-m-d H:i:s) Data aggiornamento carrello
nomeProdotto string Nome prodotto inserito in carrello
nomeVersione string Nome versione inserita in carrello
qtProdotto int Quantità prodotto attualmente presente in carrello
prezzo money Prezzo unitario del prodotto presente in carello
tipologia string

Indica il tipo di operazione eseguita

  • "delete" Prodotto eliminato
  • "insert" Nuovo prodotto inserito
  • "update" Prodotto modificato

getCart Elenco prodotti in carrello

Restituisce un array di prodotti presenti nel carrello del cliente

GET

https://www.nomedominio.it/API/getCart

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getCart": {
        "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0"
    }
}
key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "getCart": {
        "result": "OK",
        "API": "getCart",
        "version": "2.0.0",
        "cart": [
            {
                "IDpref": "945",
                "id_prodotto": "50",
                "nomeProdotto": "Monitor Esempio 21",
                "nomeVersione": "L",
                "qt_prodotto": "2",
                "euro_prodotto": "160.00",
                "euro_originale": "160.00",
                "aliquota_iva": "22",
                "url_prodotto": "https://www.nomedominio.it/prodotto_50_Monitor-Esempio-21.html",
                "url_immagine": "https://www.nomedominio.it/images/img_prodotti/Monitor-Esempio-Modello-Nero-394973.jpg",
                "data_inserimento": "2022-05-12 13:49:54"
            },
            {
                "IDpref": "944",
                "id_prodotto": "57",
                "nomeProdotto": "Giacca Casual",
                "nomeVersione": "L",
                "qt_prodotto": "3",
                "euro_prodotto": "90.356",
                "euro_originale": "90.00",
                "aliquota_iva": "22",
                "url_prodotto": "https://www.nomedominio.it/prodotto_57_Giacca-Casual.html",
                "url_immagine": "https://www.nomedominio.it/images/img_prodotti/Giacca-Casual-776982.jpg",
                "data_inserimento": "2022-05-12 13:29:05"
            },
            {
                "IDpref": "946",
                "id_prodotto": "48",
                "nomeProdotto": "Stampante Esempio",
                "nomeVersione": "",
                "qt_prodotto": "4",
                "euro_prodotto": "132.00",
                "euro_originale": "132.00",
                "aliquota_iva": "22",
                "url_prodotto": "https://www.nomedominio.it/prodotto_48_Stampante-Esempio.html",
                "url_immagine": "https://www.nomedominio.it/images/img_prodotti/Stampante-Esempio-366623.jpg",
                "data_inserimento": "2022-05-12 14:17:37"
            }
        ]
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Cart

Rappresenta un array dei prodotti inseriti in carrello.

Descrizione
IDpref int Id record Carrello
id_prodotto int Id del prodotto in carrello
nomeProdotto string Nome prodotto inserito in carrello
nomeVersione string Nome versione inserita in carrello
qt_prodotto int Quantità prodotto attualmente presente in carrello
euro_prodotto money Prezzo unitario del prodotto presente in carello
euro_originale money Rappresenta il prezzo inizialmente inserito in carrello, in presenza di sconti applicata da Back-end
aliquota_iva int Aliquota iva attuale del prodotto
url_prodotto string Url del prodotto nel front-end
url_immagine string Url immagine del prodotto nel front-end
aggiornamento date(Y-m-d H:i:s) Data inserimento prodotto in carrello

getCartInfo Informazioni realtime su totale ordine

Restituisce informazioni con totale Carrello, modalità di pagamento e corrieri abilitati.

GET

https://www.nomedominio.it/API/getCartInfo

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getCart": {
        "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
        "stato": "web"
    }
}
key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
stato * string
  • "web" Visualizza solo Pagamenti e Corrieri visibili nel front-end
  • "admin" Visualizza tutte le modalità di Pagamento e Corrieri
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "getCartInfo": {
        "result": "OK",
        "API": "getCartInfo",
        "version": "2.0.0",
        "stato": "web",
        "info": [
            {
                "carrello_prodotti": "5",
                "carrello_totale": "591,07",
                "carrello_aliquota": "22",
                "carrello_totale_ivato": "721,10",
                "carrello_peso": "4"
            }
        ],
        "pagamenti": [
            {
                "id": 18,
                "nome": "Bollettino postale",
                "country": "IT",
                "stato_checkout": 0,
                "pos_virtuale": 0,
                "predefinito": 0,
                "da_euro": "0.00",
                "a_euro": "800.00",
                "commissione_perc": 3,
                "commissione_min": 15,
                "importoCommissione": 17.73,
                "logo_pagamento": "bollettino-icon.png",
                "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/bollettino-icon.png",
                "descrizione": "",
                "cc_postale": {
                    "conto_postale_cc": "12345678",
                    "conto_postale_intestato": "Pizzut Test"
                }
            },
            {
                "id": 17,
                "nome": "Bonifico bancario",
                "country": "IT",
                "stato_checkout": 0,
                "pos_virtuale": 0,
                "predefinito": 1,
                "da_euro": "0.00",
                "a_euro": "0.00",
                "commissione_perc": 0,
                "commissione_min": 0,
                "importoCommissione": "0.00",
                "logo_pagamento": "Bank-icon.png",
                "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/Bank-icon.png",
                "descrizione": "Puoi pagare con bonifico bancario intestato alla nostra società. Nella pagina successiva riceverai le coordinate bancarie, effettuato il bonifico dovrai inviare copia della contabile via email o FAX. L'ordine sarà evaso non appena l'operazione sarà visibile sul conto (in media 3/4 giorni).",
                "coordinate": {
                    "conto_banca_iban": "IT92X0873874130000000019296",
                    "conto_banca_intestato": "Pizzut",
                    "conto_banca_nome": "Pizzut bank test",
                    "conto_banca_indirizzo": "",
                    "conto_banca_abi": "A",
                    "conto_banca_cab": "b",
                    "conto_banca_cin": "c",
                    "conto_banca_bic": "d"
                }
            },
            {
                "id": 20,
                "nome": "Contrassegno",
                "country": "IT",
                "stato_checkout": 0,
                "pos_virtuale": 0,
                "predefinito": 0,
                "da_euro": "0.00",
                "a_euro": "900.00",
                "commissione_perc": 0,
                "commissione_min": 0,
                "importoCommissione": "0.00",
                "logo_pagamento": "money-icon.png",
                "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/money-icon.png",
                "descrizione": "Potrai pagare in contanti o con assegno bancario direttamente al corriere al momento del ritiro. Nessun costo aggiuntivo viene applicato per questo tipo di pagamento."
            },
            {
                "id": 22,
                "nome": "PayPal",
                "country": "IT",
                "stato_checkout": 0,
                "pos_virtuale": 0,
                "predefinito": 0,
                "da_euro": "0.00",
                "a_euro": "0.00",
                "commissione_perc": 0,
                "commissione_min": 0,
                "importoCommissione": "0.00",
                "logo_pagamento": "paypal-icon.png",
                "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/paypal-icon.png",
                "descrizione": "Il circuito Paypal è tra i più sicuri al mondo con più di 50 milioni di clienti. La transazione avviene direttamente nei loro server garantendo piena sicurezza ai tuoi dati.\r\n

Maggiori info: www.paypal.it

\r\n", "paypal": { "paypal_email": "info@pizzut.it", "paypal_api_username": "", "paypal_api_password": "", "paypal_api_firma": "" } }, { "id": 23, "nome": "Ricarica Postepay", "country": "IT", "stato_checkout": 0, "pos_virtuale": 0, "predefinito": 0, "da_euro": "0.00", "a_euro": "0.00", "commissione_perc": 0, "commissione_min": 0, "importoCommissione": "0.00", "logo_pagamento": "postepay-icon.png", "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/postepay-icon.png", "descrizione": "La Postepay è una carta di credito prepagata di Poste Italiane (opera con circuito VISA). Puoi pagare effettuando una ricarica online (se sei possessore della carta) oppure presso un qualsiasi ufficio postale. Dovrai richiedere infatti un modulo per ricaricare la postepay ed inserire i dati che ti forniremo in seguito.\r\n

Maggiori info: www.poste.it

\r\n", "carta_postepay": { "postepay_numero": "3448348348834", "postepay_intestato": "Pizzut", "postepay_codfiscale": "" } }, { "id": 28, "nome": "ScalaPay", "country": "IT", "stato_checkout": 0, "pos_virtuale": 5, "predefinito": 0, "da_euro": "0.00", "a_euro": "0.00", "commissione_perc": 0, "commissione_min": 0, "importoCommissione": "0.00", "logo_pagamento": "logo_scalapay.png", "url_logo": "https://www.nomedominio.it/images/icone_pagamenti/logo_scalapay.png", "descrizione": "", "scalapayAPI": { "pos_account": "AAA", "pos_mac_secret": "BBBB" } } ], "corrieri": [ { "id": 2, "nome": "Bartolini", "predefinito": 0, "stato_contrassegno": 0, "min_ordine": "0.00", "max_ordine": "0.00", "prezzo": "15.20", "stato_assicurazione": 0, "perc_assicurazione": "5.00", "costo_assicurazione": "0.00", "costo_assicurazione_limite": "0.00", "descrizioneSpedizione": "Calcolo standard", "calcoloSpedizione": { "importoSpedizione": "12,00", "importoAssicurazione": 29.55, "importoGestione": 88.66, "importoTotale": 130.21, "aliquotaSpedizione": 22 }, "spedizione_logo": "bartolini.gif", "url_logo": "https://www.nomedominio.it/images/img_corrieri/bartolini.gif", "assistenza": "", "tariffe": [ { "da_peso": "50.00", "a_peso": "200.00", "euro": "50.00", "country": "IT" }, { "da_peso": "200.00", "a_peso": "250.00", "euro": "60.00", "country": "IT" }, { "da_peso": "1.00", "a_peso": "10.00", "euro": "12.00", "country": "CH" }, { "da_peso": "11.00", "a_peso": "100.00", "euro": "25.35", "country": "CH" } ] }, { "id": 12, "nome": "UPS", "predefinito": 0, "stato_contrassegno": 0, "min_ordine": "0.00", "max_ordine": "0.00", "prezzo": "15.00", "stato_assicurazione": 0, "perc_assicurazione": "3.00", "costo_assicurazione": "2.00", "costo_assicurazione_limite": "0.00", "descrizioneSpedizione": "Calcolo standard", "calcoloSpedizione": { "importoSpedizione": "15,00", "importoAssicurazione": 19.73, "importoGestione": 88.66, "importoTotale": 123.39, "aliquotaSpedizione": 22 }, "spedizione_logo": "UPS.png", "url_logo": "https://www.nomedominio.it/images/img_corrieri/UPS.png", "assistenza": "", "tariffe": [ { "da_peso": "3.00", "a_peso": "5.00", "euro": "15.00", "country": "IT" }, { "da_peso": "6.00", "a_peso": "10.00", "euro": "20.00", "country": "IT" } ] } ] } }

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Info

Descrizione
carrello_prodotti int Numero pezzi contenuti in carrello
carrello_totale money(EUR) iva esclusa Importo totale merce in carrello
carrello_aliquota int Aliquota IVA base per il calcolo di commissioni e/o costi extra sulla spedizione
carrello_totale_ivato money(EUR) iva esclusa Importo totale merce in carrello iva inclusa
carrello_peso int Peso merce contenuta in carrello

Pagamenti e Corrieri

I valori di "pagamenti" e corrieri" sono i medesimi delle due Apis

In aggiunta ai valori, sono presenti i seguenti importi

Pagamenti

Descrizione
importoCommissione money(EUR) iva esclusa Rappresenta il valore dell'eventuale commissione applicata in funzione dell'importo ordine

Corrieri > calcoloSpedizione

Descrizione
importoSpedizione money(EUR) iva esclusa Costo spedizione in funzione del peso totale dell'ordine
importoAssicurazione money(EUR) iva esclusa Costo assicurazione calcolato in funzione dell'importo ordine (se configurato in back-end)
importoGestione money(EUR) iva esclusa Costo gestione ordine calcolato in funzione dell'importo ordine (se configurato in back-end)
importoTotale money(EUR) iva esclusa Costo totale spese di spedizione
aliquotaSpedizione int Aliquota IVA prevista per le spese di spedizione

pushCheckout Finalizza l'ordine

Attraverso questa Api puoi concludere l'ordine web

POST

https://www.nomedominio.it/API/pushCheckout

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "pushCheckout": {
        "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
        "idPagamento": "18",
        "idCorriere": "2",
        "idPoint": "0",
        "idIndirizzo": "12",
        "ipCliente": "212.66.99.153",
        "stato_assicurazione": "1",
        "note": "test ordine web"
    }
}

Parametri Request (JSON)

Per concludere l'ordine è sufficiente indicare ID della modalità di Pagamento scelta e ID del corriere scelto.

key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
idPagamento * int ID della modalità di pagamento scelta
idCorriere * int ID del corriere scelto
idPoint int Se valorizzato indica, in altertiva alla spedizione, ritiro in sede (Punto vendita)
idIndirizzo int Se valorizzato indica l'indirizzo di destinazione merce
ipCliente int IP del cliente in fase d'ordine
stato_assicurazione * int

Stabilisci se includere il costo di assicurazione in ordine o meno

  • "0" Escludi costo di assicurazione
  • "1" Aggiungi costo di assicurazione
note string

Eventuali note sull'ordine

* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "pushCheckout": {
        "result": "OK",
        "API": "pushCheckout",
        "version": "2.0.0",
        "idPagamento": "18",
        "idCorriere": "2",
        "idPoint": "10",
        "stato_assicurazione": "1",
        "spedizione": {
            "importoTotale": "0.00",
            "importoTotale_ivato": ""
        },
        "pagamento": {
            "importoCommissione": "24.339",
            "importoCommissione_ivato": "29,69"
        },
        "order": {
            "num_ordine": "296",
            "data_ordine": "2022-05-17 14:48:35",
            "totale_ordine": "689,34",
            "totale_ordine_ivato": "840,99",
            "orderToken": "6196f25997b6df291cb27cfe7810c4cbf1bf1efc"
        }
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API

Spedizione

Indica il costo totale delle spese di spedizioni applicate

Descrizione
importoTotale money(EUR) iva esclusa Importo totale spedizione
importoTotale_ivato money(EUR) iva esclusa Importo totale spedizione iva inclusa

Pagamento

Indica eventuali commissioni applicate per la modalità di pagamento scelta

Descrizione
importoCommissione money(EUR) iva esclusa Importo totale commissione
importoCommissione_ivato money(EUR) iva esclusa Importo totale commissione iva inclusa

Order

Indica le informazioni sull'ordine appena generato

Descrizione
num_ordine int Numero ordine sequenziale
data_ordine date(Y-m-d H:i:s) Data aggiornamento carrello
totale_ordine money(EUR) iva esclusa Totale ordine iva esclusa
totale_ordine_ivato money(EUR) iva inclusa Totale ordine iva inclusa
orderToken string Token ordine appena generato

getOrderList Elenco Ordini del cliente

Permette di visionare tutti gli ordini eseguiti dal cliente, stato di avanzamento, importi, tracking...

GET

https://www.nomedominio.it/API/getOrderList

Parametri Request (JSON)


{
    "key": "f242bb347d7c70e04XXXXXXXXXXXXXXXXX",
    "getOrderList": {
        "userToken": "6bb77edbd27291a5ed2f89501609112c489a33f0",
        "rowsPerPage": "20",
        "startingRow": "0",
        "stato": "",
        "idOrdine": "0"
    }
}

Parametri Request (JSON)

Per concludere l'ordine è sufficiente indicare ID della modalità di Pagamento scelta e ID del corriere scelto.

key * string Api Key abilitata da pannello di controllo
userToken * string Token di autenticazione del cliente
rowsPerPage* int Numero prodotti per pagina, di default 30, massimo 30.
startingRow* int Inizia da riga (ad esempio "0", "30", "60") per paginazione
stato int

Filtra gli ordini in funzione dello stato

Se non valorizzato vengono visualizzati tutti gli ordini

  • "0" Ordini Aperti
  • "1" Evadibili
  • "101" Preparato
  • "2" Spedito
  • "3" Regolato
  • "5" Annullato
  • "6" Da Spedire
  • "7" Di Oggi
  • "8" Ultime Spedizioni
idOrdine int Filtra ordine in funzione del suo ID per ottenere le informazioni sul singolo ordine.
* Parametro obbligatorio

Response Body

Se le API sono state configurate correttamente e sono accessibili verranno visualizzate le seguenti informazioni

{
    "getOrderList": {
        "result": "OK",
        "API": "getOrderList",
        "version": "2.0.0",
        "stato": "2",
        "id": "0",
        "startingRow": 0,
        "rowsPerPage": 20,
        "recordsTotal": "34",
        "orderList": [
            {
                "id": 259,
                "ragione_sociale": "Giuseppe Colombo",
                "country": "IT",
                "num_ordine": "265",
                "data_ordine": "2022-03-16 13:15:21",
                "importo": "238,14",
                "orderToken": "5cf451e7c9fc8bb25e382efefbd80fca2e596319",
                "citta": "Palermo (PA)",
                "pagamento": {
                    "id": "22",
                    "nome": "PayPal"
                },
                "corriere": {
                    "id": "2",
                    "nome": "Bartolini"
                },
                "spedizione": {
                    "data": "2022-03-16 00:00:00",
                    "peso": "0",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "202",
                    "id_fattura": "238",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 235,
                "ragione_sociale": "Salvatore Russo",
                "country": "IT",
                "num_ordine": "240",
                "data_ordine": "2022-02-17 19:25:10",
                "importo": "160,86",
                "orderToken": "5f08a6f133f422a58a435ba4045e8a138413f1ef",
                "citta": "Verona (VR)",
                "pagamento": {
                    "id": "17",
                    "nome": "Bonifico bancario"
                },
                "corriere": {
                    "id": "2",
                    "nome": "Bartolini"
                },
                "spedizione": {
                    "data": "2022-03-21 15:12:21",
                    "peso": "0",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "201",
                    "id_fattura": "237",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 210,
                "ragione_sociale": "Rossi Daniele",
                "country": "IT",
                "num_ordine": "215",
                "data_ordine": "2021-12-22 15:32:48",
                "importo": "0,00",
                "orderToken": "f30a0f8bcff57c91a02596a874ad594272e08efb",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2022-03-16 16:35:48",
                    "peso": "3",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "203",
                    "id_fattura": "239",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 200,
                "ragione_sociale": "Giovanni Rossi",
                "country": "IT",
                "num_ordine": "205",
                "data_ordine": "2021-12-17 17:33:23",
                "importo": "313,02",
                "orderToken": "f9b706848c29e1f06af4f965ff7ca4e63be4dbef",
                "citta": "Milano (MI)",
                "pagamento": {
                    "id": "20",
                    "nome": "Contrassegno"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2022-02-08 14:39:48",
                    "peso": "15",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "190",
                    "id_fattura": "224",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 199,
                "ragione_sociale": "Azienda Rossi srl",
                "country": "IT",
                "num_ordine": "204",
                "data_ordine": "2021-12-17 16:10:58",
                "importo": "74.015,57",
                "orderToken": "7204a6bbeef465f6c5b8a0819cfbe332abee312e",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "27",
                    "nome": "Carta di Credito"
                },
                "corriere": {
                    "id": "2",
                    "nome": "Bartolini"
                },
                "spedizione": {
                    "data": "2021-12-20 00:00:00",
                    "peso": "3",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "188",
                    "id_fattura": "222",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 198,
                "ragione_sociale": "Azienda Rossi srl",
                "country": "IT",
                "num_ordine": "203",
                "data_ordine": "2021-12-16 16:35:15",
                "importo": "1.888,34",
                "orderToken": "8bb2fe95fd498ae34f1efcd9cf61a699a2988d33",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "27",
                    "nome": "Carta di Credito"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-17 00:00:00",
                    "peso": "2",
                    "colli": "1",
                    "tracking": "AAA",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "187",
                    "id_fattura": "221",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 197,
                "ragione_sociale": "Azienda Rossi srl",
                "country": "IT",
                "num_ordine": "202",
                "data_ordine": "2021-12-16 16:32:53",
                "importo": "2.184,82",
                "orderToken": "5e3b77807dd569d020b287949d25d2a8fe4242e0",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "4",
                    "nome": "SDA"
                },
                "spedizione": {
                    "data": "2021-12-16 00:00:00",
                    "peso": "27",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": "BBXX"
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "186",
                    "id_fattura": "220",
                    "num_ddt": "0"
                },
                "note": "test"
            },
            {
                "id": 196,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "201",
                "data_ordine": "2021-12-15 18:06:54",
                "importo": "137,25",
                "orderToken": "4ba5476d3149598cd14513d4d6243726f81bfd3d",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-17 17:48:29",
                    "peso": "1",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "0",
                    "id_fattura": "0",
                    "num_ddt": "62"
                },
                "note": ""
            },
            {
                "id": 195,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "200",
                "data_ordine": "2021-12-15 18:04:54",
                "importo": "137,25",
                "orderToken": "36fd1d468283c4c3418a80b0eb8505b31bbf516d",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-20 17:46:35",
                    "peso": "1",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "0",
                    "id_fattura": "0",
                    "num_ddt": "61"
                },
                "note": ""
            },
            {
                "id": 189,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "194",
                "data_ordine": "2021-12-15 17:41:57",
                "importo": "134,75",
                "orderToken": "8d93db882945063290492f5f88487e7a61362c21",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-21 00:00:00",
                    "peso": "1",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "184",
                    "id_fattura": "218",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 188,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "193",
                "data_ordine": "2021-12-15 17:37:32",
                "importo": "185,44",
                "orderToken": "55ffcb29b9c54064dedf18a65937f589a27f38c4",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-22 12:25:37",
                    "peso": "2",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "183",
                    "id_fattura": "217",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 187,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "192",
                "data_ordine": "2021-12-15 17:32:08",
                "importo": "185,44",
                "orderToken": "b69e3b96cede6f68e91cef7d7bc094348fcdf3ed",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-22 00:00:00",
                    "peso": "2",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "180",
                    "id_fattura": "214",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 186,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "191",
                "data_ordine": "2021-12-15 17:29:56",
                "importo": "508,13",
                "orderToken": "e268df731d3c57ea5c42071ed71b1084c17592f5",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "2",
                    "nome": "Bartolini"
                },
                "spedizione": {
                    "data": "2021-12-16 00:00:00",
                    "peso": "3",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": "YYY"
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "179",
                    "id_fattura": "213",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 181,
                "ragione_sociale": "Azienda Rossi srl",
                "country": "IT",
                "num_ordine": "186",
                "data_ordine": "2021-12-15 16:28:43",
                "importo": "322,69",
                "orderToken": "1c5cb70eb9f83936b6baa168c59ca85b3333fcac",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-22 12:52:09",
                    "peso": "0",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "185",
                    "id_fattura": "219",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 178,
                "ragione_sociale": "Azienda Rossi srl",
                "country": "IT",
                "num_ordine": "183",
                "data_ordine": "2021-12-15 16:21:24",
                "importo": "322,69",
                "orderToken": "695c0d3cc20fbfe3d40a65580cf1663b86c6c2b6",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-15 00:00:00",
                    "peso": "0",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "178",
                    "id_fattura": "212",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 174,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "179",
                "data_ordine": "2021-12-03 17:12:12",
                "importo": "118,34",
                "orderToken": "2ff4a8314eb6368cdb16f284fbf3a54e4f3df941",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-21 14:56:03",
                    "peso": "5",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "147",
                    "id_fattura": "181",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 171,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "176",
                "data_ordine": "2021-12-03 17:07:14",
                "importo": "179,34",
                "orderToken": "37a7c9c7af12129d5a72b62ada77c556c3d9261d",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "18",
                    "nome": "Bollettino postale"
                },
                "corriere": {
                    "id": "0",
                    "nome": ""
                },
                "spedizione": {
                    "data": "2021-12-22 12:54:06",
                    "peso": "5",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "150",
                    "id_fattura": "182",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 156,
                "ragione_sociale": "Test Pizzut srl",
                "country": "IT",
                "num_ordine": "161",
                "data_ordine": "2021-12-01 16:18:17",
                "importo": "469,09",
                "orderToken": "b0d9b52c7b59f501ebff5c5c85d77eb6ef75dbc9",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "27",
                    "nome": "Carta di Credito"
                },
                "corriere": {
                    "id": "2",
                    "nome": "Bartolini"
                },
                "spedizione": {
                    "data": "2021-12-15 00:00:00",
                    "peso": "9",
                    "colli": "1",
                    "tracking": "080010017684806",
                    "url_tracking": "https://tracking.qapla.it/347513728eab0009bfc60cc47acaffd0",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "0",
                    "id_fattura": "0",
                    "num_ddt": "0"
                },
                "note": "dfssdfsfdfsd"
            },
            {
                "id": 50,
                "ragione_sociale": "Pizzut sas",
                "country": "IT",
                "num_ordine": "51",
                "data_ordine": "2021-05-06 17:09:01",
                "importo": "201,30",
                "orderToken": "509db908537861a5c7515b2f0ffe9d11a35f1ec7",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "17",
                    "nome": "Bonifico bancario"
                },
                "corriere": {
                    "id": "3",
                    "nome": "TNT"
                },
                "spedizione": {
                    "data": "2021-05-19 13:49:49",
                    "peso": "0",
                    "colli": "1",
                    "tracking": "",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "15",
                    "id_fattura": "37",
                    "num_ddt": "0"
                },
                "note": ""
            },
            {
                "id": 49,
                "ragione_sociale": "Pizzut sas",
                "country": "IT",
                "num_ordine": "50",
                "data_ordine": "2021-05-06 16:42:16",
                "importo": "42,38",
                "orderToken": "0ae89e60d4f87f1e526c63ffd1795f3dfb8dd17c",
                "citta": "Latina (LT)",
                "pagamento": {
                    "id": "17",
                    "nome": "Bonifico bancario"
                },
                "corriere": {
                    "id": "3",
                    "nome": "TNT"
                },
                "spedizione": {
                    "data": "2021-12-16 00:00:00",
                    "peso": "0",
                    "colli": "1",
                    "tracking": "XXX",
                    "url_tracking": "",
                    "barcode": ""
                },
                "point": {
                    "id": "0",
                    "nome": ""
                },
                "avanzamento": {
                    "stato": "2",
                    "nome": "Spedito",
                    "color": "bg-dark text-white"
                },
                "documenti": {
                    "num_fattura": "16",
                    "id_fattura": "38",
                    "num_ddt": "0"
                },
                "note": ""
            }
        ]
    }
}

Errori

Vengono restituiti i seguenti errori, per la descrizione si rimanda alla tabella 'Errori'

Descrizione

Descrizione
result string Il risultato dell'operazione: OK o KO in caso di errore
version string La versione dell'API
recordsTotal int Numero record trovati

OrderList

Indica il costo totale delle spese di spedizioni applicate

Descrizione
ragione_sociale string Ragione sociale / Nome+Cognome del cliente
country String
ISO 3166-1 alpha-2 codes
Codice nazione cliente
num_ordine int Numero ordine sequenziale assegnato all'ordine
data_ordine date(Y-m-d H:i:s) Data Ordine
importo money(EUR) iva inclusa Importo totale iva inclusa
orderToken string Token univoco assegnato all'ordine
citta string Città e provincia destinazione merce
pagamento array

Informazioni sulla modalità di pagamento scelta

  • "id" Id della modalità di pagamento
  • "nome" Nome modalità di pagamento
corriere array

Informazioni sul corriere scelto

  • "id" Id del Corriere
  • "nome" Nome del Corriere
spedizioni array

Informazioni su eventuale spedizione merce

  • "data" Data spedizione merce (Y-m-d H:i:s)
  • "peso" In KG identifica il peso complessivo dell'ordine
  • "colli" Numero Colli dell'ordine
  • "tracking" Numero tracking dell'ordine
  • "url_tracking" URL tracking dell'ordine
  • "barcode" Barcode assegnato al collo
point array

Indica informazioni su eventuale punto vendita scelto per il ritiro

  • "id" Id del Punto Vendita
  • "nome" Nome del Punto Vendita
avanzamento array

Indica lo stato di avanzamento dell'ordine

  • "stato" indica lo stato di avanzamento (per la lista consultare i valori di Request)
  • "nome" Nome testuale dello stato di avanzamento
  • "color" Colore assegnato per eventuali elementi grafici
documenti array

Indica eventuali documenti emessi per l'ordine

  • "num_fattura" Numero fattura
  • "id_fattura" ID Fattura per eventuale ristampa
  • "num_ddt" Numero DDT
note string Eventuali note dell'ordine