Si tu empresa tiene un proceso que lee facturas de proveedores extranjeros, recibos, identificaciones o formatos escaneados y pasa los datos a tu ERP, hay una buena probabilidad de que por dentro use Azure AI Document Intelligence, el servicio de Microsoft que hasta 2023 se llamaba Form Recognizer. Y si esa integración se hizo entre 2020 y 2022, es probable que siga llamando a la versión 2.1 de la API.
Esa versión tiene fecha de caducidad: el 15 de septiembre de 2027. Según el aviso de retiro que Microsoft publicó el 12 de septiembre de 2024, a partir de ese día todas las solicitudes con la v2.1 van a fallar. Faltan diez meses, que parece mucho hasta que uno recuerda cuánto tarda en conseguir presupuesto, encontrar a quien hizo la integración y probarla con documentos reales.
La anterior ya llegó a su fecha
No es una amenaza teórica. La v2.0 tenía su propio aviso, publicado el 15 de septiembre de 2023, con retiro el 31 de agosto de 2026. Esa fecha ya pasó y la documentación actual de Microsoft ya no cuenta la v2.0 entre las versiones vigentes. Antes, el 30 de junio de 2026, llegaron a fin de soporte tres versiones preliminares que muchos desarrolladores usaron para probar funciones nuevas.
Con la guía de migración de Microsoft, actualizada en octubre de 2026, y los avisos de retiro, el calendario queda así:
| Versión de la API | Fin de soporte |
|---|---|
| v2.0 | 31 ago 2026 (ya pasó; aviso de septiembre de 2023) |
| Preliminares 2023-10-31, 2024-02-29 y 2024-07-31 | 30 jun 2026 (ya pasó) |
| v2.1 | 15 sep 2027 |
| v3.0 (2022-08-31) | 30 mar 2029 |
| v4.0 (2024-11-30) | Versión GA recomendada |
Microsoft pide migrar a la 2024-11-30 (v4.0) "para evitar interrupciones en producción". La misma guía dice que las versiones v3.x restantes se retirarán según calendarios que irá publicando.
/formrecognizer/v2.1/prebuilt/invoice/analyze a /documentModels/prebuilt-invoice:analyze), cambia la estructura de la respuesta y hay cambios que rompen compatibilidad, como el campo boundingBox, que ahora se llama polygon. Si tu integración lee el JSON de la respuesta para llenar campos del ERP, ese código hay que reescribirlo y probarlo.Cómo saber si te afecta
La mayoría de las pymes no contrató "Document Intelligence": contrató a alguien que le hizo un proceso para leer documentos. Por eso la primera tarea es averiguar qué hay debajo:
- Busca recursos de Document Intelligence o Form Recognizer en tu suscripción de Azure. Si no tienes acceso al portal, pídele a tu proveedor la lista de servicios que te factura Microsoft.
- Revisa el código o la configuración de la integración. Si las direcciones contienen
/formrecognizer/v2.1/o/formrecognizer/v2.0/, estás en la versión vieja (y si es la 2.0, ya pasó su fecha de retiro). Si contienenapi-version=con una fecha terminada en-preview, también. - Pregunta por herramientas de terceros. Algunos complementos de captura, gestores documentales y automatizaciones usan el servicio por dentro con su propia cuenta. En ese caso la migración le toca al fabricante, pero tú tienes que preguntarle cuándo la hará.
Los modelos personalizados se vuelven a entrenar
Si tu integración usa un modelo personalizado, entrenado con tus propios formatos (las remisiones de un proveedor, un formato de pedido, una hoja de inspección), hay trabajo extra. El aviso de Microsoft recomienda volver a entrenarlos con una versión GA más nueva, y la guía agrega dos reglas:
- Los modelos entrenados con una versión preliminar se retiran junto con esa versión.
- Desde la v3.1, los modelos personalizados tienen fecha de expiración, porque se construyen sobre un modelo base que Microsoft actualiza. Al consultar un modelo, la API devuelve el campo
expirationDateTime.
Eso significa conservar los documentos de entrenamiento y sus etiquetas. Si nadie sabe dónde quedaron, reentrenar es empezar de cero.
La oportunidad: revisar si sigue siendo la mejor herramienta
Una migración obligada es buen momento para preguntarse si el diseño de 2021 sigue teniendo sentido. Desde entonces cambiaron dos cosas:
- Para facturas mexicanas no necesitas leer el PDF. El CFDI trae un XML con todos los datos fiscales; leerlo es más exacto y barato que cualquier reconocimiento de imagen. Lo explicamos en el tutorial de cómo usar IA para leer los XML del SAT.
- Los modelos de lenguaje ya extraen datos estructurados de documentos con formatos que cambian, sin entrenar un modelo por formato. Para volúmenes altos de documentos muy repetitivos, un servicio especializado como Document Intelligence sigue siendo buena opción; para formatos variados y volumen medio, conviene comparar.
Sea cual sea la decisión, que la tomes con datos: cuántos documentos procesas al mes, cuántos llegan con error y cuánto tiempo se va en corregirlos.
El patrón de Azure en estos meses
Esta no es la única fecha de retiro en los servicios de IA de Microsoft. Hace una semana contamos que Azure Content Moderator se retira en marzo, y en octubre, la lista de modelos que Azure OpenAI apaga en noviembre y diciembre. La lección se repite: cada integración con IA en la nube tiene una versión y esa versión tiene fecha de caducidad. Conviene tener una lista de lo que usas, con su fecha, y revisarla cada trimestre.
Qué hacer antes de que cierre el año
- Haz el inventario de procesos que leen documentos y de qué servicio y versión usa cada uno.
- Pide una cotización de migración a quien hizo la integración y mete el costo al presupuesto de 2027.
- Junta los documentos de entrenamiento de tus modelos personalizados.
- Planea migrar antes del verano de 2027, con tiempo para probar en paralelo con documentos reales, no el 14 de septiembre.
Si la integración la hizo alguien que ya no está, un equipo de desarrollo de software puede revisarla, migrarla a la v4.0 y dejarla documentada para la próxima fecha.
Fuentes: guía de migración de Azure Document Intelligence en Microsoft Learn (actualizada el 19 de octubre de 2026); aviso de retiro de la API GA v2.1 (12 de septiembre de 2024) y aviso de retiro de la API v2.0 (15 de septiembre de 2023), según el registro de avisos de Azure.
Inteligencia artificial
Que tu captura automática no se apague un lunes cualquiera
Hacemos el inventario de tus integraciones de IA, detectamos versiones con fecha de retiro y las migramos con pruebas sobre tus documentos.



