Documentazione del fornitore

Feed your app and retrieve orders through the API

Collegare la piattaforma ERP, e-commerce, POS o software aziendale a SellViaApp. Invia categorie, prodotti e prezzi, quindi recuperare gli ordini di negozio confermati come JSON.

Avvio rapido

Authenticate, choose a route, test.

Get the X-API-Key and generate the Bearer in Dashboard → API. Enter them below, then use “Test · Generate” on an endpoint to obtain the response and cURL, PHP 8 or JavaScript code.

Credentials incompleteEnter the X-API-Key and Bearer token to prepare a test.

Credentials remain in memory for this page only. For a customer-related operation, add customer_id.

Keep in mindHTTPS + JSON · keep both credentials server-side · never send tokens to support.

Real time

Connect SellViaApp to any HTTPS-capable system.

A webhook alerts your ERP, CRM, automation or software whenever a product, customer, cart, order, document or important setting changes. Use the API to retrieve the full authoritative object when needed.

Create the destination

In Dashboard → Webhooks, enter an HTTPS URL and select events. The secret is shown once.

Verify the signature

Compute HMAC-SHA256 over timestamp.delivery_id.raw_body and compare it with X-SellViaApp-Signature.

Acknowledge quickly

Return HTTP 2xx, deduplicate with X-SellViaApp-Event-Id, then process in the background.

Reliable deliveryUp to eight attempts with progressive delays. A repeatedly failing destination is paused automatically, and every delivery remains visible and retryable in the Dashboard.
payload = timestamp + "." + delivery_id + "." + raw_body
expected = "v1=" + HMAC_SHA256(payload, signing_secret)

Punti di fine

Clienti

Creare e gestire account clienti per ogni negozio.

5 routes
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.

24 routes
GET /fam1/list Chiave + Cuscinetto

Elenca le categorie primarie.

POST /fam1/add Chiave + Cuscinetto

Creare una categoria primaria.

PATCH /fam1/update Chiave + Cuscinetto

Aggiorna una categoria primaria.

DELETE /fam1/delete Chiave + Cuscinetto

Nascondere una categoria primaria.

GET /fam2/list Chiave + Cuscinetto

Elenca le sottocategorie.

POST /fam2/add Chiave + Cuscinetto

Crea una sottocategoria.

PATCH /fam2/update Chiave + Cuscinetto

Aggiorna una sottocategoria.

DELETE /fam2/delete Chiave + Cuscinetto

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 Chiave + Cuscinetto

Creare un prodotto.

PATCH /product/update Chiave + Cuscinetto

Aggiorna un prodotto.

GET /product/action Chiave + Cuscinetto

Retrieve a product action type and its settings.

PUT /product/action/configure Chiave + Cuscinetto

Configure direct purchase, auction or information request and their settings.

DELETE /product/delete Chiave + Cuscinetto

Nascondi un prodotto.

POST /product/favoris Chiave + Cuscinetto

Aggiungere o rimuovere un prodotto dai preferiti.

GET /product/auction Chiave + Cuscinetto

Retrieve an auction state and anonymised bid history.

POST /product/auction/bid Chiave + Cuscinetto

Place a bid with atomic minimum-amount validation.

POST /product/auction/buy-now Chiave + Cuscinetto

Buy now and atomically close the auction.

POST /product/inquiry Chiave + Cuscinetto

Send an information request linked to a product.

GET /price/list Chiave + Cuscinetto

List prices applicable to the customer group, falling back to the product sales price.

GET /mark/list Chiave + Cuscinetto

Elenca le marche disponibili.

GET /size/list Chiave + Cuscinetto

Elenco disponibili dimensioni.

GET /libweb/list Chiave + Cuscinetto

List web reference labels, falling back to catalogue labels.

Punti di fine

Carico e ordini

Gestisci il carrello e confermi un ordine atomico.

14 routes
GET /order/list Chiave + Cuscinetto

List every confirmed shop order with pagination.

DELETE /order/delete Chiave + Cuscinetto

Cancellare ed eliminare il carrello corrente.

GET /order/total Chiave + Cuscinetto

Calcola il carrello subtotale, IVA e totale.

POST /promotion/validate Chiave + Cuscinetto

Validate a promotion code against the current cart on the server and calculate net, VAT and total discounts.

GET /loyalty/summary Chiave + Cuscinetto

Retrieve the loyalty programme, customer balance and available discount value.

GET /loyalty/history Chiave + Cuscinetto

List the customer’s earning, redemption, correction and expiry history.

POST /loyalty/quote Chiave + Cuscinetto

Calculate server-side how many points can be redeemed against the current cart.

POST /order/shipping/quote Chiave + Cuscinetto

Calculate shipping fees from the cart, fulfilment mode and country.

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

Customer payments

Choose pay on delivery or open a secure Stripe payment, then retrieve its server-verified status.

4 routes
GET /payment/config Chiave + Cuscinetto

Retrieve the enabled Stripe payment methods and the Stripe account provider selected for the app.

POST /payment/checkout/create Chiave + Cuscinetto

Create or resume a Stripe Checkout page for an unpaid order or booking owned by the signed-in customer. A still-changeable pay-on-delivery choice is safely replaced.

POST /payment/pay-later Chiave + Cuscinetto

Record pay on delivery or replace a still-open Stripe payment after its session is securely checked and expired.

GET /payment/status Chiave + Cuscinetto

Retrieve a payment status; only the signed Stripe webhook can confirm it as paid.

Punti di fine

Documenti

Fatture, stime, ordini e loro linee.

8 routes
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

Real-time webhooks

Automatically receive SellViaApp changes in your ERP, CRM, automation or business service.

10 routes
GET /webhooks/events Chiave + Cuscinetto

List all available events and the contract version.

GET /webhooks/endpoints/list Chiave + Cuscinetto

List destinations, status and counters.

POST /webhooks/endpoints/create Chiave + Cuscinetto

Create an HTTPS destination and receive its signing secret once.

PATCH /webhooks/endpoints/update Chiave + Cuscinetto

Update the destination, events or pause delivery.

DELETE /webhooks/endpoints/delete Chiave + Cuscinetto

Soft-delete a destination.

POST /webhooks/endpoints/rotate-secret Chiave + Cuscinetto

Replace the HMAC secret and reveal it once.

GET /webhooks/deliveries/list Chiave + Cuscinetto

Inspect deliveries, responses, errors and attempts.

POST /webhooks/deliveries/retry Chiave + Cuscinetto

Retry one delivery without replaying the others.

POST /webhooks/test Chiave + Cuscinetto

Emit and deliver a signed test event.

GET /webhooks/stats Chiave + Cuscinetto

Retrieve the last thirty days of delivery metrics.

Punti di fine

Notifications and integrations

Mobile notifications and external synchronisation.

61 routes
GET /admin/notification/sendtomobile Chiave + Cuscinetto

Recuperare le notifiche mobili.

POST /admin/notification/setdelivery Chiave + Cuscinetto

Segna una notifica come consegnata.

POST /woocommerce/categories/sync Chiave + Cuscinetto

Batch-sync WooCommerce categories and subcategories.

POST /woocommerce/products/sync Chiave + Cuscinetto

Sync products, variations, images, prices, VAT, stock and visibility.

POST /woocommerce/customers/sync Chiave + Cuscinetto

Create or update WooCommerce customer accounts without sending email.

PATCH /woocommerce/products/inventory Chiave + Cuscinetto

Quickly update prices, promotions, stock or visibility only.

POST /woocommerce/products/archive Chiave + Cuscinetto

Batch-archive deleted WooCommerce products without changing orders.

GET /woocommerce/orders/feed Chiave + Cuscinetto

Retrieve confirmed orders with cursor-based reconciliation.

POST /woocommerce/orders/acknowledge Chiave + Cuscinetto

Confirm that an order was imported into WooCommerce.

POST /woocommerce/webhooks/subscribe Chiave + Cuscinetto

Register a signed HTTPS WooCommerce webhook.

GET /woocommerce/webhooks/list Chiave + Cuscinetto

List active WooCommerce webhooks.

DELETE /woocommerce/webhooks/delete Chiave + Cuscinetto

Disable a WooCommerce webhook.

POST /woocommerce/webhooks/process Chiave + Cuscinetto

Process pending webhook deliveries with automatic retries.

GET /woocommerce/sync/logs Chiave + Cuscinetto

View the technical synchronisation log.

POST /shopify/categories/sync Chiave + Cuscinetto

Sync Shopify collections and product types.

POST /shopify/categories/archive Chiave + Cuscinetto

Archive a deleted Shopify collection.

POST /shopify/products/sync Chiave + Cuscinetto

Sync Shopify products, variants, images, prices, inventory and visibility.

PATCH /shopify/products/inventory Chiave + Cuscinetto

Quickly update Shopify prices, inventory or visibility.

POST /shopify/products/archive Chiave + Cuscinetto

Archive Shopify variants by identifier.

POST /shopify/products/archive-parent Chiave + Cuscinetto

Archive every variant of a deleted Shopify product.

POST /shopify/customers/sync Chiave + Cuscinetto

Sync Shopify customers without sending email.

POST /shopify/customers/redact Chiave + Cuscinetto

Redact customer data requested by Shopify.

GET /shopify/orders/feed Chiave + Cuscinetto

Retrieve SellViaApp orders not yet imported into Shopify.

POST /shopify/orders/acknowledge Chiave + Cuscinetto

Acknowledge a Shopify order import.

POST /shopify/webhooks/subscribe Chiave + Cuscinetto

Register the signed SellViaApp webhook for Shopify.

GET /shopify/webhooks/list Chiave + Cuscinetto

List Shopify connector webhooks.

DELETE /shopify/webhooks/delete Chiave + Cuscinetto

Disable a Shopify webhook.

POST /shopify/webhooks/process Chiave + Cuscinetto

Retry pending Shopify notifications.

GET /shopify/account Chiave + Cuscinetto

Identify the store and retrieve its mobile test account.

GET /shopify/sync/logs Chiave + Cuscinetto

View Shopify logs isolated from WooCommerce.

POST /wix/connect Pubblico

Connect a Wix instance to an existing SellViaApp Dashboard account.

GET /wix/account Chiave + Cuscinetto

Identify the SellViaApp account connected to Wix and its mobile test account.

POST /wix/disconnect Chiave + Cuscinetto

Revoke the connector token and disconnect Wix.

POST /wix/categories/sync Chiave + Cuscinetto

Synchronise Wix Stores V1/V3 categories or collections.

POST /wix/products/sync Chiave + Cuscinetto

Synchronise Wix products with images, prices, inventory and visibility.

PATCH /wix/products/inventory Chiave + Cuscinetto

Quickly update Wix prices, inventory or visibility.

POST /wix/products/archive Chiave + Cuscinetto

Archive deleted Wix products.

POST /wix/customers/sync Chiave + Cuscinetto

Synchronise Wix contacts without sending email.

POST /wix/customers/redact Chiave + Cuscinetto

Redact one or more synchronised Wix contacts.

POST /wix/privacy/shop-redact Chiave + Cuscinetto

Remove Wix-origin data after uninstall.

GET /wix/orders/feed Chiave + Cuscinetto

Read SellViaApp orders to reconcile with Wix.

POST /wix/orders/acknowledge Chiave + Cuscinetto

Record the result of a Wix order reconciliation.

POST /wix/webhooks/subscribe Chiave + Cuscinetto

Create a signed SellViaApp destination for the Wix connector.

GET /wix/webhooks/list Chiave + Cuscinetto

List SellViaApp webhooks for the Wix connector.

DELETE /wix/webhooks/delete Chiave + Cuscinetto

Disable a Wix connector webhook.

POST /wix/webhooks/process Chiave + Cuscinetto

Process pending SellViaApp deliveries for Wix.

GET /wix/sync/logs Chiave + Cuscinetto

View the isolated Wix synchronisation log.

POST /odoo/oauth/device/code Pubblico

Start an Odoo OAuth authorisation without sharing the SellViaApp password.

POST /odoo/oauth/device/token Pubblico

Exchange an approved device code for a revocable integration access token.

GET /odoo/account Chiave + Cuscinetto

Verify the SellViaApp account connected to the Odoo installation.

POST /odoo/disconnect Chiave + Cuscinetto

Immediately revoke this Odoo installation token.

POST /odoo/categories/sync Chiave + Cuscinetto

Synchronise the Odoo category hierarchy.

POST /odoo/categories/archive Chiave + Cuscinetto

Hide Odoo categories removed from the catalogue.

POST /odoo/products/sync Chiave + Cuscinetto

Synchronise Odoo variants, references, descriptions, translations, images, prices, VAT and stock.

PATCH /odoo/products/inventory Chiave + Cuscinetto

Quickly update Odoo prices, stock and visibility.

POST /odoo/products/archive Chiave + Cuscinetto

Hide removed Odoo products, categories or subcategories.

POST /odoo/customers/sync Chiave + Cuscinetto

Send Odoo contacts to SellViaApp and prepare their mobile access.

POST /odoo/customers/feed Chiave + Cuscinetto

Retrieve SellViaApp customers for duplicate-safe reconciliation with Odoo contacts.

POST /odoo/orders/feed Chiave + Cuscinetto

Retrieve confirmed SellViaApp orders in Odoo.

POST /odoo/orders/acknowledge Chiave + Cuscinetto

Record the result of an Odoo order import.

GET /odoo/sync/logs Chiave + Cuscinetto

View the isolated Odoo synchronisation log.

Reference

Responses and errors

Each row has a “Parameters and responses” button showing required or optional fields, possible statuses and JSON examples. An empty list means the resource is not populated yet, not that the endpoint is down.

400Richiesta non valida
401Autenticazione richiesta
403Accesso negato
404Risorse o percorso non trovato
409conflitto commerciale
422Mancato il mancato convalida
429Troppe richieste
5xxxxIncidenza tecnica

Area di lavoro API

Endpoint

GET

Il codice generato contiene le credenziali inserite. Conservale sul server e non condividere mai uno screenshot senza oscurarle.

Pronto per il test