# SYSCOM API v1 > API REST para integrar el catálogo y las operaciones de SYSCOM: productos, precios, existencias, facturas, carrito y más. Incluye búsqueda semántica de productos en lenguaje natural, ideal para agentes de IA. Autenticación OAuth2 client_credentials + Bearer. Base de la API: https://developers.syscom.mx/api/v1 ## Autenticación - [Generar token](https://developers.syscom.mx/docs/autenticacion#oauth-token): Genera el token de acceso (válido por un año) que debes enviar en cada llamada protegida. ## Endpoints ### Categorías - [GET /api/v1/categorias](https://developers.syscom.mx/docs/categorias#categorias-lista): Lista las categorías principales del catálogo. - [GET /api/v1/categorias/{id}](https://developers.syscom.mx/docs/categorias#categorias-detalle): Muestra una categoría junto con la ruta de categorías a la que pertenece y sus subcategorías. ### Carrito - [POST /api/v1/carrito/generar](https://developers.syscom.mx/docs/carrito#carrito-generar): Cotiza un carrito con precios, descuentos y costo de envío ya calculados. - [POST /api/v1/carrito/guia](https://developers.syscom.mx/docs/carrito#carrito-guia): Sube tu guía de envío prepagada a tus pedidos: el pedido queda marcado para enviarse con tu paquetería (sin mensajería de SYSCOM). - [GET /api/v1/carrito/direcciones](https://developers.syscom.mx/docs/carrito#direcciones-lista): Lista las direcciones de envío guardadas del cliente. - [POST /api/v1/carrito/direcciones](https://developers.syscom.mx/docs/carrito#direcciones-crear): Guarda una nueva dirección de envío. - [PUT /api/v1/carrito/direcciones/{id}](https://developers.syscom.mx/docs/carrito#direcciones-actualizar): Actualiza una dirección de envío. - [DELETE /api/v1/carrito/direcciones/{id}](https://developers.syscom.mx/docs/carrito#direcciones-eliminar): Elimina una dirección de envío del cliente. ### Facturas - [GET /api/v1/facturas](https://developers.syscom.mx/docs/facturas#facturas-lista): Lista las facturas del cliente con el avance de su entrega. - [GET /api/v1/facturas/guias](https://developers.syscom.mx/docs/facturas#facturas-guias): Lista las guías de envío del cliente. - [GET /api/v1/facturas/{id}](https://developers.syscom.mx/docs/facturas#facturas-detalle): Muestra el detalle completo de una factura: datos de envío, guías, productos y totales. - [GET /api/v1/facturas/{anio}/{id}](https://developers.syscom.mx/docs/facturas#facturas-detalle-anio): Igual que el detalle de factura, pero para folios que incluyen el año (por ejemplo FA26/000000). ### Marcas - [GET /api/v1/marcas](https://developers.syscom.mx/docs/marcas#marcas-lista): Lista todas las marcas del catálogo, para filtros y navegación por marca. - [GET /api/v1/marcas/{marca}](https://developers.syscom.mx/docs/marcas#marcas-detalle): Muestra la información de una marca: nombre, descripción, logo y las categorías donde tiene productos. - [GET /api/v1/marcas/{marca}/productos](https://developers.syscom.mx/docs/marcas#marcas-productos): Lista los productos de una marca (hasta 60 por página), con su precio y disponibilidad. ### Productos - [GET /api/v1/productos](https://developers.syscom.mx/docs/productos#productos-buscar): Busca productos del catálogo por categoría, marca o palabra clave. - [GET /api/v1/productos/busqueda-ia](https://developers.syscom.mx/docs/productos#productos-busqueda-ia): 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 no… - [GET /api/v1/productos/{id}](https://developers.syscom.mx/docs/productos#productos-detalle): Muestra la ficha completa de un producto: precio, disponibilidad, descripción, características, imágenes y documentos. - [GET /api/v1/productos/{id}/relacionados](https://developers.syscom.mx/docs/productos#productos-relacionados): Lista los productos relacionados con uno dado, ideales para sugerir alternativas. - [GET /api/v1/productos/{id}/accesorios](https://developers.syscom.mx/docs/productos#productos-accesorios): Lista los accesorios compatibles con un producto (hasta 5), útiles para venta complementaria. - [GET /api/v1/productos?modelo={modelo}](https://developers.syscom.mx/docs/productos#productos-modelo): Consulta un producto por su modelo/SKU exacto y obtén su precio y disponibilidad. ### Catálogos de referencia - [GET /api/v1/tipocambio](https://developers.syscom.mx/docs/catalogos#tipocambio): Tipo de cambio vigente (normal, preferencial y por plazos) para convertir precios a pesos. - [GET /api/v1/sucursales](https://developers.syscom.mx/docs/catalogos#sucursales): Lista las sucursales de Syscom en México, con su nombre e identificador. - [GET /api/v1/carrito/paises](https://developers.syscom.mx/docs/catalogos#carrito-paises): Países disponibles para las direcciones de envío. - [GET /api/v1/carrito/estados/{cp}](https://developers.syscom.mx/docs/catalogos#carrito-estados): Devuelve el estado y el municipio que corresponden a un código postal. - [GET /api/v1/carrito/colonias/{cp}](https://developers.syscom.mx/docs/catalogos#carrito-colonias): Lista las colonias de un código postal. - [GET /api/v1/carrito/pago](https://developers.syscom.mx/docs/catalogos#carrito-pago): Formas de pago disponibles para el pedido (transferencia, pago en sucursal, crédito, etc.), con su descuento y plazo. - [GET /api/v1/carrito/fleteras](https://developers.syscom.mx/docs/catalogos#carrito-fleteras): Paqueterías disponibles para el envío, indicando cuáles ofrecen entrega al día siguiente. - [GET /api/v1/carrito/cfdi](https://developers.syscom.mx/docs/catalogos#carrito-cfdi): Usos de CFDI disponibles para la facturación del pedido. ### Contenido - [GET /api/v1/banners](https://developers.syscom.mx/docs/contenido#banners): Banners promocionales de la portada: los fijos y los del carrusel vigentes hoy. ### Wishlists - [GET /api/v1/wishlists](https://developers.syscom.mx/docs/wishlists#wishlists-lista): Lista las listas de deseos del cliente con los productos que contiene cada una. - [POST /api/v1/wishlists](https://developers.syscom.mx/docs/wishlists#wishlists-crear): Crea una lista de deseos con un nombre y, si quieres, productos iniciales. - [GET /api/v1/wishlists/{id}](https://developers.syscom.mx/docs/wishlists#wishlists-detalle): Muestra una lista de deseos con sus productos completos, incluyendo precio y disponibilidad. - [DELETE /api/v1/wishlists/{id}](https://developers.syscom.mx/docs/wishlists#wishlists-eliminar): Elimina una lista de deseos del cliente y todos sus productos. - [POST /api/v1/wishlists/{id}/productos/{productoId}](https://developers.syscom.mx/docs/wishlists#wishlists-agregar-producto): Agrega un producto a una lista de deseos. - [DELETE /api/v1/wishlists/{id}/productos/{productoId}](https://developers.syscom.mx/docs/wishlists#wishlists-quitar-producto): Quita un producto de una lista de deseos y devuelve la lista al día. ## Errores - [Errores y códigos de estado](https://developers.syscom.mx/docs/errores): contrato de error uniforme (JSON) y códigos HTTP semánticos. ## Optional - [Documentación completa en texto](https://developers.syscom.mx/llms-full.txt): todos los endpoints con parámetros, códigos de estado, cURL y ejemplos de respuesta en un solo archivo. - [Guía de inicio](https://developers.syscom.mx/guide): obtener el token y hacer la primera llamada.