Ir al contenido

Comando 18 — Actualizar un clienterehacer

PATCH /client/{clientID}. El mapeo de campos es el mismo que el del comando 08.

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
PATCH /client/{clientID}Clientes → Clientes - Guardar
API V1
curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=18&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&ClientID=93271' \
--data-urlencode 'ClientName=Benito' \
--data-urlencode 'ClientSurname1=Perez' \
--data-urlencode 'ClientSurname2=Galdos' \
--data-urlencode 'ClientNIF=00000000A' \
--data-urlencode 'ClientPhone1=610000000' \
--data-urlencode 'ClientEmail=benito@perez.com' \
--data-urlencode 'ClientAddress=Calle Mayor 1' \
--data-urlencode 'ClientPostCode=28013'
API V2 — solo el cambio
curl --location --request PATCH 'https://api.flowww.net/v2/client/93271' \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{ "ClientPhone1": "622334455" }'
TemaAPI V1API V2
Campos obligatoriosClientName y ClientSurname1 en cada actualización, más los que la clínica marcara como obligatorios para altas online.Pasan a ser los mismos que exige la interfaz de flowww. ClientName y ClientSurname1 dejan de ser obligatorios en cada llamada — manda solo lo que cambie — y cada campo que envíes debe cumplir las reglas del comando 08.
Clientes fusionadosTampoco se traducían: un id antiguo fallaba.404.
PaísNo se podía cambiar.ClientCountryID sí se puede cambiar.
DuplicadosSe comprobaban contra las reglas de la clínica.Solo se comprueban cuando envías ClientForceEmail: 0, igual que en el comando 08.
Consentimiento—ClientEnableRGPD sigue anulando los seis canales de consentimiento cuando lo envías; si lo omites, se mantiene el consentimiento actual.
Acceso a la appFuera de alcance: la app se activaba con ClientFWA=1 en los comandos 08 y 17.ClientFWA: 1 activa la app para el cliente y genera el ClientAppToken si no tenía. Si omites el campo, no cambia nada. El token se lee después con el comando 17. En la referencia de la API es Edit Client (updateClient).
RespuestaQué significaQué hacer
404El cliente no existe, o se fusionó con otro.Búscalo otra vez y reintenta con el id nuevo. No se ha cambiado nada.
409Cliente duplicado (con ClientForceEmail: 0), o el login de app ya lo usa otro cliente.Corrige el dato.
400 566 / 322 / 453 / 299La clínica no permite dos clientes con el mismo email / documento / teléfono / número de tarjeta.Corrige el dato.
400 invalid-request-data + fieldUn campo no cumple las reglas del comando 08.Corrige el campo.
400 (errorCode 15)El usuario de API no tiene Clientes → Clientes → Guardar.Concede el permiso.