Comando 120 — Obtener las citas registradas en un sistemarehacer
La V1 respondía con todas las citas de un rango de fechas para una lista de clínicas en una sola llamada. La V2 lee la agenda como lo hace la aplicación: una clínica y un día o una semana cada vez.
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 |
|---|---|
GET /client/{clientID} | Clientes → Clientes - Editar |
GET /diary/{diaryGID} | Agenda → Cita - Visualizar |
POST /diary | Agenda → Cita - Guardar |
POST /diary/{id}/move | Agenda → Cita - Guardar |
GET /diary | Agenda → Agenda - Ver diaria Agenda → Agenda - Ver semanal Agenda → Agenda - Ver diaria por profesional Agenda → Agenda - Ver semanal por profesional |
Antes y después
Sección titulada «Antes y después»curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=120&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&FromDate=01/04/2025&ToDate=15/04/2025' \ --data-urlencode 'ClinicIDs[]=1,2'curl --location 'https://api.flowww.net/v2/diary?diaryGDate=01/04/2025&view=day&groupBy=cabinet&clinicID=1' \ --header 'Authorization: Bearer <api_key>'Mapeo de campos
Sección titulada «Mapeo de campos»| API V1 | API V2 | Notas |
|---|---|---|
FromDate / ToDate | diaryGDate + view=day|week | Hueco: no hay rango libre. view=week devuelve los 7 días que empiezan en diaryGDate (no de lunes a domingo), así que un rango de 15 días son 3 llamadas por clínica. diaryGDate es dd/MM/yyyy; una fecha inválida falla con 400 errorCode 21 (día) o 20 (semana). |
ClinicIDs[]=1,2 | ?clinicID= | Una clínica por llamada — recorre tus centros en bucle. |
| — | groupBy=cabinet|professional | Obligatorio, exactamente una vez, igual que view. Ambos funcionan con cualquiera de las dos vistas, pero la forma de la respuesta cambia: view=day&groupBy=cabinet devuelve un array pelado; las demás combinaciones devuelven {"DiaryAvailable": […], "DiaryUnavailable": […]}. |
AppID, AppDate, AppStart, AppEnd | DiaryGID, DiaryGDate, DiaryGStart, DiaryGEnd | Renombrados. |
Cabinet.CabID / CabName | DiaryGCabinetNum, DiaryGCabinetAbbr | La respuesta es plana ahora, no anidada. DiaryGCabinetNum no es el id del gabinete: es la columna del gabinete en la agenda (con groupBy=professional, la columna del profesional). El nombre del gabinete llega en DiaryAvailable[].DiaryGCabinetName. |
Client.ClientID / ClientName / ClientPhone1 | DiaryGClientID, DiaryGClientName, DiaryGClientPhone1 | DiaryGClientName llega como una única cadena de presentación (“Rosalind Franklin (nº 1)”), sin separar nombre y apellidos (los apellidos solo se incluyen si la clínica los separa), y el email del cliente no viene en esta respuesta — léelo con GET /client/{clientID} si lo necesitas. |
AppDelayedID | DiaryGDelayed | — |
Clinic.ClinicID / ClinicCommercialName | — | Se deduce del clinicID de la llamada. |
| — | DiaryGConfirmed, DiaryGNotAttended, DiaryGUserName, DiaryGProductZoneCode, DiaryGLocked, DiaryGFWA | Nuevos. |
Detalle de una cita suelta: GET /diary/{diaryGID}. Crear, mover, confirmar y anular citas son también operaciones de primera clase en V2 (POST /diary, POST /diary/{id}/move, /confirm, /cancel) — ninguna de ellas existía en V1.
Las filas no son las mismas
Sección titulada «Las filas no son las mismas»Las dos versiones no devuelven el mismo conjunto de filas. Filtra la respuesta de V2 antes de compararla con la de V1:
| Filas | API V1 | API V2 |
|---|---|---|
| Citas con cliente | Sí. | Sí. |
| Bloqueos, horas cerradas, candados | No. | Sí, mezclados con las citas: filas sin DiaryGID, o con DiaryGLocked: -1. Quédate solo con las filas que tengan DiaryGID, DiaryGLocked distinto de -1 y DiaryGClientID mayor que 0. |
| Citas no asistidas (anuladas) | Sí, marcadas. | Sí, con DiaryGNotAttended: -1. En esas filas DiaryGComments lleva el motivo. |
| Citas en gabinetes ocultos, citas ocultas | Sí. | No. |
Citas de un profesional sin turno ese día (groupBy=professional) | Sí. | No. Usa groupBy=cabinet para una lectura completa. |
| Citas de grupo | Una fila por integrante. | view=day: una fila por integrante. view=week: una fila para el grupo, con DiaryGClientID: 0. |
| Otras clínicas | Cualquier clínica del sistema, en una llamada. | Una clínica por llamada. |
Lo que el usuario de API puede ver
Sección titulada «Lo que el usuario de API puede ver»- Un usuario restringido a sus propias citas solo recibe esas, envíes lo que envíes.
DiaryGClientPhone1llega vacío si el usuario no puede ver los datos de contacto de los clientes, yDiaryGClientNotessolo aparece si la clínica muestra las notas del cliente en la agenda.- Las horas son la hora local de la clínica, sin zona horaria.
Errores
Sección titulada «Errores»| Respuesta | Qué significa | Qué hacer |
|---|---|---|
400 invalid-request-data + field | Falta view o groupBy, o están repetidos o son inválidos. | Envía cada uno exactamente una vez. |
400 21 / 20 | diaryGDate inválida. | Usa dd/MM/yyyy. |
400 448 | groupBy=professional no está disponible: la clínica exige profesional en todas las citas y algunas del rango no lo tienen. | Usa groupBy=cabinet. |
400 (errorCode 15) | El usuario de API no tiene el permiso de esa vista. Día y semana, por gabinete y por profesional, son cuatro permisos distintos en la agenda. | Concede los que uses. |