Productos

Bearer · scope ver-productos

Consulta el catálogo: busca productos y revisa su ficha, precio y disponibilidad según tu cuenta.

GET/api/v1/productos

Buscar productos

Bearerscope: ver-productos

Busca productos del catálogo por categoría, marca o palabra clave. Cada resultado muestra su precio y disponibilidad según tu cuenta. Indica al menos una categoría, marca o palabra para realizar la búsqueda.

curl 'https://developers.syscom.mx/api/v1/productos?categoria=21,30&inventarios=true&pagina=1&limit=1000' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros de consulta

categoriastring (CSV)

Uno o varios IDs de categoría: 21,30. Une niveles 1/2/3. Solo dígitos y comas.

marcastring (CSV)

Uno o varios slugs de marca: hikvision,ubiquiti (solo [a-z0-9,]). Slug inexistente → 404.

busquedastring

Búsqueda por texto (motor de tags interno).

ordenstring

relevancia (def.), precio:asc, precio:desc, modelo:asc, modelo:desc, marca:asc, marca:desc, bestseller, topseller. También admite los alias sueltos marca, precio, modelo.

paginanumber

Página (1–1000). Default 1.

limitnumber

Resultados por página (10–1000). Default 60.

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.

sucursalstring (CSV)

Filtra por existencia en uno o varios almacenes (slug de sucursal: mexico, guadalajara…). Slug inexistente → 404.

monedastring

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

ivaflag

iva=1 → precios con IVA.

financieroflag

financiero=1 → aplica el descuento financiero al precio.

inventariosflag

Agrega existencia.detalle (desglose por almacén y condición); sin él, detalle es [].

descripcionflag

descripcion=1 → incluye el campo descripcion (HTML) en cada resultado.

informacion_proflag

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

Códigos de estado

200

OK.

400

Parámetros inválidos o faltan categoria/marca/busqueda.

401

Token ausente, inválido o revocado.

403

Scope ver-productos insuficiente o cuenta sin acceso.

404

Marca o sucursal no encontrada.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/productos/busqueda-ia

Búsqueda con IA

Nuevo · IA Bearerscope: ver-productos

Busca productos por intención en lenguaje natural (con IA), no solo por palabras exactas: describe lo que necesitas —"cámara domo para exterior con visión nocturna"— y obtén los más relevantes, con su precio y disponibilidad. Ideal para asistentes de IA (Claude Code, Cursor, Codex).

curl 'https://developers.syscom.mx/api/v1/productos/busqueda-ia?q=camara+domo+exterior+vision+nocturna&limit=10' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros de consulta

qstringrequerido

Consulta en lenguaje natural (3–256 caracteres). Ej.: "radio portátil uhf para brigada de rescate".

paginanumber

Página (1–1000). Default 1.

limitnumber

Resultados por página (1–60). Default 20.

stockflag

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

monedastring

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

ivaflag

iva=1 → precios con IVA.

financieroflag

financiero=1 → aplica el descuento financiero al precio.

inventariosflag

Agrega existencia.detalle (desglose por almacén y condición).

descripcionflag

descripcion=1 → incluye el campo descripcion (HTML) en cada resultado.

informacion_proflag

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

Códigos de estado

200

OK. Sin coincidencias → productos: [].

400

Parámetro q ausente o fuera de 3–256 caracteres.

401

Token ausente, inválido o revocado.

403

Scope ver-productos insuficiente o cuenta sin acceso.

429

Límite de peticiones de búsqueda con IA excedido (Retry-After).

503

Servicio de búsqueda con IA no disponible temporalmente.

500

Error interno.

GET/api/v1/productos/{id}

Ficha de producto

Bearerscope: ver-productos

Muestra la ficha completa de un producto: precio, disponibilidad, descripción, características, imágenes y documentos. Puedes consultar varios productos a la vez.

curl 'https://developers.syscom.mx/api/v1/productos/210627?iva=1&inventarios=1' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros

idstring (CSV)requerido

ID de producto, o varios separados por coma (hasta 300).

Parámetros de consulta

monedastring

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

ivaflag

iva=1 → precios con IVA.

financieroflag

financiero=1 → aplica el descuento financiero al precio.

inventariosflag

Agrega existencia.detalle (desglose por almacén y condición); sin él, detalle es [].

informacion_proflag

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

Códigos de estado

200

OK (objeto si 1 ID, arreglo si varios).

400

id inválido.

401

Token ausente, inválido o revocado.

403

Scope ver-productos insuficiente o cuenta sin acceso.

404

Ningún producto disponible (product_not_available).

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/productos/{id}/relacionados

Productos relacionados

Bearerscope: ver-productos

Lista los productos relacionados con uno dado, ideales para sugerir alternativas. Solo incluye los que tienen disponibilidad.

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

Parámetros

idnumberrequerido

ID del producto base.

Parámetros de consulta

monedastring

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

ivaflag

iva=1 → precios con IVA.

financieroflag

financiero=1 → aplica el descuento financiero.

inventariosflag

Agrega existencia.detalle (desglose por almacén); sin él, detalle es [].

informacion_proflag

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

Códigos de estado

200

OK (arreglo, vacío si no hay relacionados).

400

id inválido.

401

Token ausente, inválido o revocado.

403

Scope ver-productos insuficiente o cuenta sin acceso.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/productos/{id}/accesorios

Accesorios compatibles

Bearerscope: ver-productos

Lista los accesorios compatibles con un producto (hasta 5), útiles para venta complementaria.

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

Parámetros

idnumberrequerido

ID del producto base.

Parámetros de consulta

monedastring

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

ivaflag

iva=1 → precios con IVA.

financieroflag

financiero=1 → aplica el descuento financiero.

inventariosflag

Agrega existencia.detalle (desglose por almacén); sin él, detalle es [].

informacion_proflag

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

Códigos de estado

200

OK (arreglo, vacío si no hay accesorios).

400

id inválido.

401

Token ausente, inválido o revocado.

403

Scope ver-productos insuficiente o cuenta sin acceso.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/productos?modelo={modelo}

Producto por modelo (SKU)

Bearerscope: ver-productos

Consulta un producto por su modelo/SKU exacto y obtén su precio y disponibilidad. Funciona aunque el modelo lleve diagonal (ej. DS-2FA1205-C8/K).

curl -G 'https://developers.syscom.mx/api/v1/productos' \
  --data-urlencode 'modelo=DS-2FA1205-C8/K' \
  -H 'Authorization: Bearer TU_TOKEN'

Parámetros de consulta

modelostringrequerido

Modelo comercial o modelo limpio (cod_art). Admite diagonal.

monedastring

usd (default) | mxn.

Códigos de estado

200

OK (objeto si 1 coincidencia, arreglo si varias).

400

falta modelo (u otro filtro).

401

Token ausente, inválido o revocado.

404

Sin coincidencias para ese modelo.

AnteriorMarcas Siguiente Catálogos de referencia