Ir al contenido

Comando 17 — Datos de un clienterehacer

GET /client/{clientID}. La misma información, en JSON en vez de XML, con un puñado de campos renombrados y algunos que se han mudado. Cambian dos comportamientos: el id tiene que ser el vigente del cliente, y la llamada ya no activa la app del cliente.

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
GET /client/{clientID}Clientes → Clientes - Editar
GET /referer/{refererID}Clientes - Catálogo de orígenes de contacto → Editar
GET /system/countriesGeneral → Configuración - Cargar
API V1
curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=17&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&ClientID=1&ClientFWA=0'
API V2
curl --location 'https://api.flowww.net/v2/client/1?clinicID=1' \
--header 'Authorization: Bearer <api_key>'
Elemento V1Campo V2Notas
Result—Lo sustituye el código HTTP. Un cliente inexistente — o fusionado — es un 404, no un Result=0.
ClientID, ClientNumber, ClientClinicID, ClientRefererID, ClientName, ClientSurname1/2, ClientSex, ClientIDClass, ClientPhone1/2, ClientEmail, ClientAddress, ClientPostCode, ClientNotes, ClientSMSDisabled, ClientAppToken, ClientAppDisabled, ClientCustom1…10mismos nombresPasan tal cual.
ClientDNIClientNIFRenombrado — ojo, la V1 ya era incoherente: tomaba ClientNIF al escribir y devolvía ClientDNI al leer.
ClientBirthDayClientBirthDateRenombrado.
ClientCityNameClientCityRenombrado.
ClientProvinceISO3166_2 + ClientProvinceNameClientProvinceID + ClientProvinceId numérico en vez del código ISO.
ClientCountryISO3166_1_alfa2 + ClientCountryNameClientCountryID + ClientCountryEl mismo cambio.
ClientRefererDesc—Solo vuelve el id. Resuelve la descripción con GET /referer/{refererID}.
ClientClinicName, ClientDatemismos nombresVacíos cuando la clínica usa la ficha de marketing ampliada del cliente.
ClientLoginClientFWALoginLogin del cliente en la app.
ClientWarnings* (5 campos)—Los avisos del cliente son ahora su propio recurso: GET /client/{clientID}/alert?clinicID=….
ClientLastSessionDate—No está en el detalle. Lo devuelven los endpoints de búsqueda (comando 24) junto con ClientLastPurchaseDate.
—ClientLifeCycleStageName, ClientConsent* (6), ClientEnableRGPD, ClientEnableGeneralConditions, ClientVIP, ClientCardNumber, ClientHistory, ClientVouchers, ClientDeferred, ClientRep*Nuevos en V2, sin coste.
TemaAPI V1API V2
Clientes fusionadosUn id antiguo se traducía al cliente superviviente y devolvía sus datos.404. La ficha absorbida ya no existe. Busca el cliente otra vez y guarda el id nuevo — ver 4.7.
ClientFWA=1Era una acción: activaba la app del cliente (y creaba el token) si aún no estaba activa.Desaparece del GET, que solo lee. Para activar la app en un cliente existente, envía ClientFWA: 1 en el comando 18; genera el ClientAppToken si el cliente no tenía, y esta llamada te lo devuelve.
Otros fallosResult=0 con un código.Cualquier fallo al leer el cliente responde 404. Los permisos y una clínica inválida responden 400, con el motivo en errorCode.
RespuestaQué significaQué hacer
404El cliente no existe, o se fusionó con otro.Búscalo otra vez (GET /client?clientData=).
400 (errorCode 15)El usuario de API no tiene Clientes → Clientes → Ver la ficha de un cliente.Concede el permiso.