DocumentaciónGarantías y RMA
Garantías y RMA
Sigue tus garantías, reparaciones y devoluciones (RMA / órdenes de servicio) con el mismo estatus en lenguaje claro que ves en el panel de syscom.mx. Solo consulta.
Listado de órdenes
BearerLista todos tus casos de soporte, del más reciente al más antiguo: equipos que ya están en el laboratorio (orden de servicio) y solicitudes de RMA cuyo equipo todavía no llega a SYSCOM. Cada caso trae su estatus en lenguaje claro y lo que tienes que hacer, si aplica. Para ver todo el detalle de un caso usa la consulta por identificador. Ningún campo viene como `null`: lo que no aplica llega vacío (`""`, `{}`, `[]`, `0` o `false`). Las fechas van como `YYYY-MM-DD HH:MM:SS` en hora de México.
curl 'https://developers.syscom.mx/api/v1/soporte/ordenes?pagina=1&anio=2026' \
-H 'Authorization: Bearer TU_TOKEN'Parámetros de consulta
paginanumberPágina (25 por página; entero ≥1). Default 1.
anionumberAño de registro del caso (formato YYYY, p. ej. 2026). Opcional; sin él se listan todos los años.
busquedastringTexto a buscar en folio de RMA, orden de servicio, modelo, factura de origen o número de serie (coincidencia parcial). Máx. 60 caracteres.
Campos de la respuesta
folio_rmastringFolio del RMA (RMA-<número>), la solicitud que registras primero. Vacío si el equipo se recibió en sucursal sin RMA.
folio_orden_serviciostringFolio de la orden de servicio (OS-<número>) que se asigna cuando el equipo llega al laboratorio. Vacío mientras el equipo no llega.
factura_origenstringFactura con la que compraste el equipo. Vacía si no se capturó al registrar el caso.
tipo_servicioobjectTipo de caso. codigo: garantia, reparacion, devolucion, reserva_garantia o negociacion.
productoobjectEl equipo que enviaste: producto_id (el mismo id de GET /api/v1/productos/{id}; 0 si ya no está en el catálogo), modelo (código interno, puede venir sin guiones), titulo y no_serie.
estatusobjectEn qué va tu caso: codigo, etiqueta, descripcion, color sugerido para mostrarlo, siguiente_paso y accion_requerida_cliente (en texto, lo que tienes que hacer tú; vacío si no tienes que hacer nada). Códigos, en orden del proceso: rma_creado (esperando tu equipo), equipo_recibido, en_diagnostico, en_pruebas, esperando_refaccion, diagnostico_listo, dictamen_<tipo> (ya hay resolución), cotizado (cotización por aprobar), listo_recoger / listo_sin_recoger, enviado (va en camino), sin_existencia_go7* (sin stock para reponerte el equipo), entregado, resuelto (devolución cerrada) y cancelado.
accion_requerida_clienteobjectLa misma acción de estatus.accion_requerida_cliente, para automatizar: tipo (enviar_equipo, aprobar_cotizacion, recoger_sucursal, rastrear_envio o elegir_reposicion) y url a syscom.mx cuando aplica. {} si no hay acción.
dictamenobjectLa resolución de SYSCOM: codigo (reparado, equipo_nuevo, nota_credito, cotizacion, proveedor —se gestiona con el fabricante—, sin_garantia, interno o cancelado), titulo y descripcion. {} mientras no hay resolución.
envioobjectEnvío de regreso: estatus (en_transito, recibido_en_sucursal, personal o pendiente), fletera, guia y fecha. La guía viene vacía si la paquetería no la reporta o si es entrega personal. {} si aún no hay envío.
fecha_alta_rmastringCuándo registraste el RMA (YYYY-MM-DD HH:MM:SS, hora de México).
fecha_recepcionstringCuándo llegó el equipo a SYSCOM. Vacía si aún no llega.
Códigos de estado
Listado paginado (puede venir vacío).
Parámetros inválidos (`pagina` < 1, `anio` fuera de rango o `busqueda` demasiado larga).
Token ausente, inválido, expirado o revocado.
Distribuidor sin acceso a la API.
Límite de peticiones excedido.
Error interno.
Detalle de orden
BearerMuestra el seguimiento completo de tus equipos en soporte. Busca por número de serie, factura de compra, folio de RMA o folio de orden de servicio: si tu búsqueda abarca varios equipos (por ejemplo, un RMA o una factura con varias piezas), vienen todos. Incluye los mismos campos del listado más el reporte técnico, la línea de tiempo, la resolución y lo que recibirás. Ningún campo viene como `null`.
curl 'https://developers.syscom.mx/api/v1/soporte/ordenes/FA26%2F000000' \
-H 'Authorization: Bearer TU_TOKEN'Parámetros
identificadorstringrequeridoPuedes buscar por cualquiera de estos datos; el tipo se detecta por su formato: • Número de serie del equipo — LP3462601284591 (cualquier texto que no sea de los siguientes; un número sin prefijo, como 1573134, se busca como serie). • Folio de orden de servicio — OS-1573134. • Folio de RMA — RMA-1429613. • Factura de compra — FA26/1771328, con la diagonal codificada como %2F (FA26%2F1771328); también se acepta sin codificar. No se distinguen mayúsculas de minúsculas. Las series genéricas (SIN SERIE, S/N, N/A, 0…) o de menos de 3 caracteres no identifican un equipo y responden 404. Si una serie se parece a un folio (p. ej. OS-123), gana el folio.
Campos de la respuesta
consultaobjectCómo se interpretó tu búsqueda: tipo (serie, factura, rma u orden_servicio) y valor.
producto.imagenstringFoto del producto (solo en el detalle).
aplica_garantiaobjectOpinión del técnico al revisar: valor (si aplica la garantía), motivo (causa encontrada) y reparado. {} hasta que hay reporte técnico. La resolución final es dictamen.
clasificacion_textostringResultado técnico de la revisión, p. ej. Reparado - Express o No reparado.
problema_reportadostringLa falla que reportaste al registrar el caso.
falla_detectada, causa, accion, sugerenciasstringReporte del técnico: qué falla encontró, su causa, qué hizo y sus recomendaciones. Vacíos hasta que hay reporte.
tecnicostringTécnico que revisó el equipo.
sucursalobjectDónde está el equipo y dónde lo recoges: nombre, direccion y mapa. Puede ser distinta a la sucursal del técnico.
fecha_fabricacionstringFecha de fabricación del equipo (YYYY-MM-DD), si se conoce.
timelinearrayPasos del caso con codigo, titulo, estado (completado, activo, pendiente o cancelado), fecha y subtitulo. La fecha viene vacía si el paso no ha ocurrido o no se registró.
documento_resolucionobjectCotización, pedido o factura que SYSCOM generó para resolver el caso (por ejemplo, la factura sin costo del equipo nuevo). No es tu factura de compra. Trae folio, tipo, fase y fase_texto (misma fase que en tus pedidos), autorizado, factura_adicional y es_negociacion. Si el dictamen es cotizacion y viene {}, la cotización aún se está preparando.
recibiras_modeloobjectProducto que recibirás a cambio cuando es distinto al que enviaste (producto_id, modelo, titulo). {} si recibes el mismo modelo o no aplica.
nota_creditoobjectSolo en devoluciones: folio, tramite (en_proceso, autorizado o rechazado), comentarios_rechazado, fecha_alta, estado (disponible, parcial, aplicada o cancelada), saldo_disponible y moneda (MXN o USD). {} en otros casos.
refaccionesarrayPiezas que se instalaron en la reparación: cantidad, codigo y descripcion. [] si no se usaron piezas o en devoluciones.
reposicionobjectSolo cuando no hubo stock para reponerte el equipo: estatus (pendiente = debes elegir, espera_stock o nota_credito), compra_en_camino y fechas estimadas del modelo y del sustituto. {} en otros casos.
evidencias_disponiblesstringReservado para las fotos que toma el técnico. Por ahora siempre viene vacío.
hermanosarrayLos demás equipos del mismo RMA, con folio_rma, folio_orden_servicio, factura_origen, modelo y estatus.
direccion_regresoobjectSolo si tu equipo aún no llega: la dirección de regreso que capturaste al crear el RMA. {} en otros casos.
garantia_cubierta_porstringQuién absorbe la garantía: fabricante (el proveedor del equipo, con SYSCOM a cargo del trámite) o syscom. Vacío hasta que hay reporte técnico. No cambia lo que debes hacer: tu resolución está en dictamen.
Códigos de estado
Detalle de todos los equipos que coinciden con el identificador.
Identificador vacío o demasiado largo (máx. 64 caracteres).
Token ausente, inválido, expirado o revocado.
Distribuidor sin acceso a la API.
No hay casos de soporte en tu cuenta para ese identificador (o es una serie genérica como `SIN SERIE`).
Límite de peticiones excedido.
Error interno.
Consulta múltiple
BearerConsulta en una sola llamada el detalle de soporte de hasta 15 búsquedas mezcladas: número de serie, factura de compra, folio de RMA o folio de orden de servicio (el tipo se detecta por su formato, igual que en el detalle individual). Siempre responde 200, con un resultado por búsqueda en el orden en que las enviaste (sin repetidos): `consulta` indica cómo se interpretó cada uno, `encontrado` si hubo coincidencias y `ordenes` los equipos, con el mismo detalle completo que la consulta individual. Un mismo equipo puede aparecer en varios resultados si coincide con más de una búsqueda. Las series genéricas (`SIN SERIE`, `S/N`, `N/A`…) no se buscan y vienen con `encontrado: false`.
curl -X POST 'https://developers.syscom.mx/api/v1/soporte/ordenes' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer TU_TOKEN' \
-d '{"busqueda":["OS-1573134","RMA-1429613","FA26/000000","LP3462601284591"]}'Cuerpo de la petición
busquedastring[]requeridoArreglo de textos con lo que quieres buscar, sin codificar (p. ej. ["OS-1573134", "RMA-1429613", "FA26/000000", "LP3462601284591"]). Cada elemento puede ser una serie, una factura (FA26/000000), un RMA (RMA-1429613) o una orden de servicio (OS-1573134), mezclados. Solo textos: números u otros tipos se rechazan (envía "1573134", no 1573134). Máximo 15 elementos; los repetidos se cuentan antes de eliminarse. Cada uno de hasta 64 caracteres.
Campos de la respuesta
resultados[].consultaobjectCómo se interpretó cada búsqueda: tipo y valor.
resultados[].encontradobooleanSi hubo equipos para esa búsqueda.
resultados[].totalnumberCuántos equipos coincidieron.
resultados[].ordenesarrayLos equipos, con el mismo objeto que el detalle individual.
consultado_enstringMomento de la consulta (YYYY-MM-DD HH:MM:SS, hora de México).
Códigos de estado
Un resultado por búsqueda, en el orden enviado (los no encontrados, y las series genéricas, con `encontrado: false`).
Body no es JSON, `busqueda` falta, no es un arreglo de textos o está vacío, trae más de 15 elementos o alguno supera 64 caracteres.
Token ausente, inválido, expirado o revocado.
Distribuidor sin acceso a la API.
Límite de peticiones excedido.
Error interno.