Marcas

Bearer

Las marcas del catálogo: listado, información de cada marca y sus productos.

GET/api/v1/marcas

Lista de marcas

Bearer

Lista todas las marcas del catálogo, para filtros y navegación por marca.

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

Códigos de estado

200

OK; arreglo de marcas.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso (gate de distribuidor).

500

Error interno.

GET/api/v1/marcas/{marca}

Detalle de marca

Bearer

Muestra la información de una marca: nombre, descripción, logo y las categorías donde tiene productos.

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

Parámetros

marcastringrequerido

Slug de la marca (p. ej. hikvision).

Códigos de estado

200

OK; detalle de la marca.

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso (gate de distribuidor).

404

Marca no encontrada.

500

Error interno.

GET/api/v1/marcas/{marca}/productos

Productos de una marca

Bearer

Lista los productos de una marca (hasta 60 por página), con su precio y disponibilidad.

curl 'https://developers.syscom.mx/api/v1/marcas/hikvision/productos?limit=20&orden=precio:asc' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

marcastringrequerido

Slug de la marca (p. ej. hikvision).

Parámetros de consulta

limitnumber

Resultados por página. Tope 60. Default 60.

paginanumber

Página. Default 1.

ordenstring

relevancia (def.), precio:asc, precio:desc, modelo:asc, marca, bestseller…

monedastring

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

ivaflag

iva=1 → precios con IVA.

financieroflag

financiero=1 → aplica el ajuste financiero al precio.

stockflag

stock=true (o 1) → solo productos con existencia. Acepta true/false, 1/0 (no basta con solo enviarlo).

stock_nuevoflag

stock_nuevo=true (o 1) → solo productos con existencia nueva (no cuenta caja abierta). Acepta true/false, 1/0. No se combina con stock=true.

descripcionflag

Valor truthy (p. ej. descripcion=1) → agrega el campo descripcion (HTML) a cada producto.

inventariosflag

Valor truthy (p. ej. inventarios=1) → llena existencia.detalle[] con el desglose por almacén.

informacion_proflag

informacion_pro=true → agrega titulo_pro, descripcion_pro y caracteristicas_pro: versiones mejoradas del título, descripción y características.

agruparflag

agrupar=1 o agrupar=true. Aceptado por compatibilidad, sin efecto en este endpoint (las variantes salen siempre en atributos).

Códigos de estado

200

OK; página de productos de la marca.

400

Parámetros inválidos (p. ej. combinar stock y stock_nuevo).

401

Token ausente, inválido, expirado o revocado.

403

Cuenta sin acceso (gate de distribuidor).

404

Marca no encontrada.

500

Error interno.

AnteriorPedidos Siguiente Productos