Maxim

Maxim

Última actualización el Oct 8, 2026

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