Dal tuo software ai clienti

Un semplice flusso di dati a due vie

Il sistema rimane la fonte dei dati aziendali. Esso alimenta il negozio SellViaApp mentre gli ordini confermati dal cliente risalgono al vostro ERP o software di business.

1

Il tuo ERP

Prodotti, categorie, prezzi e contenuti.

2

API SellViaApp

Proteggere gli scambi JSON su HTTPS.

3

App mobile

I clienti Sfogliano e ordinano.

4

I tuoi ordini

Il sistema li recupera automaticamente.

Nessuna voce duplicata

Gli identificatori esterni conservano la mappatura dei riferimenti ERP, mentre la paginazione mantiene affidabili le grandi sincronizzazioni.

Avvio rapido

Collegare il sistema in tre fasi

1

Ottieni le tue credenziali

La chiave API identifica il tuo negozio. Il token dell'amministratore protegge le operazioni del server.

2

Alimentare il catalogo

Crea categorie, quindi invia o aggiorna i prodotti dal tuo ERP.

3

Recuperare gli ordini

Inserire il percorso del fornitore impaginato e memorizzare ogni GUID elaborato.

Creare un prodotto · cURL

curl -X POST "https://api.sellviaapp.com/product/add" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -d '{
    "external_key": "ERP-ARTICLE-1042",
    "code": "ART-1042",
    "name": "Premium product",
    "description": "Complete product description",
    "base_price": 24.90,
    "vat_rate": 21,
    "category_id": 12,
    "active": true
  }'

Recuperare gli ordini · cURL

curl "https://api.sellviaapp.com/admin/order/list?page=1&per_page=25&from_date=2026-08-01" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_SUPPLIER_KEY" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Ogni ordine contieneGUID, numero, cliente, linee, quantità, prezzi, IVA, totale, valuta, modalità di esecuzione, indirizzo e data.

Sicurezza

credenziali separate per ogni utilizzo

KEY

X-API-Key

Richiesto di identificare il fornitore. Non esporre mai la chiave in JavaScript pubblico.

JWT

Autorizzazione: Cuscinetto

Necessario per i dati dei clienti autenticati. Rinnova tramite auth/refresh.

AMMINISTRAZIONE

X-Admin-Token

Riservato per integrazioni server approvate che modificano cataloghi e categorie.

Integrazione lato server

Tenere X-API-Key e X-Admin-Token all'interno del server o ERP. Non li posizionare mai in un sito web pubblico, app mobile o repository sorgente.

Punti di fine

Autenticazione

Creare, rinfrescare e chiudere sessioni sicure.

POST /auth/login Chiave API

Iscriviti al cliente utilizzando il proprio login e password.

POST /auth/refresh Chiave API

Rinnova un token di accesso utilizzando un token di aggiornamento.

POST /auth/logout Chiave + Cuscinetto

Chiudere la sessione attiva.

POST /auth/guest Chiave API

Creare una sessione per gli ospiti quando abilitata dal fornitore.

POST /auth/forgot-password Chiave API

Avviare il recupero del conto senza rivelare se esiste un account.

Punti di fine

Fornitori e branding

Trova un negozio e recupera la sua configurazione pubblica.

GET /admin/supplier/list Pubblico

Cerca fornitori visibili nella directory.

GET /admin/supplier/logo Pubblico

Recuperare un logo del fornitore ottimizzato.

GET /admin/supplier/contact Chiave API

Recuperare i dati di contatto pubblico configurati.

GET /admin/supplier/legal Chiave API

Recuperare i termini, la privacy, la comunicazione legale e i contenuti.

GET /admin/megawinappcheck/check_supplier_to_use Pubblico

Risolvere un fornitore da un suffisso o un identificatore.

Punti di fine

Clienti

Creare e gestire account clienti per ogni negozio.

POST /customer/add Chiave API

Crea un cliente e genera il login del fornitore.

GET /customer/list Chiave + Cuscinetto

Elenca o filtra le informazioni dei clienti autorizzate.

GET /customer/me Chiave + Cuscinetto

Recupera il profilo del cliente autenticato.

PATCH /customer/update Chiave + Cuscinetto

Profilo di aggiornamento, lingua, tipo, email o password.

DELETE /customer/deleteaccount Chiave + Cuscinetto

Disattivare l'account cliente nel negozio attivo.

Punti di fine

Catalogo

Categorie, prodotti, immagini, prezzi, stock, promozioni e favoriti.

GET /fam1/list Chiave + Cuscinetto

Elenca le categorie primarie.

POST /fam1/add Amministratore

Creare una categoria primaria.

PATCH /fam1/update Amministratore

Aggiorna una categoria primaria.

DELETE /fam1/delete Amministratore

Nascondere una categoria primaria.

GET /fam2/list Chiave + Cuscinetto

Elenca le sottocategorie.

POST /fam2/add Amministratore

Crea una sottocategoria.

PATCH /fam2/update Amministratore

Aggiorna una sottocategoria.

DELETE /fam2/delete Amministratore

Nascondi una sottocategoria.

GET /product/list Chiave + Cuscinetto

Elenco e ricerca prodotti con impaginazione.

GET /product/image URL del registro

Servire un'immagine firmata e memorizzabile del prodotto.

POST /product/add Amministratore

Creare un prodotto.

PATCH /product/update Amministratore

Aggiorna un prodotto.

DELETE /product/delete Amministratore

Nascondi un prodotto.

POST /product/favoris Chiave + Cuscinetto

Aggiungere o rimuovere un prodotto dai preferiti.

GET /price/list Chiave + Cuscinetto

Elenca i prezzi applicabili al gruppo clienti.

GET /mark/list Chiave + Cuscinetto

Elenca le marche disponibili.

GET /size/list Chiave + Cuscinetto

Elenco disponibili dimensioni.

GET /libweb/list Chiave + Cuscinetto

Elenca le etichette di riferimento web.

Punti di fine

Carico e ordini

Gestisci il carrello e confermi un ordine atomico.

GET /admin/order/list Amministratore

Recuperare tutti gli ordini di fornitore confermati con cliente, linee e paginazione.

GET /order/add Chiave + Cuscinetto

Recuperare o inizializzare il carrello corrente.

GET /order/list Chiave + Cuscinetto

Elenca la cronologia del carrello e dell'ordine.

DELETE /order/delete Chiave + Cuscinetto

Cancellare ed eliminare il carrello corrente.

GET /order/total Chiave + Cuscinetto

Calcola il carrello subtotale, IVA e totale.

GET /order/count/line Chiave + Cuscinetto

Conta le linee nel carrello.

POST /order/sendtomegawin Chiave + Cuscinetto

Confermare l'ordine, la modalità di esecuzione e l'indirizzo.

POST /orderline/add Chiave + Cuscinetto

Aggiungere un prodotto e la quantità al carrello.

GET /orderline/list Chiave + Cuscinetto

Recuperare le linee di carrello correnti.

PATCH /orderline/update Chiave + Cuscinetto

Aggiornare una quantità di linea.

DELETE /orderline/delete Chiave + Cuscinetto

Rimuovere una linea dal carrello.

Punti di fine

Documenti

Fatture, stime, ordini e loro linee.

POST /document/add Chiave + Cuscinetto

Creare un documento legato al cliente.

GET /document/list Chiave + Cuscinetto

Elenca o filtra i documenti.

PATCH /document/update Chiave + Cuscinetto

Aggiornare un documento identificato da GUID.

DELETE /document/delete Chiave + Cuscinetto

Eliminare un documento e le sue linee.

POST /documentline/add Chiave + Cuscinetto

Aggiungere una riga e ricalcolare il documento.

GET /documentline/list Chiave + Cuscinetto

Recuperare un documento con tutte le sue linee.

PATCH /documentline/update Chiave + Cuscinetto

Aggiorna una linea identificata da GUID.

DELETE /documentline/delete Chiave + Cuscinetto

Eliminare una linea e ricalcolare i totali.

Punti di fine

Supporto, notifiche e integrazioni

Comunicazione del cliente, supporto e sincronizzazione esterna.

GET /support/ticket/list Chiave + Cuscinetto

Elenca i biglietti disponibili per il cliente.

POST /support/ticket/create Chiave + Cuscinetto

Crea una richiesta di supporto.

GET /support/ticket/list/log_reply Chiave + Cuscinetto

Recuperare un biglietto e le sue risposte.

GET /support/ticket/list/waiting_reply_by_support Chiave + Cuscinetto

Elenca le richieste in attesa di supporto.

POST /support/ticket/reply/send Chiave + Cuscinetto

Rispondi a un biglietto.

POST /admin/supplier/sendfeedbackfromapp Chiave + Cuscinetto

Invia un feedback al fornitore.

POST /admin/supplier/sendemailtosalesupport Chiave + Cuscinetto

Supporto di vendita di contatti.

GET /admin/notification/sendtomobile Chiave + Cuscinetto

Recuperare le notifiche mobili.

POST /admin/notification/setdelivery Chiave + Cuscinetto

Segna una notifica come consegnata.

POST /woocommerce/menu/synchronisation Amministratore

Sincronizza le categorie WooCommerce.

POST /woocommerce/product/synchronisation Amministratore

Prodotti Synchronise WooCommerce.

Contratti obbligatori

Parametri dettagliati

I parametri possono essere inviati come JSON o, per le vie GET, nella stringa di query.

/auth/login+

NomeTipo diObbligatorioDesignazione delle merci

loginstringaSì.

Email, login del cliente o login, incluso il suffisso del fornitore.

passwordstringaSì.

Password del cliente.

supplierstringaNo.

Suffisso del fornitore o chiave quando non incluso nel login.

/customer/add+

NomeTipo diObbligatorioDesignazione delle merci

nomstringaSì.

Il cognome del cliente.

prenomstringaSì.

Nome del cliente.

emailemailSì.

Email unica all'interno del fornitore.

denominationstringaNo.

Nome della società, facoltativo.

passwordstringaSì.

Almeno otto personaggi.

languestringaNo.

Lingua preferenziale.

/product/list+

NomeTipo diObbligatorioDesignazione delle merci

pageIntegerNo.

Numero di pagina, a partire da 1.

per_pageIntegerNo.

Prodotti per pagina.

searchstringaNo.

Cerca per codice, nome o descrizione.

category_idIntegerNo.

Filtro di categoria primario.

subcategory_idIntegerNo.

Filtro sottocategoria.

/product/add+

NomeTipo diObbligatorioDesignazione delle merci

codestringaSì.

Codice prodotto unico all'interno del negozio.

namestringaSì.

Nome visualizzato nell'app.

descriptionstringaNo.

Descrizione dettagliata del prodotto.

base_pricedecimaleSì.

Prezzo di vendita escluso tassa in base alla vostra configurazione.

vat_ratedecimaleNo.

Tassi IVA, ad esempio 21.

category_idIntegerNo.

SellViaApp identificatore categoria.

external_keystringaNo.

Identificatore stabile dal tuo ERP.

image_urlurlNo.

URL HTTPS dell'immagine principale.

activebooleanNo.

Controlla la visibilità del prodotto.

/admin/order/list+

NomeTipo diObbligatorioDesignazione delle merci

pageIntegerNo.

Pagina richiesta, a partire da 1.

per_pageIntegerNo.

Ordini per pagina, massimo 100.

from_datedataNo.

Solo gli ordini di ritorno da questa data.

guidstringaNo.

Recuperare un ordine da parte di GUID.

statusstringaNo.

Filtro disponibile a seconda della modalità di archiviazione: in attesa, preparazione, pronto, consegnato o cancellato.

/order/sendtomegawin+

NomeTipo diObbligatorioDesignazione delle merci

order_guidUuidNo.

GUID del carrello da confermare.

delivery_modeenumeraSì.

pickup | delivery

delivery_addressstringaNo.

Richiesto per la consegna.

delivery_datedataNo.

YYYYY-MM-DD

delivery_commentstringaNo.

Istruzioni di adempimento.

languagestringaNo.

Linguaggio e-mail transazionale.

/document/add+

NomeTipo diObbligatorioDesignazione delle merci

doc_typestringaSì.

invoice | estimate | purchase_order

customer_idIntegerNo.

Compatibilità legacy; il cliente autenticato ha la precedenza.

doc_numberstringaSì.

Numero di documento.

doc_datedataSì.

YYYYY-MM-DD

due_datedataNo.

YYYYY-MM-DD

payment_methodstringaNo.

Metodo di pagamento.

remarkstringaNo.

Osservazione libera.

/documentline/add+

NomeTipo diObbligatorioDesignazione delle merci

document_guidUuidSì.

Documento di ricerca.

textstringaSì.

Descrizione della linea.

quantitydecimaleSì.

Quantità.

unit_pricedecimaleSì.

Prezzo unitario IVA esclusa.

vat_ratedecimaleNo.

Tassi IVA.

discount_percentagedecimaleNo.

Percentuale di sconto.

JSON

Busta di risposta

200 OK

{
  "success": true,
  "message": "OK",
  "data": {
    "items": []
  },
  "meta": {
    "page": 1,
    "per_page": 10,
    "total": 0
  }
}

Diagnostica

Errori strutturati

Ogni errore espone un codice leggibile dalla macchina, categoria, messaggio leggibile dall'uomo e, quando disponibile, un identificatore di richiesta.

400Richiesta non valida

401Autenticazione richiesta

403Accesso negato

404Risorse o percorso non trovato

409conflitto commerciale

422Mancato il mancato convalida

429Troppe richieste

5xxxxIncidenza tecnica

422 Contenuto non elaborato

{
  "success": false,
  "message": "The delivery address is required.",
  "data": null,
  "error": {
    "code": "DELIVERY_ADDRESS_REQUIRED",
    "category": "validation",
    "message": "The delivery address is required.",
    "details": {}
  }
}

Documentazione legacy

Gli URL di Legacy rimangono riconosciuti

La nuova API accetta varianti pubblicate su doc.sellviaapp.com così le integrazioni esistenti continuano a funzionare.

/api/document/*→/document/*

/user/add→/customer/add

/fam1/insert→/fam1/add

/product/insert→/product/add

/product/favorites→/product/favoris

/order/count→/order/count/line

/CUSTOMER/LIST→/customer/list

Verifica completa

Ogni percorso pubblicato nella documentazione legacy ha ora un percorso nativo o un alias di compatibilità.

Feed your app e recuperare gli ordini tramite l'API.

Un semplice flusso di dati a due vie

Il tuo ERP

API SellViaApp

App mobile

I tuoi ordini

Collegare il sistema in tre fasi

Ottieni le tue credenziali

Alimentare il catalogo

Recuperare gli ordini

credenziali separate per ogni utilizzo

X-API-Key

Autorizzazione: Cuscinetto

X-Admin-Token

Autenticazione

Fornitori e branding

Clienti

Catalogo

Carico e ordini

Documenti

Supporto, notifiche e integrazioni

Parametri dettagliati

Busta di risposta

Errori strutturati

Gli URL di Legacy rimangono riconosciuti