Nombramientos

Tabla normalizada de nombramientos del padrón CDMX.

Namespace

datos_mexico.endpoints.nombramientos.NombramientosNamespace

NombramientosNamespace(http: HttpClient)

Bases: BaseNamespace

Endpoints de la tabla normalizada nombramientos del padrón CDMX.

Un nombramiento liga una persona con un puesto, sector, tipo de contratación y un sueldo bruto/neto. Para una vista desnormalizada "lista para consumir" (con nombre del puesto y del sector ya resueltos), usar client.cdmx.servidores_lista().

list

list(
    *,
    page: int = 1,
    per_page: int = 50,
    persona_id: int | None = None,
    sector_id: int | None = None,
) -> PaginatedResponse[Nombramiento]

Lista paginada de nombramientos.

Endpoint: GET /api/v1/nombramientos/

Parameters:

Name	Type	Description	Default
page	int	Número de página (1-indexed).	1
per_page	int	Elementos por página.	50
persona_id	int | None	Filtra por ID de persona (útil para ver todos los nombramientos de una persona específica, p. ej. doble plaza).	None
sector_id	int | None	Filtra por ID de sector. Ver client.cdmx.catalogo_sectores() para la lista de IDs.	None

get

get(nombramiento_id: int) -> Nombramiento

Detalle de un nombramiento por ID.

Endpoint: GET /api/v1/nombramientos/{nombramiento_id}

Raises:

Type	Description
NotFoundError	Si no existe un nombramiento con ese ID.

Modelo

Modelos Pydantic del namespace nombramientos.

Tabla normalizada del Patrón Único de Servidores Públicos CDMX. Un nombramiento es la asignación de una persona a un puesto, con su sector, sueldo y tipo de contratación específicos. Una persona puede tener varios nombramientos (doble plaza) — cada uno es un registro.

Nombramiento

Bases: DatosMexicoModel

Item de GET /api/v1/nombramientos/ y GET /api/v1/nombramientos/{id}.

Los IDs (puesto_id, sector_id, etc.) referencian los catálogos expuestos en client.cdmx.catalogo_*. Los campos monetarios (sueldo_bruto, sueldo_neto) llegan como string desde la API y se convierten a Decimal para preservar precisión. fecha_ingreso se parsea a date.