Skip to content

Command 18 — Update a client's datarework

PATCH /client/{clientID}. The field mapping is the same as command 08.

V2 checks an app permission on every call — V1 checked none — and a call whose permission is missing answers 400 with errorCode 15, the same status as an invalid payload (see 4.4). Grant these to the API user before porting the command; the names are the ones of the permission tree in flowww.

CallPermission
PATCH /client/{clientID}Clients → Clients - Save
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 — just the change
curl --location --request PATCH 'https://api.flowww.net/v2/client/93271' \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{ "ClientPhone1": "622334455" }'
TopicAPI V1API V2
Mandatory fieldsClientName and ClientSurname1 on every update, plus the fields the clinic marked as mandatory for online registrations.The same fields the flowww interface requires. ClientName and ClientSurname1 are no longer mandatory on every call — send only what changes — and each field you send must meet the rules of command 08.
Merged clientsNot translated either: an old id failed.404.
CountryCould not be changed.ClientCountryID can be changed.
DuplicatesChecked against the clinic’s rules.Only checked when you send ClientForceEmail: 0, as in command 08.
Consent—ClientEnableRGPD still overrides the six consent channels when you send it; when omitted, the current consent is kept.
App accessOut of reach: the app was activated with ClientFWA=1 on commands 08 and 17.ClientFWA: 1 activates the app for the client and generates ClientAppToken if it had none. Omit the field and nothing changes. Read the token afterwards with command 17. See Edit Client (updateClient) in the API reference.
AnswerMeaningWhat to do
404The client does not exist, or was merged into another one.Search it again and retry with the new id. Nothing was changed.
409Duplicate client (with ClientForceEmail: 0), or the app login is already used by another client.Fix the data.
400 566 / 322 / 453 / 299The clinic does not allow two clients with the same email / ID number / phone / card number.Fix the data.
400 invalid-request-data + fieldA field does not meet the rules of command 08.Fix the field.
400 (errorCode 15)The API user lacks Clients → Clients → Save.Grant the permission.