API/POST/externalSale

POST {{apiURL}}/API/POST/externalSale?token={{apiToken}}

Endpoint che gestisce una vendita effettuata da un servizio esterno. I dati dei clienti possono essere passati in chiaro oppure tramite UUID (se il cliente esiste già sul nostro sistema). I due esempi relativi alla request sottolineano i differenti approcci.

Al momento non risulta possibile inserire una vendita senza collegarla a un cliente

@return {Object} obj
@return {String} obj.uuid: UUID univoco identificativo della vendita in db
@throws {Boom} .notFound: Se uno dei dispositivi venduti non viene trovato in db;

---

Gestione Vendite Esterne

Quando viene creata una vendita esterna il dealer potrà visualizzarla nella sezione Richieste Servizi Esterni del gestionale Secondhand.

Da questa pagina, il dealer, potrà effettuare lo scarico della vendita e le operazioni ad collegate es. attivazione garanzia, firma policy, aggiunta punti fedeltà etc.

Lo stato delle vendite può essere monitorato tramite l'endpoint /API/GET/externalSaleStatus/:sellIdentifier

Le vendite rimarranno nella sezione per solo 30 minuti

Request Params

Request Body

{"devices"=>[{"deviceUUID"=>"2e5ed0c2-acb8-4e94-87ab-e2efdc46b345", "price"=>168}, {"deviceUUID"=>"7d3a3925-5068-4d15-8977-396740a136c0", "price"=>119}], "clientUUID"=>"94248dd3-db9c-11e7-bc57-06a2f90ff7b1", "callbackURL"=>"www.google.com", "sellIdentifier"=>"35155168003145420230124044727"}

HEADERS

RESPONSES

status: OK

{"uuid":"459a8126-4394-41ea-baeb-1f5f39ed2b17"}