Por la cual se definen los lineamientos para la incorporación de la información y la interoperabilidad del Sistema de Subsidio Familiar en el SAT respecto a los trabajadores independientes y pensionados

Resolución · 2134 · 2021-12-17 · Jerarquía: nivel 8

Vigente
Articulado
Artículos 41–49 de 49

Artículo ANEXO (33/41)

Cuando al SI realizar la transacción el servicio no puede responder GEXX Estructura de los datos de entrada incorrectos GNXX Validación de datos incorrecta 3.3 Pérdida de la afiliación por causa grave Estas estructuras de información contienen los datos que le permiten a las cajas de compensación familiar reportar al SAT y actualizar el reporte de pérdida de la afiliación de la caja de compensación familiar para los trabajadores independientes y los pensionados, en los términos establecidos en el artículo 45 de la Ley 21 de 1982. 3.3.1 Reporte de pérdida de la afiliación del trabajador independiente por causa grave Campos de entrada Temporal 2 o 3 |38 $ No. Nombre del campo g DE Valores permitidos 5 8/32 3 E lo) Corresponde al múmero de radicado con 0 No. Radicado de la CCF A 50 | que la caja de compensación familiar Ss! reporta Valores disponibles: Código Descripción 1 Trabajador independiente . : con aporte 0.6% 1 Tipo de afiliado A 1 2 Trabajador independiente si con aporte 2% 3 Colombiano residente en el exterior con aporte 2% Es el tipo del documento de identificación del afiliado. Valores permitidos: - : Tipo de documento de Código identificación 1 . [919] Cédula de ciudadania : Tipo de documento de A A 21], . : . A 2 CE Cédula de extranjería ] sI identificación del afiliado an) Camé Diplomático. | PE Permiso Especial de: L Permanencia _ | PT Permiso por Protección | RESOLUCIÓN NÚMERO LOL 2134 De 2021 20 DIC 2021 moya no 26 2 o 31/1583 3 No. Nombre del campo 3 DE Valores permitidos 8 o 7 3 g 3 á Número del documento de identificación de! afiliado, acorde con el tipo de documento definido en el campo anterior. No se permiten puntos, comas o guiones.

Artículo ANEXO (34/41)

Número de documento de A 3 | identificación del afiliado Ap | Tipo de documentos peroo | MN L O E LL CE 37 7 £_ 0. J..31. bo PEC do 1] PT 7 4 | Primer apellido del afiliado A 60 Si 5 Primer nombre del afiliado A 60 Sl 6 Fecha de pérdida de afiliación F 10 Formato: AAAA-MM-DD Si . Se enuncia la causal en los términos 7 ¡Causa de pérdida de lal A, | 200 | establecidos en el artículo 45 de la Ley 21 | SI afiliación de 1982 Valor Descripción 1 Reporte de pérdida de la afiliación por causa grave 8 | Estado del reporte N 1 activo SI 2 Reporte de pérdida de la afiliación por causa grave “terminado Campos de respuesta e 30 28 $ No. Nombre del campo 23 > E Valores permitidos 5 E 095 l] 30 o 1 |Resultado A |50 Código para seguimiento de la solicitud St 2 ¡Mensaje A_|200 Mensaje de respuesta a la solicitud El Código de respuesta a la solicitud Código |Mensaje 200 OK 400 Campos de entrada incompletos . 401 Autenticación fallida 3 Código A |10 500 Error interno del servidor. | | SI Cuando al realizar la transacción el servicio no puede responder GEXX Estructura de los datos de entrada incorrectos GNXX Validación de datos incorrecta 3.3.2 Reporte de pérdida de la afiliación por causa grave del pensionado Campos de entrada RESOLUCIÓN NÚMERO 062134 De 2021 20 DIC 2021 HOJA No 27 o 8o 32 $ No. Nombre del campo 23 DE Valores permitidos E) E 238 Ss [e ñ . : Corresponde al número de radicado con 0 amero o ala 50 | que ta caja de compensación familiar si P reporta la novedad.

Artículo ANEXO (35/41)

Valores disponibles: Valor Descripción 1 Vinculado por fidelidad pensionado 25 años Ley 789 de 2002 con aporte del 0% 2 Vinculado por fidelidad pensionado 25 años Ley 789 de 2002 con aporte voluntario del 2% 3 Pensionado con mesada superior de 1.5 SMMLV con 1 Tipo de afiliado o vinculado A 1 aporte del 2% SI 4 Pensionado con mesada superior de 1.5 SMMLV con aporte del 0.6% 5 Pensionado con mesada hasta 1.5 SMMLV con aporte del 0% 6 Pensionado con mesada hasta 15 SMLV con aporte voluntario del 0,6% 7 Pensionado con mesada hasta 15 SMLVY con aporte voluntario del 2% Valores permitidos: Tipo de documento de Código identificación RC Registro civil TI Tarjeta de identidad a, 2 | Tipo de documento de A 2 [e10] Cédula de ciudadanía. SI identificación del afiliado CE Cédula de extranjería 019) Carné diplomático PE Permiso Especial de Permanencia ] PT "Permiso por Protección Temporal Número del documento de identificación del afiliado, acorde con el tipo de documento definido en el campo anterior. No se permiten puntos, comas o guiones. Tipo de Longitud 3 Número de documento de A 16 documento permitica Ss! identificación del afiliado RC — 0777 Ti 11 7 cc ET CE 3-7 CD 3-11 PE 15 PT 7 4 | Primer apellido del afiliado A 60 Si 5 | Primer nombre del afiliado A 60 SI 6 | Fecha de pérdida de afiliación E 10 Fecha de la notificación de la resolución si expedida por el Consejo Directivo de resoLución MúmEñoL CL 2134 pe202 20 DIC 2021 hoya no 28 o o 2 39 33 E No. Nombre del campo 253 DE Valores permitidos 5 Erss hr] 2 O acuerdo con lo establecido en el

Artículo ANEXO (36/41)

articulo 45 de la Ley 21 de 1982 Formato: AAAA-MM-DD Se enuncia la causal en los términos 7 1 Causal de retiro A 200 | establecidos en el artículo 45 de la Ley 21 SI de 1982 Valor Descripción 1 Reporte de pérdida de la afiliación por causa grave 8 | Estado del reporte N 1 activo SI 2 Reporte de pérdida de la afiliación por causa grave terminado Campos de respuesta o o e Bol 33 3 No. Nombre del campo 2 5 DE Valores permitidos Ss E 38 5 a [) 1 [Resultado A |50 Código para seguimiento de la solicitud El] 2 ¡Mensaje A_ [200 Mensaje de respuesta a la soticitud El Código de respuesta a la solicitud Código ¡Mensaje : 200 oK 400 Campos de entrada incompletos Código 401 Autenticación fallida 3 A p10 500 Error interno del servidor. si Cuando al realizar la transacción el servicio no puede responder GEXX Estructura de los datos de entrada incorrectos GNXX Validación de datos incorrecta 3.4 Reporte del estado en el pago de aportes de los trabajadores independientes y pensionados al Sistema del Subsidio Familiar El SAT dispondrá de un servicio web, con la estructura de información que se muestra a continuación, con el fin de que las cajas de compensación familiar reporten a dicho sistema el estado de pago de aportes de los trabajadores independientes y pensionados. 3.4.1 Reporte del estado en el pago de aportes de los trabajadores independientes al Sistema del Subsidio Familiar Campos de entrada 2 o 3 (38 3 No. Nombre del campo 3 DE Valores permitidos Ss 2133 E E Oo o Número de radicado de la caja A 50 Corresponde al número de radicado con el que SI de compensación familiar la CCF reporta.

Artículo ANEXO (37/41)

Tipo de documento de 0 1 identificación del afiliado A 2 |Valores permitidos: si ao y RESOLUCIÓN numeros 642134 DE 2021 20 DIC 2021 HOJA No 29 2 o 3 13% $ No. Nombre del campo 3 SE Valores permitidos > 2 (32 3 ETS 9 Código | Tipo de documento de ¡dentificación [SE ——. [Cédula de ciudadanía. CE Cédula de extranjería pele) Carné diplomático PE Permiso especial de permanencia __ PT Permiso por] Protección Temporal Número del documento de identificación del afiliado, acorde con el tipo de documento definido en el campo anterior. No se permiten puntos, comas o guiones. Número de documento de Tipo d mentos Longitud 2 identificación del afiliado A 16 L po de docume permitida _ si [e] ET CE 37 CD A PE A ¿15 a PT 17 Estado de pago de aportes del Los valores permitidos son: e Ñ Código Valor 3 lafiliado a la Caja de| N 1 7 Al dia El] Compensación Familiar 2 En mora Campos de respuesta E z. 2 dol2É 4 E No. Nombre del campo £3 > E Valores permitidos ES E 392 hr] a O 1 | Resultado A 50 | Código para seguimiento de la solicitud SI 2 |Mensaje A | 200 | Mensaje de respuesta a la solicitud Si Código de respuesta a la solicitud: Código ¡Mensaje 200 OK 400 ¡Campos de entrada incompletos . 401 Autenticación fallida 3 Cédigo A 40 |[500 Error interno del servidor. SI Cuando al realizar la transacción el servicio no puede responder GEXX Estructura de los datos de entrada incorrectos GNXX Validación de datos incorrecta 3.4.2 Reporte del estado en el pago de aportes de los pensionados al Sistema del Subsidio Familiar Campos de entrada ResoLución Número ¿0£2134 ne 2021 20 DIC 2021 hoya no 30 2 2 3 | 33 3 No.

Artículo ANEXO (38/41)

Nombre del campo 3 DE Valores permitidos 3 2133 3 : Corresponde al número de radicado con el que O |No. Radicado de la cer A 50 la CCF reporta. SI Valores permitidos: Código Tipo de documento de identificación Re Registro civil ____.. _ T Tarjeta de identidad 4 |Yipo de documento del y 2 ec Cédula de ciudadanía__|| identificación del afiliado CE Cédula de extranjería co Carné diplomático __ PE Permiso especial de permanencia ____ | Permiso por Protección PT Temporal Número del documento de identificación del afiliado, acorde con el tipo de documento definido en.el campo anterior. No se permiten puntos, comas o guiones. Longitud Tipo de documentos _| permitida - Número de documento de 2 [identificación del afiliado A | 16 [|RO si TI cc CE CD PE A 1 a] PT 7 Estado de pago de aportes del Los valores permitidos son: Ñ . Código Valor 3 jfafiliado a la Caja de| N 1 n Al dí st Compensación Familiar 2 2 En mora Campos de respuesta o s E Bo 32 2 No. Nombre del campo 23 SE Valores permitidos 5 E 22 S O 1 | Resultado A 50 | Código para seguimiento de la solicitud Sl 2 ¡Mensaje A | 200 | Mensaje de respuesta a la solicitud El] Código de respuesta a la solicitud: Código ¡Mensaje 200 OK 400 Campos de entrada incompletos : 401 Autenticación fallida 3 Código A 10 [1500 Error interno del servidor. El Cuando al realizar la transacción el servicio no puede responder GEXX Estructura de los datos de entrada incorrectos GNXX Validación de datos incorrecta RESOLUCIÓN NÚMERO LLL 2134 pez202 20 DIC 2021 hoya no 31 4.

Artículo ANEXO (39/41)

Características técnicas de intercambio de información con SAT Las caracteristicas de los servicios web que se implementan tanto en SAT, como en las Cajas de Compensación Familiar, para el envío de la información de solicitudes, cumplirán con las siguientes caracteristicas: 4.1 Lenguaje del Servicio Web. Los servicios web deben ser desarrollados haciendo uso de los siguientes elementos: j 4.1.1. Datos de entrada y salida en formato JSON 4.1.2. Servicios RESTful 4.1.3. Documentación de los servicios en Swagger Las respuestas de los servicios estarán documentadas en el Swagger que se disponga, y tendrán por lo menos un código resultado acorde a: Código Descripción 200 Éxito en la transacción 400 Datos no enviados correctamente 401 Autenticación fallida 500 Error interno del servidor. Cuando al realizar la transacción el servicio no puede responder 4.2 Esquema de seguridad. Para el acceso a los servicios Web se debe implementar: 4.2.1. Para el envío de las solicitudes a las cajas de compensación familiar, de que trata la presente resolución, se tendrá: 4.2.1.1. Esquema de seguridad OAuth2. Una vez implementado, cada caja de compensación familiar debe enviar al Ministerio de Salud y Protección Social la información de ClientlD y Password. Se recomienda que la información de Password pueda ser modificada posteriormente vía Web por el Ministerio de Salud y Protección Social, cada vez que se considere necesario. 4.2.1.2. Encripción de mensajes. El Ministerio de Salud y Protección Social enviará los mensajes de las solicitudes por canal SSL, por lo que ta información viajará encriptada. No se realizarán encripción adicional a los mensajes. 4.2.1.3. Registros de auditoría. El Ministerio de Salud y Protección Socia! guardará registro de traza de cada solicitud, a nivel de qué envía y qué respuesta obtiene. Asi mismo, construirá un servicio de consulta para esta traza, con los siguientes datos: Campos de entrada A] 2 del2E mi S No.

Artículo ANEXO (40/41)

Nombre del campo 2 | DE Valores permitidos S 2ouj¡es£ o pu 00 = 32 2 [e] 1 Resultado A |50 Código para seguimiento de la solicitud si Campos de respuesta E] 2 Boel23 E No. Nombre del campo 23 DE Valores permitidos 5 E 52 3 2 Mensaje A_ | 200 Mensaje de respuesta a la solicitud. Si 3 |Datos de entrada A_ | NA. Estructura de entrada en formato JSON Si 4 _ | Datos de respuesta A_ | NA. Estructura de salida en formato JSON Si e Fecha de la solicitud en formato AAAA-MM- 5 [Fecha de la solicitud A 19 DDTHH:mm:SS SI 4.2.2. Para el envío de las cajas de compensación familiar al SAT se tendrá en cuenta: ResoLución NUMERO LL2134 pe 2021 20 DIC 2021 HOJA No 32 4.2.2.1. Esquema de seguridad OAuth2. El Ministerio de Salud y Protección Social habilitará la funcionalidad de administración de servicios Web para que cada Caja de Compensación Familiar pueda conocer la información de ClientlD de cada servicio web dispuesto, usuario a utilizar y pueda asignar su Password. 4.2.2.2. 4.2.2.3. Encriptación de mensajes. Las Cajas de Compensación Familiar enviarán la información de cada servicio web a través de canal SSL, por lo que la información viajará encriptada. No se realizarán encripción adicional alos mensajes. Registros de auditoría. El Ministerio de Salud y Protección Social guardará registro de traza de cada solicitud, a nivel de qué envía y qué respuesta obtiene. Así mismo, construirá un servicio de consulta para esta traza, con los siguientes datos: Campos de entrada 2 o 3 (38 5 23 0 2 No. Nombre del campo g DE Valores permitidos 3 o 00 = a par 2 E + 9 1 |Resultado A 50 | Código para seguimiento de la solicitud El] Campos de respuesta 3 lua 2 sl 33 o 23 Ses - No.

Artículo ANEXO (41/41)

Nombre del campo 3 |É Valores permitidos S o S4 3 a par 2 E 2 o Código de respuesta a ta solicitud. Código [Mensaje 200 OK 400 Campos de entrada incompletos 4 Código A 10 401 Autenticación fallida SI 500 Error interno del servidor. Cuando al realizar la transacción el servicio no puede responder GEXX Estructura de los datos de entrada incorrectos GNXX Validación de datos incorrecta 2 |Mensaje A | 200 | Mensaje de respuesta a la solicitud. Si 3 | Datos de entrada A | NA. | Estructura de entrada en formato JSON. Si 4 | Datos de respuesta A | NA. | Estructura de salida en formato JSON. Si mm Fecha de la solicitud en formato AAAA-MM- 5 |Fecha de ta solicitud A 19 DDTHH:mm:SS SI

Todavía no hay normas relacionadas registradas para este documento.

¿Tienes dudas sobre esta norma? Pregúntale a la IA

Respuestas basadas en la legislación y la jurisprudencia colombianas, con las fuentes citadas.

Tipo: Resolución

Estado: Vigente

Nivel jerárquico: 8

Fuente auxiliar: No

Fundamento: CP art. 189-11 y 208; Ley 489/1998 arts. 59 y 61; Sentencia C-1005/2008 (harness/ai/instructions/piramide-normativa.md).

Fuente de la vigencia: Vigencia según el Normograma del Ministerio de Salud (valor de la fuente: «Vigente»; normograma-msps-2021.zip · hoja RESOLUCIONES · fila 251), consultado el 2026-10-22. Texto extraído del PDF oficial por OCR (Tesseract); revisar contra el original antes de citar.

Documento oficial: ver original

Preguntar a la IA sobre esta norma