Editar

Descripcion general

Esta ruta actualiza parcialmente un concepto de nómina extralegal (origin: "custom"). Todos los campos del cuerpo son opcionales: si omites una clave, ese campo queda intacto. El identificador en la URL es el payroll_concept_number del concepto dentro de tu organización. Los conceptos de ley (origin: "legal") los administra la plataforma y no se editan por la API. Una solicitud exitosa devuelve 200 con la forma completa del concepto actualizado.

La API key necesita el permiso Actualizar conceptos de nómina y alcance sobre toda la organización.

Ruta

PATCHhttps://app.integranom.com/api/v1/payroll-concepts/{payroll_concept_number}

Parámetro de ruta: payroll_concept_number: entero positivo, el número del concepto dentro de la organización.

Actualizacion minima

Envía solo los campos que quieras cambiar. El resto del concepto queda intacto.

{ "name": "Bono de productividad", "sort_order": 15 }

curl -X PATCH "https://app.integranom.com/api/v1/payroll-concepts/42" \-H "Authorization: Bearer $API_KEY" \-H "Content-Type: application/json" \-d '{ "name": "Bono de productividad", "sort_order": 15 }'

Campos del cuerpo

Campo	Tipo	Notas
`code`	string	1–60 caracteres. Único por organización.
`name`	string	No puede ir vacío.
`sat_key`	string \| null	Clave del catálogo SAT de la clasificación del concepto. `null` o `""` la limpia, salvo en un concepto que se timbra. Un concepto que no se timbra no lleva clave.
`formula_expression`	string \| null	Solo para conceptos de fórmula (`behavior: "formula"`); no se puede limpiar. En cualquier otro concepto se ignora.
`employer_responsibility`	boolean
`affects_net_cash`	boolean
`reduces_isr_base`	boolean	Solo deducciones con fórmula o captura manual. `true` resta el importe de la base gravable de ISR antes de calcular el impuesto. En otro concepto responde `400`.
`reduces_isn_base`	boolean	Solo deducciones con fórmula o captura manual. `true` resta el importe de la base del impuesto sobre nómina. En otro concepto responde `400`.
`is_active`	boolean	`false` desactiva el concepto. Desc Patronal Fondo Ahorro no se puede desactivar mientras Desc Aportación Trabajador F.A esté activo, ni Vales de despensa entregados mientras Vales de despensa esté activo. `true` sobre Desc Aportación Trabajador F.A o Vales de despensa también activa su deducción si estaba inactiva.
`sort_order`	entero	Mayor o igual a 0.

Forma de la respuesta

200 OK: el objeto completo del concepto actualizado, con la misma forma del ejemplo.

is_mandatory es de solo lectura y no se envía en el cuerpo: es true solo en un concepto de ley que la nómina calcula a cada empleado, como el sueldo o el ISR, y false en los demás, incluidos todos los extralegales. Quién recibe un concepto extralegal lo decide su contrato.

`400`: Desc Patronal Fondo Ahorro con el fondo del trabajador activo

{
  "message": "La validación falló.",
  "errors": [
    {
      "field": "is_active",
      "code": "SAVINGS_FUND_PAIR_ACTIVE",
      "message": "Desc Patronal Fondo Ahorro no se puede desactivar mientras Desc Aportación Trabajador F.A esté activo."
    }
  ]
}

Con Vales de despensa entregados mientras Vales de despensa está activo, el error es el mismo con code FOOD_VOUCHER_PAIR_ACTIVE y el mensaje "Vales de despensa entregados no se puede desactivar mientras Vales de despensa esté activo."

Errores

Status	Causa
`400`	`payroll_concept_number` inválido en la URL, cuerpo que no es JSON, o falla de validación de campos.
`400`	`sat_key` inválida para la clasificación del concepto, limpiada en un concepto que se timbra, o enviada a un concepto que no se timbra (`INVALID_INPUT`).
`400`	`formula_expression` en `null` en un concepto de fórmula.
`400`	`is_active: false` sobre Desc Patronal Fondo Ahorro mientras Desc Aportación Trabajador F.A está activo (`SAVINGS_FUND_PAIR_ACTIVE`).
`400`	`is_active: false` sobre Vales de despensa entregados mientras Vales de despensa está activo (`FOOD_VOUCHER_PAIR_ACTIVE`).
`400`	`reduces_isr_base` o `reduces_isn_base` en `true` sobre un concepto que no es deducción con fórmula o captura manual (`INVALID_INPUT`).
`403`	El concepto es de ley (`IMMUTABLE_LEGAL_CONCEPT`), o la API key no tiene alcance sobre toda la organización.
`404`	El concepto no existe o fue eliminado en esta organización.
`409`	Ya existe otro concepto con ese `code` en la organización.

Editar catálogo PATCH

Página anterior

Eliminar concepto DELETE

Página siguiente