Ir al contenido

Códigos de error de V1 en V2

La V1 devolvía 200 OK incluso para los errores de aplicación: había que leer <Result> y, si fallaba, <ResultError>. En V2 comprueba primero el estado HTTP. Si la respuesta incluye errorCode, úsalo para distinguir la causa concreta: es una cadena que puede contener un número o un identificador de texto, y depende del endpoint. La tabla recoge casos habituales de migración, no una conversión automática código por código; consulta también los errores de cada endpoint.

ResultError de V1Qué significaAPI V2
Result=1Procesado correctamente200 / 201
100000, 100001, 100003, 100004Parámetro inesperado, ausente, obligatorio o inválidoNormalmente 400. La validación de campos puede devolver invalid-request-data con field; si el cuerpo no se puede procesar, invalid-request-content. Otros endpoints usan sus propios códigos.
100018Login o contraseña incorrectosEn POST /getapikey: 403 “Invalid credentials…”. En cualquier otra llamada: 401 “Invalid or missing API key.”, o “Credentials have changed…” si cambió la contraseña del usuario
100021La llamada superó el tiempo máximo de ejecución502 / 503. Léete 4.6 antes de reintentar algo que cree
100022Elemento no encontrado404, o 400 con el errorCode propio del endpoint — 169 en presupuestos, 238 en pedidos, 717 en tickets
100023, 100024No se pudo conectar con flowww502 / 503 — ver 4.6
108000, 108001Login o email duplicados409 {"message":"A client with those details already exists.","errorCode":"409"} — solo cuando envías ClientForceEmail: 0 (ver comando 08)
108002, 108003No se pudo crear el cliente / límite superado400 con el errorCode propio del endpoint (381 límite alcanzado)
119000No se pudo crear el ticket400 en POST /invoice: 495 ClientID inválido, 502 al cliente le faltan campos obligatorios, 50 / 142 caja (ver comando 19)
119001Los pagos no cuadran con el importe de la factura409 49 al cerrar el ticket (PATCH /invoice/{id}), no al añadir las líneas de pago
166, 169, 618, 619, 620Datos del presupuesto inválidos / producto fuera de tarifa / id de presupuesto, cliente o clínica no encontrados400 166 o 169 en las llamadas de presupuesto (ver comando 40)
108004Pedido no aceptado, o sin stock suficienteNo se comprueba al aceptar. Al servir, 400 no-stock solo cuando no se puede servir nada
108010, 108012Pedido ya servido / demasiadas unidadesLa V2 no lo comprueba: revisa el pedido antes de aceptar o servir (comando 102 y comando 103)
108011Página fuera de rangoYa no aplica: GET /order no está paginado

Estos casos pueden ser nuevos en V2 o tener un tratamiento distinto según el comando V1. No presupongas que carecían de ResultError: revisa el comportamiento de tu integración y la respuesta del endpoint V2.

SituaciónAPI V2
Cliente no encontrado — también cuando se fusionó con otro404 {"errorCode":"404"}. Ver 4.7
El usuario no tiene el permiso del endpoint400 {"errorCode":"15"} — no un 403. (El 436, también 400, significa que la clínica está suspendida)
La clínica no existe, o clinicID no es numérico400 {"errorCode":"714"} / 400 invalid-clinicid
System key incorrecta403 “Invalid systemkey…” en /getapikey — a partir de ahí la system key va ligada a la API key
Demasiadas peticiones simultáneas429. Reintenta pasado el Retry-After
Cuota mensual agotada429. No reintentes hasta el reinicio mensual — ver 4.8
Problema temporal502 / 503. Mira 4.6 antes de reintentar una llamada que cree algo