Listar tipos de contrato
GET /api/catalogos/tipo-contrato/
Tipo de contrato del trabajador: término fijo, indefinido, obra o labor, aprendizaje, prácticas (anexo de nómina, numeral 5.5.2).
Lista DIAN: TipoContrato. Anexo técnico: Nómina Electrónica v1.0 (Resolución 000013 de 2021).
Campos que reciben sus valores:
| Ruta | Campo | Se envía |
|---|---|---|
/api/nomina/empleado/ | tipo_contrato | id |
/api/nomina/nomina/ | tipo_contrato | id |
/api/nomina/nomina/ | empleado.tipo_contrato | id |
Paginado; search busca por código y nombre.
operationId: catalogos_tipo_contrato_list
Autenticación
Sección titulada «Autenticación»Cualquiera de estas credenciales:
Parámetros
Sección titulada «Parámetros»| Nombre | En | Tipo | Obligatorio | Descripción |
|---|---|---|---|---|
page | query | integer | no | Un número de página dentro del conjunto de resultados paginado. |
search | query | string | no | Un término de búsqueda. |
Ejemplo
Sección titulada «Ejemplo»curl "https://api.rededoc.uk/api/catalogos/tipo-contrato/"Respuestas
Sección titulada «Respuestas»| Código | Descripción |
|---|---|
200 | |
429 | Error |
200 — cuerpo
Sección titulada «200 — cuerpo»| Campo | Tipo | Descripción |
|---|---|---|
count | integer | |
next | string (uri) | Admite null. |
previous | string (uri) | Admite null. |
results | array<ElementoCatalogo> |
{ "count": 123, "next": "http://api.example.org/accounts/?page=4", "previous": "http://api.example.org/accounts/?page=2", "results": [ { "id": 1, "codigo": "texto", "nombre": "texto", "activo": true } ]}429 — cuerpo
Sección titulada «429 — cuerpo»| Campo | Tipo | Descripción |
|---|---|---|
detail | string | Mensaje para mostrar a la persona. |
errores | array<object> | Nunca vacía. Cada error trae codigo, que es lo que el cliente mapea —los de DRF tal cual (required, invalid, does_not_exist, not_found…) y los propios en español (campo_desconocido, solicitud_invalida…)—, y mensaje, para la persona. Si el error es de un campo, su ruta va delante del mensaje: detalles[0].impuestos[0].tributo: Este campo es obligatorio. |
{ "detail": "texto", "errores": [ { "codigo": "texto", "mensaje": "texto" } ]}RedEDoc es un servicio de Semántica Digital S.A.S.