Códigos de error

Estos códigos son los valores de code que aparecen dentro de errores (y de los errores de cada elemento de detalle) en las respuestas de los endpoints de escritura. No son códigos HTTP: esas respuestas llegan con HTTP 200 y el resultado se lee en resultado (ver Convenciones).

{
    "resultado": "R",
    "errores": [
        { "code": 101, "msg": "Se ha superado la cantidad maxima de registros a procesar. El maximo es de 20." }
    ],
    "detalle": []
}

Los mensajes se muestran tal como los devuelve el sistema. Las partes entre {} se reemplazan por el dato concreto. Algunos códigos (400, 406, 419) no tienen un mensaje fijo: el texto describe el problema puntual.

Código	Mensaje	Dónde aparece
100	No se han enviado registros para procesar	Error general. Todos los endpoints de envío masivo (pedidos, comprobantes, preparación, visitas, operaciones de stock, ubicaciones y contactos de clientes).
101	Se ha superado la cantidad maxima de registros a procesar. El maximo es de {n}.	Error general, en los mismos endpoints que 100. El máximo depende del endpoint y de la configuración.
400	(variable) Descripción del dato inválido, por ejemplo un campo obligatorio faltante o un texto demasiado largo.	Modelo inválido. Pedidos, comprobantes, preparación, entradas de reparto, operaciones de stock, cobros, visitas, clientes.
401	Identificador no definido (o un mensaje específico, por ejemplo cuando falta el vendedor y no hay uno por defecto)	Pedidos, comprobantes, eliminación y orden de ítems de ventas, preparación.
402	Identificador repetido	Pedidos, comprobantes, preparación.
403	Pedido ya procesado	Crear pedidos: el identificador ya fue usado por el mismo usuario.
404	Tipo de venta no reconocido	Crear pedidos.
405	El campo {campo} tiene un codigo invalido (a veces seguido de un detalle)	Un código que no existe en el sistema (cliente, vendedor, artículo, etc.). Pedidos, comprobantes, preparación, entradas de reparto, operaciones de stock, cobros, visitas, clientes.
406	(variable) Error al guardar o regla de negocio no cumplida.	Todos los endpoints de escritura. También los errores de validación de Asignaciones por vehículo.
407	La fecha del registro no es valida (o un mensaje específico)	Pedidos (fecha con más de 4 días de antigüedad), comprobantes, cobros, visitas.
408	El codigo de combo {combo} es invalido	Crear pedidos.
409	No es posible procesar un pedido que contenga combos e items regulares	Definido pero no se genera actualmente.
410	Existen items miembros del combo {combo}, pero este no fue declarado con su cantidad	Crear pedidos.
411	El item {item}, no encontrado en combo {combo} con descuento {n}%	Crear pedidos.
412	El item {item}, no encontrado en combo componente {componente}	Crear pedidos.
413	Faltan el componente {componente} en el combo {combo}	Definido pero no se genera actualmente (validación desactivada).
414	En el item {item}, debe especificarse el componente del combo (recomendado) o el combo y su descuento	Crear pedidos.
415	No se especificaron las cantidades de combos o los items del mismo	Definido pero no se genera actualmente.
416	Tipo de ubicación no reconocido	Ubicación de clientes.
417	La ubicación indicada no es válida	Ubicación de clientes.
418	Hay items con descuentos inválidos. El valor debe estar comprendido entre 0 y 1	Crear pedidos.
419	(variable) La venta no está en una etapa que permita la operación.	Comprobantes, eliminación de ítems de ventas.
420	La venta ya se encuentra cerrada	Comprobantes.
421	La venta ya tiene asignada una empresa y es diferente a la indicada en el comprobante	Comprobantes.
422	La información en el campo {campo} no es válida (a veces seguido de un detalle)	Crear pedidos (por ejemplo descuento junto con descuentos), comprobantes.
423	La reserva está vencida o no existe	Definido pero no se genera actualmente.
424	El ítem con Id {id} no fue encontrado.	Eliminación de ítems de ventas.
425	Se especificó una cantidad incorrecta en item {id}	Eliminación de ítems de ventas.
426	Se especificó una cantidad de piezas incorrecta en item {id}	Eliminación de ítems de ventas.
427	La venta quedará vacía si se elimina el ítem. Se debe eliminar la venta completa.	Eliminación de ítems de ventas.
428	El valor de la propiedad {nombre} en el campo ‘Propiedades’ no es un objeto o null	Crear pedidos.
429	No se especificaron las cantidades de piezas en el articulo con Id {id} que se maneja por piezas en el inventario	Eliminación de ítems de ventas.
500	Error desconocido	Error inesperado del sistema. Pedidos, comprobantes, preparación. Si se repite, informarlo con el request enviado.
501	Error interno	Preparación de ventas.