ACI Colombia Volver al sitio Ingresar al portal
Área de desarrolladores

Radica afiliaciones desde tu propio sistema

Una API REST para crear afiliaciones de salud, seguir su estado y descargar el soporte. Con un sandbox donde puedes probarlo todo sin tocar datos reales.

Producciónhttps://portal.acicolombia.com.co/api/external/v1
Sandboxhttps://portal.acicolombia.com.co/api/external/sandbox/v1
Ver la referencia completa
# Crear una afiliación de salud
curl -X POST https://portal.acicolombia.com.co/api/external/v1/affiliation-requests \
  -H "X-ACI-API-Key: $ACI_API_KEY" \
  -H "X-ACI-Secret-Key: $ACI_SECRET_KEY" \
  -H "Idempotency-Key: OT-1024" \
  -H "Content-Type: application/json" \
  -d '{"external_reference":"OT-1024", ...}'

Empieza en tres pasos

Del sandbox a producción sin cambiar tu código: solo cambia la URL base y las credenciales.

1

Genera tus credenciales

Dentro del portal, en Configuración › Integración API. Se muestran una sola vez: guárdalas en el gestor de secretos de tu servidor.

2

Prueba en el sandbox

Mismas rutas, otra URL base y credenciales que no se cruzan con producción. Puedes provocar el desenlace que quieras ensayar.

3

Pasa a producción

Manda tu external_reference en cada creación y usa Idempotency-Key para reintentar sin duplicar.

La documentación, por temas

Cada tarjeta abre su sección dentro de la referencia completa.

¿Necesitas credenciales o ayuda para integrar?

Escríbenos y te acompañamos en la puesta en marcha.

Escribir a info@acicolombia.com.co