Actualizar negociación por ID
El robot «Actualizar negociación por ID» modifica cualquier negociación por su identificador desde cualquier contexto de proceso de negocio en Bitrix24. Los campos a modificar se pasan como JSON en formato camelCase (title, stageId, opportunity, assignedById y otros). Devuelve un indicador de éxito Y/N para la ramificación condicional del proceso y funciona a través del método universal de CRM crm.item.update.
El robot actualiza una negociación arbitraria por su ID, incluso cuando el proceso de negocio se ejecuta sobre otra entidad de CRM — un contacto, un prospecto o una tarea. El ID de la negociación y el conjunto de campos se indican de forma explícita: los campos se pasan como una cadena JSON en formato camelCase (por ejemplo {"title":"Nueva negociación","stageId":"C1:WON","opportunity":50000,"assignedById":5}). La actualización usa el método universal crm.item.update, por lo que están disponibles todos los campos de la negociación, incluidos los personalizados. Casos típicos: cuando cambia la etapa del contacto, actualizar la negociación vinculada; fijar el responsable y el importe a partir de datos de un sistema externo; cambiar de forma masiva las etapas de las negociaciones desde un proceso superior. Devuelve un indicador Correcto (Y/N): Y si la actualización tiene éxito, N si el ID está vacío, el JSON está vacío o no es válido, o si hay un error de API — compárelo en la condición del siguiente paso.
¿Qué parámetros de entrada acepta el robot?
| Parámetro | Tipo | ¿Obligatorio? | Por defecto |
|---|---|---|---|
| ID de la negociación | int | sí | |
| Campos a actualizar (JSON camelCase): {"title":"New deal","stageId":"C1:WON","assignedById":5,"opportunity":50000} | string | sí |
¿Qué devuelve el robot?
| Parámetro | Tipo |
|---|---|
| Éxito (Y/N) | string |
Escenario: actualización de una negociación desde un proceso sobre un contacto
- El contacto pasa a una nueva etapa del embudo
- El robot actualiza la negociación vinculada: stageId y opportunity se pasan como JSON
- Un resultado Y confirma la actualización para el siguiente paso