Comando 08 — Alta de clienterehacer
Da de alta un cliente. En V2 es POST /client, y casi todos los campos conservan el nombre. Lo que cambia es lo que la llamada comprueba: la detección de duplicados, los campos obligatorios y varios valores por defecto funcionan distinto — ver Qué cambia respecto a V1 bajo el mapeo.
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 | Clientes → Alta rápida - Crear |
PATCH /client/{clientID} | Clientes → Clientes - Guardar |
GET /system/countries | General → Configuración - Cargar |
GET /client/{clientID} | Clientes → Clientes - Editar |
GET /client | Clientes → Clientes - Buscar |
Antes y después
Sección titulada «Antes y después»curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=08&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&ClinicID=1' \ --data-urlencode 'ClientName=Benito' \ --data-urlencode 'ClientSurname1=Perez' \ --data-urlencode 'ClientPhone1=610000000' \ --data-urlencode 'ClientSex=M' \ --data-urlencode 'ClientEmail=benito@perez.com' \ --data-urlencode 'ClientCountryISO3166_1_alfa2=ES' \ --data-urlencode 'ClientProvinceISO3166_2=ES-M' \ --data-urlencode 'ClientRefererID=1'<Cmd08> <Result>1</Result> <ResultClientID>93271</ResultClientID></Cmd08>curl --location 'https://api.flowww.net/v2/client?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{ "ClientName": "Benito", "ClientSurname1": "Perez", "ClientPhone1": "610000000", "ClientSex": "M", "ClientEmail": "benito@perez.com", "ClientCountryID": 201, "ClientProvinceID": 32, "ClientRefererID": 1 }'{ "ClientID": 93271 }Mapeo de campos
Sección titulada «Mapeo de campos»La mayoría de campos conservan el nombre que tenían en V1, y POST /client y PATCH /client/{clientID} aceptan los mismos. Aquí va solo lo que un payload de V1 tiene que cambiar; la lista completa de campos, con tipos y límites, está en la referencia de la API (Create Client, createClient).
| API V1 | API V2 | Qué hacer |
|---|---|---|
ClientProvinceISO3166_2 (ES-M) | ClientProvinceID (28) | El id numérico, no el código ISO. Resuélvelo una vez con GET /system/provinces?countryID=… — ver 4.11. |
ClientCountryISO3166_1_alfa2 (ES) | ClientCountryID (201) | El mismo cambio. GET /system/countries trae el catálogo — ver 4.11. |
ClientCityName | ClientCity | Renombrado. |
ClientBirthDay | ClientBirthDate | Renombrado. dd/MM/yyyy, como todo en V2 — ver 4.1. |
| Representante legal | ClientRepParenthood, ClientRepName, ClientRepSurnames, ClientRepNIF, ClientRepIDClass, ClientRepAddress, ClientRepPhone, ClientRepEmail | El prefijo es ClientRep, no ClientLegalRep. Envíalos para un menor. |
ClientEnableRGPD | ClientConsentEmail, ClientConsentSMS, ClientConsentAPP, ClientConsentPhone, ClientConsentWhatsApp, ClientConsentPostal | El consentimiento es por canal. ClientEnableRGPD sigue funcionando, pero anula los seis — lee el aviso de abajo. |
ClientDisableEMailNotification | — | Desaparece. El correo de bienvenida se envía siempre que la clínica tenga la app de cliente activada y el cliente tenga email. |
ClientTemp, ClientAppDisabled | mismos nombres | Verdadero es -1, no 1 — ver 4.2. El cliente temporal se crea con este mismo POST /client enviando ClientTemp; no hay llamada aparte. |
ClientFWA | mismo nombre | Sigue siendo 1 para dar la app al cliente, y ahora también funciona al actualizar — ver comando 18. |
Merece la pena enviarlos aunque la V1 no tuviera equivalente: ClientPhonePrefix1…3 (el prefijo telefónico, aparte del número), ClientExternalReference (tu propio id, que además resuelve el referente), ClientSource, ClientCardNumber, ClientFWALogin / ClientFWAPassword y ClientLNotes.
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Clínica | Con el ajuste clínica por defecto para altas online, la V1 ignoraba ClinicID y usaba esa clínica. | El cliente se crea en el clinicID que envíes (o en la clínica por defecto del usuario de API). Ese ajuste se ignora. |
| Campos obligatorios | La V1 exigía la lista de campos que la clínica marcara como obligatorios para altas online (100003 si faltaba alguno). | Pasan a ser los mismos que exige la interfaz de flowww. La configuración de la clínica se aplica igual que al dar de alta un cliente a mano desde flowww; la lista aparte de altas online deja de ser un caso propio. |
| Códigos de país, provincia y origen | Se comprobaban. | Se guardan tal cual. |
| Menores | Rechazaba una fecha de nacimiento que exigiera representante legal. | Se acepta; envía los campos ClientRep* para crear al representante. |
Emails tipo nomail…, nowant… | Se vaciaban, y el texto pasaba a ClientCustom3. | Se guardan tal cual. |
Consentimiento si se omite ClientEnableRGPD | El valor por defecto de la clínica. | Denegado en todos los canales. |
| Correo de bienvenida | Se podía suprimir con ClientDisableEMailNotification. | Se envía siempre que la clínica tenga la app de cliente activada y el cliente tenga email. |
Duplicados
Sección titulada «Duplicados»Este es el cambio con más probabilidad de generar clientes duplicados tras el cambio.
- La V1 comprobaba siempre el email, y también el documento y los teléfonos cuando la clínica los marcaba como únicos.
- La V2 solo comprueba cuando envías
ClientForceEmail: 0. Entonces aplica las reglas de la clínica: el nombre completo siempre, y el email, el documento, los teléfonos y el número de tarjeta según su configuración. Si omitesClientForceEmail, no se comprueba nada.
Envía ClientForceEmail: 0 para que la comprobación se haga. Un duplicado responde 409 {"message":"A client with those details already exists.","errorCode":"409"}.
Recurre a ClientForceEmail: 1 solo cuando hayas verificado que sí quieres una segunda ficha — has buscado al cliente y es otra persona, o quien gestiona el 409 ha decidido crearlo igualmente. Reintentar la misma llamada con ClientForceEmail: 1 como reacción automática al 409 convierte la comprobación de duplicados en papel mojado, y es justo así como se cuelan.
Comprueba siempre que la respuesta trae un ClientID numérico antes de guardarlo.
Errores
Sección titulada «Errores»| Respuesta | Qué significa | Qué hacer |
|---|---|---|
400 invalid-request-data + field | Un campo no cumple las reglas del mapeo. | Corrige el campo. |
| 409 | Cliente duplicado (solo con ClientForceEmail: 0). | Busca el cliente existente y úsalo. Envía ClientForceEmail: 1 solo cuando alguien haya verificado que de verdad es otra persona — nunca como reintento automático. |
400 381 / 340 | El sistema (o la clínica de pruebas) ha llegado a su máximo de clientes. | Contacta con flowww. |
400 403 / 706 / 707 / 708 | Clínica conectada al registro sanitario autonómico: faltan datos obligatorios del registro, o la fecha de nacimiento está en el futuro, es demasiado antigua o no es válida. | Completa los datos. Ojo: aquí el 403 es un errorCode dentro de una respuesta 400. |
400 (errorCode 15) | El usuario de API no tiene Clientes → Alta rápida → Crear. | Concede el permiso. |