Artikel 8 von 8
Der Bestand eines Fachhändlers
Die Uhren in Ihrem Bestand, auch die, die Ihnen ein Hersteller anvertraut hat: sie auflisten, eine davon finden und eine noch nicht verkaufte Uhr an einen anderen Fachhändler ihres Herstellers übertragen.
Was Ihr Bestand enthält
Als Fachhändler enthält Ihre Liste die Uhren, die Sie erstellt haben, die, deren Eigentümer Sie sind, und die Ihres Bestands: die Uhren, die ein Hersteller bei Ihnen platziert hat, Uhrenpässe oder Uhren noch ohne Karte. Nur der Hersteller legt eine Uhr in Ihren Bestand oder nimmt sie zurück.
Eine Uhr Ihres Bestands ist Ihnen anvertraut, solange sie nicht verkauft ist: Es ist kein Verkauf gemeldet, und niemand außer ihrem Hersteller ist ihr Eigentümer. Ein an einen Käufer gemeldeter Verkauf zählt, auch bevor dieser ihn bestätigt.
Ihren Bestand auflisten
GET / mit origin=entrusted gibt die Ihnen anvertrauten Uhren zurück, mit oder ohne Karte, und origin=own den Rest Ihrer Liste; ohne origin erhalten Sie beides. origin wird nur für das Konto eines Fachhändlers gelesen.
Die Liste kommt seitenweise: page ab 0, size Zeilen pro Seite, standardmäßig 20. sort sortiert sie: recent (zuletzt aktualisierte zuerst, standardmäßig), brand (Marken von A bis Z, dann das Modell) oder created (zuletzt erstellte zuerst). totalCertificatesCount zählt die Zeilen aller Seiten, außer mit format=medium oder 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"Bei einer Ihnen anvertrauten Uhr gibt die Zeile an:
watchMakerUser: ihr Hersteller, mit seiner ID, seiner Rolle und dem Namen seines Unternehmens;entrustedBy: wer sie Ihnen anvertraut hat, ihr Hersteller oder der Fachhändler, der sie Ihnen übertragen hat;entrustedAt: seit wann sie in Ihrem Bestand ist;canTransferToRetailer: ob Sie sie jetzt übertragen können (siehe unten);serialCase: ihre Seriennummer des Gehäuses, im Klartext;externalRef:null. Eine Referenz liest nur das Konto, das die Uhr erstellt hat, hier ihr Hersteller.
Der Aufruf benötigt Ihren API-Schlüssel im Header api-key, mit dem Bereich Uhren (watches). Ohne den Bereich Kunden behalten die Zeilen die Daten der Uhr, aber die Personen darin, etwa ihr Eigentümer, kommen als null zurück.
Eine Uhr finden
Fügen Sie diese Parameter zu origin=entrusted hinzu, um bei den Ihnen anvertrauten Uhren zu bleiben. Ein Filter verkleinert nur Ihre Liste: Er erreicht nie den Bestand eines anderen Fachhändlers und auch nicht die anderen Uhren des Herstellers.
- Eine Suche:
searchText, Wort für Wort, jedes Wort an beliebiger Stelle in Marke, Modell, Referenz, Karten-ID oder Seriennummer des Gehäuses (nicht der des Uhrwerks) sowie in den Namen des Eigentümers und des Fachhändlers; - Exakte IDs:
certificateCardIdsfür Karten-IDs (je 9 Buchstaben oder Ziffern),watchIdsfür Uhren-IDs. Eine Zeile, die einer davon entspricht, wird zurückgegeben; - Marke, Modell, Referenz:
brands,modelsundreferences, nach dem Textanfang, ohne Beachtung der Groß- und Kleinschreibung; - Die letzte Aktualisierung:
startDatean oder nach einem Datum,endDatean oder vor einem Datum.
curl "https://api.watchcertificate.org/api/v1/certificates/list?origin=entrusted&searchText=AB12345" \
-H "api-key: YOUR_API_KEY"Ihre eigene Referenz findet nur die Uhren, die Sie erstellt haben: externalRefs in der Liste, GET / und GET /. Eine Ihnen anvertraute Uhr trägt die Referenz ihres Herstellers, die Sie nicht sehen: Finden Sie sie über ihre Karten-ID, ihre Uhren-ID oder die Seriennummer ihres Gehäuses.
Eine Uhr lesen
GET / liest einen Uhrenpass, GET / eine Uhr noch ohne Karte: dieselben Felder wie in der Liste, canTransferToRetailer inbegriffen. Eine Karten-ID oder Uhren-ID, die nicht existiert, antwortet mit 404.
Den empfangenden Fachhändler wählen
GET / mit certificateCardId, oder watchId für eine Uhr noch ohne Karte, listet die Fachhändler auf, an die Sie sie übertragen können: die anderen aktiven Fachhändler ihres Herstellers. Jede Zeile enthält nur ihre id sowie Name, Stadt und Land ihres Unternehmens, und searchText filtert sie nach Name oder Stadt. Diese id ist die userId der Übertragung.
Dieser Aufruf lehnt eine Uhr ab, die auch die Übertragung ablehnen würde, weil sie nicht in Ihrem Bestand oder verkauft ist, mit denselben Codes (unten). Ihr Schlüssel benötigt den Bereich Netzwerk (network).
curl "https://api.watchcertificate.org/api/v1/users/list?usersListFilter=transfer-retailers&certificateCardId=ABC123456" \
-H "api-key: YOUR_API_KEY"Eine noch nicht verkaufte Uhr übertragen
POST / für einen Uhrenpass, POST / für eine Uhr noch ohne Karte, ohne Body: userId ist der empfangende Fachhändler. Eine Uhr, deren Karte inzwischen verknüpft wurde, ist weiterhin über ihre Uhren-ID erreichbar. Ihr Schlüssel benötigt den Bereich Netzwerk (network), und ein Schlüssel mit „Nur Lesen“ überträgt nicht.
Die Übertragung gelingt, wenn:
- die Uhr in Ihrem Bestand ist und ihr Hersteller Sie weiterhin zu seinen aktiven Fachhändlern zählt;
- sie im oben beschriebenen Sinn noch nicht verkauft ist;
- der empfangende Fachhändler ein anderer aktiver Fachhändler desselben Herstellers ist: nie Sie selbst, nie der Fachhändler eines anderen Herstellers.
Eine Übertragung bleibt unter den Fachhändlern des Herstellers der Uhr, und nur der Hersteller nimmt eine Uhr zurück.
curl -X POST https://api.watchcertificate.org/api/v1/users/1234/certificates/ABC123456/transfer \
-H "api-key: YOUR_API_KEY"Die Antwort, 201, ist der empfangende Fachhändler, so wie ihn die Liste der Fachhändler oben zeigt:
{
"id": 1234,
"company": {
"name": "Boutique Exemple",
"city": "Lyon",
"countryCode": "FR"
}
}Die Uhr geht in den Bestand des empfangenden Fachhändlers über und ist ihm ab dann anvertraut; ihr entrustedBy nennt Sie. Sonst ändert sich nichts: Hersteller, Eigentümer und Karte der Uhr bleiben dieselben.
Alles wird geprüft, bevor etwas geschrieben wird: Nach einem Fehler hat sich die Uhr nicht bewegt. Eine unbekannte Karten-ID oder Uhren-ID antwortet mit 404; die anderen Ablehnungen, in der Reihenfolge ihrer Prüfung:
| HTTP-Code | code | Was es bedeutet |
|---|---|---|
| 403 | RETAILER_ | Übertragungen zwischen Fachhändlern sind in dieser Umgebung nicht freigegeben. |
| 403 | RETAILER_ | Die Uhr ist nicht in Ihrem Bestand, oder ihr Hersteller zählt Sie nicht mehr zu seinen aktiven Fachhändlern. |
| 409 | RETAILER_ | Die Uhr ist verkauft: Ein Verkauf ist gemeldet, oder jemand anderes als ihr Hersteller ist ihr Eigentümer, auch ein Käufer, der noch nicht bestätigt hat. |
| 400 | RETAILER_ | Der empfangende Fachhändler sind Sie selbst. |
| 403 | RETAILER_ | Der empfangende Fachhändler ist kein aktiver Fachhändler des Herstellers der Uhr, oder kein Konto hat diese ID. |
| 409 | OWNERSHIP_ | Die Uhr hat sich während der Übertragung geändert: ein gemeldeter Verkauf, ihr Hersteller, der sie zurücknimmt, oder einer der beiden Fachhändler, der seine Liste verlässt. Nichts wurde geschrieben. |
Was danach geschieht
Der empfangende Fachhändler erhält eine E-Mail, dass die Uhr in seinem Bestand angekommen ist, und der Hersteller eine, dass sie übertragen wurde; die Bewegungen derselben zehn Minuten kommen in einer einzigen E-Mail. Sie erhalten keine.
Die Übertragung fügt der Historie des Uhrenpasses nichts hinzu und verbraucht keine Credits.