Guía para Desarrolladores

Bienvenido

Esta guía está dirigida a desarrolladores e ingenieros que van a implementar el estándar Sofmed Interop en los sistemas de información de una EPS o IPS.

Prerrequisitos

Conocimiento de REST APIs y JSON
Familiaridad básica con FHIR R4 (o disposición a aprenderlo)
Acceso al sistema de información de tu organización
Un entorno de desarrollo con un cliente HTTP

Recursos FHIR que debes conocer

Recurso	Cuándo lo usas
Patient	Siempre — datos del paciente
ServiceRequest	Siempre — la solicitud de referencia
Encounter	Siempre — el encuentro clínico
Organization	Siempre — IPS y EPS
Practitioner	Siempre — profesional de salud
Bundle	Siempre — paquete de la referencia

Flujo técnico resumido


1. Autenticarse → Obtener token OAuth 2.0
2. Construir Bundle → Crear recursos FHIR según perfiles Sofmed
3. Validar → Verificar conformidad con perfiles
4. Enviar → POST /fhir/Bundle
5. Consultar → GET /fhir/ServiceRequest/{id}
6. Actualizar → PUT /fhir/ServiceRequest/{id}

Secciones

Autenticación — Cómo autenticarse
Endpoints — Endpoints disponibles
Ejemplos JSON — Payloads de ejemplo
Manejo de errores — Códigos y manejo
Testing — Cómo probar tu implementación

Librerías recomendadas

Lenguaje	Librería	Enlace
Java	HAPI FHIR	hapifhir.io
.NET	Firely SDK	fire.ly/fhir-sdk
Python	fhir.resources	PyPI
JavaScript	fhir-kit-client	npm