Reglas que funcionan igual en todos los métodos de la API.
Precisión de los números
Las cantidades se guardan con hasta 3 decimales, los importes y los precios hasta el céntimo. La API redondea los valores entrantes igual que la interfaz de Controlata: 0.3333 se guarda como 0.333, y 10.125 como 10.13. La cantidad en las líneas de una operación debe seguir siendo mayor que cero tras el redondeo: 0.0004 se rechaza.
Edición
Los métodos edit cambian solo los campos que envías. Solo el ID del registro es obligatorio, el resto de los campos conservan sus valores anteriores.
- Los array (líneas de la operación, categorías, proveedores, componentes del producto) se reemplazan por completo cuando se envían. Para vaciar un array, envía un array vacío.
- Si se envía al menos uno de los array materials y products, las líneas de la operación se reemplazan por completo, y el array que no se envía se considera vacío. Si no se envía ninguno, las líneas no cambian.
Por ejemplo, para cambiar solo las notas de una compra, envía purchase_id y notes: las líneas, las fechas, los almacenes y el proveedor se quedan como estaban.
Paginación
Los métodos get_list aceptan parámetros opcionales de paginación. Excepción: los catálogos pequeños (unidades de medida, categorías y almacenes) siempre se devuelven completos y no aceptan estos parámetros.
| Campo | Tipo | Descripción |
|---|---|---|
| limit | int | Tamaño de página, de 1 a 1000 |
| offset | int | Cuántos registros omitir. Se envía junto con limit |
Sin limit se devuelve toda la lista. La respuesta incluye el campo total con el número total de registros que cumplen los filtros.
| Error | Motivo |
|---|---|
| Invalid limit value. Must be between 1 and 1000 | limit no válido |
| Invalid offset value. Must be 0 or greater | offset no válido |
| Offset requires limit | se envió offset sin limit |