Iniciar sesiónRun in Postman

DocumentaciónWishlists

Wishlists

Bearer · scope wishlists

Listas de deseos de tus clientes y los productos que guardan, con su precio y disponibilidad.

GET/api/v1/wishlists

Listas del cliente

Bearerscope: wishlists

Lista las listas de deseos del cliente con los productos que contiene cada una.

curl 'https://developers.syscom.mx/api/v1/wishlists' \
  -H 'Authorization: Bearer TU_TOKEN'

Códigos de estado

200

Arreglo de listas ([] si el cliente no tiene ninguna).

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o sin scope wishlists.

429

Límite de peticiones excedido.

500

Error interno.

POST/api/v1/wishlists

Crear lista

Bearerscope: wishlists

Crea una lista de deseos con un nombre y, si quieres, productos iniciales.

curl -X POST https://developers.syscom.mx/api/v1/wishlists \
  -H 'Authorization: Bearer TU_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "nombre": "Proyecto escuela", "productos": [12345] }'

Parámetros de consulta

monedastring

usd (def.) o mxn. Alias: mxn=1.

ivaflag

iva=1 → precios con IVA (×1.16).

financieroflag

financiero=1 → aplica descuento financiero a los precios.

inventariosflag

inventarios=1 → llena existencia.detalle (objeto por asterisco → almacén → cantidad); sin él detalle es [].

Cuerpo de la petición

nombrestringrequerido

Nombre de la lista (10–255 caracteres).

productosnumber[]requerido

IDs de producto iniciales ([] si ninguno).

Códigos de estado

201

Lista creada con sus productos.

400

Body inválido (nombre 10–255 y productos[] requeridos).

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o sin scope wishlists.

429

Límite de peticiones excedido.

500

Error interno (p. ej. un producto inicial no existe).

GET/api/v1/wishlists/{id}

Detalle de lista

Bearerscope: wishlists

Muestra una lista de deseos con sus productos completos, incluyendo precio y disponibilidad.

curl 'https://developers.syscom.mx/api/v1/wishlists/12?iva=1' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

idnumberrequerido

ID de la lista.

Parámetros de consulta

monedastring

usd (def.) o mxn. Alias: mxn=1.

ivaflag

iva=1 → precios con IVA (×1.16).

financieroflag

financiero=1 → aplica descuento financiero a los precios.

inventariosflag

inventarios=1 → llena existencia.detalle (objeto por asterisco → almacén → cantidad); sin él detalle es [].

Códigos de estado

200

Lista con sus productos completos.

400

id inválido.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o sin scope wishlists.

404

Lista no encontrada (o de otro cliente).

429

Límite de peticiones excedido.

500

Error interno.

DELETE/api/v1/wishlists/{id}

Eliminar lista

Bearerscope: wishlists

Elimina una lista de deseos del cliente y todos sus productos.

curl -X DELETE https://developers.syscom.mx/api/v1/wishlists/12 \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

idnumberrequerido

ID de la lista.

Códigos de estado

200

Lista eliminada.

400

id inválido.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o sin scope wishlists.

404

Lista no encontrada (o de otro cliente).

429

Límite de peticiones excedido.

500

Error interno.

POST/api/v1/wishlists/{id}/productos/{productoId}

Agregar producto

Bearerscope: wishlists

Agrega un producto a una lista de deseos. Si ya estaba, actualiza su precio. Devuelve la lista al día.

curl -X POST https://developers.syscom.mx/api/v1/wishlists/12/productos/12345 \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

idnumberrequerido

ID de la lista.

productoIdnumberrequerido

ID del producto.

Parámetros de consulta

monedastring

usd (def.) o mxn. Alias: mxn=1.

ivaflag

iva=1 → precios con IVA (×1.16).

financieroflag

financiero=1 → aplica descuento financiero a los precios.

inventariosflag

inventarios=1 → llena existencia.detalle (objeto por asterisco → almacén → cantidad); sin él detalle es [].

Códigos de estado

200

Producto agregado; devuelve la lista actualizada.

400

id o productoId inválidos.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o sin scope wishlists.

404

Lista no encontrada (o de otro cliente).

429

Límite de peticiones excedido.

500

Error interno (p. ej. el producto no existe).

DELETE/api/v1/wishlists/{id}/productos/{productoId}

Quitar producto

Bearerscope: wishlists

Quita un producto de una lista de deseos y devuelve la lista al día.

curl -X DELETE https://developers.syscom.mx/api/v1/wishlists/12/productos/12345 \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

idnumberrequerido

ID de la lista.

productoIdnumberrequerido

ID del producto.

Parámetros de consulta

monedastring

usd (def.) o mxn. Alias: mxn=1.

ivaflag

iva=1 → precios con IVA (×1.16).

financieroflag

financiero=1 → aplica descuento financiero a los precios.

inventariosflag

inventarios=1 → llena existencia.detalle (objeto por asterisco → almacén → cantidad); sin él detalle es [].

Códigos de estado

200

Producto quitado; devuelve la lista actualizada.

400

id o productoId inválidos.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso o sin scope wishlists.

404

Lista no encontrada (o de otro cliente).

429

Límite de peticiones excedido.

500

Error interno.

AnteriorContenido