Checklist de migración
Ve bajando por la lista. Cada paso enlaza con la sección que lo explica.
Los diecisiete pasos
Sección titulada «Los diecisiete pasos»- Prepara un usuario de API dedicado (ver 2.1): sin compartir con nadie, con permisos en el perfil de su centro de trabajo por defecto, sin verificación en dos pasos, con la lista blanca de IPs con las IPv4 públicas de tus servidores (recomendado), y sin caducidad de contraseña.
- Pide la API key una sola vez con
POST /getapikeyy guárdala como secreto (ver 2.2). Quitadoctor,pass,key,country,serverysystemkeyde todas las peticiones. No llames a/getapikeyen cada arranque. - Apunta todo a
https://api.flowww.net/v2y elimina la lógica de hosts por región. EnvíaclinicIDexplícitamente en cada llamada, y el mismo en todas las de un flujo (ver 4.3). - Cambia el parser: XML → JSON, y mueve la comprobación de éxito de
<Result>al código HTTP. Registra elerrorCodey elerrorDescriptioncuando existan (ver 4.4). - Gestiona los modos de fallo nuevos:
400conerrorCodenumérico (reglas de negocio, permisos —15—, clínica suspendida —436),403(el plan no da acceso a la API),409(conflictos),429(concurrencia o cuota — se tratan distinto),502/503. Nunca entres en bucle con un401: bloquea al usuario. - Haz seguros los reintentos: las llamadas que crean algo no son idempotentes. Tras un timeout o un
502, lee el recurso y envía solo lo que falte (ver 4.6). - Revisa los permisos del usuario de API contra los que documenta cada endpoint.
- Repasa con cada cliente su configuración: campos obligatorios para vender, reglas de caja, autorización de descuentos, control de duplicados, precios manuales en presupuestos, central de compras… (ver Ajustes que pueden bloquear la venta, y cada sección). Prueba contra una copia de su configuración real.
- Convierte los datos que envías: códigos ISO de país y provincia → ids numéricos; fecha de validez del presupuesto →
dd/MM/yyyy; precios de presupuesto → con IVA; formas de pago de V1 →paymethodIDde V2. - Decide la política de duplicados: envía
ClientForceEmail: 0enPOST /clientsalvo que compruebes tú los duplicados (ver comando 08). - Decide el modelo de consentimiento — el
ClientEnableRGPDheredado o los seis canalesClientConsent*. No los dos (ver comando 08). - Gestiona los clientes fusionados: ante un
404de un id guardado, busca el cliente otra vez y actualiza tus registros (ver 4.7). - Replantea los flujos multipaso (ventas, pedidos, presupuestos): guárdate el id que devuelve la primera llamada, confirma el resultado con un
GETal final (algunas llamadas responden200aunque una regla de la clínica haya impedido el cambio), y define qué haces cuando falla el paso 3 de 5. - Recalcula tu cuota: una venta en V1 era 1 petición; en V2 son entre 5 y 8 (ver 4.8).
- Repasa los huecos señalados en esta guía — precio de coste en las líneas de pedido, envío manual por línea, marca de tiempo de los comentarios, caducidad del bono en el momento de la venta, paginación de pedidos, histórico de cambios de etapa — y decide el apaño para cada uno antes de cambiar.
- Planifica el paso a webhooks de todo lo que hoy consultes en bucle (con suscripción Ultimate — ver 4.9).
- Corre las dos vías en paralelo contra un sistema de pruebas antes de cambiar producción, y mantén disponible la de V1 hasta que la nueva haya pasado un ciclo de negocio completo.
La V2 es mucho más amplia que la V1 {#wider}
Sección titulada «La V2 es mucho más amplia que la V1 {#wider}»Esta guía resume la documentación pública de la API de flowww. Cuando un parámetro de la V1 no tiene equivalente en V2 se señala como hueco en vez de mapearlo en silencio — contrasta esos casos con tu propia integración antes de cambiar. Para la referencia completa de cada endpoint (todos los campos, todas las respuestas, todos los códigos de error) consulta la sección de la API V2 de la documentación.