Ir al contenido

Comando 110 — Añadir un comentario al historial del clienterenombrado

Misma llamada, algunos campos renombrados. POST /client/{clientID}/comment.

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 /client/{clientID}/commentClientes → Historial - Comentar
POST /client/{clientID}/historyClientes → Nueva conversión
GET /client/{clientID}/historyClientes → Historial - Listar
API V1
curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=110&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&ClientID=1' \
--data-urlencode 'ClientCRMDate=24/01/2022' \
--data-urlencode 'ClientCRMTime=12:00:00' \
--data-urlencode 'ClientCRMText=Llamada para confirmar la cita.'
API V2
curl --location 'https://api.flowww.net/v2/client/1/comment?clinicID=1' \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{"ClientComment": "Llamada para confirmar la cita."}'
API V1API V2Notas
ClientID{clientID} en la ruta—
ClientCRMTextClientCommentRenombrado.
ClientCRMDate + ClientCRMTime—Hueco: el comentario se sella con el momento de la llamada. Si la marca de tiempo original importa (importaciones, notas con fecha anterior), métela dentro del texto.
—?clinicID=Documentado como obligatorio: envíalo.
TemaAPI V1API V2
Comprobación del clienteRespondía “ClientID not found” cuando el cliente no existía.No comprueba que el cliente exista. Asegúrate de que el id esté vigente (los clientes fusionados no se traducen — ver 4.7).
Origen del comentarioSe marcaba como comentario externo.Se guarda como un comentario escrito por el usuario de API, igual que uno escrito en la aplicación. Empieza el texto con tu propia etiqueta (por ejemplo [Web]) si la clínica necesita distinguirlos.
FormatoTexto plano.Se convierte a HTML: los saltos de línea y los caracteres especiales se conservan para mostrarlos en la aplicación.
RespuestaQué significaQué hacer
400 224El comentario no se guardó (por ejemplo, el id no es numérico).Revisa el clientID.
400 (errorCode 15)El usuario de API no tiene Clientes → Historial → Añadir comentarios.Concede el permiso.