Iniciar sesiónObtener credencialesRun in Postman

DocumentaciónGarantías y RMA

Garantías y RMA

Bearer

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.

GET/api/v1/soporte/ordenes

Listado de órdenes

Bearer

Lista 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

paginanumber

Página (25 por página; entero ≥1). Default 1.

anionumber

Año de registro del caso (formato YYYY, p. ej. 2026). Opcional; sin él se listan todos los años.

busquedastring

Texto 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_rmastring

Folio del RMA (RMA-<número>), la solicitud que registras primero. Vacío si el equipo se recibió en sucursal sin RMA.

folio_orden_serviciostring

Folio 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_origenstring

Factura con la que compraste el equipo. Vacía si no se capturó al registrar el caso.

tipo_servicioobject

Tipo de caso. codigo: garantia, reparacion, devolucion, reserva_garantia o negociacion.

productoobject

El 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.

estatusobject

En 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_clienteobject

La 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.

dictamenobject

La 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.

envioobject

Enví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_rmastring

Cuándo registraste el RMA (YYYY-MM-DD HH:MM:SS, hora de México).

fecha_recepcionstring

Cuándo llegó el equipo a SYSCOM. Vacía si aún no llega.

Códigos de estado

200

Listado paginado (puede venir vacío).

400

Parámetros inválidos (`pagina` < 1, `anio` fuera de rango o `busqueda` demasiado larga).

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

429

Límite de peticiones excedido.

500

Error interno.

GET/api/v1/soporte/ordenes/{identificador}

Detalle de orden

Bearer

Muestra 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

identificadorstringrequerido

Puedes 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

consultaobject

Cómo se interpretó tu búsqueda: tipo (serie, factura, rma u orden_servicio) y valor.

producto.imagenstring

Foto del producto (solo en el detalle).

aplica_garantiaobject

Opinió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_textostring

Resultado técnico de la revisión, p. ej. Reparado - Express o No reparado.

problema_reportadostring

La falla que reportaste al registrar el caso.

falla_detectada, causa, accion, sugerenciasstring

Reporte del técnico: qué falla encontró, su causa, qué hizo y sus recomendaciones. Vacíos hasta que hay reporte.

tecnicostring

Técnico que revisó el equipo.

sucursalobject

Dónde está el equipo y dónde lo recoges: nombre, direccion y mapa. Puede ser distinta a la sucursal del técnico.

fecha_fabricacionstring

Fecha de fabricación del equipo (YYYY-MM-DD), si se conoce.

timelinearray

Pasos 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_resolucionobject

Cotizació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_modeloobject

Producto que recibirás a cambio cuando es distinto al que enviaste (producto_id, modelo, titulo). {} si recibes el mismo modelo o no aplica.

nota_creditoobject

Solo 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.

refaccionesarray

Piezas que se instalaron en la reparación: cantidad, codigo y descripcion. [] si no se usaron piezas o en devoluciones.

reposicionobject

Solo 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_disponiblesstring

Reservado para las fotos que toma el técnico. Por ahora siempre viene vacío.

hermanosarray

Los demás equipos del mismo RMA, con folio_rma, folio_orden_servicio, factura_origen, modelo y estatus.

direccion_regresoobject

Solo si tu equipo aún no llega: la dirección de regreso que capturaste al crear el RMA. {} en otros casos.

garantia_cubierta_porstring

Quié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

200

Detalle de todos los equipos que coinciden con el identificador.

400

Identificador vacío o demasiado largo (máx. 64 caracteres).

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

404

No hay casos de soporte en tu cuenta para ese identificador (o es una serie genérica como `SIN SERIE`).

429

Límite de peticiones excedido.

500

Error interno.

POST/api/v1/soporte/ordenes

Consulta múltiple

Bearer

Consulta 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[]requerido

Arreglo 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[].consultaobject

Cómo se interpretó cada búsqueda: tipo y valor.

resultados[].encontradoboolean

Si hubo equipos para esa búsqueda.

resultados[].totalnumber

Cuántos equipos coincidieron.

resultados[].ordenesarray

Los equipos, con el mismo objeto que el detalle individual.

consultado_enstring

Momento de la consulta (YYYY-MM-DD HH:MM:SS, hora de México).

Códigos de estado

200

Un resultado por búsqueda, en el orden enviado (los no encontrados, y las series genéricas, con `encontrado: false`).

400

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.

401

Token ausente, inválido, expirado o revocado.

403

Distribuidor sin acceso a la API.

429

Límite de peticiones excedido.

500

Error interno.