Articolo 8 di 8
Lo stock di un rivenditore
Gli orologi del tuo stock, compresi quelli che una manifattura ti ha affidato: elencarli, ritrovarne uno e trasferire un orologio non ancora venduto a un altro rivenditore della sua manifattura.
Cosa contiene il tuo stock
Come rivenditore, il tuo elenco contiene gli orologi che hai creato, quelli di cui sei proprietario e quelli del tuo stock: gli orologi che una manifattura ha messo presso di te, passaporti o orologi ancora senza carta. Solo la manifattura mette un orologio nel tuo stock o lo riprende.
Un orologio del tuo stock ti è affidato finché non è venduto: nessuna vendita è dichiarata e nessuno ne è proprietario tranne la sua manifattura. Una vendita dichiarata a un acquirente conta, anche prima che la confermi.
Elencare il tuo stock
GET / con origin=entrusted restituisce gli orologi che ti sono affidati, con o senza carta, e origin=own il resto del tuo elenco; senza origin, ricevi entrambi. origin viene letto solo per l'account di un rivenditore.
L'elenco arriva una pagina alla volta: page da 0, size righe per pagina, 20 per impostazione predefinita. sort lo ordina: recent (gli ultimi aggiornati prima, per impostazione predefinita), brand (le marche dalla A alla Z, poi il modello) o created (gli ultimi creati prima). totalCertificatesCount conta le righe di tutte le pagine, tranne con format=medium o format=extra_small.
curl "https://api.watchcertificate.org/api/v1/certificates/list?origin=entrusted&page=0&size=20&sort=recent" \
-H "api-key: YOUR_API_KEY"Su un orologio che ti è affidato, la riga indica:
watchMakerUser: la sua manifattura, con il suo id, il suo ruolo e il nome della sua azienda;entrustedBy: chi te l'ha affidato, la sua manifattura o il rivenditore che te l'ha trasferito;entrustedAt: da quando è nel tuo stock;canTransferToRetailer: se puoi trasferirlo ora (vedi sotto);serialCase: il suo numero di serie sulla cassa, in chiaro;externalRef:null. Un riferimento è letto solo dall'account che ha creato l'orologio, qui la sua manifattura.
La chiamata richiede la tua chiave API, nell'intestazione api-key, con l'ambito Orologi (watches). Senza l'ambito Clienti, le righe mantengono i dati dell'orologio, ma le persone che contengono, ad esempio il suo proprietario, tornano come null.
Ritrovare un orologio
Aggiungi questi parametri a origin=entrusted per restare tra gli orologi che ti sono affidati. Un filtro restringe solo il tuo elenco: non raggiunge mai lo stock di un altro rivenditore, né gli altri orologi della manifattura.
- Una ricerca:
searchText, parola per parola, ogni parola in qualsiasi punto della marca, del modello, del riferimento, dell'id della carta o del numero di serie sulla cassa (non quello del movimento), e nei nomi del proprietario e del rivenditore; - Id esatti:
certificateCardIdsper gli id delle carte (9 lettere o cifre ciascuno),watchIdsper gli id degli orologi. Viene restituita una riga che corrisponde a uno qualsiasi di essi; - La marca, il modello, il riferimento:
brands,modelsereferences, per l'inizio del testo, senza distinzione tra maiuscole e minuscole; - L'ultimo aggiornamento:
startDatein o dopo una data,endDatein o prima di una data.
curl "https://api.watchcertificate.org/api/v1/certificates/list?origin=entrusted&searchText=AB12345" \
-H "api-key: YOUR_API_KEY"Il tuo riferimento ritrova solo gli orologi che hai creato: externalRefs nell'elenco, GET / e GET /. Un orologio che ti è affidato porta il riferimento della sua manifattura, che non vedi: ritrovalo con l'id della sua carta, il suo id dell'orologio o il suo numero di serie sulla cassa.
Leggere un orologio
GET / legge un passaporto, GET / un orologio ancora senza carta: gli stessi campi dell'elenco, canTransferToRetailer compreso. Un id di carta o di orologio che non esiste risponde 404.
Scegliere il rivenditore che lo riceve
GET / con certificateCardId, o watchId per un orologio ancora senza carta, elenca i rivenditori a cui puoi trasferirlo: gli altri rivenditori attivi della sua manifattura. Ogni riga dà solo il suo id e il nome, la città e il paese della sua azienda, e searchText li filtra per nome o città. Quell'id è l'userId del trasferimento.
Questa chiamata rifiuta un orologio che il trasferimento rifiuterebbe, fuori dal tuo stock o venduto, con gli stessi codici (sotto). La tua chiave ha bisogno dell'ambito Rete (network).
curl "https://api.watchcertificate.org/api/v1/users/list?usersListFilter=transfer-retailers&certificateCardId=ABC123456" \
-H "api-key: YOUR_API_KEY"Trasferire un orologio non ancora venduto
POST / per un passaporto, POST / per un orologio ancora senza carta, senza corpo: userId è il rivenditore che lo riceve. Un orologio la cui carta è stata collegata nel frattempo risponde ancora al suo id dell'orologio. La tua chiave ha bisogno dell'ambito Rete (network), e una chiave in sola lettura non trasferisce.
Il trasferimento va a buon fine quando:
- l'orologio è nel tuo stock e la sua manifattura ti conta ancora tra i suoi rivenditori attivi;
- non è ancora venduto, nel senso definito sopra;
- il rivenditore che lo riceve è un altro rivenditore attivo della stessa manifattura: mai tu stesso, mai il rivenditore di un'altra manifattura.
Un trasferimento resta tra i rivenditori della manifattura dell'orologio, e solo la manifattura riprende un orologio.
curl -X POST https://api.watchcertificate.org/api/v1/users/1234/certificates/ABC123456/transfer \
-H "api-key: YOUR_API_KEY"La risposta, 201, è il rivenditore che lo riceve, come lo mostra l'elenco dei rivenditori qui sopra:
{
"id": 1234,
"company": {
"name": "Boutique Exemple",
"city": "Lyon",
"countryCode": "FR"
}
}L'orologio passa nello stock del rivenditore che lo riceve e gli è affidato da quel momento; il suo entrustedBy indica te. Nient'altro cambia: la sua manifattura, il suo proprietario e la sua carta restano gli stessi.
Tutto viene verificato prima di scrivere qualsiasi cosa: dopo un errore, l'orologio non si è mosso. Un id di carta o di orologio sconosciuto risponde 404; gli altri rifiuti, nell'ordine in cui sono verificati:
| Codice HTTP | code | Cosa significa |
|---|---|---|
| 403 | RETAILER_ | I trasferimenti tra rivenditori non sono aperti in questo ambiente. |
| 403 | RETAILER_ | L'orologio non è nel tuo stock, o la sua manifattura non ti conta più tra i suoi rivenditori attivi. |
| 409 | RETAILER_ | L'orologio è venduto: una vendita è dichiarata, o qualcuno diverso dalla sua manifattura ne è proprietario, compreso un acquirente che non ha ancora confermato. |
| 400 | RETAILER_ | Il rivenditore che lo riceve sei tu. |
| 403 | RETAILER_ | Il rivenditore che lo riceve non è un rivenditore attivo della manifattura dell'orologio, o nessun account ha questo id. |
| 409 | OWNERSHIP_ | L'orologio è cambiato durante il trasferimento: una vendita dichiarata, la sua manifattura che lo riprende, o uno dei due rivenditori che lascia il suo elenco. Non è stato scritto nulla. |
Cosa succede dopo
Il rivenditore destinatario riceve un'email che gli dice che l'orologio è arrivato nel suo stock, e la manifattura una che le dice che è stato trasferito; i movimenti degli stessi dieci minuti arrivano in un'unica email. Tu non ne ricevi nessuna.
Il trasferimento non aggiunge nulla alla storia del passaporto e non consuma alcun credito.