Ir al contenido

Comando 50 — Lista de etapas del ciclo de vida del clienterehacer

La V1 tomaba un rango de fechas (FromDate, ToDate) y un origen (ClientRefererID) y devolvía los cambios de etapa de los clientes de ese rango: una fila cada vez que un cliente pasaba a una etapa nueva, con la fecha del cambio. La V2 no tiene equivalente de ese histórico. La herramienta más parecida es la lista de trabajo de captación: una lista de los clientes que están ahora mismo en las etapas que elijas, que se crea y luego se lee página a página, y que la clínica también puede trabajar desde la aplicación.

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/advanced-searchClientes → Búsqueda Avanzada - Buscar
GET /client/{clientID}Clientes → Clientes - Editar
POST /acquisitionClientes → Nuevo
POST /acquisition/{AcqID}/client/{ClientID}/actionClientes → Ejecutar acción
GET /acquisitionClientes → Captación
DELETE /acquisition/{AcqID}Clientes → Clientes - Eliminar listado de captación
GET /acquisition/{AcqID}Clientes → Ver
API V1 — una llamada
curl --location --request POST 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=50&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&FromDate=01/01/2026&ToDate=31/03/2026&ClientRefererID=7'
API V2 — 1. Crea la lista de trabajo (AcqClinicID '0' = todas las clínicas, AcqRefererID '0' = todos los orígenes)
curl --location 'https://api.flowww.net/v2/acquisition?clinicID=1' \
--header 'Authorization: Bearer <api_key>' \
--header 'Content-Type: application/json' \
--data '{
"AcqName": "Leads web Q1",
"AcqStart": "01/01/2026",
"AcqEnd": "31/03/2026",
"AcqClinicID": "0",
"AcqRefererID": "7",
"AcqLifeCycleStage": "1,2"
}'
→ 200 con el cuerpo vacío: el id de la lista nueva no se devuelve.
2. Averigua el id de la lista
curl --location 'https://api.flowww.net/v2/acquisition?clinicID=1' \
--header 'Authorization: Bearer <api_key>'

Busca tu AcqName en la respuesta y guárdate su AcqID. Ponle un nombre único a cada lista para poder encontrarla: la llamada acepta ?AcqName= para filtrar por nombre, y pagina de diez en diez con ?Page=.

3. Léela, página a página
curl --location 'https://api.flowww.net/v2/acquisition/{AcqID}?Page=0' \
--header 'Authorization: Bearer <api_key>'
API V1API V2Notas
FromDate / ToDateAcqStart / AcqEndSignifican otra cosa. V1: la fecha del cambio de etapa. V2: la fecha en que el cliente se dio de alta, o se convirtió desde ese origen. Mismo formato dd/MM/yyyy. Opcionales en V2.
ClientRefererIDAcqRefererIDAhora es una lista separada por comas, y 0 significa todos los orígenes.
todos los cambios de etapaAcqLifeCycleStageObligatorio: los ids de las etapas a las que apunta la lista. La lista contiene los clientes que están ahora en esas etapas.
—AcqClinicIDObligatorio: ids de clínica separados por comas, o 0 para todas.

Como la lista de trabajo es un objeto de primera clase en V2, te llevas gratis el lado del seguimiento: POST /acquisition/{AcqID}/client/{ClientID}/action registra sobre cada lead una llamada (CAL), un descarte (SKP), un aplazamiento (POS, con AcqAPostpone) o el cierre porque ya tiene cita (APP) o presupuesto (BUD), GET /acquisition lista las listas de trabajo y DELETE /acquisition/{AcqID} borra una.

TemaAPI V1API V2
Qué obtienesUna fila por cambio de etapa, con la etapa alcanzada y la fecha.Una fila por cliente que esté ahora en las etapas elegidas. Ni la fecha del cambio ni la etapa del cliente vuelven en la lista; el origen llega como descripción, no como id.
Filtros obligatoriosFromDate, ToDate y ClientRefererID.AcqName, AcqClinicID, AcqRefererID y AcqLifeCycleStage. Los clientes sin origen no se incluyen.
Lecturas repetidasSiempre las mismas filas para el mismo rango.Los clientes ya trabajados en la lista (llamados, descartados, aplazados) desaparecen de ella.
PaginaciónNinguna.Las dos lecturas paginan con Page, empezando en 0: GET /acquisition trae diez listas por página, y GET /acquisition/{AcqID} los clientes de una. Para cuando una página traiga menos elementos que la anterior.
La lista en síNo se guardaba nada.La lista queda guardada en el sistema y visible en la aplicación. Bórrala con DELETE /acquisition/{AcqID} cuando ya no la necesites.

Si lo que necesitas es el histórico de cambios de etapa, suscríbete a crm.client.updated (ver 4.9) y mantenlo tú de aquí en adelante.

RespuestaQué significaQué hacer
400 16AcqName vacío, faltan etapas, clínicas u orígenes, o la lista no existe.Completa el cuerpo o revisa el AcqID.
400 invalid-request-dataUn campo no es válido.Corrígelo. Evita las comillas dobles en AcqName.
400 (errorCode 15)El usuario de API no tiene los permisos de Clientes → Herramientas de captación.Concédeselos.