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 roles empleador persona jurídica y empleador persona natural

Si RESOLUCIÓN NÚMERO); yes 0 LUN 083 oe 202 28FNE 2021 Hoya no 36 2 2 3 (38 3 No. Nombre del campo 3|9 E Valores permitidos E 28132 3 E o Corresponde al indicador de novedad Código | Descripción R Registro de la novedad 12 Indicador de la novedad A 1 J Interrupción S| P Prórroga ce Cancelación Xx Corrección Se envía la respuesta dada por el solicitante: 13 Autorización del manejo de los A 2 Valor Descripción Si datos personales Si Autoriza NO No autoriza lici : Autoriza envio de notificaciones Se envía la respuesta dada por el solicitant: Ñ DA Valor Descripción 14 respecto al trámite de la afiliación, | A 2 Si Autoriza E] mediante medios electrónicos NO No autoriza Campos de respuesta o Cc ] >= Bel 2 S No. Nombre del campo 2 5 2 E Valores permitidos 5 E E S Ja 3 | 1 |Resultado S 50 Código para seguimiento de la solicitud, El 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 10 500 Error intemo 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.8 Modificación de salario Esta estructura de información le permite a SAT reportar a la caja de compensación familiar el cambio del salario de un trabajador a cargo de un empleados afiliado. De igual manera, será la estructura para que las cajas de compensación familiar reporten las novedades que se realicen directamente ante ellas. Campos de entrada No.

Nombre del campo Longitud permitida Valores permitidos Obligatorio No. Radicado de la CCF cm o CCF reporta Corresponde al número de radicado con el que la novedad. Número de transacción >| > | Tipo de dato a o Corresponde al número de transacción de SAT. ResoLución número “25 083 nez02 28ENE 2021 moya no 37 No. Nombre del campo Vatores permitidos Tipo de dato Longitud permitida Obtigatorlo Es el tipo de persona correspondiente al empleador. Valores permitidos Código Tipo Persona N Natural Al Juridica > 2 | Tipo de persona Valores permitidos: Código Tipo de documento de identificación NI Número de identificación Tipo de documento de tributaria SI identificación del empleador cc Cédula de ciudadania CE Cédula de extranjería CD Carné diplomático PE Permiso especial de permanencia Número del documento de identificación del empleador, acorde con el tipo de documento definido en el campo anterior. No se permiten puntos, comas o guiones. Número de documento de onaltuc 0 | 4 identificación del empleador | A | 18 | | Tipodeo Loma | To |] POOL 104 NO CE 3-7 | a | 3 A PE _15 N Ni 9 N Aplica para organismos públicos creados por la Serial en el SAT para ley, con la autonomia administrativa y financiera 5 ¡organismos del sector central de| A 4 | que la ley les señale, sin personería jurídica E] las entidades territoriales Cuando no se cuente con serial, se deberá colocar el valor cero (0) En formato AAAA-MM-DD. Debe corresponder a 6 |Fecha de modificación de salarioj F 10 | la fecha en que se realiza la novedad de cambioj Sl de IBC.

Los valores permitidos son: Código | Tipo de documento de Identificación 19) Registro civil Ti Tarjeta de identidad 7 Tipo de documento de A 2 cc Céduta de ciudadanía NO identificación del trabajador CE Cédula de extranjerla CD Carné diplomático PE Permiso especial de _ permanencia Solo aplica si el tipo de trabajador es dependiente Número del documento de identificación del trabajador, No se permiten puntos, comas o guiones. Tipo de Longitud | Tipo de] 8 Número documento] y 47 documentos | permitida [dato __ ! NO identificación del trabajador RC 11 N 10. JA +0 A Wi A Ñ o [9] 3-10 N RESOLUCIÓN NÚMERO 1016083 DE 2021 2 8 ENE 2021 HOJA No 38 g o 3 |3% 3 No. Nombre del campo 3 DE Valores permitidos 8 38/32 é E o CE 13-7 ¡A ” 4CD 92 HAL] PE 15 N - 9 | Primer nombre del trabajador A 60 | Primer nombre del trabajador El 10 | Primer apellido del trabajador A 60 | Primer apellido del trabajador E 11 | Salario N 10 | Corresponde al nuevo salario del trabajador EJ Es el tipo de satario de! afifiado para la relación laboral, 12 | Tipo de salario Nba ¡(E éMg0 eseripción si ijo 2 Variable 3 Integral Se envía la respuesta dada por el solicitante: 13 Autorización del manejo de los A 2 Valor Descripción si datos personales Si Autoriza NO No autoriza Autoriza envlo de notificaciones Se envía la respuesta dada por el solicitante: 14 respecto al trámite de la A 2 Valor Descripción si afiliación, mediante medios Sl Autoriza electrónicos NO No autoriza Campos de respuesta MEE E No.

Nombre del campo 2 3 E Valores permitidos El q E oo -] J3£ O 1 |Resultado A 50 | Código para seguimiento de ta 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 |Pódigo A | 10 |[500 Error intemo 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.9 Retiro definitivo del empleador al Sistema de Subsidio Familiar - SSF Esta estructura de información contiene los datos de la novedad de retiro definitivo del empleador al Sistema de Subsidio Familiar, la cual será dispuesta por SAT para que las cajas de compensación familiar puedan actualizar sus sistemas con esta novedad. De igual manera, será la estructura para que las cajas de compensación familiar reporten tos retiros definitivos de empresas que se realicen directamente ante ellas. Esta novedad sólo se podrá reportar cuando el empleador no tenga relaciones laborales vigentes o prácticas formativas vigentes. RESOLUCIÓN NÚMERO * +1.5083 oe zo21 28 ENÉ 2021 Hoya no 39 Continuación de ta resolución “Por la cual se definen los lineamientos pare la incorporación de la información y la interoperabilidad del Sistema de Subsidio Familiar en el SAT respecto a los roles empleador persona jurídica y Campos de entrada E o $133 E No. Nombre del campo $ El E Valores permitidos 5 2/33 3 Ep o . Corresponde al número de radicado con el que CCF O |No. Radicado de la CCF Aj] 50 reporta la novedad NO 1 | Número de transacción Aj] 50 | Corresponde al número de transacción de SAT SI Valores permitidos: Código ¡ Tipo de documento de identificación .

NI Número de identificación 2 Tipo de documento de Alo tributaria si identificación del empleador ul - ! cc Cédula de ciudadanía CE Cédula de extranjerla CD Carné diplomático PE Permiso especial de permanencia Número del documento de identificación del empleador, acorde con el tipo de documento definido en el campo anterior. No se permiten puntos, comas o guiones. 3 [Número de documento del y | 76 Tipo de Longitud” | Tipo de si identificación del empleador documentos | permitida _| dato ceo. 3-10 A p CE 37 A 1 CD. 13-11 IA PEL 115 NL 1 N_ Lo. 7 NL Aplica para organismos públicos creados por la ley, con la Serial en el SAT para autonomía administrativa y financiera que la ley les señale, 4 organismos del sector Alas sin personería jurídica. S central de las entidades territoriales Cuando no se cuente con serial, se deberá colocar el valor cero (0) 5 cado! Sistema o de Flo En formato AAAA-MM-DD, Debe corresponder a la fecha Ss; Subsidio Familiar en que se retira el empleador al SSF Los valores permitidos son: Códi D ipció! Causal de retiro definitivo go | eserpcon Ñ 1 Liquidación 6 ¡delempleador al Sistemade | N | 2 3 Sustitució n 7 El] Subsidio Familiar ustTiucón patrona 3 Fusión o absorción 4 Cese de actividades definitivas 5 Muerte del empleador Campos de respuesta 2 o 3 (38 E No.

Nombre del campo 3 DE Valores permitidos El 2152 3 EJ? o 1 ¡Resultado A 50 | Código para seguimiento de la soticitud si 2 ¡Mensaje A |] 200 | Mensaje de respuesta a la solicitud El RESOLUCIÓN NÚMERO ' ¡AA ASE SS 083 DE 2021 28 ENE 202 hoya No 40 interoperabilidad del Sistema de Subsidio Familiar en el SAT respecto a los roles empleador persona jurídica y Código Código de respuesta a la solicitud: Código [Mensaje 200 OK 400 Campos de entrada incompletos 401 Autenticación fallida 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 SI 3.10 Reporte del estado en el pago de aportes de los empleadores 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 empleadores. Campos de entrada No. Nombre del campo Longitud permitida Valores permitidos Obligatorio No. Radicado de la CCF > ¡Tipo de dato; [»] Corresponde al número de radicado con el que la CCF reporia. z o Tipo de documento de identificación del empleador Valores permitidos: Código Tipo de documento de identificación NI Número de identificación tributaria Cédula de ciudadania Cédula de extranjería Carné diplomático Permiso especial de permanencia El Número de documento de identificación del empleador Número del documento de identificación del empleador, acorde con el tipo de documento definido en el campo anterior. No se permiten puntos, comas o guiones.

Tipo de Longitud ¡documentos ¡permitida | date ¡CC 310. __¡N _. [ce 3-7 A [cb 13-14 A | [PE 15. iN y NI 9 ¡N si Serial en el SAT para organismos del sector central de las entidades territoriales Aplica para organismos públicos creados por la ley, con la autonomía administrativa y financiera que la ley les señale, sin personería jurídica. Cuando no se cuente con serial, se deberá colocar el valor cero (0) El] Estado de pago de aportes del empleador a la Caja de Compensación Familiar Los valores permitidos son: Código Valor At día 2 En mora SI RESOLUCIÓN NÚMERO > .* 083 pg 20294 28ENÉ 202 HOJA No 41 Campos de respuesta o a 235 E o 23 2 No. MO 23 D E Valores permitidos 5 E 22 3 1 |Resultado A 50 Código para seguimiento de la solicitud El 2 ¡Mensaje A 200 Mensaje de respuesta a la solicitud Si Código de respuesta a la solicitud: Códig |Mensaje (7 200 OK 3 Código A 10 400 Campos de entrada incompletos SI 401 Autenticación fallida 500 Error interno del servidor. Cuando al realizar la transacción el servicio no puede responder GGEXX_ |Estructura de los datos de entrada incorrectos GNXX |Validación de datos incorrecta Características técnicas de intercambio de información con SAT Las características de los servicios web que se implementan tanto en SAT, como en tas 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: 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 intemo 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 de afiliación 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 ClientiD y Password. Se recomienda que la información de Password pueda ser modificada posteriormente via 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 la 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 Social 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 2 35 2 Dolj2za E] No.

Nombre del campo 2% DE Valores permitidos EA E 3 J 2 2 e. 1 [Resultado A |50 |Código para seguimiento de la solicitud SI ResoLución Numero 3 "210083 pe 2022 28 ENE W2 osa mo 42 Campos de respuesta o 8013 E No. Nombre del campo ps 3 PE Valores permitidos 5 pa 2 2 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 5 |Fecha de la solicitud A 19 Fecha de solicitud en formato AAAA-MM-DDTHH:mm:SS | Si | 4.2.2. Para el envío de las respuestas de las Cajas de Compensación Familiar a la solicitud de afiliación se tendrá: 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. 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 ta información viajará encriptada. No se realizarán encripción adicional a los mensajes. 4.2.2.3. Registros de auditoría. El Ministerio de Salud y Protección Social guardará registro de traza de cada solicitud, a nivel de qué envla y qué respuesta obtiene. As! mismo, construirá un servicio de consulta para esta traza, con los siguientes datos: Campos de entrada 2 o 3 |33 $ No.

Nombre del campo g£ DE Valores permitidos 3 2 133 3 E o 1_ [Resultado A 50 | Código para seguimiento de la solicitud SI Campos de respuesta 3 los 2 o 23 o No.| Nombredel [o [53 Valores permitidos 5 campo E É Es a 0 Mi o Código de respuesta a la solicitud. Código I|Mensaje 200 OK 400 Campos de entrada incompletos Código 401 Autenticación fallida 1 A 10 500 Error interno del servidor. Cuando al Si realizar la transacción el servicio no puede responder GEXX Estructura de tos datos de entrada incorrectos GNXX Validación de datos incorrecta 2 |Mensaje A 200 ¡Mensaje de respuesta a la solicitud. St | 3_ | Datos de entrada Á NA. [Estructura de entrada en formato JSÓN. El 4 | Datos de respuesta] A NA. |Estructura de salida en formato JSON. Si 5 Fecha de la A 19 Fecha de solicitud en formato AAAA-MM- Si solicitud ODDTHH:mm:SS