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.
La tabla de equivalencias
Sección titulada «La tabla de equivalencias»ResultError de V1 | Qué significa | API V2 |
|---|---|---|
Result=1 | Procesado correctamente | 200 / 201 |
100000, 100001, 100003, 100004 | Parámetro inesperado, ausente, obligatorio o inválido | Normalmente 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. |
100018 | Login o contraseña incorrectos | En 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 |
100021 | La llamada superó el tiempo máximo de ejecución | 502 / 503. Léete 4.6 antes de reintentar algo que cree |
100022 | Elemento no encontrado | 404, o 400 con el errorCode propio del endpoint — 169 en presupuestos, 238 en pedidos, 717 en tickets |
100023, 100024 | No se pudo conectar con flowww | 502 / 503 — ver 4.6 |
108000, 108001 | Login o email duplicados | 409 {"message":"A client with those details already exists.","errorCode":"409"} — solo cuando envías ClientForceEmail: 0 (ver comando 08) |
108002, 108003 | No se pudo crear el cliente / límite superado | 400 con el errorCode propio del endpoint (381 límite alcanzado) |
119000 | No se pudo crear el ticket | 400 en POST /invoice: 495 ClientID inválido, 502 al cliente le faltan campos obligatorios, 50 / 142 caja (ver comando 19) |
119001 | Los pagos no cuadran con el importe de la factura | 409 49 al cerrar el ticket (PATCH /invoice/{id}), no al añadir las líneas de pago |
166, 169, 618, 619, 620 | Datos del presupuesto inválidos / producto fuera de tarifa / id de presupuesto, cliente o clínica no encontrados | 400 166 o 169 en las llamadas de presupuesto (ver comando 40) |
108004 | Pedido no aceptado, o sin stock suficiente | No se comprueba al aceptar. Al servir, 400 no-stock solo cuando no se puede servir nada |
108010, 108012 | Pedido ya servido / demasiadas unidades | La V2 no lo comprueba: revisa el pedido antes de aceptar o servir (comando 102 y comando 103) |
108011 | Página fuera de rango | Ya no aplica: GET /order no está paginado |
Fallos de V2 sin equivalencia única en V1
Sección titulada «Fallos de V2 sin equivalencia única en V1»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ón | API V2 |
|---|---|
| Cliente no encontrado — también cuando se fusionó con otro | 404 {"errorCode":"404"}. Ver 4.7 |
| El usuario no tiene el permiso del endpoint | 400 {"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érico | 400 {"errorCode":"714"} / 400 invalid-clinicid |
| System key incorrecta | 403 “Invalid systemkey…” en /getapikey — a partir de ahí la system key va ligada a la API key |
| Demasiadas peticiones simultáneas | 429. Reintenta pasado el Retry-After |
| Cuota mensual agotada | 429. No reintentes hasta el reinicio mensual — ver 4.8 |
| Problema temporal | 502 / 503. Mira 4.6 antes de reintentar una llamada que cree algo |