Escribir en secciones

Un WriteOperation envía un diccionario campo → valor. Pero la sección no es un almacén pasivo: al escribir, el servidor autorrellena campos dependientes, calcula totales y puede ejecutar la misma lógica interna que usa la interfaz. Entender estos tres comportamientos evita la mayoría de sorpresas al integrar.

1. El orden de los campos importa

Los campos se procesan en el orden en que los envías, y escribir uno dispara los autorrellenados que dependen de él.

Ejemplo real de Ventas: al rellenar Cliente, se copia automáticamente su descuento a la venta. Si envías primero el descuento manual y después el cliente, el autorrellenado del cliente pisa tu descuento. Regla práctica: primero las referencias (cliente, proceso, producto...), después los valores manuales.

Otro ejemplo, de Oportunidades CRM: al escribir el Proceso comercial, la Fase se autorrellena con la fase inicial de ese proceso. El proceso va antes que cualquier campo que dependa de la fase.

2. Autorrellenado «Siempre» copia incondicionalmente

Cuando un campo está definido como autorrellenado «Siempre» desde otro, la copia se ejecuta cada vez que cambia el origen:

• Si seleccionas un cliente sin descuento, el descuento de la venta se copia vacío (no se conserva el anterior).
• Si deseleccionas el cliente, el destino también se vacía.

No es un valor por defecto: es una copia viva. Si necesitas un valor manual distinto, escríbelo después del campo que lo autorrellena.

3. Los scripts hacen el trabajo por ti

Cada sección puede llevar scripts internos: cálculos, validaciones y filtros que en la interfaz se ejecutan solos. Al escribir por API con scripts activados, se ejecutan igual:

// Tercer parámetro a true: el servidor ejecuta los scripts de la sección
// (calcula totales, valida y aplica su lógica, igual que en la interfaz).
var result = await dinaupClient.RunWriteOperationAsync(sectionId, bulkOperations, true);

En una venta, rellenas Cantidad y PrecioPorUnidad de una línea y el total del concepto —y los totales del documento— se calculan solos. En turnos, los scripts calculan duraciones. Sin scripts, esos campos quedarían a tu cargo: actívalos y reduce tu responsabilidad a los datos de negocio.

4. En las listas, el servidor solo toca las líneas que envías

Una sección con lista (una venta y sus conceptos, un asiento y sus apuntes) se escribe siempre por su sección principal: la cabecera en DataMainRow y las líneas en DataListRows, dentro del mismo WriteOperation. La sección de lista no admite escrituras directas — sus scripts y cálculos viven en la principal.

Enviar líneas no reemplaza la lista. El servidor procesa una a una las que recibe, decide por su "id", y deja intactas las que no están en el envío:

Puedes corregir el precio de un concepto enviando una única línea con su "id", sin releer ni reenviar el resto del documento.

Resumen operativo

Ejemplos completos de escritura: WriteOperations por lotes, agregar un cliente y agregar un recambio.