Ir al contenido

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.

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 /clientClientes → Alta rápida - Crear
PATCH /client/{clientID}Clientes → Clientes - Guardar
GET /system/countriesGeneral → Configuración - Cargar
GET /client/{clientID}Clientes → Clientes - Editar
GET /clientClientes → Clientes - Buscar
API V1
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>
API V2
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 }

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 V1API V2Qué 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.
ClientCityNameClientCityRenombrado.
ClientBirthDayClientBirthDateRenombrado. dd/MM/yyyy, como todo en V2 — ver 4.1.
Representante legalClientRepParenthood, ClientRepName, ClientRepSurnames, ClientRepNIF, ClientRepIDClass, ClientRepAddress, ClientRepPhone, ClientRepEmailEl prefijo es ClientRep, no ClientLegalRep. Envíalos para un menor.
ClientEnableRGPDClientConsentEmail, ClientConsentSMS, ClientConsentAPP, ClientConsentPhone, ClientConsentWhatsApp, ClientConsentPostalEl 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, ClientAppDisabledmismos nombresVerdadero es -1, no 1 — ver 4.2. El cliente temporal se crea con este mismo POST /client enviando ClientTemp; no hay llamada aparte.
ClientFWAmismo nombreSigue 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.

TemaAPI V1API V2
ClínicaCon 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 obligatoriosLa 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 origenSe comprobaban.Se guardan tal cual.
MenoresRechazaba 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 ClientEnableRGPDEl valor por defecto de la clínica.Denegado en todos los canales.
Correo de bienvenidaSe podía suprimir con ClientDisableEMailNotification.Se envía siempre que la clínica tenga la app de cliente activada y el cliente tenga email.

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 omites ClientForceEmail, 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.

RespuestaQué significaQué hacer
400 invalid-request-data + fieldUn campo no cumple las reglas del mapeo.Corrige el campo.
409Cliente 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 / 340El sistema (o la clínica de pruebas) ha llegado a su máximo de clientes.Contacta con flowww.
400 403 / 706 / 707 / 708Clí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.