Ir al contenido

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.

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
GET /client/{clientID}Clientes → Clientes - Editar
GET /diary/{diaryGID}Agenda → Cita - Visualizar
POST /diaryAgenda → Cita - Guardar
POST /diary/{id}/moveAgenda → Cita - Guardar
GET /diaryAgenda → Agenda - Ver diaria
Agenda → Agenda - Ver semanal
Agenda → Agenda - Ver diaria por profesional
Agenda → Agenda - Ver semanal por profesional
API V1
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'
API V2
curl --location 'https://api.flowww.net/v2/diary?diaryGDate=01/04/2025&view=day&groupBy=cabinet&clinicID=1' \
--header 'Authorization: Bearer <api_key>'
API V1API V2Notas
FromDate / ToDatediaryGDate + view=day|weekHueco: 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|professionalObligatorio, 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, AppEndDiaryGID, DiaryGDate, DiaryGStart, DiaryGEndRenombrados.
Cabinet.CabID / CabNameDiaryGCabinetNum, DiaryGCabinetAbbrLa 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 / ClientPhone1DiaryGClientID, DiaryGClientName, DiaryGClientPhone1DiaryGClientName 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.
AppDelayedIDDiaryGDelayed—
Clinic.ClinicID / ClinicCommercialName—Se deduce del clinicID de la llamada.
—DiaryGConfirmed, DiaryGNotAttended, DiaryGUserName, DiaryGProductZoneCode, DiaryGLocked, DiaryGFWANuevos.

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 dos versiones no devuelven el mismo conjunto de filas. Filtra la respuesta de V2 antes de compararla con la de V1:

FilasAPI V1API V2
Citas con clienteSí.Sí.
Bloqueos, horas cerradas, candadosNo.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 ocultasSí.No.
Citas de un profesional sin turno ese día (groupBy=professional)Sí.No. Usa groupBy=cabinet para una lectura completa.
Citas de grupoUna fila por integrante.view=day: una fila por integrante. view=week: una fila para el grupo, con DiaryGClientID: 0.
Otras clínicasCualquier clínica del sistema, en una llamada.Una clínica por llamada.
  • Un usuario restringido a sus propias citas solo recibe esas, envíes lo que envíes.
  • DiaryGClientPhone1 llega vacío si el usuario no puede ver los datos de contacto de los clientes, y DiaryGClientNotes solo 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.
RespuestaQué significaQué hacer
400 invalid-request-data + fieldFalta view o groupBy, o están repetidos o son inválidos.Envía cada uno exactamente una vez.
400 21 / 20diaryGDate inválida.Usa dd/MM/yyyy.
400 448groupBy=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.