Configuración
Aquí se prende la conexión de la institución con SIIFA y se define, pagador por pagador, desde cuándo y para qué módulo aplica el intercambio. Se hace una vez y se revisa cuando entra un pagador nuevo.
Acceso
- Menú: SIIFA > Configuración.
- Ruta:
/siifa/configuracion.
Solo se pueden guardar cambios con permiso de modificar.
Conexión con SIIFA
| Campo | Qué poner |
|---|---|
| SIIFA activo para este prestador | Enciende o apaga el intercambio. |
| Adaptador | Simulado (fake) para pruebas, sin conectarse a nadie, o HTTP real para la conexión verdadera. |
| Ambiente | Pruebas o Producción. |
| NIT del prestador | Hasta 20 caracteres. |
| Código del prestador (REPS) | Hasta 20 caracteres. |
Con HTTP real aparecen además los datos de acceso que entrega SIIFA:
| Campo | Qué poner |
|---|---|
| URL base | La dirección del servicio. |
| URL del token (OAuth2, opcional) | La dirección para obtener el acceso, si aplica. |
| Client ID | El identificador de la institución. |
| Client secret | La clave. Una vez guardada, el campo muestra «Guardado (escriba para reemplazar)»: déjelo vacío si no quiere cambiarla. |
| Llave de API | Igual que la clave: «Guardada (escriba para reemplazar)». |
| Tiempo máximo (ms) | Entre 1.000 y 120.000. |
Oprima Guardar. El sistema avisa Configuración guardada.
Deje el Adaptador en Simulado (fake) y el Ambiente en Pruebas hasta que SIIFA le entregue las credenciales y haya probado la conexión. Pasar a Producción sin probar puede enviar respuestas reales equivocadas a un pagador.
Fases por pagador
Una fase dice: «con este pagador, para este módulo, el intercambio por SIIFA empieza en esta fecha». La sincronización solo consulta los módulos con una fase vigente.
| Campo | Qué poner |
|---|---|
| Pagador | El pagador. Obligatorio. |
| Módulo | Contratación, FEV-RIPS, Seguimiento a facturas o Seguimiento a pagos. Obligatorio. |
| Inicio | La fecha desde la cual aplica. |
| Grupo (Res. 1962) | Sin grupo, Grupo 1 o Grupo 2, el grupo que la resolución asigna al pagador. |
| Observaciones | Hasta 500 caracteres. |
| Fase activa | Interruptor para activar o suspender la fase. |
Guardar fase crea o actualiza («Fase guardada.»). Debajo, la tabla muestra Pagador, Módulo, Inicio, Grupo y Estado (Activa o Inactiva), con Editar en cada fila. Si no hay ninguna, dice Sin fases configuradas.
Recomendaciones
- Configure las fases pagador por pagador, no todas de una vez: así puede probar con uno y comprobar que la bandeja trae lo esperado.
- Registre en Observaciones de dónde sale la fecha de inicio (comunicado del pagador, resolución): evita discusiones sobre desde cuándo corren los plazos.
- No comparta el Client secret ni la Llave de API. Si cree que se conocieron, reemplácelos.
Evidencia visual
Captura pendiente.
Dirección en el sistema:
/siifa/configuracion