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 (Alaio). 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 |
¿Qué errores puede devolver el robot?
El robot escribe estos mensajes en el registro del proceso de negocio cuando no puede completar un paso. El texto indica qué corregir en la configuración o en los datos.
- Error: no se ha indicado {id}
- Error: fields_json está vacío
- Error: fields_json contiene un JSON no válido
- Error de la API
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
Robots similares
Artículos relacionados
- Etapa anterior de la negociación en Bitrix24: por qué una regla de automatización no la ve
- Generar documentos en Bitrix24: numeración, automatización y el archivo final
- Informes en Bitrix24: analítica CRM, BI Builder y métricas propias
- Cómo actualizar un campo del negocio en Bitrix24: REST API, webhooks y sin código
- ID de campos en Bitrix24: cómo conocer el código de un campo y para qué sirve
- Lanzamiento masivo de procesos de negocio en Bitrix24 por filtro de entidades