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.
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 |
|---|---|
POST /client/advanced-search | Clientes → Búsqueda Avanzada - Buscar |
GET /client/{clientID} | Clientes → Clientes - Editar |
POST /acquisition | Clientes → Nuevo |
POST /acquisition/{AcqID}/client/{ClientID}/action | Clientes → Ejecutar acción |
GET /acquisition | Clientes → Captación |
DELETE /acquisition/{AcqID} | Clientes → Clientes - Eliminar listado de captación |
GET /acquisition/{AcqID} | Clientes → Ver |
El flujo
Sección titulada «El flujo»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'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.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=.
curl --location 'https://api.flowww.net/v2/acquisition/{AcqID}?Page=0' \ --header 'Authorization: Bearer <api_key>'Mapeo de campos
Sección titulada «Mapeo de campos»| API V1 | API V2 | Notas |
|---|---|---|
FromDate / ToDate | AcqStart / AcqEnd | Significan 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. |
ClientRefererID | AcqRefererID | Ahora es una lista separada por comas, y 0 significa todos los orígenes. |
| todos los cambios de etapa | AcqLifeCycleStage | Obligatorio: los ids de las etapas a las que apunta la lista. La lista contiene los clientes que están ahora en esas etapas. |
| — | AcqClinicID | Obligatorio: 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.
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Qué obtienes | Una 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 obligatorios | FromDate, ToDate y ClientRefererID. | AcqName, AcqClinicID, AcqRefererID y AcqLifeCycleStage. Los clientes sin origen no se incluyen. |
| Lecturas repetidas | Siempre las mismas filas para el mismo rango. | Los clientes ya trabajados en la lista (llamados, descartados, aplazados) desaparecen de ella. |
| Paginación | Ninguna. | 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.
Errores
Sección titulada «Errores»| Respuesta | Qué significa | Qué hacer |
|---|---|---|
400 16 | AcqName vacío, faltan etapas, clínicas u orígenes, o la lista no existe. | Completa el cuerpo o revisa el AcqID. |
400 invalid-request-data | Un 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. |