Módulo de compra directa FEV-RIPS: guía técnica para 2026

compra directa FEV-RIPS

La compra directa FEV-RIPS tiene desde el 11 de agosto de 2026 un módulo 5.0.0.1 en pruebas preliminares para recibir facturas convencionales sin RIPS por ventas masivas directas de medicamentos, dispositivos y APME. Los obligados técnicos son fabricantes, importadores y titulares de registro sanitario autorizados; las IPS deben evaluar su impacto como receptoras para dispensación y coordinar datos, contratos, inventario y conciliación sin asumir obligaciones ajenas.

El Ministerio de Salud y Protección Social abrió un nuevo frente dentro del ecosistema FEV-RIPS: la recepción y validación de facturas convencionales asociadas a compras masivas directas. El cambio no convierte toda compra farmacéutica en un RIPS ni traslada automáticamente la transmisión a la IPS. Crea un flujo específico para operaciones en las que fabricantes, importadores o titulares de registro sanitario venden a EPS u otros pagadores para posterior dispensación.

El micrositio oficial informa que la versión 5.0.0.1 quedó disponible en pruebas preliminares el 11 de agosto de 2026 y que opera de manera diferente al mecanismo ordinario. A 5 de septiembre, la página no anuncia allí una fecha de producción. SISPRO: Facturación Electrónica.

La acción responsable es preparar y probar integración, identidad, archivos, contratos y consultas. Las IPS receptoras deben revisar conciliación e inventario sin presentarse como emisoras cuando no tengan esa calidad.

¿Qué es el módulo de compra directa FEV-RIPS?

El módulo de compra directa FEV-RIPS es una solución del Mecanismo Único de Validación destinada a recibir facturas electrónicas convencionales sin Registro Individual de Prestación de Servicios de Salud. Su razón normativa es que una compra masiva no representa una prestación individual a un paciente y, por ello, no se soporta con RIPS.

La Resolución 948 de 2026 incluye en su ámbito a fabricantes, importadores y titulares de registro sanitario que realicen ventas masivas de medicamentos, dispositivos o insumos a EPS y otros pagadores, para entrega posterior a gestores farmacéuticos o prestadores. Ordena que estas facturas se transmitan al mecanismo, sin exigir RIPS, y prevé la generación del código de validación aplicable. Ministerio de Salud: Resolución 948 de 2026.

El manual técnico denomina el componente Factura Electrónica de Venta Compra Directa (FEVCD). Describe una API REST con ambientes Stage y Production, aunque la publicación del micrositio mantiene la versión 5.0.0.1 bajo la etiqueta de pruebas preliminares. La existencia de una URL de producción en el manual no debe interpretarse, por sí sola, como confirmación de habilitación productiva de esta versión. Ministerio de Salud: Manual de Consumo de Servicios REST FEVCD, versión 1.0.

¿A quién aplica y cuál es el papel de una IPS?

El ámbito técnico directo está delimitado. El manual se dirige a las áreas de tecnología, desarrollo y facturación de fabricantes, importadores y titulares de registro sanitario enrolados en SISPRO bajo el régimen identificado como FIT, cuando realizan ventas masivas directas a EPS u otras entidades de pago.

Una IPS puede ser destino para dispensación. Debe conciliar productos, recepciones, inventario y entrega, pero esto no la convierte en emisora. El rol concreto debe validarse contra contrato, registro e instrucciones vigentes.

ActorPapel descrito por la fuente oficialPreparación tecnológica principalQué no debe presumirse
Fabricante, importador o titularEmite y transmite la factura convencional de venta masiva directaEnrolamiento, autenticación, XML, carga, consulta y correcciónQue deba adjuntar RIPS a la compra masiva
EPS u otro pagadorAdquiere directamente y participa en la relación contractualRegistro coherente del contrato, recepción y conciliaciónQue la validación sustituya controles contractuales
Gestor farmacéuticoPuede recibir para dispensación posteriorInventario, trazabilidad y articulación con dispensaciónQue sea siempre el facturador del flujo FEVCD
IPSPuede recibir tecnologías para dispensación según el casoRecepción, inventario, gestión farmacéutica y conciliaciónQue toda IPS deba consumir la API como emisor
Ministerio/SISPRODispone recepción, validación, resultados y transferencia progresiva a SIIFAOperación y actualización del mecanismoQue una prueba preliminar sea producción confirmada

¿Por qué estas facturas se presentan sin RIPS?

El RIPS individualiza la prestación o provisión asociada a un usuario. En cambio, la operación cubierta por FEVCD es una venta masiva anterior a la dispensación individual. La Resolución 948 distingue expresamente estas facturas convencionales y señala que no requieren campos adicionales del sector salud ni soporte RIPS para este supuesto.

La factura debe transmitirse al módulo, superar las validaciones aplicables y obtener el código correspondiente. En los campos generales del XML debe registrarse el Código Único de Contrato (CUCON). Resolución 948 de 2026.

¿Qué diferencia hay frente al FEV-RIPS ordinario?

  • Objeto del registro: la ruta ordinaria relaciona FEV y RIPS de servicios o tecnologías individualizados; FEVCD recibe una factura convencional de compra masiva.
  • Archivos: el módulo de compra directa carga XML de FEV o nota crédito, no un JSON RIPS de paciente.
  • Sujetos técnicos: FEVCD se enfoca en fabricantes, importadores y titulares autorizados para el supuesto descrito.
  • Validación: conserva controles sintácticos y transaccionales, pero usa servicios y reglas propios.
  • Integración posterior: el manual prevé transferencia progresiva de información validada hacia SIIFA.

Una organización no debe reutilizar sin revisión el conector del MUV ordinario. El micrositio oficial indica que el módulo opera de manera diferente y exige seguir el manual específico. SISPRO: publicación de pruebas FEVCD.

¿Cómo funciona la API de compra directa FEV-RIPS?

El manual organiza la API REST en tres componentes: autenticación, recepción y consultas. El flujo técnico puede representarse como una secuencia controlada:

  1. Registrar al delegado autorizado y asociarlo con la entidad correspondiente en SISPRO.
  2. Autenticar el usuario y la entidad para obtener un token JWT.
  3. Construir y validar localmente el XML de FEV o nota crédito.
  4. Calcular identificadores e integridad del archivo.
  5. Cargar el documento completo o por fragmentos en el receptor.
  6. Consultar el resultado individual, masivo o por rango de fechas.
  7. Corregir rechazos con base en código, descripción y ubicación del dato fallido.
  8. Conservar la evidencia y conciliar la transferencia posterior a SIIFA.

¿Cómo opera la autenticación?

El endpoint de autenticación recibe datos del usuario y de la entidad, además del tipo de mecanismo, y retorna un JWT. El manual señala que los delegados deben estar registrados en MiSeguridadSocial y asociados a la entidad en SISPRO. Los servicios protegidos usan el token en la cabecera Authorization.

Como análisis técnico, la integración debe usar un almacén seguro de secretos, separar ambientes y aplicar rotación y revocación; el manual define el mecanismo, pero no una política completa de secretos.

¿Cómo se carga el XML?

El receptor expone un servicio de carga multipart/form-data. El archivo puede enviarse completo o fragmentado. Entre los parámetros descritos están un GUID, el tipo documental, el hash SHA-256 del archivo y, de forma opcional, una URL de webhook.

El GUID identifica la carga y el hash permite verificar integridad. El manual muestra una respuesta 409 Conflict para un duplicado y devuelve datos que facilitan reconocer el documento previamente recibido. La integración debe tratar este evento de manera idempotente: verificar antes de reenviar y no crear nuevas transacciones internas cada vez que una red inestable produce incertidumbre.

¿Cómo se consultan los resultados?

La API ofrece tres patrones:

  • Consulta individual: por código de validación, SHA-256 o GUID.
  • Consulta masiva: recibe una colección de identificadores y devuelve estados detallados.
  • Consulta por fechas: recupera documentos procesados dentro de un rango.

Los resultados pueden incluir número de factura, fecha de radicación, estado, códigos de validación, descripción y ruta del nodo problemático. El PathFuente permite orientar la corrección hacia el dato XML que falló, cuando aplique. Manual FEVCD, versión 1.0.

¿Qué significan CUCON, CUV, GUID y SHA-256?

Estos identificadores cumplen funciones distintas y no deben intercambiarse:

ElementoFunciónMomento de usoControl institucional
CUCONIdentifica el contrato registrado en SIIFAPreparación y validación transaccionalConciliar contrato, partes y vigencia
CUVConstancia de validación generada por el mecanismo cuando correspondeDespués de superar reglas aplicablesAsociarlo a factura y evidencia
GUIDIdentifica técnicamente el archivo o cargaAntes y durante la transmisiónEvitar duplicados y rastrear reintentos
SHA-256Resume criptográficamente el archivo para controlar integridadAntes de cargar y al consultarRecalcular sobre el archivo exacto
JWTAutoriza temporalmente llamadas protegidasDurante la sesión APICustodia, expiración y revocación

El manual define el CUCON como una cadena de 64 caracteres generada en SIIFA y exigida en la validación transaccional de compra directa. Define también el CUV, el JWT, el webhook, XML y XSD. La Resolución 948 explica que el CUCON permite identificar y seguir el contrato dentro de SIIFA. Manual FEVCD y Resolución 948 de 2026.

¿Qué validaciones y errores debe anticipar la integración?

El manual describe validación sintáctica de nivel 1 y transaccional de nivel 2. También menciona cruces con maestros de medicamentos, SISPRO y contratos CUCON registrados en SIIFA. Por ello, pasar un XSD local no asegura el resultado final: la estructura puede ser válida y los datos fallar frente a fuentes maestras o relaciones contractuales.

¿Cuáles son los riesgos más probables?

  • Entidad o delegado sin asociación correcta en SISPRO.
  • Credencial válida en un ambiente pero usada en otro.
  • XML que no corresponde al tipo documental esperado.
  • Archivo alterado después de calcular el SHA-256.
  • GUID reutilizado sin una política deliberada de idempotencia.
  • CUCON inexistente, inconsistente o no relacionado con las partes.
  • Reintentos automáticos que generan duplicados o saturan consultas.
  • Correcciones manuales sin trazabilidad entre versión rechazada y reenviada.

El catálogo completo de reglas debe tomarse de la documentación oficial vigente. La lista anterior combina requisitos explícitos del manual con riesgos técnicos razonables; no pretende inventar códigos de rechazo que no aparezcan en las fuentes consultadas.

¿Cómo debería prepararse un actor obligado?

La preparación de la compra directa FEV-RIPS requiere un proyecto breve pero formal, con dueños de proceso y criterios de salida.

¿Qué debe hacerse antes de integrar?

  1. Confirmar que la entidad pertenece al ámbito descrito y tiene el enrolamiento correcto.
  2. Inventariar contratos, emisores, pagadores, productos y fuentes maestras.
  3. Verificar la generación del XML convencional y las notas crédito aplicables.
  4. Definir custodia de credenciales y segregación entre Stage y producción.
  5. Asignar identificadores únicos y política de reintentos.
  6. Diseñar una bitácora que relacione factura, CUCON, GUID, hash, respuesta y CUV.

¿Qué pruebas mínimas conviene ejecutar?

  • Autenticación válida, inválida, expirada y revocada.
  • Archivo completo y carga fragmentada.
  • Documento duplicado con el mismo identificador.
  • Hash incorrecto o archivo modificado.
  • Consulta individual, masiva y por rango de fechas.
  • Rechazo de primer y segundo nivel disponible en el ambiente.
  • Interrupción de red antes y después de recibir respuesta.
  • Webhook repetido, tardío o temporalmente no disponible, si se implementa.

La entidad debe demostrar repetibilidad, conciliación y recuperación, conservando evidencia sin exponer datos sensibles o secretos.

Para comprender el flujo general relacionado, puede revisarse la guía de RIPS JSON e interoperabilidad y la información de Software Médico. Estos enlaces internos se verificaron y sirven como contexto; la fuente normativa del módulo continúa siendo el Ministerio.

¿Qué debe hacer una IPS que no transmite FEVCD?

Una IPS receptora no debería ignorar el módulo. La compra directa FEV-RIPS puede afectar la conciliación entre lo comprado por el pagador, lo recibido por la institución y lo finalmente dispensado. Su preparación se concentra en interfaces y controles internos, no necesariamente en consumir la API como emisor.

¿Qué puntos debe revisar con pagador y proveedor?

  • Identificadores de contrato y documentos compartidos.
  • Catálogo de medicamentos, dispositivos y APME usado en la recepción.
  • Unidades de medida, presentaciones y conversiones de inventario.
  • Reglas para diferencias, devoluciones, notas crédito y faltantes.
  • Trazabilidad desde la recepción hasta la dispensación.
  • Responsables y canales para conciliaciones técnicas o contractuales.

La IPS debe evitar mezclar tres eventos: compra masiva, recepción logística y dispensación individual. Pueden estar relacionados, pero tienen actores, tiempos y evidencias distintas. Un diseño de datos que preserve esa separación facilita auditoría y evita atribuir un faltante a la etapa equivocada.

¿Qué decisiones deben esperar una confirmación oficial?

No debe fijarse una fecha de salida a producción basada en rumores o en la sola existencia del ambiente productivo descrito en el manual. Tampoco debe afirmarse que el módulo cubre operaciones diferentes a las delimitadas por la Resolución 948 y la publicación oficial.

La versión consultada del micrositio solicita reportar incidencias durante las pruebas preliminares y remite al Manual de Consumo API FEVCD. Los equipos deben monitorear esa misma página para cambios de versión, reglas, instrucciones y anuncio productivo. SISPRO: módulo de compra directa.

La preparación sí puede avanzar sin esperar: sanear contratos, definir identificadores, construir trazabilidad, separar ambientes y ejecutar casos de error son inversiones útiles aun cuando cambie un endpoint o una regla.

¿Cuál es la conclusión sobre la compra directa FEV-RIPS?

La compra directa FEV-RIPS extiende el Mecanismo Único de Validación a facturas convencionales sin RIPS originadas en ventas masivas directas de tecnologías en salud. La versión 5.0.0.1 estaba en pruebas preliminares desde el 11 de agosto de 2026; por eso, el objetivo inmediato es validar preparación, no declarar producción.

Fabricantes, importadores y titulares deben confirmar ámbito, enrolamiento, CUCON, XML, seguridad, carga y consulta. Pagadores, gestores e IPS deben alinear contratos, recepción, inventario, dispensación y conciliación según su rol. Tecnología lidera la integración; facturación valida documentos; contratación gobierna CUCON; seguridad controla credenciales; y auditoría comprueba trazabilidad de extremo a extremo.

Preguntas frecuentes

¿La compra directa FEV-RIPS lleva archivo JSON de RIPS?

No para el supuesto analizado. La factura convencional de venta masiva directa se transmite sin RIPS porque no corresponde a una prestación individual.

¿Toda IPS debe conectarse a la API FEVCD?

No puede afirmarse. El manual dirige la obligación técnica a fabricantes, importadores y titulares autorizados. Una IPS puede participar como receptora para dispensación y debe validar su rol concreto.

¿La versión 5.0.0.1 ya está en producción?

La publicación oficial consultada la identifica como versión de pruebas preliminares desde el 11 de agosto de 2026 y no anuncia allí una fecha productiva.

¿Para qué sirve el CUCON?

Identifica el contrato registrado en SIIFA y participa en la validación transaccional de las facturas de compra directa.

¿Cómo se consulta una validación?

El manual contempla consultas individuales, masivas y por rango de fechas mediante servicios protegidos con token.

Si su organización necesita integrar facturación, contratos, inventario y trazabilidad alrededor de compra directa FEV-RIPS, una demostración de Software Médico puede servir para revisar interfaces y responsabilidades sobre un escenario real. Solicite una demo o contacte a un asesor, manteniendo la validación normativa y del rol concreto con la autoridad competente.

Fuentes oficiales consultadas