Actualizar empresa por ID
El robot «Actualizar empresa por ID» modifica cualquier empresa 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, assignedById, industry, revenue 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 empresa arbitraria por su ID, incluso cuando el proceso de negocio se ejecuta sobre otra entidad de CRM — una negociación, un contacto o una tarea. El ID de la empresa 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 empresa","assignedById":5,"industry":"IT","revenue":1000000}). La actualización usa el método universal crm.item.update, por lo que están disponibles todos los campos de la empresa, incluidos los personalizados. Casos típicos: cuando cambia la etapa de la negociación, actualizar la empresa vinculada; fijar el responsable y el sector a partir de datos de un sistema externo; cambiar de forma masiva los campos de las empresas 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 empresa | int | sí | |
| Campos a actualizar (JSON camelCase): {"title":"New company","assignedById":5,"industry":"IT","revenue":1000000} | 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 empresa desde un proceso sobre una negociación
- La negociación pasa a una nueva etapa del embudo
- El robot actualiza la empresa vinculada: assignedById e industry se pasan como JSON
- Un resultado Y confirma la actualización para el siguiente paso