--- title: "Actualizar empleado" description: "Reemplaza los datos editables de identidad, empleo, nómina y domicilio de un empleado." language: es-MX canonical_url: "https://exac.mx/docs/api/catalog/employees/update-employee" md_url: "https://exac.mx/docs/api/catalog/employees/update-employee.md" --- # Actualizar empleado Reemplaza los datos editables de identidad, empleo, nómina y domicilio de un empleado. ## Solicitud `PATCH /v1/employees/{employeeId}` - **Autorización:** Permiso requerido: `employees:manage`. - **Entornos:** Producción y prueba - **Idempotencia:** Requerida ## Contrato canónico para máquinas Este fragmento se genera desde la operación canónica y los contratos Zod que utiliza la ruta. ```json { "method": "PATCH", "path": "/v1/employees/{employeeId}", "operation": { "operationId": "updateEmployee", "tags": [ "Employees" ], "summary": "Actualizar empleado", "description": "Reemplaza los datos editables de identidad, empleo, nómina y domicilio de un empleado.", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "employeeId", "in": "path", "required": true, "schema": { "type": "string", "minLength": 1 } }, { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": "Clave estable para reintentar exactamente la misma solicitud sin duplicar efectos." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "curp": { "type": "string" }, "postalCode": { "type": "string" }, "employeeNumber": { "type": "string" }, "employmentStartDate": { "type": "string", "format": "date", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$" }, "taxSystem": { "description": "Active SAT tax-system code.", "x-exac-sat-catalog": "tax-systems", "oneOf": [ { "type": "string", "title": "SAT c_RegimenFiscal", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/invoicing#tax-systems).", "enum": [ "601", "603", "605", "606", "607", "608", "610", "611", "612", "614", "615", "616", "620", "621", "622", "623", "624", "625", "626" ] } ] }, "socialSecurityNumber": { "type": "string" }, "contractType": { "description": "Active SAT payroll contract-type code.", "x-exac-sat-catalog": "payroll-contract-types", "oneOf": [ { "type": "string", "title": "SAT c_TipoContrato", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#payroll-contract-types).", "enum": [ "10", "99", "01", "02", "03", "04", "05", "06", "07", "08", "09" ] } ] }, "regimeType": { "description": "Active SAT payroll regime-type code.", "x-exac-sat-catalog": "payroll-regime-types", "oneOf": [ { "type": "string", "title": "SAT c_TipoRegimen", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#payroll-regime-types).", "enum": [ "10", "11", "12", "13", "99", "02", "03", "04", "05", "06", "07", "08", "09" ] } ] }, "paymentFrequency": { "description": "Active SAT payroll payment-frequency code.", "x-exac-sat-catalog": "payroll-payment-frequencies", "oneOf": [ { "type": "string", "title": "SAT c_PeriodicidadPago", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#payroll-payment-frequencies).", "enum": [ "10", "99", "01", "02", "03", "04", "05", "06", "07", "08", "09" ] } ] }, "jobTitle": { "type": "string" }, "department": { "type": "string" }, "workScheduleType": { "description": "Active SAT payroll work-schedule code.", "x-exac-sat-catalog": "payroll-work-schedule-types", "oneOf": [ { "type": "string", "title": "SAT c_TipoJornada", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#payroll-work-schedule-types).", "enum": [ "99", "01", "02", "03", "04", "05", "06", "07", "08" ] } ] }, "positionRisk": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "99" ], "description": "Active SAT payroll position-risk code.", "x-exac-sat-catalog": "payroll-position-risks" }, "federalEntityCode": { "description": "Active SAT federal-entity code.", "x-exac-sat-catalog": "federal-entities", "oneOf": [ { "type": "string", "title": "SAT c_Estado", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#federal-entities).", "enum": [ "AGU", "BCN", "BCS", "CAM", "CHP", "CHH", "COA", "COL", "CMX", "DUR", "GUA", "GRO", "HID", "JAL", "MEX", "MIC", "MOR", "NAY", "NLE", "OAX", "PUE", "QUE", "ROO", "SLP", "SIN", "SON", "TAB", "TAM", "TLA", "VER", "YUC", "ZAC" ] } ] }, "recurringEarnings": { "type": "array", "items": { "type": "object", "properties": { "code": { "description": "Active SAT payroll earning-type code.", "x-exac-sat-catalog": "payroll-earning-types", "oneOf": [ { "type": "string", "title": "SAT c_TipoPercepcion", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#payroll-earning-types).", "enum": [ "001", "002", "003", "004", "005", "006", "009", "010", "011", "012", "013", "014", "015", "019", "020", "021", "022", "023", "024", "025", "026", "027", "028", "029", "030", "031", "032", "033", "034", "035", "036", "037", "038", "039", "044", "045", "046", "047", "048", "049", "050", "051", "052", "053" ] } ] }, "taxableAmount": { "type": "number" }, "exemptAmount": { "type": "number" } }, "required": [ "code", "taxableAmount", "exemptAmount" ], "additionalProperties": false } }, "recurringDeductions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "SAT payroll deduction-type code." }, "amount": { "type": "number" } }, "required": [ "code", "amount" ], "additionalProperties": false } }, "recurringOtherPayments": { "type": "array", "items": { "type": "object", "properties": { "code": { "description": "Active SAT payroll other-payment code.", "x-exac-sat-catalog": "payroll-other-payment-types", "oneOf": [ { "type": "string", "title": "SAT c_TipoOtroPago", "description": "Consulta códigos y nombres vigentes [aquí](/docs/sat-catalogs/payroll#payroll-other-payment-types).", "enum": [ "999", "001", "002", "003", "004", "005", "006", "007", "008", "009" ] } ] }, "amount": { "type": "number" }, "employmentSubsidy": { "type": "number" } }, "required": [ "code", "amount" ], "additionalProperties": false } } }, "additionalProperties": false }, "example": { "jobTitle": "Engineering Manager" } } } }, "responses": { "200": { "description": "Operación completada.", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "employeeId": { "type": "string", "minLength": 1 }, "name": { "type": "string" }, "postalCode": { "type": "string" }, "taxSystem": { "type": "string" }, "employeeNumber": { "type": "string" }, "curp": { "type": "string" }, "socialSecurityNumber": { "type": "string" }, "jobTitle": { "type": "string" }, "department": { "type": "string" }, "paymentFrequency": { "type": "string" }, "employmentStartDate": { "type": "string" }, "contractType": { "type": "string" }, "workScheduleType": { "type": "string" }, "regimeType": { "type": "string" }, "rfc": { "type": "string" }, "lastPayrollDate": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "employeeId", "name", "rfc" ], "additionalProperties": false } }, "required": [ "data" ], "additionalProperties": false }, "example": { "data": { "employeeId": "employee-example", "name": "Persona Ejemplo", "curp": "EJEA010101HSLXXX01", "rfc": "EJE010101AAA", "lastPayrollDate": "2026-07-27T12:00:00.000Z" } } } } }, "400": { "description": "Solicitud inválida.\n\n`validation_error`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "401": { "description": "Credencial inválida o ausente.\n\n`unauthenticated`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWWAuthenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "403": { "description": "La credencial no incluye el permiso `employees:manage`.\n\n`forbidden`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWWAuthenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "404": { "description": "Recurso no encontrado.\n\n`not_found`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "405": { "description": "Método no permitido.\n\n`method_not_allowed`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Allow": { "$ref": "#/components/headers/Allow" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "409": { "description": "La operación entra en conflicto con su estado actual o con la clave de idempotencia.\n\nCódigos posibles: `conflict`, `idempotency_conflict`, `operation_in_progress`, `recovery_required`.", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Retry-After": { "$ref": "#/components/headers/RetryAfter" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "429": { "description": "Demasiadas solicitudes.\n\n`rate_limited`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Retry-After": { "$ref": "#/components/headers/RetryAfter" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "500": { "description": "Error interno del servidor.\n\n`internal`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } }, "503": { "description": "Servicio temporalmente no disponible.\n\n`provider_unavailable`", "headers": { "Request-Id": { "$ref": "#/components/headers/RequestId" }, "Retry-After": { "$ref": "#/components/headers/RetryAfter" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-exac-environments": [ "production", "sandbox" ] }, "components": { "schemas": { "ApiError": { "type": "object", "properties": { "error": { "$ref": "#/components/schemas/ProgrammaticError" } }, "required": [ "error" ], "additionalProperties": false }, "ProgrammaticError": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "validation_error", "unauthenticated", "forbidden", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "rate_limited", "provider_unavailable", "internal" ], "description": "Acción recomendada por código:\n\n- `validation_error` — Corrige cada elemento de details.issues usando su path y código estable.\n- `unauthenticated` — Proporciona una API key o un token de acceso OAuth válido.\n- `forbidden` — Usa una credencial con el permiso requerido.\n- `not_found` — Verifica el identificador del recurso dentro de la organización.\n- `method_not_allowed` — Usa el método HTTP documentado.\n- `conflict` — Actualiza el recurso y resuelve su estado actual.\n- `idempotency_conflict` — Usa otra clave de idempotencia para una solicitud modificada.\n- `operation_in_progress` — Espera el tiempo de Retry-After y repite la misma solicitud.\n- `recovery_required` — No reintentes automáticamente; reconcilia el resultado del proveedor.\n- `rate_limited` — Espera el tiempo de Retry-After antes de reintentar.\n- `provider_unavailable` — Reintenta solo cuando la respuesta marque la falla como reintentable.\n- `internal` — Reintenta después y contacta a soporte si el error persiste." }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } }, "retryable": { "type": "boolean" }, "retryAfterSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false }, "status": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "code", "message", "status" ], "additionalProperties": false } } } } ``` [OpenAPI 3.1](/openapi.json) ## Herramientas MCP equivalentes - [`save_employee`](/docs/mcp/tools/save_employee.md) Documentación completa: https://exac.mx/docs.md Índice para agentes: https://exac.mx/docs/llms.txt