Consulta de CCCs Asignados a una Autorización

⚠️

Añade test=1 para realizar pruebas sin efectos reales. En producción, omite este parámetro.

Devuelve el listado de Cuentas de Cotización (CCC) asignadas a la autorización del certificado en uso. El listado en TGSS puede ser muy grande (cientos o miles de CCCs), por lo que la respuesta se entrega paginada por cursor: cada llamada devuelve un tramo de la lista y, mientras queden tramos pendientes, un campo pagination.page_after que debe enviarse en la siguiente petición para continuar. Cuando ya no se devuelve page_after, se ha llegado al final del listado.

Parámetros

test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
authorized_num (número entero) : Opcional. Número de autorización, requerido cuando el usuario tiene mas de un autorizado. Al realizar la petición devuelve los autorizados si tiene mas de un autorizado con el status 428
situacionCCC (string (1)) : Opcional. Filtro por situación del CCC. Por defecto T. Posibles valores:
- T: Todos (por defecto)
- A: Alta(Activo)
- B: Baja(Inactivo)
page_after (UUID) : Opcional. Cursor de continuación devuelto en data.pagination.page_after de la respuesta anterior. Debe enviarse para obtener el siguiente tramo del listado. Si se omite, la consulta arranca desde el principio. El cursor se consume al usarse (no es reutilizable).

GET /ccc-asignados

{
  "test": 1,
  "authorized_num": "999252",
  "situacionCCC": "T",
  "page_after": "d2fc9d33-ac2d-4555-9d48-51f9196d45a7"
}

Respuesta OK

Respuesta

{
    "success": true,
    "message": "OK",
    "status": 200,
    "data": {
        "authorized_num": "257020",
        "pagination": {
            "current_page": 1,
            "total_pages": 3,
            "total_records": 1232,
            "_total": 124,
            "page_after": "d2fc9d33-ac2d-4555-9d48-51f9196d45a7"
        },
        "list": [
            {
                "regimen": "0138",
                "ccc": "96372899466",
                "razSoc": "Partida de Naranjo",
                "ccc_type": "S Secundario",
                "startDate": "2024-01-21",
                "code_situacion": "02",
                "ccc_situacion": "ALTA",
                "ccc_es_practica": "SI"
            },
            {
                "regimen": "0111",
                "ccc": "20120294786",
                "razSoc": "Empresa Bautista e Hija",
                "ccc_type": "S Secundario",
                "startDate": "2024-10-25",
                "code_situacion": "06",
                "ccc_situacion": "ALTA POR REINICIO",
                "ccc_es_practica": "SI"
            }
        ]
    }
}

Respuesta status 428

Respuesta

{
    "success": false,
    "message": "Existen más de una autorización, por favor especifique la autorización a consultar {authorized_num}.",
    "status": 428,
    "data": {
        "list": [
            {
                "numero": "194114",
                "razSoc": "Vanegas-Burgos"
            },
            {
                "numero": "631504",
                "razSoc": "Viajes Tovar S. de H."
            },
            {
                "numero": "843705",
                "razSoc": "Corporación Juárez"
            },
            {
                "numero": "928612",
                "razSoc": "Serrato de Quintanilla"
            },
            {
                "numero": "875039",
                "razSoc": "Armenta y Candelaria"
            }
        ]
    }
}