Consultar SIMs del cliente

Descripción

Este método permite obtener el listado paginado de tarjetas SIM asociadas a un cliente, identificado por su nombre de usuario. Soporta paginación, ordenamiento y búsqueda de registros.

---

URL API

https://apidevstore.axiosmobile.mx

---

Parámetros de Entrada

Parámetro de ruta

Parámetro	Tipo	Descripción	Ejemplo
client	string	Nombre de usuario del cliente	"6144135400"

Parámetros de consulta (Query Params)

Parámetro	Tipo	Requerido	Default	Descripción	Ejemplo
page	number	No	1	Número de página a consultar	1
pageSize	number	No	100	Cantidad de registros por página	100
order	string	No	asc	Orden de los resultados (asc/desc)	"asc"
search	string	No	—	Término de búsqueda (ICCID)	"8952140061846130299F"

---

Ejemplo de Uso

Método: GET
Endpoint: {{API}}/simcard/client-sims/{{client}}?page=1&pageSize=50&order=asc&search=
Headers: {{token}}
Body: No aplica

Response Success

{
  "TotalSims": 133,
  "TotalDisponibles": 50,
  "TotalRestantes": 0,
  "TotalPaginas": 3,
  "Sims": [
    {
      "_id": "61ca02e5ac28bf001d06144f",
      "beId": "246",
      "imsi": "334140131651063",
      "imsiRb1": "334140131651063",
      "imsiRb2": "334140131651063",
      "iccid": "8952140061846130299F",
      "iccid2": "895214006184613029",
      "msisdn": "6561234567",
      "pin": "1234",
      "puk": "16543650",
      "serie": "10302",
      "product": "MOV",
      "active": false,
      "available": false,
      "mainLot": "20211222",
      "owner": "6144135400",
      "activated": true,
      "createdAt": "2021-12-27T18:16:08.453Z",
      "updatedAt": "2024-01-05T18:21:33.501Z",
      "activatedAt": "2023-09-21T05:00:00.000Z",
      "activatedBy": "6144135400",
      "activationAmount": "100",
      "logs": [],
      "barring": false,
      "predeactivated": false,
      "suspend": false
    }
  ]
}

---

Parámetros de Salida

Paginación

Parámetro	Tipo	Descripción
TotalSims	number	Total de SIMs del cliente
TotalDisponibles	number	Total de SIMs disponibles (sin activar ni asignar)
TotalRestantes	number	Total de SIMs restantes en la página actual
TotalPaginas	number	Número total de páginas disponibles
Sims	array	Listado de tarjetas SIM del cliente

Objeto SIM (Sims[])

Parámetro	Tipo	Descripción
_id	string	Identificador único de la SIM
beId	string	Identificador del backend
imsi	string	IMSI principal de la tarjeta
imsiRb1	string	IMSI alternativo Rb1
imsiRb2	string	IMSI alternativo Rb2
iccid	string	ICCID completo de la tarjeta (con dígito de control)
iccid2	string	ICCID sin dígito de control
msisdn	string	Número telefónico asignado a la SIM
pin	string	PIN de la tarjeta SIM
puk	string	Código PUK para desbloqueo
serie	string	Número de serie del lote
product	string	Código de producto asignado
active	boolean	Indica si la SIM está activa en la red
available	boolean	Indica si la SIM está disponible para asignar
mainLot	string	Lote principal de la SIM (formato YYYYMMDD)
owner	string	Usuario propietario de la SIM
activated	boolean	Indica si la SIM ha sido activada alguna vez
createdAt	string	Fecha de creación del registro (ISO 8601)
updatedAt	string	Fecha de última actualización (ISO 8601)
activatedAt	string	Fecha en que fue activada la SIM (ISO 8601)
activatedBy	string	Sistema o usuario que realizó la activación
activationAmount	string	Monto aplicado en la activación
logs	array	Historial de eventos de la SIM (_id, type)
barring	boolean	Indica si la SIM tiene restricción de servicio
predeactivated	boolean	Indica si la SIM está en estado de predesactivación
suspend	boolean	Indica si la SIM está suspendida

Estos son los parámetros que recibirás al realizar la solicitud. Asegúrate de manejar los datos correctamente en tu aplicación.