Artículo 8 de 8
El stock de un minorista
Los relojes de su stock, incluidos los que un fabricante le ha confiado: listarlos, encontrar uno y transferir un reloj aún no vendido a otro minorista de su fabricante.
Lo que contiene su stock
Como minorista, su lista contiene los relojes que ha creado, los que son de su propiedad y los de su stock: los relojes que un fabricante ha colocado en su tienda, pasaportes o relojes aún sin tarjeta. Solo el fabricante coloca un reloj en su stock o lo retira.
Un reloj de su stock le está confiado mientras no se haya vendido: no hay ninguna venta declarada y nadie más que su fabricante es su propietario. Una venta declarada a un comprador cuenta, incluso antes de que este la confirme.
Listar su stock
GET / con origin=entrusted devuelve los relojes que le han confiado, con o sin tarjeta, y origin=own el resto de su lista; sin origin, recibe ambos. origin solo se lee para la cuenta de un minorista.
La lista llega página a página: page desde 0, size filas por página, 20 por defecto. sort la ordena: recent (los últimos actualizados primero, por defecto), brand (las marcas de la A a la Z, luego el modelo) o created (los últimos creados primero). totalCertificatesCount cuenta las filas de todas las páginas, salvo 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"En un reloj que le han confiado, la fila indica:
watchMakerUser: su fabricante, con su id, su rol y el nombre de su empresa;entrustedBy: quién se lo ha confiado, su fabricante o el minorista que se lo ha transferido;entrustedAt: desde cuándo está en su stock;canTransferToRetailer: si puede transferirlo ahora (véase más abajo);serialCase: su número de serie de la caja, completo;externalRef:null. Una referencia solo la lee la cuenta que creó el reloj, aquí su fabricante.
La llamada necesita su clave API, en el encabezado api-key, con el ámbito Relojes (watches). Sin el ámbito Clientes, las filas conservan los datos del reloj, pero las personas que contienen, su propietario por ejemplo, vuelven como null.
Encontrar un reloj
Añada estos parámetros a origin=entrusted para quedarse entre los relojes que le han confiado. Un filtro solo reduce su lista: nunca alcanza el stock de otro minorista ni los demás relojes del fabricante.
- Una búsqueda:
searchText, palabra por palabra, cada palabra en cualquier parte de la marca, el modelo, la referencia, el id de la tarjeta o el número de serie de la caja (no el del movimiento), y en los nombres del propietario y del minorista; - Ids exactos:
certificateCardIdspara ids de tarjeta (9 letras o cifras cada uno),watchIdspara ids de reloj. Se devuelve una fila que coincida con cualquiera de ellos; - La marca, el modelo, la referencia:
brands,modelsyreferences, por el inicio del texto, sin distinguir mayúsculas; - La última actualización:
startDateen o después de una fecha,endDateen o antes de una fecha.
curl "https://api.watchcertificate.org/api/v1/certificates/list?origin=entrusted&searchText=AB12345" \
-H "api-key: YOUR_API_KEY"Su propia referencia solo encuentra los relojes que usted ha creado: externalRefs en la lista, GET / y GET /. Un reloj que le han confiado lleva la referencia de su fabricante, que usted no ve: encuéntrelo por su id de tarjeta, su id de reloj o su número de serie de la caja.
Leer un reloj
GET / lee un pasaporte, GET / un reloj aún sin tarjeta: los mismos campos que en la lista, canTransferToRetailer incluido. Un id de tarjeta o de reloj que no existe responde 404.
Elegir el minorista que lo recibe
GET / con certificateCardId, o watchId para un reloj aún sin tarjeta, lista los minoristas a los que puede transferirlo: los demás minoristas activos de su fabricante. Cada fila da solo su id y el nombre, la ciudad y el país de su empresa, y searchText los filtra por nombre o ciudad. Ese id es el userId de la transferencia.
Esta llamada rechaza un reloj que la transferencia rechazaría, fuera de su stock o vendido, con los mismos códigos (más abajo). Su clave necesita el ámbito Red (network).
curl "https://api.watchcertificate.org/api/v1/users/list?usersListFilter=transfer-retailers&certificateCardId=ABC123456" \
-H "api-key: YOUR_API_KEY"Transferir un reloj aún no vendido
POST / para un pasaporte, POST / para un reloj aún sin tarjeta, sin cuerpo: userId es el minorista que lo recibe. Un reloj cuya tarjeta se ha vinculado desde entonces sigue respondiendo a su id de reloj. Su clave necesita el ámbito Red (network), y una clave de solo lectura no transfiere.
La transferencia se realiza cuando:
- el reloj está en su stock y su fabricante le sigue contando entre sus minoristas activos;
- aún no se ha vendido, en el sentido definido más arriba;
- el minorista que lo recibe es otro minorista activo del mismo fabricante: nunca usted mismo, nunca el minorista de otro fabricante.
Una transferencia se queda entre los minoristas del fabricante del reloj, y solo el fabricante retira un reloj.
curl -X POST https://api.watchcertificate.org/api/v1/users/1234/certificates/ABC123456/transfer \
-H "api-key: YOUR_API_KEY"La respuesta, 201, es el minorista que lo recibe, tal como lo muestra la lista de minoristas de arriba:
{
"id": 1234,
"company": {
"name": "Boutique Exemple",
"city": "Lyon",
"countryCode": "FR"
}
}El reloj pasa al stock del minorista que lo recibe y le queda confiado desde ese momento; su entrustedBy le nombra a usted. Nada más cambia: su fabricante, su propietario y su tarjeta siguen siendo los mismos.
Todo se comprueba antes de escribir nada: tras un error, el reloj no se ha movido. Un id de tarjeta o de reloj desconocido responde 404; los demás rechazos, en el orden en que se comprueban:
| Código HTTP | code | Qué significa |
|---|---|---|
| 403 | RETAILER_ | Las transferencias entre minoristas no están abiertas en este entorno. |
| 403 | RETAILER_ | El reloj no está en su stock, o su fabricante ya no le cuenta entre sus minoristas activos. |
| 409 | RETAILER_ | El reloj está vendido: hay una venta declarada, o alguien distinto de su fabricante es su propietario, incluido un comprador que aún no ha confirmado. |
| 400 | RETAILER_ | El minorista que lo recibe es usted. |
| 403 | RETAILER_ | El minorista que lo recibe no es un minorista activo del fabricante del reloj, o ninguna cuenta tiene este id. |
| 409 | OWNERSHIP_ | El reloj cambió durante la transferencia: una venta declarada, su fabricante que lo retira, o uno de los dos minoristas que sale de su lista. No se ha escrito nada. |
Qué ocurre después
El minorista destinatario recibe un correo electrónico que le indica que el reloj ha llegado a su stock, y el fabricante otro que le indica que se ha transferido; los movimientos de los mismos diez minutos llegan en un solo correo. Usted no recibe ninguno.
La transferencia no añade nada al historial del pasaporte y no consume ningún crédito.