Comando 24 — Búsqueda de clientesrehacer
Dos sustitutos, según para qué lo usaras.
curl --location --request GET 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=24&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY' \ --data-urlencode 'ClientNIF=00000000A' \ --data-urlencode 'ClientPhone=650000000' \ --data-urlencode 'ClientEMail=benito@perez.com' \ --data-urlencode 'ClinicID=1'La V1 devolvía los clientes cuyo NIF, teléfono y email fueran exactamente los enviados (todos ellos), en el ClinicID indicado, y sin límite de resultados.
Permisos
Sección titulada «Permisos»La V2 comprueba un permiso de aplicación en cada llamada — la V1 no comprobaba ninguno — y una llamada a la que le falte responde 400 con errorCode 15, el mismo estado que un payload inválido (ver 4.4). Dáselos al usuario de API antes de portar el comando; los nombres son los del árbol de permisos de flowww.
| Llamada | Permiso |
|---|---|
POST /client/advanced-search | Clientes → Búsqueda Avanzada - Buscar |
GET /client | Clientes → Clientes - Buscar |
A. Búsqueda simple — GET /client?clientData=
Sección titulada «A. Búsqueda simple — GET /client?clientData=»Un único término, que se busca en el nombre y los apellidos o, si el término lo parece, en el email, el NIF o el teléfono. Es el sustituto directo del “¿está ya registrada esta persona?” — con las diferencias de abajo.
curl --location 'https://api.flowww.net/v2/client?clientData=benito@perez.com' \ --header 'Authorization: Bearer <api_key>'[ { "ClientID": 93260, "ClientNumber": 93260, "ClientFullName": "Benito Perez", "ClientPhone1": "610000000", "ClientEmail": "benito@perez.com", "ClientClinicID": 2, "ClinicName": "…", "ClientLastPurchaseDate": "17/08/2014", "ClientLastSessionDate": "21/06/2021" }]Opcional: phoneMatch=national (con phoneNationalDigits, 9 por defecto para España) para exigir coincidencia completa del número nacional cuando el término es un teléfono.
| Tema | API V1 | API V2 |
|---|---|---|
| Criterios | NIF, teléfono y email a la vez, y todos tenían que coincidir. | Un solo término. Para varios criterios a la vez, usa la búsqueda avanzada (B). |
| Coincidencia | Exacta. | Contiene el término (ver arriba). Usa phoneMatch=national para teléfonos. |
ClinicID | Filtraba los resultados por clínica. | clinicID es la clínica desde la que se busca, no un filtro. Qué clientes ve el usuario de API depende de cómo el sistema reparta los clientes entre clínicas — ver 4.10. |
| Número de resultados | Todos. | Los primeros 50, sin paginación. Afina el término si te llegan 50. |
| Sin resultados | Lista vacía. | 404 (ver el mapeo de la respuesta). |
B. Varios criterios a la vez — POST /client/advanced-search
Sección titulada «B. Varios criterios a la vez — POST /client/advanced-search»La V1 te dejaba enviar NIF y teléfono y email y devolvía los clientes que cumplieran todas las condiciones. GET /client acepta un solo término, así que una búsqueda con Y se va a la avanzada, que combina los filtros documentados en su referencia (datos de identidad y contacto, fechas, clínicas, orígenes…) más Page para paginar. Dos de esos filtros usan ids, no códigos: ClientCountryID y ClientProvinceID — resuélvelos con los catálogos de 4.11.
Paginación: Page empieza en 0 y cada página trae 50 clientes. Para cuando una página traiga menos de 50; no esperes a una página vacía. La búsqueda avanzada es más lenta que la simple en sistemas grandes: no la uses para comprobar si una persona está registrada.
curl --location 'https://api.flowww.net/v2/client/advanced-search?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{ "ClientName": "Benito", "ClientEmail": "benito@perez.com", "Page": 0 }'Mapeo de la respuesta
Sección titulada «Mapeo de la respuesta»| API V1 | API V2 (GET /client) |
|---|---|
ClientID, ClientNumber, ClientClinicID, ClientLastPurchaseDate, ClientLastSessionDate | mismos nombres |
| — | además ClientFullName, ClientPhone1, ClientEmail, ClinicName y los flags ClientIncomplete / ClientDeferred / ClientInvestigate / ClientTMP |
<Clients></Clients> vacío cuando no hay coincidencias | 404 {"message": "No clients found for the provided search criteria."} — trátalo como “no registrado”, no como un fallo |
Errores
Sección titulada «Errores»| Respuesta | Qué significa | Qué hacer |
|---|---|---|
| 404 | Ningún cliente coincide. | Trátalo como “no registrado”. |
400 375 | Término de búsqueda vacío. | Envía un término. |
400 (errorCode 15) | El usuario de API no tiene Clientes → Clientes → Buscar (o Clientes → Búsqueda avanzada). | Concede el permiso. |