Ir al contenido

Comando 24 — Búsqueda de clientesrehacer

Dos sustitutos, según para qué lo usaras.

API V1
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.

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.

LlamadaPermiso
POST /client/advanced-searchClientes → Búsqueda Avanzada - Buscar
GET /clientClientes → 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.

Petición
curl --location 'https://api.flowww.net/v2/client?clientData=benito@perez.com' \
--header 'Authorization: Bearer <api_key>'
Respuesta
[
{
"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.

TemaAPI V1API V2
CriteriosNIF, 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).
CoincidenciaExacta.Contiene el término (ver arriba). Usa phoneMatch=national para teléfonos.
ClinicIDFiltraba 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 resultadosTodos.Los primeros 50, sin paginación. Afina el término si te llegan 50.
Sin resultadosLista 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.

Petición
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
}'
API V1API V2 (GET /client)
ClientID, ClientNumber, ClientClinicID, ClientLastPurchaseDate, ClientLastSessionDatemismos nombres
—además ClientFullName, ClientPhone1, ClientEmail, ClinicName y los flags ClientIncomplete / ClientDeferred / ClientInvestigate / ClientTMP
<Clients></Clients> vacío cuando no hay coincidencias404 {"message": "No clients found for the provided search criteria."} — trátalo como “no registrado”, no como un fallo
RespuestaQué significaQué hacer
404Ningún cliente coincide.Trátalo como “no registrado”.
400 375Té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.