tfhkacolwiki - Contribuciones del usuario [es]

Sector Salud Resolución 948 de 14 de Mayo 2026

2026-07-10T13:48:18Z

Amurillo: /* Implementación DLL */

<includeonly>==</includeonly>==<font color="Blue"> Resolución 0948 de 14 de Mayo de 2026</font>==<includeonly>==</includeonly>

La Resolución 0948 del 14 de mayo de 2026 del Ministerio de Salud y Protección Social actualiza y modifica los anexos técnicos de la Facturación Electrónica en Salud (FEV-Salud) y el Registro Individual de Prestación de Servicios (RIPS), estableciendo cambios estructurales obligatorios tanto en el documento XML fiscal como en el archivo JSON de RIPS que acompaña cada factura electrónica del sector salud.
<br>
Esta resolución modifica disposiciones de las resoluciones 2275 de 2023 y 1884 de 2024 en los aspectos específicos que regula, y es de adopción obligatoria para todos los facturadores electrónicos del sector salud que operan a través de la plataforma de la DIAN y del mecanismo único de validación del Ministerio de Salud y Protección Social.
<br>

====<font color="Black">Fechas Clave de Implementación</font>====
<br>

{| class="wikitable" style="margin: 0 auto; width: 80%;"
! style="color:white; background-color:#337ab7; font-size: 110%;" | Fecha
! style="color:white; background-color:#337ab7; font-size: 110%;" | Hito
! style="color:white; background-color:#337ab7; font-size: 110%;" | Impacto para el Integrador
|-
| <center>'''1 de junio de 2026'''</center>
| <center>'''Activación de Reglas Severas'''</center>
| Las reglas de validación que anteriormente generaban '''Notificación''' pasan a generar '''Rechazo'''. Los documentos que no cumplan con los nuevos nodos y estructuras del XML serán rechazados por el mecanismo de validación del Ministerio.
|-
| <center>'''1 de julio de 2026'''</center>
| <center>'''Obligatorio en Producción'''</center>
| Fecha límite para que todos los facturadores electrónicos tengan implementados en producción los ajustes estructurales: CIE-11, reubicación de anticipos, nuevos nodos XML (FACTURA_SIN_CONTRATO) y demás cambios establecidos en la presente resolución.
|}
<br>

====<font color="Black">URL Web Service SOAP Versión 4</font>====

* <font color="Black">URL Demo:</font> [http://demoemision21v4.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl http://demoemision21v4.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl]

* <font color="Black">URL Producción:</font> [https://emision21v4.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl https://emision21v4.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl]
<br>

====<font color="Black">URL Web Service REST</font>====

* <font color="Black">URL Demo:</font> [https://demoemision21-api.thefactoryhka.com.co https://demoemision21-api.thefactoryhka.com.co]

* <font color="Black">URL Producción:</font> [https://emision21-api.thefactoryhka.com.co https://emision21-api.thefactoryhka.com.co]
<br>

<font color="blue">'''@IMPORTANTE:'''</font> Asegúrese de utilizar la '''Versión 4''' del servicio SOAP (<code>emision21v4</code>) para que la extensión UBL del sector salud sea generada correctamente según los lineamientos de la Resolución 0948:2026.

<includeonly>==</includeonly>==<font color="Blue"> Resumen de Cambios Estructurales</font>==<includeonly>==</includeonly>
La Resolución 0948 introduce modificaciones en dos documentos técnicos independientes: el Documento Técnico N°2 (XML - FEV). A continuación se presenta un resumen de todos los cambios que deben ser implementados por las casas de software e integradores:
<br>

{| class="wikitable" style="margin: 0 auto; width: 95%;"
|+ style="font-size: 115%;"|'''Cambios Estructurales — Documento Técnico N°2 (XML - FEV en Salud)'''
! style="color:white; background-color:#2F5496; text-align:center;" | N°
! style="color:white; background-color:#2F5496; text-align:center;" | Cambio
! style="color:white; background-color:#2F5496; text-align:center;" | Descripción
! style="color:white; background-color:#2F5496; text-align:center;" | Obligatoriedad
|-
| <center>1</center>
| '''Reubicación de Recaudos y Anticipos'''
| Copago, Cuota Moderadora, Pagos Compartidos y Anticipos se eliminan del <nowiki>UBLExtension</nowiki> (Extensión Salud) y pasan obligatoriamente al nodo estándar de la DIAN <nowiki><cac:PrepaidPayment></nowiki> con el atributo <nowiki>schemeID="conceptoRecaudo"</nowiki>.
| <center>'''Obligatorio'''</center>
|-
| <center>2</center>
| '''Nuevo Nodo FACTURA_SIN_CONTRATO'''
| Si la atención no tiene un Código Único de Contrato (CUCON), el campo NUMERO_CONTRATO viaja vacío y se vuelve obligatorio instanciar el campo adicional <nowiki><Nombre>22</Nombre></nowiki> con un valor numérico del 1 al 6 que justifica la ausencia de contrato.
| <center>'''Obligatorio'''<br>(cuando no hay CUCON)</center>
|-
| <center>3</center>
| '''Compras Directas SIN RIPS'''
| Las compras masivas directas de EPS a laboratorios o fabricantes ya no llevan RIPS. Para estas facturas comerciales se debe usar el campo <nowiki><cbc:Note></nowiki> a nivel raíz para incrustar la cadena del CUCON: <nowiki><cbc:Note>CUCON:123...</cbc:Note></nowiki>
| <center>'''Obligatorio'''<br>(cuando aplica)</center>
|-
| <center>4</center>
| '''Nota a Nivel de Línea (InvoiceLine)'''
| Se habilita el campo <nowiki>cbc:Note</nowiki> en la línea de detalle de la factura (hasta 5.000 caracteres) para justificar cuando se deba facturar el mismo código CUPS con descripciones y valores diferentes en distintas líneas.
| <center>Opcional</center>
|-
| <center>5</center>
| '''Actualización de Cabecera (CustomTagGeneral)'''
| La URL del Responsable en el CustomTagGeneral cambia a la web del SISPRO, y la etiqueta del acto administrativo debe actualizarse a '''Resolución 0948:2026'''.
| <center>'''Obligatorio'''</center>
|}
<br>

<includeonly>==</includeonly>==<font color="Blue"> Actualización de Cabecera — CustomTagGeneral</font>==<includeonly>==</includeonly>
Con la entrada en vigencia de la Resolución 0948, el nodo <code>CustomTagGeneral</code> del XML fiscal debe ser actualizado en dos elementos:
<br>

*La '''URL del Responsable''' cambia de la web del Ministerio de Salud a la web del '''SISPRO''': <code>https://web.sispro.gov.co</code>
*La etiqueta del '''acto administrativo''' debe actualizarse de "Resolución 2275:2023" a '''<nowiki>Resolución 0948:2026</nowiki>'''.
<br>

<ActoAdministrativo>Resolución 0948:2026</ActoAdministrativo>
<UrlResponsable>https://web.sispro.gov.co</UrlResponsable>

<font color="blue">'''@IMPORTANTE:'''</font> Esta actualización es responsabilidad de la plataforma de emisión (HKA Integración). El integrador no necesita enviar ningún campo adicional; la cabecera se genera automáticamente con base en los parámetros de la cuenta configurada. Sin embargo, es fundamental verificar que la versión del servicio de emisión utilizado refleje la nueva cabecera antes del '''1 de junio de 2026'''.
<br>

<includeonly>==</includeonly>==<font color="Blue">Campos Adicionales Factura Electrónica Sector Salud</font>==<includeonly>==</includeonly>
Los facturadores electrónicos del sector salud, deberán incluir la siguiente información en campos individuales y separados de tal forma que atiendan las especificaciones de estándares UBL ("Universal Business Language") en formato XML, según lo dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
<br>

'''Información sobre el grupo UBLExtension:'''

✓ Código del prestador de servicios de salud

✓ Modalidades de pago

✓ Cobertura o plan de beneficios

✓ Número de contrato o

✓ Número de póliza

✓ Factura sin contrato

<includeonly>==</includeonly>==<font color="Blue"> Cambio 1: Reubicación de Recaudos y Anticipos en PrepaidPayment</font>==<includeonly>==</includeonly>
Este es el cambio más significativo de la Resolución 0948. Todos los conceptos de Copago, Cuota Moderadora, Pagos Compartidos y Anticipos se eliminan por completo de la extensión de salud (<code>UBLExtension</code>) y deben mapearse '''única y obligatoriamente''' en el nodo estándar de la DIAN <nowiki><cac:PrepaidPayment></nowiki> en la raíz de la factura, con el atributo <nowiki>schemeID="conceptoRecaudo"</nowiki>.
<br>

'''Información sobre el grupo PrepaidPayment'''

✓ Copago

✓ Cuota moderadora

✓ Pagos compartidos en planes voluntarios de salud

✓ Anticipos

====<font color="Black">Códigos de Tipo de Recaudo</font>====
<br>

{| class="wikitable" style="margin: 0 auto; width: 60%;"
! style="color:white; background-color:#2F5496; text-align:center;" | Código
! style="color:white; background-color:#2F5496; text-align:center;" | Concepto de Recaudo
! style="color:white; background-color:#2F5496; text-align:center;" | Nodo XML Generado
|-
| <center>01</center>
| Copago
| <nowiki><cac:PrepaidPayment schemeID="conceptoRecaudo"></nowiki>
|-
| <center>02</center>
| Cuota Moderadora
| <nowiki><cac:PrepaidPayment schemeID="conceptoRecaudo"></nowiki>
|-
| <center>03</center>
| Pagos Compartidos en Planes Voluntarios
| <nowiki><cac:PrepaidPayment schemeID="conceptoRecaudo"></nowiki>
|-
| <center>04</center>
| Anticipo
| <nowiki><cac:PrepaidPayment schemeID="conceptoRecaudo"></nowiki>
|-
| <center>05</center>
| No Aplica
| <nowiki><cac:PrepaidPayment schemeID="conceptoRecaudo"></nowiki>
|}
<br>

<font color="blue">'''@IMPORTANTE:'''</font> El servicio admite el reporte de '''hasta 4 nodos''' <nowiki><cac:PrepaidPayment></nowiki> por factura. La sumatoria de todos los recaudos reportados debe coincidir con el valor del campo <code>totalAnticipos</code> del Objeto Factura.
<br>

Para integracion alternativa como la DLL los campos del identificador '''06B''' (Copago, Cuota Moderadora y Pagos Compartidos) dentro de la clase <code>CamposGenerales ID06B</code> deben enviarse '''vacíos'''.
<br>

====<font color="Black">Implementación REST (JSON)</font>====
En el servicio REST se debe utilizar el arreglo <code>anticipos</code> dentro del Objeto Factura, incluyendo en cada nodo el campo <code>extras</code> con <code>nombre="recaudo"</code> y el código del concepto en <code>valor</code>. Los campos de Copago, Cuota Moderadora y Pagos Compartidos dentro de <code>CamposGenerales</code> ya no se envian:

"factura": {
// Se admite el reporte de hasta 4 Anticipos
"anticipos": [
{
// Campo obligatorio Res. 948: identificador del tipo de recaudo
"extras": [
{
"nombre": "recaudo", // Fijo: siempre "recaudo"
"valor": "01", // 01=Copago | 02=Cuota Mod. | 03=Pagos Compartidos | 04=Anticipo
"controlInterno1": null,
"controlInterno2": null
}
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
"id": "1", // Secuencia del nodo (1 a 4)
"instrucciones": "Copago", // Descripción del concepto de recaudo
"montoPagado": "41.00"
},
{
"extras": [
{
"nombre": "recaudo",
"valor": "02", // Cuota Moderadora
"controlInterno1": null,
"controlInterno2": null
}
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
"id": "2",
"instrucciones": "Cuota Moderadora",
"montoPagado": "41.00"
}
],
// totalAnticipos = sumatoria de todos los montoPagado reportados
"totalAnticipos": "82.00",
"sectorSalud": {
"Pacientes": [
{
"CamposGenerales": [
{ "Nombre": "1", "Valor": "8632000024" }, // Código PSS
{ "Nombre": "9", "Valor": "04" }, // Modalidad de Pago
{ "Nombre": "10", "Valor": "01" }, // Cobertura Plan
{ "Nombre": "14", "Valor": "e3b0c44298fc..." }, // CUCON
{ "Nombre": "15", "Valor": "654321" }, // Número Póliza
]
}
]
}
}

====<font color="Black">Implementación SOAP (XML)</font>====
En el servicio SOAP se utiliza el nodo <code><anticipos></code> dentro del Objeto Factura. Cada <code><Anticipos></code> debe contener el subnodo <code><extras><Extensible></code> con <code><nombre>recaudo</nombre></code> y el código correspondiente en <code><valor></code>:

<Anticipos>

<extras>
<Extensible>

<nombre>recaudo</nombre>

<valor>01</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>1</id>

<instrucciones>Copago</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
<Anticipos>
<extras>
<Extensible>
<nombre>recaudo</nombre>
<valor>02</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>2</id>
<instrucciones>Cuota Moderadora</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
<Anticipos>
<extras>
<Extensible>
<nombre>recaudo</nombre>
<valor>03</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>3</id>
<instrucciones>Pagos Compartidos</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>

En el campo PrepaidAmount TOTAL DE ANTICIPOS = SUMATORIA DE TODOS LOS montoPagado
<totalAnticipos>123.00</totalAnticipos>

<Pacientes>
<DatosPacienteSalud>
<CamposGenerales>
<GeneralSalud><Nombre>1</Nombre><Valor>8632000024</Valor> </GeneralSalud>
<GeneralSalud><Nombre>9</Nombre><Valor>04</Valor></GeneralSalud>
<GeneralSalud><Nombre>10</Nombre><Valor>01</Valor></GeneralSalud>
<GeneralSalud><Nombre>14</Nombre><Valor>e3b0c44298fc...</Valor></GeneralSalud>
<GeneralSalud><Nombre>15</Nombre><Valor>654321</Valor></GeneralSalud>
</CamposGenerales>
</DatosPacienteSalud>
</Pacientes>
<br>

====<font color="Black">Implementación DLL</font>====
Desde la integración por DLL, se debe utilizar la clase <code>Anticipos</code> ID 04 del Objeto Factura. El campo <code>Extras</code> de cada anticipo debe contener un objeto <code>Extensible</code> con <code>Nombre = "recaudo"</code> y el código del concepto en <code>Valor</code>. Los campos 06B del <code>CamposGenerales</code> se asignan como cadena vacía:

<pre>
Anticipos= "02A||2024-02-27||1|Copago|41.00|||recaudo|01|"
Anticipos1= "02A||2024-02-27||2|Cuota Moderadora|41.00|||recaudo|02|"
Anticipos2= "02A||2024-02-27||3|Pagos Compartidos|41.00|||recaudo|03|"
ID02A = Anticipos + "%" + Anticipos1 + "%" + Anticipos2
</pre>

Total de anticipos del ID02 = sumatoria de todos los montos recaudados, este valor se resta del total del documento TotalAnticipos = "123.00"

<includeonly>==</includeonly>==<font color="Blue"> Cambio 2: Nuevo Nodo FACTURA_SIN_CONTRATO</font>==<includeonly>==</includeonly>
La Resolución 0948 introduce el campo adicional '''FACTURA_SIN_CONTRATO''' para los casos en que la atención médica no esté respaldada por un Código Único de Contrato (CUCON). La regla es la siguiente:
<br>

*Cuando '''sí existe CUCON''': el campo <code>NUMERO_CONTRATO</code> (<code>Nombre="14"</code>) se llena con el hash del CUCON y el '''Nuevo''' Campo 22 '''no se envía'''.
*Cuando '''NO existe CUCON''': el campo <code>NUMERO_CONTRATO</code> (<code>Nombre="14"</code>) viaja '''vacío''' y es '''obligatorio''' incluir el '''Nuevo''' campo adicional <code>Nombre="22"</code> con el código numérico que justifica la ausencia de contrato.
<br>

====<font color="Black">Códigos de Justificación — FACTURA_SIN_CONTRATO (Nombre=22)</font>====
<br>

{| class="wikitable" style="margin: 0 auto; width: 70%;"
! style="color:white; background-color:#2F5496; text-align:center;" | Código (Valor)
! style="color:white; background-color:#2F5496; text-align:center;" | Justificación de Ausencia de Contrato
|-
| <center>01</center>
| ATENCION DE URGENCIAS
|-
| <center>02</center>
| ATENCION A CARGO DE ADRES O DE ASEGURADORA SOAT, PLANES VOLUNTARIOS DE SALUD
|-
| <center>03</center>
| ATENCION EN SALUD POR FALLOS DE TUTELA/ORDENES JUDICIALES
|-
| <center>04</center>
| ATENCION EN SALUD POR PORTABILIDAD O EN LOS CASOS DE ASIGNACION MASIVA DE AFILIADOS - ARTICULO 2.5.3.4.7.9 DEL DECRETO 780/2016
|-
| <center>05</center>
| ATENCION EN SALUD EN CASOS EXCEPCIONALES POR COTIZACIONES O AUTORIZACIONES SIN CONTRATO ATENCIONES ADICIONALES EXCEPCIONALES
|-
| <center>06</center>
| GESTION RECUPERACION DE ORGANOS PARA TRASPLANTE EN CUMPLIMIENTO LEY ESTATUTARIA 1751 DE 2015
|}
<br>

<font color="blue">'''@IMPORTANTE:'''</font> El campo <code>Nombre="22"</code> debe ubicarse dentro del arreglo <code>CamposGenerales</code> de la clase <code>DatosPacienteSalud</code>, después del campo <code>Nombre="15"</code> (Número de Póliza). Su ausencia cuando <code>NUMERO_CONTRATO</code> está vacío generará '''rechazo''' a partir del 1 de junio de 2026.
<br>

====<font color="Black">Implementación REST (JSON) — Factura Sin Contrato</font>====

"factura": {
"sectorSalud": {
"IdPersonalizacion": "SS-CUFE",
"Pacientes": [
{
"CamposGenerales": [
{
"Nombre": "1",
"Valor": "8632000024" // Código del PSS (Prestador de Servicios de Salud)
},
{
"Nombre": "9",
"Valor": "04" // Modalidad de Pago
},
{
"Nombre": "10",
"Valor": "01" // Cobertura o Plan de Beneficios
},
{
// NUMERO_CONTRATO (CUCON): viaja VACÍO cuando no hay contrato
"Nombre": "14",
"Valor": ""
},
{
"Nombre": "15",
"Valor": "222222222" // Número de Póliza (si aplica)
},
{
'''// NUEVO CAMPO RES. 948: FACTURA_SIN_CONTRATO'''
"Nombre": "22",
"Valor": "01" // Código de justificación (1=Urgencias, 2=Tutelas, etc.)
}
]
}
],
"TipoEscenario": "2"
}
}
<br>

====<font color="Black">Implementación SOAP (XML) — Factura Sin Contrato</font>====

<IdPersonalizacion>SS-CUFE</IdPersonalizacion>
<Pacientes>
<DatosPacienteSalud>
<CamposGenerales>
<GeneralSalud>

<Nombre>1</Nombre>
<Valor>8632000024</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>9</Nombre>
<Valor>04</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>10</Nombre>
<Valor>01</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>14</Nombre>
<Valor></Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>15</Nombre>
<Valor>654321</Valor>
</GeneralSalud>
<GeneralSalud>
'''// NUEVO CAMPO RES. 948: FACTURA_SIN_CONTRATO'''



<Nombre>22</Nombre>
<Valor>06</Valor>
</GeneralSalud>
</CamposGenerales>
</DatosPacienteSalud>
</Pacientes>
<TipoEscenario>2</TipoEscenario>
<br>

====<font color="Black">Implementación DLL — Factura Sin Contrato</font>====
Desde la integración por DLL, el campo <code>FACTURA_SIN_CONTRATO</code> se gestiona a través del campo <code>Extras</code> del Objeto Factura usando el identificador <code>04</code> y el código de campo extra <code>4001</code>, siguiendo el formato de cadena pipe-delimitada:

'''FACTURA SIN CONTRATO - Resolución 0948:2026'''

Formato del campo '''Extras = 04|controlInterno1|controlInterno2|nombre|pdf|valor|xml'''

Donde el último valor (1-6) es el código de justificación de ausencia de contrato

*Extras1 = "04|||4001|0|01|0"
*Extras= Extras1

' Ejemplo: ATENCION DE URGENCIAS(código 01) String = "04|||4001|0|01|1"

' Ejemplo: GESTION RECUPERACION DE ORGANOS PARA TRASPLANTE EN CUMPLIMIENTO LEY ESTATUTARIA 1751 DE 2015 (código 06) String = "04|||4001|0|06|0"
<br>

<font color="blue">'''@IMPORTANTE:'''</font> El campo <code>Extra 4001</code> debe enviarse, si dentro del arreglo <code>CamposGenerales ID06B</code> el campo <code>NUMERO_CONTRATO</code> está vacío generará '''rechazo''' a partir del 1 de junio de 2026.
<br>

<includeonly>==</includeonly>==<font color="Blue"> Cambio 3: Compras Directas SIN RIPS</font>==<includeonly>==</includeonly>
Las compras masivas directas realizadas por las EPS a laboratorios o fabricantes de medicamentos ya no llevan RIPS asociados. Para estas facturas comerciales, la Resolución 0948 establece que el integrador debe incrustar el CUCON en el campo <code>cbc:Note</code> clase <code>cbc:informacionAdicional</code>
a nivel de la raíz de la factura, utilizando el prefijo <code>CUCON:</code> seguido del hash del contrato.
<br>

<font color="blue">'''@IMPORTANTE:'''</font> Este tipo de factura es una '''factura comercial estándar''' que no activa el mecanismo de validación de RIPS del Ministerio de Salud. El campo <code>tipoSector</code> no debe ser "2" (Sector Salud), y la clase <code>sectorSalud</code> no se incluye en la estructura.
<br>

====<font color="Black">Implementación REST (JSON) — Compra Directa sin RIPS</font>====

"factura": {
"tipoDocumento": "01",
"tipoOperacion": "10",
// tipoSector NO debe ser "2" para compras directas sin RIPS
// El CUCON se reporta en informacionAdicional con el prefijo "CUCON:"
"informacionAdicional": [
"CUCON:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
],
// La clase sectorSalud NO se incluye en este tipo de factura
"sectorSalud": null
}

<br>

====<font color="Black">Implementación SOAP (XML) — Compra Directa sin RIPS</font>====

Esto genera el nodo cbc:Note a nivel raíz del XML fiscal -->

<informacionAdicional>
<arr:string>CUCON:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855</arr:string>

</informacionAdicional>




<br>

====<font color="Black">Implementación DLL — Compra Directa sin RIPS</font>====
Desde la integración por DLL, el CUCON se reporta usando el identificador <code>02I</code> (Información Adicional). Este genera el nodo <code>cbc:Note</code> con el prefijo <code>CUCON:</code> en el XML fiscal:

// COMPRA DIRECTA SIN RIPS - Resolución 0948:2026

// Identificador 02I: Información Adicional → genera cbc:Note en el XML raíz

// El CUCON se reporta con el prefijo "CUCON:" en el campo InformacionAdicional

"CUCON:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

// La clase SectorSalud NO se instancia para este tipo de factura
// SectorSalud = null; (no se asigna)

// TipoSector NO debe ser "2" para facturas comerciales sin RIPS
TipoSector = ""; // Campo vacío o no asignado
<br>

<includeonly>==</includeonly>==<font color="Blue"> Cambio 4: Nota Aclaratoria a Nivel de Línea (InvoiceLine)</font>==<includeonly>==</includeonly>
La Resolución 0948 habilita el campo <code>cbc:Note</code> a nivel de línea de detalle de la factura (nodo <code>InvoiceLine</code>). Este campo acepta hasta '''5.000 caracteres''' y su propósito es justificar los casos en que se deba facturar el mismo código CUPS con descripciones y/o valores diferentes en distintas líneas de la misma factura.
<br>

Este campo ya existía en la estructura de HKA Integración como el campo <code>nota</code> de la clase <code>FacturaDetalle</code>. La Resolución 0948 lo formaliza y amplía su uso para el sector salud.
<br>

====<font color="Black">Implementación REST (JSON) — Nota a Nivel de Línea</font>====

<syntaxhighlight lang="javascript">
{
"factura": {
"detalleDeFactura": [
{
"secuencia": "1",
"codigoProducto": "890401",
"descripcion": "INTERCONSULTA POR MEDICINA GENERAL",
"estandarCodigo": "IMG",
"estandarCodigoProducto": "999",
// Res. 948: nota a nivel de línea (hasta 5.000 caracteres)
// Justifica el mismo código CUPS con diferente valor o descripción
"nota": "Consulta realizada en modalidad presencial. Tarifa aplicada según contrato EPS-IPS. Código CUPS: 890401.",
"cantidadReal": "1.00",
"cantidadUnidades": "1.00",
"precioVentaUnitario": "100.00",
"precioTotalSinImpuestos": "100.00",
"precioTotal": "100.00",
"unidadMedida": "WSD"
},
{
"secuencia": "2",
"codigoProducto": "890401", // Mismo código CUPS
"descripcion": "INTERCONSULTA POR MEDICINA GENERAL",
// Nota diferente para justificar el mismo CUPS con distinto valor
"nota": "Consulta realizada en modalidad telemedicina interactiva. Tarifa diferencial según Res. 948.",
"cantidadReal": "1.00",
"cantidadUnidades": "1.00",
"precioVentaUnitario": "80.00", // Valor diferente al de la línea 1
"precioTotalSinImpuestos": "80.00",
"precioTotal": "80.00",
"unidadMedida": "WSD"
}
]
}
}
</syntaxhighlight>
<br>

====<font color="Black">Implementación SOAP (XML) — Nota a Nivel de Línea</font>====

<syntaxhighlight lang="xml">



<detalleDeFactura>
<FacturaDetalle>
<secuencia>1</secuencia>
<codigoProducto>890401</codigoProducto>
<descripcion>INTERCONSULTA POR MEDICINA GENERAL</descripcion>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>IMG</estandarCodigoProducto>

<nota>Consulta realizada en modalidad presencial. Tarifa aplicada según contrato EPS-IPS. Código CUPS: 890401.</nota>
<cantidadReal>1.00</cantidadReal>
<cantidadUnidades>1.00</cantidadUnidades>
<precioVentaUnitario>100.00</precioVentaUnitario>
<precioTotalSinImpuestos>100.00</precioTotalSinImpuestos>
<precioTotal>100.00</precioTotal>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
<FacturaDetalle>
<secuencia>2</secuencia>
<codigoProducto>890401</codigoProducto> 
<descripcion>INTERCONSULTA POR MEDICINA GENERAL</descripcion>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>IMG</estandarCodigoProducto>

<nota>Consulta realizada en modalidad telemedicina interactiva. Tarifa diferencial según Res. 0948 de 2026.</nota>
<cantidadReal>1.00</cantidadReal>
<cantidadUnidades>1.00</cantidadUnidades>
<precioVentaUnitario>80.00</precioVentaUnitario> 
<precioTotalSinImpuestos>80.00</precioTotalSinImpuestos>
<precioTotal>80.00</precioTotal>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura>
</syntaxhighlight>
<br>

<includeonly>==</includeonly>==<font color="Blue"> Ejemplos Completos por Escenario</font>==<includeonly>==</includeonly>
A continuación se presentan los ejemplos completos de request para cada escenario de facturación del sector salud, incorporando los cambios de la Resolución 0948. Se incluyen las variantes '''Con Contrato''' (CUCON presente) y '''Sin Contrato''' (CUCON ausente, campo 22 requerido).
<br>

====<center><big><font color="blue">'''ESCENARIO SS-CUFE — Acreditación con Recaudos Previos'''</font></big></center>====
'''<center>Registro del concepto que se acreditará como Cuota moderadora — Copago - Pagos compartidos - Anticipos</center>'''
<br>

=====<font color="Black">SS-CUFE Con Contrato — Request REST</font>=====

<syntaxhighlight lang="javascript">
{
"tokenEmpresa": "{{tokenEmpresa}}",
"tokenPassword": "{{tokenPassword}}",
"factura": {
// Se admite el reporte de 4 Anticipos
"anticipos": [
{
// Se debe enviar campo Extra para identificar el tipo de Recaudo
"extras": [
{
// Nombre = Recaudo para todos los Nodos
"nombre": "recaudo",
// Valor = Codigo correspondiente concepto de Recaudo
"valor": "01",
"controlInterno1": null,
"controlInterno2": null
}
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
// ID = Secuencia del Nodo
"id": "1",
// Instrucciones = Descripcion del concepto de Recaudo
"instrucciones": "Copago",
"montoPagado": "41.00"
},
{
"extras": [
{
"nombre": "recaudo",
"valor": "02",
"controlInterno1": null,
"controlInterno2": null
}
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
"id": "2",
"instrucciones": "Cuota Moderadora",
"montoPagado": "41.00"
},
{
"extras": [
{
"nombre": "recaudo",
"valor": "03",
"controlInterno1": null,
"controlInterno2": null
}
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
"id": "3",
"instrucciones": "Pagos Compartidos",
"montoPagado": "41.00"
}
],
"cantidadDecimales": "2",
"cliente": {
"nombreRazonSocial": "NOMBRE RAZON SOCIAL",
"numeroDocumento": "123456789",
"tipoIdentificacion": "13",
"tipoPersona": "2",
"notificar": "SI",
"destinatario": [
{
"canalDeEntrega": "0",
"email": [ "integracion@empresa.com" ]
}
],
"detallesTributarios": [
{ "codigoImpuesto": "ZY" }
],
"direccionCliente": {
"ciudad": "BOGOTÁ, D.C.",
"codigoDepartamento": "11",
"departamento": "Bogotá",
"direccion": "Calle 100 # 19-61",
"lenguaje": "es",
"municipio": "11001",
"pais": "CO"
},
"responsabilidadesRut": [
{ "obligaciones": "R-99-PN", "regimen": "49" }
]
},
"consecutivoDocumento": "SETT1000001",
"detalleDeFactura": [
{
"secuencia": "1",
"codigoProducto": "890401",
"descripcion": "INTERCONSULTA POR MEDICINA GENERAL",
"nota": "Atención presencial según contrato vigente.",
"estandarCodigo": "IMG",
"estandarCodigoProducto": "999",
"cantidadReal": "1.00",
"cantidadRealUnidadMedida": "WSD",
"cantidadUnidades": "1.00",
"precioVentaUnitario": "1003.00",
"precioTotalSinImpuestos": "1003.00",
"precioTotal": "1003.00",
"unidadMedida": "WSD",
"muestraGratis": null
}
],
"fechaEmision": "2026-05-30 00:00:00",
// Fecha Fin Periodo Facturacion = CampoAdicional N°10 de la resolucion 948
"fechaFinPeriodoFacturacion": "2026-05-30 00:00:00",
// Fecha Inicio Periodo Facturacion = CampoAdicional N°11 de la resolucion 948
"fechaInicioPeriodoFacturacion": "2026-05-01 00:00:00",
"mediosDePago": [
{
"medioPago": "10",
"metodoDePago": "1",
"numeroDeReferencia": "REF01"
}
],
"moneda": "COP",
"rangoNumeracion": "PREFIJO-CAMPODESDE",
"redondeoAplicado": "0.00",
// Campos Sector Salud
"sectorSalud": {
// Clase Beneficiario es opcional en este escenario
"Beneficiario": {
"DireccionResidencia": { "municipio": null, "pais": null },
"TipoIdentificacion": null
},
// IdPersonalizacion = Tipo de operacion segun escenario FEV-Salud
"IdPersonalizacion": "SS-CUFE",
"Pacientes": [
{
"CamposGenerales": [
{
// Codigo del Prestador de Servicios = CampoAdicional N°1
"Nombre": "1",
"Valor": "8632000024"
},
{
// Modalidad de Pago = CampoAdicional N°2
"Nombre": "9",
"Valor": "04"
},
{
// Cobertura Plan = CampoAdicional N°3
"Nombre": "10",
"Valor": "01"
},
{
// Numero de Contrato CUCON = CampoAdicional N°4 (con contrato: hash del CUCON)
"Nombre": "14",
"Valor": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{
// Numero de Poliza = CampoAdicional N°5
"Nombre": "15",
"Valor": "654321"
},
// Res. 948: Campos 06B van VACÍOS (reubicados en PrepaidPayment)
{ "Nombre": "6", "Valor": "" },
{ "Nombre": "7", "Valor": "" },
{ "Nombre": "8", "Valor": "" }
]
}
],
"TipoEscenario": "2"
},
"tipoDocumento": "01",
"tipoOperacion": "10",
"tipoSector": "2",
// totalAnticipos = sumatoria de todos los anticipos reportados
"totalAnticipos": "123.00",
"totalBaseImponible": "0.00",
"totalBrutoConImpuesto": "1003.00",
"totalMonto": "880.00",
"totalProductos": "1",
"totalSinImpuestos": "1003.00"
},
"documentosAdjuntos": "0"
}
</syntaxhighlight>
<br>

=====<font color="Black">SS-CUFE Con Contrato — Request SOAP</font>=====

<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/"
xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">

<anticipos>
<Anticipos>

<extras>
<Extensible>

<nombre>recaudo</nombre>

<valor>01</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>1</id>

<instrucciones>Copago</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
<Anticipos>
<extras>
<Extensible>
<nombre>recaudo</nombre>
<valor>02</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>2</id>
<instrucciones>Cuota Moderadora</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
<Anticipos>
<extras>
<Extensible>
<nombre>recaudo</nombre>
<valor>03</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>3</id>
<instrucciones>Pagos Compartidos</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
</anticipos>
<cantidadDecimales>2</cantidadDecimales>
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>integracion@empresa.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos><codigoImpuesto>ZY</codigoImpuesto></Tributos>
</detallesTributarios>
<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Calle 100 # 19-61</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<nombreRazonSocial>NOMBRE RAZON SOCIAL</nombreRazonSocial>
<notificar>SI</notificar>
<numeroDocumento>123456789</numeroDocumento>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>13</tipoIdentificacion>
<tipoPersona>2</tipoPersona>
</cliente>
<consecutivoDocumento>SETT1000001</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>890401</codigoProducto>
<descripcion>INTERCONSULTA POR MEDICINA GENERAL</descripcion>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>IMG</estandarCodigoProducto>

<nota>Atención presencial según contrato vigente.</nota>
<muestraGratis>0</muestraGratis>
<precioTotal>1003.00</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura>
<fechaEmision>2026-05-30 00:00:00</fechaEmision>
<fechaFinPeriodoFacturacion>2026-05-30 00:00:00</fechaFinPeriodoFacturacion>
<fechaInicioPeriodoFacturacion>2026-05-01 00:00:00</fechaInicioPeriodoFacturacion>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>REF01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-CAMPODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>

<sectorSalud>

<Beneficiario>
<DireccionResidencia>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</DireccionResidencia>
<TipoIdentificacion>91</TipoIdentificacion>
</Beneficiario>
<IdPersonalizacion>SS-CUFE</IdPersonalizacion>
<Pacientes>
<DatosPacienteSalud>
<CamposGenerales>
<GeneralSalud>

<Nombre>1</Nombre>
<Valor>8632000024</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>9</Nombre>
<Valor>04</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>10</Nombre>
<Valor>01</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>14</Nombre>
<Valor>e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855</Valor>
</GeneralSalud>
<GeneralSalud>

<Nombre>15</Nombre>
<Valor>654321</Valor>
</GeneralSalud>

<GeneralSalud><Nombre>6</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>7</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>8</Nombre><Valor></Valor></GeneralSalud>
</CamposGenerales>
</DatosPacienteSalud>
</Pacientes>
<TipoEscenario>2</TipoEscenario>
</sectorSalud>
<tipoDocumento>01</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<tipoSector>2</tipoSector>

<totalAnticipos>123.00</totalAnticipos>
<totalBaseImponible>0.00</totalBaseImponible>
<totalBrutoConImpuesto>1003.00</totalBrutoConImpuesto>
<totalMonto>880.00</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
<br>

=====<font color="Black">SS-CUFE Sin Contrato — Request REST</font>=====

<syntaxhighlight lang="javascript">
{
"tokenEmpresa": "{{tokenEmpresa}}",
"tokenPassword": "{{tokenPassword}}",
"factura": {
"anticipos": [
{
"extras": [
{ "nombre": "recaudo", "valor": "01", "controlInterno1": null, "controlInterno2": null }
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
"id": "1",
"instrucciones": "Copago",
"montoPagado": "20.00"
},
{
"extras": [
{ "nombre": "recaudo", "valor": "02", "controlInterno1": null, "controlInterno2": null }
],
"fechaDeRecibido": null,
"fechadePago": "2026-05-30",
"horaDePago": null,
"id": "2",
"instrucciones": "Cuota Moderadora",
"montoPagado": "20.00"
}
],
"cantidadDecimales": "2",
"consecutivoDocumento": "SETT1000002",
"fechaEmision": "2026-05-30 00:00:00",
"fechaFinPeriodoFacturacion": "2026-05-30 00:00:00",
"fechaInicioPeriodoFacturacion": "2026-05-01 00:00:00",
"moneda": "COP",
"rangoNumeracion": "{{rango_numeracion}}",
"sectorSalud": {
"IdPersonalizacion": "SS-CUFE",
"Pacientes": [
{
"CamposGenerales": [
{ "Nombre": "1", "Valor": "8632000024" },
{ "Nombre": "9", "Valor": "04" },
{ "Nombre": "10", "Valor": "01" },
{
// CUCON viaja VACÍO cuando no hay contrato
"Nombre": "14",
"Valor": ""
},
{ "Nombre": "15", "Valor": "222222222" },
{
// NUEVO CAMPO RES. 948: FACTURA_SIN_CONTRATO
// Obligatorio cuando CUCON está vacío
"Nombre": "22",
"Valor": "01" // 01=Urgencias | 02=Tutelas | 03=ADRES | 04=Otro | 05=Compra directa | 06=Sin contrato
},
// Campos 06B vacíos (reubicados en PrepaidPayment)
{ "Nombre": "6", "Valor": "" },
{ "Nombre": "7", "Valor": "" },
{ "Nombre": "8", "Valor": "" }
]
}
],
"TipoEscenario": "2"
},
"tipoDocumento": "01",
"tipoOperacion": "10",
"tipoSector": "2",
"totalAnticipos": "40.00",
"totalBaseImponible": "100.00",
"totalBrutoConImpuesto": "100.00",
"totalMonto": "60.00",
"totalProductos": "1",
"totalSinImpuestos": "100.00"
},
"documentosAdjuntos": "0"
}
</syntaxhighlight>
<br>

=====<font color="Black">SS-CUFE Sin Contrato — Request SOAP</font>=====

<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/"
xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<anticipos>
<Anticipos>
<extras>
<Extensible>
<nombre>recaudo</nombre>
<valor>01</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>1</id>
<instrucciones>Copago</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
<Anticipos>
<extras>
<Extensible>
<nombre>recaudo</nombre>
<valor>02</valor>
</Extensible>
</extras>
<fechaDeRecibido>2026-05-30</fechaDeRecibido>
<id>2</id>
<instrucciones>Cuota Moderadora</instrucciones>
<montoPagado>41.00</montoPagado>
</Anticipos>
</anticipos>
<cantidadDecimales>2</cantidadDecimales>
<consecutivoDocumento>SETT1000002</consecutivoDocumento>
<fechaEmision>2026-05-30 00:00:00</fechaEmision>
<fechaFinPeriodoFacturacion>2026-05-30 00:00:00</fechaFinPeriodoFacturacion>
<fechaInicioPeriodoFacturacion>2026-05-01 00:00:00</fechaInicioPeriodoFacturacion>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-CAMPODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>

<sectorSalud>
<IdPersonalizacion>SS-CUFE</IdPersonalizacion>
<Pacientes>
<DatosPacienteSalud>
<CamposGenerales>
<GeneralSalud><Nombre>1</Nombre><Valor>8632000024</Valor></GeneralSalud>
<GeneralSalud><Nombre>9</Nombre><Valor>04</Valor></GeneralSalud>
<GeneralSalud><Nombre>10</Nombre><Valor>01</Valor></GeneralSalud>
<GeneralSalud>

<Nombre>14</Nombre>
<Valor></Valor>
</GeneralSalud>
<GeneralSalud><Nombre>15</Nombre><Valor>654321</Valor></GeneralSalud>
<GeneralSalud>


<Nombre>22</Nombre>
<Valor>06</Valor>
</GeneralSalud>

<GeneralSalud><Nombre>6</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>7</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>8</Nombre><Valor></Valor></GeneralSalud>
</CamposGenerales>
</DatosPacienteSalud>
</Pacientes>
<TipoEscenario>2</TipoEscenario>
</sectorSalud>
<tipoDocumento>01</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<tipoSector>2</tipoSector>
<totalAnticipos>82.00</totalAnticipos>
<totalBaseImponible>0.00</totalBaseImponible>
<totalBrutoConImpuesto>1003.00</totalBrutoConImpuesto>
<totalMonto>921.00</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
<br>

====<center><big><font color="blue">'''ESCENARIO SS-Reporte — Reporte de Recaudo Realizado por la ERP'''</font></big></center>====
'''<center>Registro de operaciones donde la EPS realizó directamente el recaudo del pago moderador al paciente</center>'''
<br>

=====<font color="Black">SS-Reporte Con Contrato — Request REST</font>=====

<syntaxhighlight lang="javascript">
{
"tokenEmpresa": "{{tokenEmpresa}}",
"tokenPassword": "{{tokenPassword}}",
"factura": {
"cantidadDecimales": "2",
"consecutivoDocumento": "SETT1000003",
"fechaEmision": "2026-05-30 00:00:00",
// Fecha Fin Periodo Facturacion = CampoAdicional N°10 de la resolucion 948
"fechaFinPeriodoFacturacion": "2026-05-30 00:00:00",
// Fecha Inicio Periodo Facturacion = CampoAdicional N°11 de la resolucion 948
"fechaInicioPeriodoFacturacion": "2026-05-01 00:00:00",
"moneda": "COP",
"rangoNumeracion": "{{rango_numeracion}}",
"sectorSalud": {
// IdPersonalizacion = Tipo de operacion SS-Reporte
"IdPersonalizacion": "SS-Reporte",
"Pacientes": [
{
"CamposGenerales": [
{ "Nombre": "1", "Valor": "8632000024" },
{ "Nombre": "9", "Valor": "04" },
{ "Nombre": "10", "Valor": "01" },
{
// Numero de Contrato CUCON (con contrato)
"Nombre": "14",
"Valor": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{ "Nombre": "15", "Valor": "222222222" },
// Campos 06B vacíos según Res. 948
{ "Nombre": "6", "Valor": "" },
{ "Nombre": "7", "Valor": "" },
{ "Nombre": "8", "Valor": "" }
]
}
],
// TipoEscenario = 3 para SS-Reporte
"TipoEscenario": "3"
},
"tipoDocumento": "01",
"tipoOperacion": "10",
"tipoSector": "2",
"totalAnticipos": null,
"totalBaseImponible": "100.00",
"totalBrutoConImpuesto": "100.00",
"totalMonto": "100.00",
"totalProductos": "1",
"totalSinImpuestos": "100.00"
},
"documentosAdjuntos": "0"
}
</syntaxhighlight>
<br>

=====<font color="Black">SS-Reporte Con Contrato — Request SOAP</font>=====

<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/"
xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales>
<consecutivoDocumento>SETT1000003</consecutivoDocumento>
<fechaEmision>2026-05-30 00:00:00</fechaEmision>
<fechaFinPeriodoFacturacion>2026-05-30 00:00:00</fechaFinPeriodoFacturacion>
<fechaInicioPeriodoFacturacion>2026-05-01 00:00:00</fechaInicioPeriodoFacturacion>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-CAMPODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>

<sectorSalud>

<Beneficiario>
<DireccionResidencia>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</DireccionResidencia>
<TipoIdentificacion>91</TipoIdentificacion>
</Beneficiario>
<IdPersonalizacion>SS-Reporte</IdPersonalizacion>
<Pacientes>
<DatosPacienteSalud>
<CamposGenerales>
<GeneralSalud><Nombre>1</Nombre><Valor>8632000024</Valor></GeneralSalud>
<GeneralSalud><Nombre>9</Nombre><Valor>04</Valor></GeneralSalud>
<GeneralSalud><Nombre>10</Nombre><Valor>01</Valor></GeneralSalud>
<GeneralSalud>

<Nombre>14</Nombre>
<Valor>e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855</Valor>
</GeneralSalud>
<GeneralSalud><Nombre>15</Nombre><Valor>654321</Valor></GeneralSalud>

<GeneralSalud><Nombre>6</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>7</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>8</Nombre><Valor></Valor></GeneralSalud>
</CamposGenerales>
</DatosPacienteSalud>
</Pacientes>

<TipoEscenario>3</TipoEscenario>
</sectorSalud>
<tipoDocumento>01</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<tipoSector>2</tipoSector>
<totalAnticipos>0.00</totalAnticipos>
<totalBaseImponible>0.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
<br>

====<center><big><font color="blue">'''ESCENARIO SS-SinAporte — Sin Recaudos Previos'''</font></big></center>====
'''<center>Emisión de facturas electrónicas para servicios de salud sin recaudos previos de Copago, Cuota Moderadora o Anticipos</center>'''
<br>

=====<font color="Black">SS-SinAporte Con Contrato — Request REST</font>=====

<syntaxhighlight lang="javascript">
{
"tokenEmpresa": "{{tokenEmpresa}}",
"tokenPassword": "{{tokenPassword}}",
"factura": {
"cantidadDecimales": "2",
"consecutivoDocumento": "SETT1000004",
"fechaEmision": "2026-05-30 00:00:00",
// Fecha Fin Periodo Facturacion = CampoAdicional N°10 de la resolucion 948
"fechaFinPeriodoFacturacion": "2026-05-30 00:00:00",
// Fecha Inicio Periodo Facturacion = CampoAdicional N°11 de la resolucion 948
"fechaInicioPeriodoFacturacion": "2026-05-01 00:00:00",
"moneda": "COP",
"rangoNumeracion": "{{rango_numeracion}}",
"sectorSalud": {
// IdPersonalizacion = SS-SinAporte
"IdPersonalizacion": "SS-SinAporte",
"Pacientes": [
{
"CamposGenerales": [
{ "Nombre": "1", "Valor": "8632000024" },
{ "Nombre": "9", "Valor": "04" },
{ "Nombre": "10", "Valor": "01" },
{
// Numero de Contrato CUCON (con contrato: hash del CUCON)
"Nombre": "14",
"Valor": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
},
{ "Nombre": "15", "Valor": "222222222" },
// Campos 06B vacíos según Res. 948
{ "Nombre": "6", "Valor": "" },
{ "Nombre": "7", "Valor": "" },
{ "Nombre": "8", "Valor": "" }
]
}
],
// TipoEscenario = 4 para SS-SinAporte
"TipoEscenario": "4"
},
"tipoDocumento": "01",
"tipoOperacion": "10",
"tipoSector": "2",
"totalAnticipos": null,
"totalBaseImponible": "100.00",
"totalBrutoConImpuesto": "100.00",
"totalMonto": "100.00",
"totalProductos": "1",
"totalSinImpuestos": "100.00"
},
"documentosAdjuntos": "0"
}
</syntaxhighlight>
<br>

=====<font color="Black">SS-SinAporte Con Contrato — Request SOAP</font>=====

<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tem="http://tempuri.org/"
xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales>
<consecutivoDocumento>SETT1000004</consecutivoDocumento>
<fechaEmision>2026-05-30 00:00:00</fechaEmision>
<fechaFinPeriodoFacturacion>2026-05-30 00:00:00</fechaFinPeriodoFacturacion>
<fechaInicioPeriodoFacturacion>2026-05-01 00:00:00</fechaInicioPeriodoFacturacion>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-CAMPODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>

<sectorSalud>

<Beneficiario>
<DireccionResidencia>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</DireccionResidencia>
<TipoIdentificacion>91</TipoIdentificacion>
</Beneficiario>

<IdPersonalizacion>SS-SinAporte</IdPersonalizacion>
<Pacientes>
<DatosPacienteSalud>
<CamposGenerales>
<GeneralSalud><Nombre>1</Nombre><Valor>8632000024</Valor></GeneralSalud>
<GeneralSalud><Nombre>9</Nombre><Valor>04</Valor></GeneralSalud>
<GeneralSalud><Nombre>10</Nombre><Valor>01</Valor></GeneralSalud>
<GeneralSalud>

<Nombre>14</Nombre>
<Valor>e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855</Valor>
</GeneralSalud>
<GeneralSalud><Nombre>15</Nombre><Valor>654321</Valor></GeneralSalud>

<GeneralSalud><Nombre>6</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>7</Nombre><Valor></Valor></GeneralSalud>
<GeneralSalud><Nombre>8</Nombre><Valor></Valor></GeneralSalud>
</CamposGenerales>
</DatosPacienteSalud>
</Pacientes>

<TipoEscenario>4</TipoEscenario>
</sectorSalud>
<tipoDocumento>01</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<tipoSector>2</tipoSector>
<totalAnticipos>0.00</totalAnticipos>
<totalBaseImponible>0.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
<br>

=====<font color="Black">SS-SinAporte Sin Contrato — Request REST</font>=====

<syntaxhighlight lang="javascript">
{
"tokenEmpresa": "{{tokenEmpresa}}",
"tokenPassword": "{{tokenPassword}}",
"factura": {
"cantidadDecimales": "2",
"consecutivoDocumento": "SETT1000005",
"fechaEmision": "2026-05-30 00:00:00",
"fechaFinPeriodoFacturacion": "2026-05-30 00:00:00",
"fechaInicioPeriodoFacturacion": "2026-05-01 00:00:00",
"moneda": "COP",
"rangoNumeracion": "{{rango_numeracion}}",
"sectorSalud": {
"IdPersonalizacion": "SS-SinAporte",
"Pacientes": [
{
"CamposGenerales": [
{ "Nombre": "1", "Valor": "8632000024" },
{ "Nombre": "9", "Valor": "01" },
{ "Nombre": "10", "Valor": "01" },
{
// CUCON viaja VACÍO cuando no hay contrato
"Nombre": "14",
"Valor": ""
},
{ "Nombre": "15", "Valor": "222222222" },
{
// NUEVO CAMPO RES. 948: FACTURA_SIN_CONTRATO
"Nombre": "22",
"Valor": "01" // 01=Urgencias
},
// Campos 06B vacíos según Res. 948
{ "Nombre": "6", "Valor": "" },
{ "Nombre": "7", "Valor": "" },
{ "Nombre": "8", "Valor": "" }
]
}
],
"TipoEscenario": "4"
},
"tipoDocumento": "01",
"tipoOperacion": "10",
"tipoSector": "2",
"totalAnticipos": null,
"totalBaseImponible": "100.00",
"totalBrutoConImpuesto": "100.00",
"totalMonto": "100.00",
"totalProductos": "1",
"totalSinImpuestos": "100.00"
},
"documentosAdjuntos": "0"
}
</syntaxhighlight>
<br>

<includeonly>==</includeonly>==<font color="Blue"> URLs del Servicio HKA Integración — Resolución 0948</font>==<includeonly>==</includeonly>
Los endpoints del servicio de emisión no cambian con la Resolución 0948. Se debe continuar utilizando las mismas URLs según el protocolo de integración elegido:
<br>
<br>
<br>
<br>

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big>
<br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

<br>
{{clear}}

Sección para clientes de Integración

2026-04-14T14:41:30Z

Amurillo:

{| style="width:100%; border:1px solid #d0d7e1; border-radius:10px; background-color:#ffffff; box-shadow:0 1px 3px rgba(0,0,0,0.08);"
|-
| style="vertical-align:top; padding:20px;" |

<div style="font-size:1.9em; font-weight:bold; color:#003366;">
Integración – The Factory HKA Colombia
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
Bienvenido a <b>Integración</b> de <b>The Factory HKA Colombia</b>, el espacio diseñado para brindar una experiencia técnica clara, eficiente y centralizada para nuestros clientes y aliados.
<br><br>
Aquí encontrará la documentación completa para la integración de los servicios de <b>Factura Electrónica</b>, <b>Nómina Electrónica</b>, <b>Recepción Electrónica</b> y <b>Documentos Equivalentes</b>, incluyendo manuales, APIs, herramientas y recomendaciones para el cumplimiento de las resoluciones DIAN vigentes.
</div>

<div style="background:linear-gradient(90deg, #0073e6 0%, #0099ff 100%); color:#fff; padding:12px 18px; border-radius:6px; font-weight:bold; font-size:1.05em;">
Acceso rápido:</span> Consulte las secciones de pasos de integración, canales de comunicación y ejemplos de APIs según su tipo de documento electrónico.
</div>

| style="width:140px; text-align:center; vertical-align:middle; background-color:#f7f9fc; border-left:1px solid #e0e6ef; padding:15px;" |
[[Archivo:Tfhka-co.png|140px|center|sinmarco]]
|}

{| style="width:100%; border:none; background-color:#ffffff; padding:2px;"
|-
| style="vertical-align:top; padding:18px 5px;" |

<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-bottom:8px;">
¿Qué hacemos?
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
En <b>The Factory HKA Colombia</b> ofrecemos soluciones tecnológicas que optimizan la <b>emisión, recepción y gestión de documentos electrónicos</b> requeridos por la DIAN.
Nuestros servicios web (APIs) están orientados a empresas, desarrolladores y casas de software que buscan integraciones seguras, escalables y de alta disponibilidad.
</div>

<div style="background-color:#f4f9fc; border-left:6px solid #0073e6; border-radius:4px; padding:12px; color:#003366; font-size:1.05em; margin-bottom:15px;">
<b>Servicios principales:</b><br>
• Facturación Electrónica con validación previa ante la DIAN.<br>
• Nómina Electrónica con soporte para documentos individuales y masivos.<br>
• Recepción de Documentos Electrónicos con trazabilidad y respuesta.<br>
• Emisión de Documentos Equivalentes conforme a la Resolución 000165 del 2023.
</div>
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;">
¿Cómo contactarnos?
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
Si necesita soporte técnico o acompañamiento durante su proceso de integración, puede comunicarse a través de los siguientes canales:
</div>

<table style="width:100%; border-collapse:collapse; font-size:1.02em; color:#333;">
<tr style="background-color:#eef4fb; text-align:left;">
<th style="padding:8px; border:1px solid #5a6a7a; width:25%;">Canal</th>
<th style="padding:8px; border:1px solid #5a6a7a;">Información de contacto</th>
</tr>
<tr>
<td style="padding:8px; border:1px solid #5a6a7a;">
[[File:icono-correo-electronico.png|20px]] <b>Correo electrónico</b>
</td>
<td style="padding:8px; border:1px solid #5a6a7a;">integracion_fel_co@thefactoryhka.com</td>
</tr>
<tr style="background-color:#f8fafd;">
<td style="padding:8px; border:1px solid #5a6a7a;">
[[File:icono-telefono.png|20px]] <b>Teléfonos</b>
</td>
<td style="padding:8px; border:1px solid #5a6a7a;">Opción 5, luego Opción 1 <br>
+57 317 668 7663 | +57 (601) 390 95 39 </td>
</tr>
<tr>
<td style="padding:8px; border:1px solid #5a6a7a;">
[[File:icono-whatsapp.png|20px]] <b>WhatsApp</b>
</td>
<td style="padding:8px; border:1px solid #5a6a7a;">Escríbanos al canal de soporte técnico https://wa.me/573163192251</td>
</tr>
<tr style="background-color:#f8fafd;">
<td style="padding:8px; border:1px solid #5a6a7a;">
[[File:icono-sesiones-grupales.png|20px]] <b>Sesiones grupales de integración</b>
</td>
<td style="padding:8px; border:1px solid #5a6a7a;">Martes y jueves de 08:30 a.m. a 10:00 a.m. (hora Colombia).<br>https://meet.google.com/fzo-xmyc-duk</td>
</tr>
</table>

<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;">
Principales métodos o APIs por producto
</div>

<div style="font-size:1.02em; color:#444; line-height:1.6; margin-bottom:10px;">
La siguiente tabla presenta los métodos principales de integración por producto.
Cada servicio dispone de endpoints para <b>emisión, validación, consulta, descarga y gestión</b> de documentos conforme a los estándares DIAN.
</div>

{| style="width:100%; border:none; margin-bottom:25px;"
|-
| style="width:49%; vertical-align:top; padding-right:15px; border:none;" |
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-bottom:15px;">Factura Electrónica - SOAP</div>
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333; border:1px solid #5a6a7a;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
|-
| style="padding:8px; border:1px solid #5a6a7a;" | FEL
| SOAP
|
'''FacturaElectronica - Enviar'''. <small>Envío y validación ante la DIAN, con verificación de requisitos técnicos y legales. '''Entornos:''' Demo / Producción</small>
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | FEL
| SOAP
|
'''FacturaElectronica - EstadoDocumento'''. <small>Consulta en tiempo real del estado y validación ante la DIAN.</small>
|-
| style="padding:8px; border:1px solid #5a6a7a;" | FEL
| SOAP
|
'''FacturaElectronica - DescargaPDF'''. <small>Generación automática del PDF conforme a estándares DIAN.</small>
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | FEL
| SOAP
|
'''FacturaElectronica - EnvioCorreo'''. <small>Distribución automatizada a clientes con PDF y XML.</small>
|}
| style="width:49%; vertical-align:top; padding-left:15px; border:none;" |
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-bottom:15px;">Factura Electrónica - REST</div>
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333; border:1px solid #5a6a7a;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #5a6a7a;" | FEL
| REST
|
'''Api/documentos/enviar'''. <small>Envío y validación ante la DIAN, con verificación de requisitos técnicos y legales. '''Entornos:''' Demo / Producción</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | FEL
| REST
|
'''Api/documentos/EstadoDocumento'''. <small>Consulta en tiempo real del estado y validación ante la DIAN.</small>
| GET
|-
| style="padding:8px; border:1px solid #5a6a7a;" | FEL
| REST
|
'''Api/documentos/DescargaPDF'''. <small>Generación automática del PDF conforme a estándares DIAN.</small>
| GET
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | FEL
| REST
|
'''FacturaElectronica - EnvioCorreo'''. <small>Distribución automatizada a clientes con PDF y XML.</small>
| POST
|}
|}

{| style="width:100%; border:none; margin-bottom:25px;"
|-
| style="width:49%; vertical-align:top; padding-right:15px; border:none;" |
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-bottom:15px;">Nómina Electrónica - SOAP</div>
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333; border:1px solid #5a6a7a;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Nomina
| SOAP
|
'''NominaElectronica - Enviar'''<br/>
<small>Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.</small><br/>
'''Entornos:''' Demo / Producción
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Nomina
| SOAP
|
'''NominaElectronica - ConsultarDocumento'''<br/>
<small>Consulta del estado de tramitación y validación de nóminas electrónicas.</small>
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Nomina
| SOAP
|
'''NominaElectronica - EnviarCorreo'''<br/>
<small>Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.</small>
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Nomina
| SOAP
|
'''NominaElectronica - ConsultarFolios'''<br/>
<small>Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.</small>
|}
| style="width:49%; vertical-align:top; padding-left:15px; border:none;" |
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-bottom:15px;">Nómina Electrónica - REST</div>
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333; border:1px solid #5a6a7a;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Nomina
| REST
|
'''Api/documentos/Enviar'''<br/>
<small>Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Nomina
| REST
|
'''Api/documentos/ConsultarDocumento'''<br/>
<small>Consulta del estado de tramitación y validación de nóminas electrónicas.</small>
| GET
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Nomina
| REST
|
'''Api/documentos/EnviarCorreo'''<br/>
<small>Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Nomina
| REST
|
'''Api/documentos/ConsultarFolios'''<br/>
<small>Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.</small>
| GET
|}
|}

{| style="width:100%; border:none; margin-bottom:25px;"
|-
| style="width:49%; vertical-align:top; padding-right:15px; border:none;" |
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-bottom:15px;">Recepción Electrónica</div>
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333; border:1px solid #5a6a7a;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Recepcion
| SOAP
|
'''Recepcion - ReporteStatus'''<br/>
<small>Procesa documentos recibidos de proveedores, validando autenticidad e integridad ante la DIAN.</small><br/>
'''Entornos:''' Demo / Producción
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Recepcion
| SOAP
|
'''Recepcion - EstadoDocumento'''<br/>
<small>Consulta del estado y trazabilidad de documentos recibidos ante la DIAN.</small>
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Recepcion
| SOAP
|
'''Recepcion - Respuesta'''<br/>
<small>Aceptación o rechazo formal de documentos recibidos, registrando eventos ante la DIAN.</small>
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Recepcion
| SOAP
|
'''Recepcion - RepresentacionGrafica'''<br/>
<small>Generación de PDFs de documentos recibidos conforme a estándares DIAN.</small>
|}
| style="width:49%; vertical-align:top; padding-left:15px; border:none;" |
<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-bottom:15px;">Documentos Equivalentes</div>
{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333; border:1px solid #5a6a7a;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Doc Equivalente
| REST
|
'''Equivalente - EnviarRequest'''<br/>
<small>Envío de documentos equivalentes a la DIAN, cumpliendo validaciones oficiales.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Doc Equivalente
| REST
|
'''Equivalente - GenerarContenedor'''<br/>
<small>Genera contenedores estructurados según requisitos técnicos de la DIAN.</small>
| GET
|-
| style="padding:8px; border:1px solid #5a6a7a;" | Doc Equivalente
| REST
|
'''Equivalente - DescargaPDF'''<br/>
<small>Generación de PDF para documentos equivalentes conforme a normativa vigente.</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #5a6a7a;" | Doc Equivalente
| REST
|
'''Equivalente - EstadoDocumento'''<br/>
<small>Consulta del estado de validación y trazabilidad ante la DIAN.</small>
| POST
|}
|}

|}
<br>
[[File:HKAFactura 3.png|200px]]
<br>

* [[Índice del Manual de Integración Directa]]

* [[Direct Integration Manual Index - Electronic Invoice]]
* <u>'''[[Facturación Electrónica bajo Resoluciones DIAN]]'''</u>
* [[Herramientas Alternativas de Integración Facturación]]
* <u>'''[[Servicio Gestión Contribuyentes]]'''</u>
* [[Representaciones Gráficas en el proceso de Emisión]]
* [[Reglas de Rechazo DIAN - Integración]]
* [[Preguntas Frecuentes de Integración con servicio Web (Val. Previa)]]
* [[Tips Urls de Emisión]]

<br>
[[File:HKANomina 3.png|200px]]
<br>

* [[Índice del Manual de Integración Nómina Electrónica]]
* [[Portal Web Nómina Electrónica]]
* [[Habilitación Nómina Electrónica]]
* <u>'''[[Herramientas Alternativas de Integración Nómina]]'''</u>
* [[Nómina Electrónica según Concepto Unificado DIAN 0106 – 19 agosto 2022 ]]
* [[Preguntas Frecuentes de Integración Nómina Electrónica]]
* [[Tips Urls de Emisión Nómina Electrónica]]

<br>
[[File:HKARecepcion 3.png|260px]]
<br>

* [[Índice del Manual de Integración Directa HKA Recepción]]
* [[HKA Reception Direct Integration Manual Index]]
* [[Preguntas Frecuentes de Integración Recepción Electrónica]]
* [[Tips Urls de Recepción Integración]]

<br>
[[File:HKAEquivalente1.png|260px]]
<br>
* [[Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos]]
* [[Requisitos minimos de las Representaciones grafica para documento equivalente]]
* [[Preguntas Frecuentes de Integración Documento Equivalente Electrónico]]
* [[Tips Urls de documento equivalente Integración]]

<br>
[[File:HKA_ Fácil_ RIPS.png|260px]]
<br>
* [[Indice del Manual Integración Directa HKA Fácil RIPS]]
* [[Tips Urls HKA Fácil RIPS]]
<br>
<br>
<br>

<br>
[[File:ArticulosInteresIntegracion.png|260px]]
<br>
* [[HKA TIPS]]
* [[Consideraciones Url Versión 4]]
* [[Recomendaciones para integraciones ante escenarios de intermitencia o Timeouts DIAN]]
* [[Manejo de SoapUI para pruebas en Demo]]
* [[Manejo de Postman para pruebas en Demo]]
* [[Campo extra para informar el Fabricante de Software]]
* [[Recomendaciones en la implementación de la factura electronica]]
* [[Politicas de seguridad de la información para aliados de The Factory HKA]]
* [[Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web]]
<br>

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big>
<br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

<br>
{{clear}}

Modelos de referencia de representaciones gráficas de factura electrónica (impresión tirilla POS y tamaño carta)

2025-11-19T21:59:20Z

Amurillo: Se actualiza la versión de la tirilla de co-POSm2-23 a co-POSm2-53 para el modelo 1 de 80mm y 2 de 58mm

<includeonly>=</includeonly>==<font color="blue">Requisitos mínimos de representaciones gráficas de factura electrónica según el artículo 29 de la resolución 00042 de 05-05-2020, con base en los requisitos de factura electrónica contemplados en el artículo 11 de la misma resolución.</font>==<includeonly>=</includeonly>
</br>
Parágrafo 1. Para efectos de las representaciones gráficas en formato digital, los facturadores electrónicos deberán utilizar formatos que sean de fácil y amplio acceso por el adquiriente, garantizando que la factura se pueda leer, copiar, descargar e imprimir, sin tener que acudir a otras fuentes para proveerse de las aplicaciones necesarias para ello.
Las representaciones gráficas en formato digital o impreso deberán contener como mínimo los requisitos de los numerales del 1 al 5, del 8 al 13, 15 y 18 del artículo 11 de esta resolución.
<br>
<br>
'''1.''' De conformidad con el literal a) del artículo 617 del Estatuto Tributario, estar denominada expresamente como factura electrónica de venta.
[[Archivo:1f.png|centro|]]
'''2.''' De conformidad con el literal b) del artículo 617 del Estatuto Tributario, deberá contener: apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del vendedor o de quien presta el servicio.
[[Archivo:2f.png|centro|]]
'''3.''' Identificación del adquiriente, según corresponda, así:
: '''a)''' De conformidad con el literal c) del artículo 617 del Estatuto Tributario, deberá contener: apellidos y nombre o razón social y Número de Identificación Tributaria –NIT del adquiriente de los bienes y servicios.

: '''b)''' Registrar apellidos y nombre y número de identificación del adquiriente de los bienes y/o servicios; para los casos en que el adquiriente no suministre la información del literal a) de este numeral, en relación con el Número de Identificación Tributaria -NIT.

: '''c)''' Registrar la frase «consumidor final» o apellidos y nombre y el número «222222222222» en caso de adquirientes de bienes y/o servicios que no suministren la información de los literales a) o, b) de este numeral.

:Se debe registrar la dirección del lugar de entrega del bien y/o prestación del servicio, cuando la citada operación de venta se realiza fuera de la sede de negocio, oficina o local del facturador electrónico para los casos en que la identificación del adquiriente, corresponda a la señalada en los literales b) y c) de este numeral.
[[Archivo:3f.png|centro|]]
'''4.''' De conformidad con lo establecido en el literal d) del artículo 617 del Estatuto Tributario, deberá
llevar un número que corresponda a un sistema de numeración consecutiva de factura electrónica de
venta, incluyendo el número, rango, fecha y vigencia de la numeración autorizada por la Unidad
Administrativa Especial Dirección de Impuestos y Aduanas Nacionales -DIAN.
[[Archivo:1m.png|centro|]]
'''5.''' Fecha y hora de generación
[[Archivo:5m.png|centro|]]
'''8.''' De conformidad con el literal f) del artículo 617 del Estatuto Tributario, indicar el número de registro, línea o ítems, el total de número de líneas o ítems en las cuales se detalle la cantidad, unidad de medida, descripción específica y códigos inequívocos que permitan la identificación de los bienes vendidos o servicios prestados, la denominación -bien cubierto- cuando se traten de los bienes vendidos del artículo 24 de la Ley 2010 de 2010, los impuestos de que trata el numeral 13 del presente artículo cuando fuere del caso, así como el valor unitario y el valor total de cada una de las líneas o ítems.
[[Archivo:8f.png|centro|]]
'''9.''' De conformidad con lo establecido en el literal g) del artículo 617 del Estatuto Tributario, el valor total de la venta de bienes o prestación de servicios, como resultado de la sumatoria de cada una de las líneas o ítems que conforman la factura electrónica de venta.
[[Archivo:9m.png|centro|]]
'''10.''' La forma de pago, estableciendo si es de contado o a crédito, en este último caso se debe señalar
el plazo.
[[Archivo:10m.png|centro|]]
'''11.''' El Medio de pago, registrando si se trata de efectivo, tarjeta crédito, tarjeta débito o transferencia
electrónica u otro medio que aplique. Este requisito aplica cuando la forma de pago es de contado.
[[Archivo:11f.png|centro|]]
'''12.''' De conformidad con lo establecido en el literal i) del artículo 617 del Estatuto Tributario, indicar la
calidad de agente retenedor del Impuesto sobre las Ventas -IVA, de autorretenedor del Impuesto sobre
la Renta y Complementarios, de gran contribuyente y/o de contribuyente del impuesto unificado bajo
el régimen simple de tributación – SIMPLE, cuando corresponda.
[[Archivo:12f.png|centro|]]
'''13.''' De conformidad con lo establecido en el literal c) del artículo 617 del Estatuto Tributario, la
discriminación del Impuesto sobre las Ventas -IVA, Impuesto Nacional al Consumo, Impuesto
Nacional al Consumo de Bolsas Plásticas, con su correspondiente tarifa aplicable a los bienes y/o
servicios que se encuentren gravados con estos impuestos.
[[Archivo:13f.png|centro|]]
'''15.''' El Código Único de Factura Electrónica -CUFE-.
[[Archivo:15f.png|centro|]]
'''18.''' Apellidos y nombre o razón social y Número de Identificación Tributaria -NIT, del fabricante del software, el nombre del software y del proveedor tecnológico si lo tuviere.
[[Archivo:18f.png|centro|]]
'''16.''' Para efectos del numeral 16 del artículo 11 de esta resolución, se debe incluir el Código de respuesta rápida -Código QR-, de conformidad con las condiciones, términos y mecanismos técnicos y tecnológicos establecidos por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales -DIAN, en el «Anexo Técnico de la factura electrónica de venta».
<br>
El tamaño mínimo que debe tener el código bidimensional QR es de 2cm para facilitar la lectura
por los diferentes dispositivos como se muestra a continuación

[[Archivo:qr.jpeg|centro|'''QR''']]
<br><br>
La representación gráfica puede ser diseñada de acuerdo con las necesidades del OFE (Obligado a Facturar Electrónicamente); como la generación está en formato XML, entonces cualquier herramienta informática de conversión de este formato a .pdf, .docx, u otros formatos digitales será suficiente para cumplir con lo previsto en la normatividad vigente. El requisito
que debe cumplir es la inclusión del código bidimensional QR tal como se precisa arriba.
<br>
<br>
Una alternativa a los formatos digitales es la impresión en papel de la representación gráfica diseñada de acuerdo con las necesidades del OFE. El requisito que debe cumplir es la
inclusión del código bidimensional QR tal como se precisa arriba.
<br>
<br>
La representación gráfica debe incluir el código QR en todas las páginas de los formatos digitales y de la impresión en papel de la factura electrónica. La representación gráfica siempre será “una representación, una imagen” de la información consignada en el formato XML de los perfiles de transacciones comerciales para la DIAN. Esto significa que el documento electrónico siempre será el que tenga valor legal para las autoridades nacionales.

<br>
<includeonly>=</includeonly>==<font color="black" size= 4 align="center"><center>Como se genera el campo 333221.</center></font>==<includeonly>=</includeonly>
<br>

Este es un campo extensible donde incluimos la versión del témplate que queremos generar. Para darle uso a este campo se debe tener en cuenta que se esté enviando el campo 333221 en el xml o sistema ERP. Se debe tener en cuenta que el proceso de la expedición de una facturación electrónica finaliza con la entrega del documento al correo electrónico del adquirente. De igual forma para que el PDF que le llegue al adquirente por correo electrónico sea lo más similar a la tirilla o ticket entregada en el punto de venta The Factory HKA implementó en ambiente DEMO los siguientes TEMPLATES:
<br>
<br>
Con 80 mm de dimensión: co-POSm1-53
<br>
Con 58 mm de dimensión: co-POSm2-53
<br>
<br>
<big><b>Se debe enviar de la siguiente manera:</b></big>
<br>
[[Archivo:1a.png|centro|]]
<br>
<big><b>Como se envia este campo extensible por portal</b></big>
<br>
Este campo extensible se puede enviar por el portal de la siguiente manera:
</br>
'''1.''' Ingrese al portal thefactoryhka.
</br>
'''2.''' Diríjase a emisión y luego generar comprobante.
[[Archivo:2b.png|centro|]]
</br>
'''3.''' En la parte información adicional encontrara nombre del campo, valor del campo y adicionar.
[[Archivo:3m.png|centro|]]
</br>
'''4.''' En la parte nombre del campo asigne 333221 y en valor del campo agregue POSm2-15 Con 58 mm de dimensión o co-POSm1-53 Con 80 mm de dimensión.
</br>
[[Archivo:4m.png|centro|]]
</br>
'''5.''' Pulse en el cuadro de "+" para asignar este campo extensible.
</br>
[[Archivo:2a.png|centro|]]
<br>
<includeonly>=</includeonly>==<font color="black" size= 4 align="center"><center>Modelo de referencia de representación gráfica de factura electrónica impreso en tirilla de factura electrónica.</center></font>==<includeonly>=</includeonly>

</br>
[[Archivo:pos1.png|centro|'''Modelo de referencia de representación gráfica de factura electrónica impreso en tirilla de factura electrónica''']]
</br>
<br>
<includeonly>=</includeonly>==<font color="black" size= 4 align="center"><center>Modelo de referencia de representación gráfica de factura electrónica en tamaño carta.</center></font>==<includeonly>=</includeonly>

</br>
[[Archivo:ModeloEstandar.jpg|centro|'''Modelo de referencia de representación gráfica de factura electrónica en tamaño carta.''']]
</br>

<br>

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big>
<br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

<br>
{{clear}}

Sección para clientes de Integración

2025-11-18T22:03:19Z

Amurillo: Se actualizó la parte inicial de la pagina de seccion de integración para cliente donde se agregó qué hacemos, cómo contactarnos (correo, teléfonos, whatsapp, sesiones grupales) y principales métodos o APIS por producto (Factura, nómina, rece

{| style="width:100%; border:1px solid #d0d7e1; border-radius:10px; background-color:#ffffff; box-shadow:0 1px 3px rgba(0,0,0,0.08);"
|-
| style="vertical-align:top; padding:20px;" |

<div style="font-size:1.9em; font-weight:bold; color:#003366;">
Integración – The Factory HKA Colombia
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
Bienvenido a <b>Integración</b> de <b>The Factory HKA Colombia</b>, el espacio diseñado para brindar una experiencia técnica clara, eficiente y centralizada para nuestros clientes y aliados.
<br><br>
Aquí encontrará la documentación completa para la integración de los servicios de <b>Factura Electrónica</b>, <b>Nómina Electrónica</b>, <b>Recepción Electrónica</b> y <b>Documentos Equivalentes</b>, incluyendo manuales, APIs, herramientas y recomendaciones para el cumplimiento de las resoluciones DIAN vigentes.
</div>

<div style="background:linear-gradient(90deg, #0073e6 0%, #0099ff 100%); color:#fff; padding:12px 18px; border-radius:6px; font-weight:bold; font-size:1.05em;">
Acceso rápido:</span> Consulte las secciones de pasos de integración, canales de comunicación y ejemplos de APIs según su tipo de documento electrónico.
</div>

| style="width:140px; text-align:center; vertical-align:middle; background-color:#f7f9fc; border-left:1px solid #e0e6ef; padding:15px;" |
[[Archivo:Tfhka-co.png|140px|center|sinmarco]]
|}

{| style="width:100%; border:none; background-color:#ffffff; padding:2px;"
|-
| style="vertical-align:top; padding:18px 5px;" |

<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-bottom:8px;">
¿Qué hacemos?
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
En <b>The Factory HKA Colombia</b> ofrecemos soluciones tecnológicas que optimizan la <b>emisión, recepción y gestión de documentos electrónicos</b> requeridos por la DIAN.
Nuestros servicios web (APIs) están orientados a empresas, desarrolladores y casas de software que buscan integraciones seguras, escalables y de alta disponibilidad.
</div>

<div style="background-color:#f4f9fc; border-left:6px solid #0073e6; border-radius:4px; padding:12px; color:#003366; font-size:1.05em; margin-bottom:15px;">
<b>Servicios principales:</b><br>
• Facturación Electrónica con validación previa ante la DIAN.<br>
• Nómina Electrónica con soporte para documentos individuales y masivos.<br>
• Recepción de Documentos Electrónicos con trazabilidad y respuesta.<br>
• Emisión de Documentos Equivalentes conforme a la Resolución 000165 del 2023.
</div>
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;">
¿Cómo contactarnos?
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
Si necesita soporte técnico o acompañamiento durante su proceso de integración, puede comunicarse a través de los siguientes canales:
</div>

<table style="width:100%; border-collapse:collapse; font-size:1.02em; color:#333;">
<tr style="background-color:#eef4fb; text-align:left;">
<th style="padding:8px; border:1px solid #cfd7e0; width:25%;">Canal</th>
<th style="padding:8px; border:1px solid #cfd7e0;">Información de contacto</th>
</tr>
<tr>
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-correo-electronico.png|20px]] <b>Correo electrónico</b>
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">integracion_fel_co@thefactoryhka.com</td>
</tr>
<tr style="background-color:#f8fafd;">
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-telefono.png|20px]] <b>Teléfonos</b>
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">Opción 5, luego Opción 1 <br>
+57 317 668 7663 | +57 (601) 390 95 39 </td>
</tr>
<tr>
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-whatsapp.png|20px]] <b>WhatsApp</b>
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">Escríbanos al canal de soporte técnico https://wa.me/573163192251</td>
</tr>
<tr style="background-color:#f8fafd;">
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-sesiones-grupales.png|20px]] <b>Sesiones grupales de integración</b>
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">Martes y jueves de 08:30 a.m. a 10:00 a.m. (hora Colombia).<br>https://meet.google.com/fzo-xmyc-duk</td>
</tr>
</table>

<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;">
Principales métodos o APIs por producto
</div>

<div style="font-size:1.02em; color:#444; line-height:1.6; margin-bottom:10px;">
La siguiente tabla presenta los métodos principales de integración por producto.
Cada servicio dispone de endpoints para <b>emisión, validación, consulta, descarga y gestión</b> de documentos conforme a los estándares DIAN.
</div>

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Factura Electrónica - SOAP
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - Enviar'''<br/>
<small>Servicio dedicado al envío y validación de facturas electrónicas ante la DIAN, garantizando el cumplimiento normativo mediante la verificación integral de todos los requisitos técnicos y legales exigidos por la autoridad tributaria colombiana.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - EstadoDocumento'''<br/>
<small>Consulta del estado de tramitación de documentos ante la DIAN, proporcionando información en tiempo real sobre la validación y aceptación definitiva.</small>
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - DescargaPDF'''<br/>
<small>Generación automática de la representación gráfica en PDF según especificaciones DIAN, lista para distribución comercial conforme a los estándares requeridos.</small>
| GET
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - EnvioCorreo'''<br/>
<small>Envío automatizado de facturas electrónicas a los destinatarios con PDF y XML técnico, asegurando entrega completa y trazable.</small>
| POST
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Factura Electrónica - REST
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''Api/documentos/enviar'''<br/>
<small>Servicio dedicado al envío y validación de facturas electrónicas ante la DIAN, con verificación completa de los requisitos técnicos y legales.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''Api/documentos/EstadoDocumento'''<br/>
<small>Consulta en tiempo real del estado del documento y validación ante la DIAN, mostrando incidencias o aceptación definitiva.</small>
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''Api/documentos/DescargaPDF'''<br/>
<small>Generación automática del PDF representativo del documento, conforme a los estándares de presentación exigidos.</small>
| GET
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''FacturaElectronica - EnvioCorreo'''<br/>
<small>Distribución electrónica automatizada de facturas a clientes, incluyendo PDF y XML técnico.</small>
| POST
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Nómina Electrónica - SOAP
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - Enviar'''<br/>
<small>Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - ConsultarDocumento'''<br/>
<small>Consulta del estado de tramitación y validación de nóminas electrónicas.</small>
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - EnviarCorreo'''<br/>
<small>Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - ConsultarFolios'''<br/>
<small>Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.</small>
| GET
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Nómina Electrónica - REST
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/Enviar'''<br/>
<small>Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/ConsultarDocumento'''<br/>
<small>Consulta del estado de tramitación y validación de nóminas electrónicas.</small>
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/EnviarCorreo'''<br/>
<small>Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/ConsultarFolios'''<br/>
<small>Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.</small>
| GET
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Recepción Electrónica
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - ReporteStatus'''<br/>
<small>Procesa documentos recibidos de proveedores, validando autenticidad e integridad para integración contable.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - EstadoDocumento'''<br/>
<small>Consulta del estado y trazabilidad de documentos recibidos ante la DIAN.</small>
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - Respuesta'''<br/>
<small>Gestión formal de aceptación o rechazo de documentos recibidos, registrando eventos ante la DIAN.</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - RepresentacionGrafica'''<br/>
<small>Descarga y generación de PDFs de documentos recibidos conforme a los estándares DIAN.</small>
| GET
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Documentos Equivalentes
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - EnviarRequest'''<br/>
<small>Envío de documentos equivalentes electrónicos a la DIAN, cumpliendo con las validaciones oficiales.</small><br/>
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - GenerarContenedor'''<br/>
<small>Genera contenedores de información estructurados según los requisitos técnicos de la DIAN.</small>
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - DescargaPDF'''<br/>
<small>Generación de representaciones gráficas PDF para documentos equivalentes conforme a la normativa vigente.</small>
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - EstadoDocumento'''<br/>
<small>Consulta del estado de validación y trazabilidad de documentos equivalentes ante la DIAN.</small>
| POST
|}

|}
<br>
[[File:HKAFactura 3.png|200px]]
<br>

* [[Índice del Manual de Integración Directa]]

* [[Direct Integration Manual Index - Electronic Invoice]]
* <u>'''[[Facturación Electrónica bajo Resoluciones DIAN]]'''</u>
* [[Herramientas Alternativas de Integración Facturación]]
* <u>'''[[Servicio Gestión Contribuyentes]]'''</u>
* [[Representaciones Gráficas en el proceso de Emisión]]
* [[Reglas de Rechazo DIAN - Integración]]
* [[Preguntas Frecuentes de Integración con servicio Web (Val. Previa)]]
* [[Tips Urls de Emisión]]

<br>
[[File:HKANomina 3.png|200px]]
<br>

* [[Índice del Manual de Integración Nómina Electrónica]]
* [[Portal Web Nómina Electrónica]]
* [[Habilitación Nómina Electrónica]]
* <u>'''[[Herramientas Alternativas de Integración Nómina]]'''</u>
* [[Nómina Electrónica según Concepto Unificado DIAN 0106 – 19 agosto 2022 ]]
* [[Preguntas Frecuentes de Integración Nómina Electrónica]]
* [[Tips Urls de Emisión Nómina Electrónica]]

<br>
[[File:HKARecepcion 3.png|260px]]
<br>

* [[Índice del Manual de Integración Directa HKA Recepción]]
* [[HKA Reception Direct Integration Manual Index]]
* [[Preguntas Frecuentes de Integración Recepción Electrónica]]
* [[Tips Urls de Recepción Integración]]

<br>
[[File:HKAEquivalente1.png|260px]]
<br>
* [[Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos]]
* [[Requisitos minimos de las Representaciones grafica para documento equivalente]]
* [[Preguntas Frecuentes de Integración Documento Equivalente Electrónico]]
* [[Tips Urls de documento equivalente Integración]]
<br>
<br>
<br>

<br>
[[File:ArticulosInteresIntegracion.png|260px]]
<br>
* [[HKA TIPS]]
* [[Consideraciones Url Versión 4]]
* [[Recomendaciones para integraciones ante escenarios de intermitencia o Timeouts DIAN]]
* [[Manejo de SoapUI para pruebas en Demo]]
* [[Manejo de Postman para pruebas en Demo]]
* [[Campo extra para informar el Fabricante de Software]]
* [[Recomendaciones en la implementación de la factura electronica]]
* [[Politicas de seguridad de la información para aliados de The Factory HKA]]
* [[Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web]]
<br>

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big>
<br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

<br>
{{clear}}

Archivo:Icono-sesiones-grupales.png

2025-11-07T15:37:38Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Sección para clientes de Integración

2025-11-07T15:34:27Z

Amurillo:

[[Archivo:Tfhka-co.png|sinmarco|derecha]]
Bienvenido al Centro de Integración de The Factory HKA Colombia, un espacio diseñado para brindarle toda la información necesaria para una correcta conexión con nuestros servicios electrónicos. Aquí encontrará manuales, guías, pasos de integración y preguntas frecuentes que facilitarán el uso y la implementación de nuestros servicios web de Facturación Electrónica, Nómina Electrónica, Recepción y Documentos Equivalentes.
<br>
La información está organizada por tipo de documento y acompañada de recursos complementarios como canales de comunicación, herramientas de apoyo, recomendaciones técnicas y actualizaciones de seguridad, para garantizar una integración eficiente, segura y conforme a la normativa DIAN.
<br>
<br>

* [[Pasos que debe seguir para integrar Factura a través de Casa de Software]]
* [[Pasos que debe seguir para integrar Nómina a través de Casa de Software]]
* [[Canales de Comunicación]]
* [[Canal de Notificaciones Técnicas Telegram]]

<br>
[[File:HKAFactura 3.png|200px]]
<br>

* [[Índice del Manual de Integración Directa]]

* [[Direct Integration Manual Index - Electronic Invoice]]
* <u>'''[[Facturación Electrónica bajo Resoluciones DIAN]]'''</u>
* [[Herramientas Alternativas de Integración Facturación]]
* <u>'''[[Servicio Gestión Contribuyentes]]'''</u>
* [[Representaciones Gráficas en el proceso de Emisión]]
* [[Reglas de Rechazo DIAN - Integración]]
* [[Preguntas Frecuentes de Integración con servicio Web (Val. Previa)]]
* [[Tips Urls de Emisión]]

<br>
[[File:HKANomina 3.png|200px]]
<br>

* [[Índice del Manual de Integración Nómina Electrónica]]
* [[Portal Web Nómina Electrónica]]
* [[Habilitación Nómina Electrónica]]
* <u>'''[[Herramientas Alternativas de Integración Nómina]]'''</u>
* [[Nómina Electrónica según Concepto Unificado DIAN 0106 – 19 agosto 2022 ]]
* [[Preguntas Frecuentes de Integración Nómina Electrónica]]
* [[Tips Urls de Emisión Nómina Electrónica]]

<br>
[[File:HKARecepcion 3.png|260px]]
<br>

* [[Índice del Manual de Integración Directa HKA Recepción]]
* [[HKA Reception Direct Integration Manual Index]]
* [[Preguntas Frecuentes de Integración Recepción Electrónica]]
* [[Tips Urls de Recepción Integración]]

<br>
[[File:HKAEquivalente1.png|260px]]
<br>
* [[Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos]]
* [[Requisitos minimos de las Representaciones grafica para documento equivalente]]
* [[Preguntas Frecuentes de Integración Documento Equivalente Electrónico]]
* [[Tips Urls de documento equivalente Integración]]
<br>
<br>
<br>

<br>
[[File:ArticulosInteresIntegracion.png|260px]]
<br>
* [[HKA TIPS]]
* [[Consideraciones Url Versión 4]]
* [[Recomendaciones para integraciones ante escenarios de intermitencia o Timeouts DIAN]]
* [[Manejo de SoapUI para pruebas en Demo]]
* [[Manejo de Postman para pruebas en Demo]]
* [[Campo extra para informar el Fabricante de Software]]
* [[Recomendaciones en la implementación de la factura electronica]]
* [[Politicas de seguridad de la información para aliados de The Factory HKA]]
* [[Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web]]
* [[¡Te contamos una historia sobre ciberseguridad!]]
<br>

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]<font color="Blue">THE FACTORY HKA COLOMBIA</font></big>
<br>Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

<br>
{{clear}}

Archivo:Icono-correo-electronico.png

2025-11-07T15:34:03Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Icono-telefono.png

2025-11-07T15:34:03Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Icono-whatsapp.png

2025-11-07T15:34:02Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web

2025-08-26T12:53:48Z

Amurillo:

<br>
[[Archivo:Mgdv3.png|izquierda|]]

[https://drive.google.com/file/d/1G97RIY0n-E3HZuEaF5qPl99vvE8fhFAO/view <big><b>Grabación 19-08-2025 de Sesión Especial de Aclaración de dudas sobre Actualización de Seguridad Requerida Migración a TLS 1.2 o superior</b></big>]
<p>En este video, te explicamos todo lo que necesitas saber para la '''Actualización de Seguridad a TLS 1.2 o superior'''.

Aprende a:
* Entender el comunicado enviado por el área de Integración.
* Aplicar el '''Manual de Hardening de TLS en Windows Server'''.
* Ver en vivo cómo ejecutar los scripts de configuración.

Al final, respondemos las preguntas realizadas por los asistentes. Esta es la guía que necesitas para cumplir con esta importante actualización.</p>
<br>

<h1>Manual de Hardening de TLS en Windows Server</h1>
<p>Este manual proporciona una guía detallada para administradores de sistemas sobre qué es el protocolo TLS (Transport Layer Security), por qué es crucial para la seguridad, y cómo configurar correctamente sus versiones en diferentes ediciones de Windows Server para garantizar la máxima protección.</p>

<h2>¿Qué es TLS?</h2>
<p>El protocolo <strong>TLS (Transport Transport Layer Security)</strong>, o "Seguridad de la Capa de Transporte", es un protocolo criptográfico diseñado para proporcionar comunicaciones seguras a través de una red. Su propósito fundamental es garantizar la privacidad y la integridad de los datos intercambiados entre dos aplicaciones, como un navegador web y un servidor. En esencia, TLS crea un "túnel" seguro y cifrado sobre la red pública (Internet), impidiendo que terceros puedan leer o modificar la información transmitida. Es la base de la confianza en el comercio electrónico, la banca en línea y cualquier servicio que maneje datos sensibles.</p>

<h2>Funcionamiento Básico: El Handshake</h2>
<p>Para establecer esta conexión segura, los clientes y servidores realizan un proceso de negociación llamado <strong>handshake</strong> (apretón de manos). De forma simplificada, el proceso es el siguiente:</p>
<ol>
<li><strong>Client Hello:</strong> El cliente, ej. tu navegador, envía un mensaje al servidor diciendo: "Hola, quiero establecer una conexión segura. Estas son las versiones de TLS y los algoritmos de cifrado que soporto".</li>
<li><strong>Server Hello:</strong> El servidor responde: "Hola. De acuerdo, usemos esta versión de TLS y este algoritmo de cifrado. Aquí tienes mi certificado digital".</li>
<li><strong>Verificación y Clave:</strong>
<ul>
<li>El cliente verifica la autenticidad del certificado digital del servidor (emitido por una Autoridad de Certificación - CA - de confianza). Esto confirma que el servidor es quien dice ser.</li>
<li>Ambas partes utilizan la información del certificado (la clave pública del servidor) para negociar de forma segura una clave de sesión secreta y simétrica que solo ellos conocerán.</li>
</ul>
</li>
<li><strong>Comunicación Segura:</strong> Una vez establecida la clave de sesión, toda la comunicación posterior entre el cliente y el servidor se cifra con esa clave. Si alguien intercepta los datos, sólo verá un galimatías indescifrable.</li>
</ol>

<h2>Relación con SSL y HTTPS</h2>
<ul>
<li><strong>SSL (Secure Sockets Layer):</strong> Es el predecesor de TLS. Aunque el término "SSL" se sigue usando coloquialmente, todas las versiones de SSL están obsoletas e inseguras. TLS es la evolución directa y segura de SSL.</li>
<li><strong>HTTPS (Hypertext Transfer Protocol Secure):</strong> No es un protocolo en sí mismo, sino la implementación de HTTP sobre una capa de seguridad TLS. Es la forma en que se aplica TLS a la navegación web. En resumen: HTTP + TLS = HTTPS.</li>
</ul>

<h2>Versiones de TLS: Un Recorrido Histórico y Actual</h2>
<h3>Línea de Tiempo de las Versiones:</h3>
<ul>
<li><strong>SSL 2.0 (1995):</strong> Obsoleta y plagada de fallos de seguridad.</li>
<li><strong>SSL 3.0 (1996):</strong> Obsoleta. Vulnerable a ataques críticos como POODLE.</li>
<li><strong>TLS 1.0 (1999):</strong> Obsoleta. Débil ante ataques como BEAST.</li>
<li><strong>TLS 1.1 (2006):</strong> Obsoleta. Ofrecía mejoras menores sobre TLS 1.0 pero comparte muchas de sus debilidades criptográficas.</li>
<li><strong>TLS 1.2 (2008):</strong> Estándar seguro y maduro. Ampliamente compatible y considerado el mínimo aceptable para una comunicación segura hoy en día.</li>
<li><strong>TLS 1.3 (2018):</strong> El estándar de oro actual. Ofrece la máxima seguridad y rendimiento.</li>
</ul>

<h3>Versiones Obsoletas y Vulnerables</h3>
<p>Las versiones SSL 2.0, SSL 3.0, TLS 1.0 y TLS 1.1 se consideran inseguras y deben ser deshabilitadas en cualquier servidor en producción. Vulnerabilidades conocidas como POODLE y BEAST permiten a un atacante, bajo ciertas condiciones, descifrar el tráfico cifrado y robar información sensible como cookies de sesión o contraseñas.</p>

<h3>Versiones Seguras y Actuales</h3>
<p>Los únicos estándares aceptados actualmente son:</p>
<ul>
<li><strong>TLS 1.2:</strong> Es el requisito mínimo indispensable de seguridad.</li>
<li><strong>TLS 1.3:</strong> Es la versión recomendada por su superioridad en seguridad y rendimiento.</li>
</ul>

<h3>Mejoras Clave en TLS 1.2 y TLS 1.3</h3>
<p>TLS 1.2 introdujo el soporte para algoritmos de cifrado más robustos y seguros (como AES-GCM) que no estaban disponibles en versiones anteriores.</p>
<p>TLS 1.3 representa un salto cualitativo importante:</p>
<ul>
<li><strong>Handshake más rápido:</strong> Reduce la latencia al requerir menos viajes de ida y vuelta entre el cliente y el servidor para establecer la conexión.</li>
<li><strong>Suite de Cifrado más simple y fuerte:</strong> Elimina algoritmos obsoletos y débiles, forzando el uso de criptografía moderna y segura.</li>
<li><strong>Mayor seguridad:</strong> Cifra más partes del handshake, protegiendo mejor la identidad del cliente y del servidor.</li>
</ul>

<h2>Guía Práctica: Activación de TLS en Servidores Windows</h2>
<p>A continuación, se detallan los pasos para habilitar las versiones seguras de TLS y deshabilitar las inseguras. Consideraciones Previas Importantes:</p>
<ol>
<li><strong>Copia de Seguridad del Registro:</strong> Antes de realizar cualquier cambio, siempre cree una copia de seguridad del Registro de Windows. Un error podría desestabilizar el sistema.</li>
<li><strong>Reinicio Requerido:</strong> Los cambios en la configuración de SCHANNEL (el proveedor de seguridad de Windows que implementa TLS) requieren un reinicio del servidor para surtir efecto.</li>
<li><strong>Dependencias de .NET Framework:</strong> Asegúrese de que las aplicaciones que se ejecutan en el servidor, especialmente las basadas en .NET, sean compatibles con TLS 1.2. Es posible que necesite actualizar .NET Framework a la versión 4.6.2 o superior para una compatibilidad total.</li>
</ol>

<h3>En Windows Server 2012 y 2012 R2</h3>
<p>Tenga en cuenta:</p>
<ul>
<li>TLS 1.2 es compatible pero no está habilitado por defecto para todas las aplicaciones.</li>
<li>TLS 1.3 no es compatible. Puedes ver una tabla de compatibilidad en las páginas oficiales de Microsoft.</li>
</ul>

<h3>Habilitar TLS 1.2</h3>
<h4>Vía Editor de Registro (regedit.exe) en Modo Administrador</h4>
</br>
[[Archivo:regedit.png|400px|center]]
</br>
<p>1. Navegue a la ruta: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols</code></p>
</br>
[[Archivo:HKEY_LOCAL_MACHINE.png|500px|center]]
</br>

<p>2. Cree una nueva clave llamada <strong>TLS 1.2</strong>.</p>
</br>
[[Archivo:nueva clave llamada TLS 1.2.png|500px|center]]
</br>

<p>3. Dentro de <strong>TLS 1.2</strong>, cree dos claves más: <strong>Client</strong> y <strong>Server</strong>.</p>
</br>
[[Archivo:Dos claves más Client y Server.png|200px|center]]
</br>
<p>4. Dentro de <strong>Client</strong> y <strong>Server</strong>, cree los siguientes valores DWORD (32-bit):</p>
<ul>
<li><code>DisabledByDefault:</code> Valor = 0</li>
<li><code>Enabled:</code> Valor = 1</li>
</ul>
</br>
[[Archivo:DWORD (32-bit).png|400px|center]]
</br>
</br>
[[Archivo:Enabled Valor 1.png|400px|center]]
</br>
<h4>Vía PowerShell (Automatizado y Recomendado)</h4>
<p><strong>Nota:</strong> Probado en Powershell 7 y en modo Administrador. No se garantiza funcione en Powershell 5 o versiones inferiores a 7.</p>
<pre><code>
# Habilitar TLS 1.2 para Cliente y Servidor en Windows Server 2012 / R2
# Definir la ruta base
$ProtocolPath = "HKLM:\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols\TLS 1.2"

# Crear las claves de registro si no existen
if (-not (Test-Path "$ProtocolPath\Client")) {
New-Item -Path "$ProtocolPath\Client" -Force | Out-Null
}
if (-not (Test-Path "$ProtocolPath\Server")) {
New-Item -Path "$ProtocolPath\Server" -Force | Out-Null
}

# Configurar valores para el Cliente
New-ItemProperty -Path "$ProtocolPath\Client" -Name "DisabledByDefault" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Client" -Name "Enabled" -Value 1 -PropertyType "DWord" -Force

# Configurar valores para el Servidor
New-ItemProperty -Path "$ProtocolPath\Server" -Name "DisabledByDefault" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Server" -Name "Enabled" -Value 1 -PropertyType "DWord" -Force

Write-Host "TLS 1.2 ha sido habilitado. Se requiere un reinicio del servidor."
</code></pre>

<h3>Deshabilitar TLS 1.0 y 1.1</h3>
<p>Para deshabilitar las versiones inseguras, debe crear claves similares pero establecer el valor <code>Enabled</code> en 0.</p>
<h4>Vía Editor de Registro (regedit.exe)</h4>
<ol>
<li>Navegue a: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols</code></li>
<li>Para <strong>TLS 1.0</strong> y <strong>TLS 1.1</strong>, cree las claves si no existen (TLS 1.0, Client, Server).</li>
<li>Dentro de las claves <strong>Client</strong> y <strong>Server</strong> de <strong>TLS 1.0</strong> y <strong>TLS 1.1</strong>, cree o modifique el valor DWORD (32-bit):
<ul>
<li><code>Enabled:</code> Valor = 0</li>
</ul>
</li>
</ol>

<h3>En Versiones Superiores (Windows Server 2016, 2019)</h3>
<p>En estas versiones, TLS 1.2 ya viene habilitado por defecto. El trabajo principal es deshabilitar las versiones más antiguas para fortalecer la seguridad. TLS 1.3 no es compatible.</p>

<h4>Vía PowerShell para deshabilitar TLS 1.0 y 1.1</h4>
<pre><code>
# Deshabilitar TLS 1.0 y TLS 1.1 en Windows Server 2016/2019
# Rutas para los protocolos a deshabilitar
$ProtocolsToDisable = @("TLS 1.0", "TLS 1.1")

foreach ($Protocol in $ProtocolsToDisable) {
$ProtocolPath = "HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\$Protocol"
# Crear claves si no existen
if (-not (Test-Path "$ProtocolPath\Client")) { New-Item -Path "$ProtocolPath\Client" -Force | Out-Null}
if (-not (Test-Path "$ProtocolPath\Server")) { New-Item -Path "$ProtocolPath\Server" -Force | Out-Null}

# Deshabilitar Cliente y Servidor para el protocolo
New-ItemProperty -Path "$ProtocolPath\Client" -Name "Enabled" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Server" -Name "Enabled" -Value 0 -PropertyType "DWord" -Force
Write-Host "El protocolo $Protocol ha sido deshabilitado."
}
Write-Host "Se requiere un reinicio del servidor para aplicar los cambios."
</code></pre>

<h3>En Windows Server 2022</h3>
<p>Windows Server 2022 es la primera versión de Windows Server con soporte para TLS 1.3, que está habilitado por defecto junto con TLS 1.2. Lo ideal es deshabilitar TLS 1.0 y 1.1, lo cual se puede hacer con el mismo script de PowerShell para Server 2016/2019.</p>

<h3>En Versiones Inferiores (Windows Server 2008 R2)</h3>
<p>Esta versión es antigua y requiere atención especial. TLS 1.2 no está habilitado por defecto.</p>

<h4>Habilitar TLS 1.2</h4>
<ol>
<li><strong>Instalar Actualización:</strong> Primero, asegúrese de que la actualización KB3140245 está instalada para agregar el soporte de TLS 1.2 a nivel de sistema operativo.</li>
<li><strong>Habilitar vía Registro:</strong> Siga los mismos pasos de registro descritos para Windows Server 2012 R2 para crear las claves y valores para TLS 1.2 (Client y Server) y establecer <code>Enabled</code> en 1 y <code>DisabledByDefault</code> en 0.</li>
</ol>

<h2>Tabla de Compatibilidad de Lenguajes de Programación </h2>
<p>
La siguiente tabla presenta una comparación de distintos lenguajes de programación en cuanto a su compatibilidad con el protocolo TLS.
Se detallan las librerías o mecanismos que cada lenguaje utiliza por defecto, el nivel de soporte para las versiones TLS 1.2 y 1.3,
así como las versiones mínimas comunes necesarias para habilitar dicho soporte.
También se incluyen notas relevantes que explican particularidades, limitaciones o dependencias de cada entorno.
El objetivo es ofrecer una visión general que facilite identificar el nivel de seguridad y requisitos adicionales en cada lenguaje.
Esta información resulta útil para desarrolladores y administradores que requieran implementar conexiones seguras en sus proyectos.
</p>
{| class="wikitable" style="margin:auto; width:70%; text-align:center; font-size:90%;"
| Python || ssl (OpenSSL) || TLS 1.2 / 1.3 || Depende de OpenSSL || TLS 1.0/1.1 deshabilitados en 3.10+.
|-
| Java || JSSE || TLS 1.2 / 1.3 || Java 8 (1.8), 11 (11.3) || TLS 1.3 desde Java 11.
|-
| C# / .NET || System.Net.Security || TLS 1.2 / 1.3 || Depende de S.O. || TLS controlado por SChannel en Windows.
|-
| PHP || openssl || TLS 1.2 / 1.3 || PHP 7.4+ con OpenSSL 1.1.1 || TLS 1.3 desde OpenSSL 1.1.1+.
|-
| Node.js || tls (OpenSSL) || TLS 1.2 / 1.3 || OpenSSL 1.1.1+ || TLSv1.0/1.1 deshabilitados desde Node 10.
|-
| Go || crypto/tls || TLS 1.2 / 1.3 || Go 1.13+ || Go 1.20 deja de ofrecer 1.13.
|-
| Ruby || OpenSSL || TLS 1.2 / 1.3 || Ruby 2.5+ || Depende de OpenSSL del sistema.
|-
| Perl || IO::Socket::SSL || TLS 1.2 / 1.3 || OpenSSL backend || Configurable.
|-
| Rust || rustls o openssl || TLS 1.2 / 1.3 || rustls → solo moderno || No soporta SSLv3 ni TLS obsoletos.
|-
| C / C++ || OpenSSL / GnuTLS || TLS 1.2 / 1.3 || Depende de la versión || Base para muchos otros.
|-
| Swift || Network.framework / CFNetwork || TLS 1.2 / 1.3 || iOS 12+ / macOS 10.14+ || TLS 1.3 soportado.
|-
| Kotlin || Usa pila Java || TLS 1.2 / 1.3 || Igual que Java || Depende de JVM.
|-
| Visual Basic (VB6) || Ninguno nativo (usa WinInet/COM) || No nativo || Requiere librerías externas || Se apoya en SChannel del SO.
|-
| Visual FoxPro || Ninguno nativo || No soporta || Requiere OCX externos || SSL/TLS posible vía ActiveX o llamadas WinAPI.
|-
| Pascal (Delphi/FreePascal) || Indy (Internet Direct) || TLS 1.0 / 1.2 (con librerías) || TLS 1.3 requiere librerías externas || No soporta TLS por defecto; se usan componentes.
|-
| COBOL || Depende del compilador (Ej. Micro Focus, GnuCOBOL) || No nativo || TLS mediante librerías externas (Ej. OpenSSL) || Entornos mainframe usan módulos externos.
|-
| Fortran || Ninguno nativo || No soporta || Requiere bindings a C || Soporte indirecto usando OpenSSL vía C.
|-
| Clipper / dBase || Ninguno nativo || No soporta || Solo vía wrappers modernos || Requiere librerías externas.
|-
| PowerBuilder || Ninguno nativo || TLS vía WinInet/COM || Depende de versión || Requiere usar API de Windows.
|}

<h3>Adicionales: Instalación de sslscan</h3>
<p>Este proyecto es una herramienta open source y funciona tanto en Windows como en Linux.</p>

<h4>1. Instalación En windows</h4>
<p>Puedes descargarlo desde github "bajo el nombre sslscan-2.2.0.zip": https://github.com/rbsec/sslscan/releases/tag/2.2.0</P>
[[Archivo:sslscan_zip.png|650px|center]]
</br>

<p>Luego descomprima y agregue la ruta donde escoja descomprimir la aplicación a sus variables de entorno</p>
{| style="margin:auto; border-spacing:30px;"
| [[Archivo:Propiedad_sistema.png|355px]]
| [[Archivo:Variables_entorno.png|450px]]
|}
<p>Una vez realizado estos pasos, puedes iniciar powershell y ejecutar el comando sslscan -- version y deberá dar la siguiente respuesta:</p>
[[Archivo:Comando_SSL.png|460px|center]]

<h4>2. Instalación En Linux</h4>
<p>Se recomienda seguir el tutorial indicado en la misma web del creador de la aplicación: https://github.com/rbsec/sslscan</P>
<p>y realizar la compilación del programa</p>
[[Archivo:Compilacion_programa.png|600px|center]]
</br>

<h4>Nota Importante:</h4><p>En cada versión de linux los comandos pueden variar; por favor ajuste los mismos a la versión que esté utilizando. Para hacer uso de la aplicación (en Linux o Windows) solo debe hacer uso del comando sslscan url a escanear.</p>
<p>Ejemplo: sslscan [http://emision21v4.thefactoryhka.com.co emision21v4.thefactoryhka.com.co]</p>
[[Archivo:SSLSCAN_emision21V4.png|650px|center]]

<h4>Nota Importante:</h4><p>Si el aplicativo indica la palabra “'''enabled'''” al lado del protocolo significa:</p>
<ol>
<li>Su servidor o computador soporta el protocolo de comunicación</li>
<li>El servidor destino tiene habilitado el protocolo</li>
</ol>

<p>No hace falta realizar configuraciones adicionales</p>

Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web

2025-08-26T12:36:22Z

Amurillo:

<br>
[[Archivo:Mgdv3.png|izquierda|]]

[https://drive.google.com/file/d/1G97RIY0n-E3HZuEaF5qPl99vvE8fhFAO/view <big><b>Grabación 19-08-2025 de Sesión Especial de Aclaración de dudas sobre Actualización de Seguridad Requerida Migración a TLS 1.2 o superior</b></big>]
<p>En este video, te explicamos todo lo que necesitas saber para la '''Actualización de Seguridad a TLS 1.2 o superior'''.

Aprende a:
* Entender el comunicado enviado por el área de Integración.
* Aplicar el '''Manual de Hardening de TLS en Windows Server'''.
* Ver en vivo cómo ejecutar los scripts de configuración.

Al final, respondemos las preguntas realizadas por los asistentes. Esta es la guía que necesitas para cumplir con esta importante actualización.</p>
<br>

<h1>Manual de Hardening de TLS en Windows Server</h1>
<p>Este manual proporciona una guía detallada para administradores de sistemas sobre qué es el protocolo TLS (Transport Layer Security), por qué es crucial para la seguridad, y cómo configurar correctamente sus versiones en diferentes ediciones de Windows Server para garantizar la máxima protección.</p>

<h2>¿Qué es TLS?</h2>
<p>El protocolo <strong>TLS (Transport Transport Layer Security)</strong>, o "Seguridad de la Capa de Transporte", es un protocolo criptográfico diseñado para proporcionar comunicaciones seguras a través de una red. Su propósito fundamental es garantizar la privacidad y la integridad de los datos intercambiados entre dos aplicaciones, como un navegador web y un servidor. En esencia, TLS crea un "túnel" seguro y cifrado sobre la red pública (Internet), impidiendo que terceros puedan leer o modificar la información transmitida. Es la base de la confianza en el comercio electrónico, la banca en línea y cualquier servicio que maneje datos sensibles.</p>

<h2>Funcionamiento Básico: El Handshake</h2>
<p>Para establecer esta conexión segura, los clientes y servidores realizan un proceso de negociación llamado <strong>handshake</strong> (apretón de manos). De forma simplificada, el proceso es el siguiente:</p>
<ol>
<li><strong>Client Hello:</strong> El cliente, ej. tu navegador, envía un mensaje al servidor diciendo: "Hola, quiero establecer una conexión segura. Estas son las versiones de TLS y los algoritmos de cifrado que soporto".</li>
<li><strong>Server Hello:</strong> El servidor responde: "Hola. De acuerdo, usemos esta versión de TLS y este algoritmo de cifrado. Aquí tienes mi certificado digital".</li>
<li><strong>Verificación y Clave:</strong>
<ul>
<li>El cliente verifica la autenticidad del certificado digital del servidor (emitido por una Autoridad de Certificación - CA - de confianza). Esto confirma que el servidor es quien dice ser.</li>
<li>Ambas partes utilizan la información del certificado (la clave pública del servidor) para negociar de forma segura una clave de sesión secreta y simétrica que solo ellos conocerán.</li>
</ul>
</li>
<li><strong>Comunicación Segura:</strong> Una vez establecida la clave de sesión, toda la comunicación posterior entre el cliente y el servidor se cifra con esa clave. Si alguien intercepta los datos, sólo verá un galimatías indescifrable.</li>
</ol>

<h2>Relación con SSL y HTTPS</h2>
<ul>
<li><strong>SSL (Secure Sockets Layer):</strong> Es el predecesor de TLS. Aunque el término "SSL" se sigue usando coloquialmente, todas las versiones de SSL están obsoletas e inseguras. TLS es la evolución directa y segura de SSL.</li>
<li><strong>HTTPS (Hypertext Transfer Protocol Secure):</strong> No es un protocolo en sí mismo, sino la implementación de HTTP sobre una capa de seguridad TLS. Es la forma en que se aplica TLS a la navegación web. En resumen: HTTP + TLS = HTTPS.</li>
</ul>

<h2>Versiones de TLS: Un Recorrido Histórico y Actual</h2>
<h3>Línea de Tiempo de las Versiones:</h3>
<ul>
<li><strong>SSL 2.0 (1995):</strong> Obsoleta y plagada de fallos de seguridad.</li>
<li><strong>SSL 3.0 (1996):</strong> Obsoleta. Vulnerable a ataques críticos como POODLE.</li>
<li><strong>TLS 1.0 (1999):</strong> Obsoleta. Débil ante ataques como BEAST.</li>
<li><strong>TLS 1.1 (2006):</strong> Obsoleta. Ofrecía mejoras menores sobre TLS 1.0 pero comparte muchas de sus debilidades criptográficas.</li>
<li><strong>TLS 1.2 (2008):</strong> Estándar seguro y maduro. Ampliamente compatible y considerado el mínimo aceptable para una comunicación segura hoy en día.</li>
<li><strong>TLS 1.3 (2018):</strong> El estándar de oro actual. Ofrece la máxima seguridad y rendimiento.</li>
</ul>

<h3>Versiones Obsoletas y Vulnerables</h3>
<p>Las versiones SSL 2.0, SSL 3.0, TLS 1.0 y TLS 1.1 se consideran inseguras y deben ser deshabilitadas en cualquier servidor en producción. Vulnerabilidades conocidas como POODLE y BEAST permiten a un atacante, bajo ciertas condiciones, descifrar el tráfico cifrado y robar información sensible como cookies de sesión o contraseñas.</p>

<h3>Versiones Seguras y Actuales</h3>
<p>Los únicos estándares aceptados actualmente son:</p>
<ul>
<li><strong>TLS 1.2:</strong> Es el requisito mínimo indispensable de seguridad.</li>
<li><strong>TLS 1.3:</strong> Es la versión recomendada por su superioridad en seguridad y rendimiento.</li>
</ul>

<h3>Mejoras Clave en TLS 1.2 y TLS 1.3</h3>
<p>TLS 1.2 introdujo el soporte para algoritmos de cifrado más robustos y seguros (como AES-GCM) que no estaban disponibles en versiones anteriores.</p>
<p>TLS 1.3 representa un salto cualitativo importante:</p>
<ul>
<li><strong>Handshake más rápido:</strong> Reduce la latencia al requerir menos viajes de ida y vuelta entre el cliente y el servidor para establecer la conexión.</li>
<li><strong>Suite de Cifrado más simple y fuerte:</strong> Elimina algoritmos obsoletos y débiles, forzando el uso de criptografía moderna y segura.</li>
<li><strong>Mayor seguridad:</strong> Cifra más partes del handshake, protegiendo mejor la identidad del cliente y del servidor.</li>
</ul>

<h2>Guía Práctica: Activación de TLS en Servidores Windows</h2>
<p>A continuación, se detallan los pasos para habilitar las versiones seguras de TLS y deshabilitar las inseguras. Consideraciones Previas Importantes:</p>
<ol>
<li><strong>Copia de Seguridad del Registro:</strong> Antes de realizar cualquier cambio, siempre cree una copia de seguridad del Registro de Windows. Un error podría desestabilizar el sistema.</li>
<li><strong>Reinicio Requerido:</strong> Los cambios en la configuración de SCHANNEL (el proveedor de seguridad de Windows que implementa TLS) requieren un reinicio del servidor para surtir efecto.</li>
<li><strong>Dependencias de .NET Framework:</strong> Asegúrese de que las aplicaciones que se ejecutan en el servidor, especialmente las basadas en .NET, sean compatibles con TLS 1.2. Es posible que necesite actualizar .NET Framework a la versión 4.6.2 o superior para una compatibilidad total.</li>
</ol>

<h3>En Windows Server 2012 y 2012 R2</h3>
<p>Tenga en cuenta:</p>
<ul>
<li>TLS 1.2 es compatible pero no está habilitado por defecto para todas las aplicaciones.</li>
<li>TLS 1.3 no es compatible. Puedes ver una tabla de compatibilidad en las páginas oficiales de Microsoft.</li>
</ul>

<h3>Habilitar TLS 1.2</h3>
<h4>Vía Editor de Registro (regedit.exe) en Modo Administrador</h4>
</br>
[[Archivo:regedit.png|400px|center]]
</br>
<p>1. Navegue a la ruta: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols</code></p>
</br>
[[Archivo:HKEY_LOCAL_MACHINE.png|500px|center]]
</br>

<p>2. Cree una nueva clave llamada <strong>TLS 1.2</strong>.</p>
</br>
[[Archivo:nueva clave llamada TLS 1.2.png|500px|center]]
</br>

<p>3. Dentro de <strong>TLS 1.2</strong>, cree dos claves más: <strong>Client</strong> y <strong>Server</strong>.</p>
</br>
[[Archivo:Dos claves más Client y Server.png|200px|center]]
</br>
<p>4. Dentro de <strong>Client</strong> y <strong>Server</strong>, cree los siguientes valores DWORD (32-bit):</p>
<ul>
<li><code>DisabledByDefault:</code> Valor = 0</li>
<li><code>Enabled:</code> Valor = 1</li>
</ul>
</br>
[[Archivo:DWORD (32-bit).png|400px|center]]
</br>
</br>
[[Archivo:Enabled Valor 1.png|400px|center]]
</br>
<h4>Vía PowerShell (Automatizado y Recomendado)</h4>
<p><strong>Nota:</strong> Probado en Powershell 7 y en modo Administrador. No se garantiza funcione en Powershell 5 o versiones inferiores a 7.</p>
<pre><code>
# Habilitar TLS 1.2 para Cliente y Servidor en Windows Server 2012 / R2
# Definir la ruta base
$ProtocolPath = "HKLM:\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols\TLS 1.2"

# Crear las claves de registro si no existen
if (-not (Test-Path "$ProtocolPath\Client")) {
New-Item -Path "$ProtocolPath\Client" -Force | Out-Null
}
if (-not (Test-Path "$ProtocolPath\Server")) {
New-Item -Path "$ProtocolPath\Server" -Force | Out-Null
}

# Configurar valores para el Cliente
New-ItemProperty -Path "$ProtocolPath\Client" -Name "DisabledByDefault" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Client" -Name "Enabled" -Value 1 -PropertyType "DWord" -Force

# Configurar valores para el Servidor
New-ItemProperty -Path "$ProtocolPath\Server" -Name "DisabledByDefault" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Server" -Name "Enabled" -Value 1 -PropertyType "DWord" -Force

Write-Host "TLS 1.2 ha sido habilitado. Se requiere un reinicio del servidor."
</code></pre>

<h3>Deshabilitar TLS 1.0 y 1.1</h3>
<p>Para deshabilitar las versiones inseguras, debe crear claves similares pero establecer el valor <code>Enabled</code> en 0.</p>
<h4>Vía Editor de Registro (regedit.exe)</h4>
<ol>
<li>Navegue a: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols</code></li>
<li>Para <strong>TLS 1.0</strong> y <strong>TLS 1.1</strong>, cree las claves si no existen (TLS 1.0, Client, Server).</li>
<li>Dentro de las claves <strong>Client</strong> y <strong>Server</strong> de <strong>TLS 1.0</strong> y <strong>TLS 1.1</strong>, cree o modifique el valor DWORD (32-bit):
<ul>
<li><code>Enabled:</code> Valor = 0</li>
</ul>
</li>
</ol>

<h3>En Versiones Superiores (Windows Server 2016, 2019)</h3>
<p>En estas versiones, TLS 1.2 ya viene habilitado por defecto. El trabajo principal es deshabilitar las versiones más antiguas para fortalecer la seguridad. TLS 1.3 no es compatible.</p>

<h4>Vía PowerShell para deshabilitar TLS 1.0 y 1.1</h4>
<pre><code>
# Deshabilitar TLS 1.0 y TLS 1.1 en Windows Server 2016/2019
# Rutas para los protocolos a deshabilitar
$ProtocolsToDisable = @("TLS 1.0", "TLS 1.1")

foreach ($Protocol in $ProtocolsToDisable) {
$ProtocolPath = "HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\$Protocol"
# Crear claves si no existen
if (-not (Test-Path "$ProtocolPath\Client")) { New-Item -Path "$ProtocolPath\Client" -Force | Out-Null}
if (-not (Test-Path "$ProtocolPath\Server")) { New-Item -Path "$ProtocolPath\Server" -Force | Out-Null}

# Deshabilitar Cliente y Servidor para el protocolo
New-ItemProperty -Path "$ProtocolPath\Client" -Name "Enabled" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Server" -Name "Enabled" -Value 0 -PropertyType "DWord" -Force
Write-Host "El protocolo $Protocol ha sido deshabilitado."
}
Write-Host "Se requiere un reinicio del servidor para aplicar los cambios."
</code></pre>

<h3>En Windows Server 2022</h3>
<p>Windows Server 2022 es la primera versión de Windows Server con soporte para TLS 1.3, que está habilitado por defecto junto con TLS 1.2. Lo ideal es deshabilitar TLS 1.0 y 1.1, lo cual se puede hacer con el mismo script de PowerShell para Server 2016/2019.</p>

<h3>En Versiones Inferiores (Windows Server 2008 R2)</h3>
<p>Esta versión es antigua y requiere atención especial. TLS 1.2 no está habilitado por defecto.</p>

<h4>Habilitar TLS 1.2</h4>
<ol>
<li><strong>Instalar Actualización:</strong> Primero, asegúrese de que la actualización KB3140245 está instalada para agregar el soporte de TLS 1.2 a nivel de sistema operativo.</li>
<li><strong>Habilitar vía Registro:</strong> Siga los mismos pasos de registro descritos para Windows Server 2012 R2 para crear las claves y valores para TLS 1.2 (Client y Server) y establecer <code>Enabled</code> en 1 y <code>DisabledByDefault</code> en 0.</li>
</ol>

<h2>Tabla de Compatibilidad de Lenguajes de Programación </h2>
<p>
La siguiente tabla presenta una comparación de distintos lenguajes de programación en cuanto a su compatibilidad con el protocolo TLS.
Se detallan las librerías o mecanismos que cada lenguaje utiliza por defecto, el nivel de soporte para las versiones TLS 1.2 y 1.3,
así como las versiones mínimas comunes necesarias para habilitar dicho soporte.
También se incluyen notas relevantes que explican particularidades, limitaciones o dependencias de cada entorno.
El objetivo es ofrecer una visión general que facilite identificar el nivel de seguridad y requisitos adicionales en cada lenguaje.
Esta información resulta útil para desarrolladores y administradores que requieran implementar conexiones seguras en sus proyectos.
</p>
{| class="wikitable" style="margin:auto; width:70%; text-align:center; font-size:90%;"
| Python || ssl (OpenSSL) || TLS 1.2 / 1.3 || Depende de OpenSSL || TLS 1.0/1.1 deshabilitados en 3.10+.
|-
| Java || JSSE || TLS 1.2 / 1.3 || Java 8 (1.8), 11 (11.3) || TLS 1.3 desde Java 11.
|-
| C# / .NET || System.Net.Security || TLS 1.2 / 1.3 || Depende de S.O. || TLS controlado por SChannel en Windows.
|-
| PHP || openssl || TLS 1.2 / 1.3 || PHP 7.4+ con OpenSSL 1.1.1 || TLS 1.3 desde OpenSSL 1.1.1+.
|-
| Node.js || tls (OpenSSL) || TLS 1.2 / 1.3 || OpenSSL 1.1.1+ || TLSv1.0/1.1 deshabilitados desde Node 10.
|-
| Go || crypto/tls || TLS 1.2 / 1.3 || Go 1.13+ || Go 1.20 deja de ofrecer 1.13.
|-
| Ruby || OpenSSL || TLS 1.2 / 1.3 || Ruby 2.5+ || Depende de OpenSSL del sistema.
|-
| Perl || IO::Socket::SSL || TLS 1.2 / 1.3 || OpenSSL backend || Configurable.
|-
| Rust || rustls o openssl || TLS 1.2 / 1.3 || rustls → solo moderno || No soporta SSLv3 ni TLS obsoletos.
|-
| C / C++ || OpenSSL / GnuTLS || TLS 1.2 / 1.3 || Depende de la versión || Base para muchos otros.
|-
| Swift || Network.framework / CFNetwork || TLS 1.2 / 1.3 || iOS 12+ / macOS 10.14+ || TLS 1.3 soportado.
|-
| Kotlin || Usa pila Java || TLS 1.2 / 1.3 || Igual que Java || Depende de JVM.
|-
| Visual Basic (VB6) || Ninguno nativo (usa WinInet/COM) || No nativo || Requiere librerías externas || Se apoya en SChannel del SO.
|-
| Visual FoxPro || Ninguno nativo || No soporta || Requiere OCX externos || SSL/TLS posible vía ActiveX o llamadas WinAPI.
|-
| Pascal (Delphi/FreePascal) || Indy (Internet Direct) || TLS 1.0 / 1.2 (con librerías) || TLS 1.3 requiere librerías externas || No soporta TLS por defecto; se usan componentes.
|-
| COBOL || Depende del compilador (Ej. Micro Focus, GnuCOBOL) || No nativo || TLS mediante librerías externas (Ej. OpenSSL) || Entornos mainframe usan módulos externos.
|-
| Fortran || Ninguno nativo || No soporta || Requiere bindings a C || Soporte indirecto usando OpenSSL vía C.
|-
| Clipper / dBase || Ninguno nativo || No soporta || Solo vía wrappers modernos || Requiere librerías externas.
|-
| PowerBuilder || Ninguno nativo || TLS vía WinInet/COM || Depende de versión || Requiere usar API de Windows.
|}

<h3>Adicionales: Instalación de sslscan</h3>
<p>Este proyecto es una herramienta open source y funciona tanto en Windows como en Linux.</p>

<h4>1. Instalación En windows</h4>
<p>Puedes descargarlo desde github "bajo el nombre sslscan-2.2.0.zip": https://github.com/rbsec/sslscan/releases/tag/2.2.0</P>
[[Archivo:sslscan_zip.png|650px|center]]
</br>

<p>Luego descomprima y agregue la ruta donde escoja descomprimir la aplicación a sus variables de entorno</p>
[[Archivo:Propiedad_sistema.png|450px|center]]
<br>
[[Archivo:Variables_entorno.png|450px|center]]
<p>Una vez realizado estos pasos, puedes iniciar powershell y ejecutar el comando sslscan -- version y deberá dar la siguiente respuesta:</p>
[[Archivo:Comando_SSL.png|460px|center]]

<h4>2. Instalación En Linux</h4>
<p>Se recomienda seguir el tutorial indicado en la misma web del creador de la aplicación: https://github.com/rbsec/sslscan</P>
<p>y realizar la compilación del programa</p>
[[Archivo:Compilacion_programa.png|600px|center]]
</br>

<h4>Nota Importante:</h4><p>En cada versión de linux los comandos pueden variar; por favor ajuste los mismos a la versión que esté utilizando. Para hacer uso de la aplicación (en Linux o Windows) solo debe hacer uso del comando sslscan url a escanear.</p>
<p>Ejemplo: sslscan [http://emision21v4.thefactoryhka.com.co emision21v4.thefactoryhka.com.co]</p>
[[Archivo:SSLSCAN_emision21V4.png|600px|center]]

<h4>Nota Importante:</h4><p>Si el aplicativo indica la palabra “'''enabled'''” al lado del protocolo significa:</p>
<ol>
<li>Su servidor o computador soporta el protocolo de comunicación</li>
<li>El servidor destino tiene habilitado el protocolo</li>
</ol>

<p>No hace falta realizar configuraciones adicionales</p>

Archivo:SSLSCAN emision21V4.png

2025-08-26T12:27:16Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Variables entorno.png

2025-08-26T12:27:15Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Comando SSL.png

2025-08-26T12:27:15Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Compilacion programa.png

2025-08-26T12:27:15Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Propiedad sistema.png

2025-08-26T12:25:03Z

Amurillo: Archivo subido con MsUpload

Archivo subido con MsUpload

Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web

2025-08-26T01:43:03Z

Amurillo:

<br>
[[Archivo:Mgdv3.png|izquierda|]]

[https://drive.google.com/file/d/1G97RIY0n-E3HZuEaF5qPl99vvE8fhFAO/view <big><b>Grabación 19-08-2025 de Sesión Especial de Aclaración de dudas sobre Actualización de Seguridad Requerida Migración a TLS 1.2 o superior</b></big>]
<p>En este video, te explicamos todo lo que necesitas saber para la '''Actualización de Seguridad a TLS 1.2 o superior'''.

Aprende a:
* Entender el comunicado enviado por el área de Integración.
* Aplicar el '''Manual de Hardening de TLS en Windows Server'''.
* Ver en vivo cómo ejecutar los scripts de configuración.

Al final, respondemos las preguntas realizadas por los asistentes. Esta es la guía que necesitas para cumplir con esta importante actualización.</p>
<br>

<h1>Manual de Hardening de TLS en Windows Server</h1>
<p>Este manual proporciona una guía detallada para administradores de sistemas sobre qué es el protocolo TLS (Transport Layer Security), por qué es crucial para la seguridad, y cómo configurar correctamente sus versiones en diferentes ediciones de Windows Server para garantizar la máxima protección.</p>

<h2>¿Qué es TLS?</h2>
<p>El protocolo <strong>TLS (Transport Transport Layer Security)</strong>, o "Seguridad de la Capa de Transporte", es un protocolo criptográfico diseñado para proporcionar comunicaciones seguras a través de una red. Su propósito fundamental es garantizar la privacidad y la integridad de los datos intercambiados entre dos aplicaciones, como un navegador web y un servidor. En esencia, TLS crea un "túnel" seguro y cifrado sobre la red pública (Internet), impidiendo que terceros puedan leer o modificar la información transmitida. Es la base de la confianza en el comercio electrónico, la banca en línea y cualquier servicio que maneje datos sensibles.</p>

<h2>Funcionamiento Básico: El Handshake</h2>
<p>Para establecer esta conexión segura, los clientes y servidores realizan un proceso de negociación llamado <strong>handshake</strong> (apretón de manos). De forma simplificada, el proceso es el siguiente:</p>
<ol>
<li><strong>Client Hello:</strong> El cliente, ej. tu navegador, envía un mensaje al servidor diciendo: "Hola, quiero establecer una conexión segura. Estas son las versiones de TLS y los algoritmos de cifrado que soporto".</li>
<li><strong>Server Hello:</strong> El servidor responde: "Hola. De acuerdo, usemos esta versión de TLS y este algoritmo de cifrado. Aquí tienes mi certificado digital".</li>
<li><strong>Verificación y Clave:</strong>
<ul>
<li>El cliente verifica la autenticidad del certificado digital del servidor (emitido por una Autoridad de Certificación - CA - de confianza). Esto confirma que el servidor es quien dice ser.</li>
<li>Ambas partes utilizan la información del certificado (la clave pública del servidor) para negociar de forma segura una clave de sesión secreta y simétrica que solo ellos conocerán.</li>
</ul>
</li>
<li><strong>Comunicación Segura:</strong> Una vez establecida la clave de sesión, toda la comunicación posterior entre el cliente y el servidor se cifra con esa clave. Si alguien intercepta los datos, sólo verá un galimatías indescifrable.</li>
</ol>

<h2>Relación con SSL y HTTPS</h2>
<ul>
<li><strong>SSL (Secure Sockets Layer):</strong> Es el predecesor de TLS. Aunque el término "SSL" se sigue usando coloquialmente, todas las versiones de SSL están obsoletas e inseguras. TLS es la evolución directa y segura de SSL.</li>
<li><strong>HTTPS (Hypertext Transfer Protocol Secure):</strong> No es un protocolo en sí mismo, sino la implementación de HTTP sobre una capa de seguridad TLS. Es la forma en que se aplica TLS a la navegación web. En resumen: HTTP + TLS = HTTPS.</li>
</ul>

<h2>Versiones de TLS: Un Recorrido Histórico y Actual</h2>
<h3>Línea de Tiempo de las Versiones:</h3>
<ul>
<li><strong>SSL 2.0 (1995):</strong> Obsoleta y plagada de fallos de seguridad.</li>
<li><strong>SSL 3.0 (1996):</strong> Obsoleta. Vulnerable a ataques críticos como POODLE.</li>
<li><strong>TLS 1.0 (1999):</strong> Obsoleta. Débil ante ataques como BEAST.</li>
<li><strong>TLS 1.1 (2006):</strong> Obsoleta. Ofrecía mejoras menores sobre TLS 1.0 pero comparte muchas de sus debilidades criptográficas.</li>
<li><strong>TLS 1.2 (2008):</strong> Estándar seguro y maduro. Ampliamente compatible y considerado el mínimo aceptable para una comunicación segura hoy en día.</li>
<li><strong>TLS 1.3 (2018):</strong> El estándar de oro actual. Ofrece la máxima seguridad y rendimiento.</li>
</ul>

<h3>Versiones Obsoletas y Vulnerables</h3>
<p>Las versiones SSL 2.0, SSL 3.0, TLS 1.0 y TLS 1.1 se consideran inseguras y deben ser deshabilitadas en cualquier servidor en producción. Vulnerabilidades conocidas como POODLE y BEAST permiten a un atacante, bajo ciertas condiciones, descifrar el tráfico cifrado y robar información sensible como cookies de sesión o contraseñas.</p>

<h3>Versiones Seguras y Actuales</h3>
<p>Los únicos estándares aceptados actualmente son:</p>
<ul>
<li><strong>TLS 1.2:</strong> Es el requisito mínimo indispensable de seguridad.</li>
<li><strong>TLS 1.3:</strong> Es la versión recomendada por su superioridad en seguridad y rendimiento.</li>
</ul>

<h3>Mejoras Clave en TLS 1.2 y TLS 1.3</h3>
<p>TLS 1.2 introdujo el soporte para algoritmos de cifrado más robustos y seguros (como AES-GCM) que no estaban disponibles en versiones anteriores.</p>
<p>TLS 1.3 representa un salto cualitativo importante:</p>
<ul>
<li><strong>Handshake más rápido:</strong> Reduce la latencia al requerir menos viajes de ida y vuelta entre el cliente y el servidor para establecer la conexión.</li>
<li><strong>Suite de Cifrado más simple y fuerte:</strong> Elimina algoritmos obsoletos y débiles, forzando el uso de criptografía moderna y segura.</li>
<li><strong>Mayor seguridad:</strong> Cifra más partes del handshake, protegiendo mejor la identidad del cliente y del servidor.</li>
</ul>

<h2>Guía Práctica: Activación de TLS en Servidores Windows</h2>
<p>A continuación, se detallan los pasos para habilitar las versiones seguras de TLS y deshabilitar las inseguras. Consideraciones Previas Importantes:</p>
<ol>
<li><strong>Copia de Seguridad del Registro:</strong> Antes de realizar cualquier cambio, siempre cree una copia de seguridad del Registro de Windows. Un error podría desestabilizar el sistema.</li>
<li><strong>Reinicio Requerido:</strong> Los cambios en la configuración de SCHANNEL (el proveedor de seguridad de Windows que implementa TLS) requieren un reinicio del servidor para surtir efecto.</li>
<li><strong>Dependencias de .NET Framework:</strong> Asegúrese de que las aplicaciones que se ejecutan en el servidor, especialmente las basadas en .NET, sean compatibles con TLS 1.2. Es posible que necesite actualizar .NET Framework a la versión 4.6.2 o superior para una compatibilidad total.</li>
</ol>

<h3>En Windows Server 2012 y 2012 R2</h3>
<p>Tenga en cuenta:</p>
<ul>
<li>TLS 1.2 es compatible pero no está habilitado por defecto para todas las aplicaciones.</li>
<li>TLS 1.3 no es compatible. Puedes ver una tabla de compatibilidad en las páginas oficiales de Microsoft.</li>
</ul>

<h3>Habilitar TLS 1.2</h3>
<h4>Vía Editor de Registro (regedit.exe) en Modo Administrador</h4>
</br>
[[Archivo:regedit.png|400px|center]]
</br>
<p>1. Navegue a la ruta: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols</code></p>
</br>
[[Archivo:HKEY_LOCAL_MACHINE.png|500px|center]]
</br>

<p>2. Cree una nueva clave llamada <strong>TLS 1.2</strong>.</p>
</br>
[[Archivo:nueva clave llamada TLS 1.2.png|500px|center]]
</br>

<p>3. Dentro de <strong>TLS 1.2</strong>, cree dos claves más: <strong>Client</strong> y <strong>Server</strong>.</p>
</br>
[[Archivo:Dos claves más Client y Server.png|200px|center]]
</br>
<p>4. Dentro de <strong>Client</strong> y <strong>Server</strong>, cree los siguientes valores DWORD (32-bit):</p>
<ul>
<li><code>DisabledByDefault:</code> Valor = 0</li>
<li><code>Enabled:</code> Valor = 1</li>
</ul>
</br>
[[Archivo:DWORD (32-bit).png|400px|center]]
</br>
</br>
[[Archivo:Enabled Valor 1.png|400px|center]]
</br>
<h4>Vía PowerShell (Automatizado y Recomendado)</h4>
<p><strong>Nota:</strong> Probado en Powershell 7 y en modo Administrador. No se garantiza funcione en Powershell 5 o versiones inferiores a 7.</p>
<pre><code>
# Habilitar TLS 1.2 para Cliente y Servidor en Windows Server 2012 / R2
# Definir la ruta base
$ProtocolPath = "HKLM:\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols\TLS 1.2"

# Crear las claves de registro si no existen
if (-not (Test-Path "$ProtocolPath\Client")) {
New-Item -Path "$ProtocolPath\Client" -Force | Out-Null
}
if (-not (Test-Path "$ProtocolPath\Server")) {
New-Item -Path "$ProtocolPath\Server" -Force | Out-Null
}

# Configurar valores para el Cliente
New-ItemProperty -Path "$ProtocolPath\Client" -Name "DisabledByDefault" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Client" -Name "Enabled" -Value 1 -PropertyType "DWord" -Force

# Configurar valores para el Servidor
New-ItemProperty -Path "$ProtocolPath\Server" -Name "DisabledByDefault" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Server" -Name "Enabled" -Value 1 -PropertyType "DWord" -Force

Write-Host "TLS 1.2 ha sido habilitado. Se requiere un reinicio del servidor."
</code></pre>

<h3>Deshabilitar TLS 1.0 y 1.1</h3>
<p>Para deshabilitar las versiones inseguras, debe crear claves similares pero establecer el valor <code>Enabled</code> en 0.</p>
<h4>Vía Editor de Registro (regedit.exe)</h4>
<ol>
<li>Navegue a: <code>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Security Providers\SCHANNEL\Protocols</code></li>
<li>Para <strong>TLS 1.0</strong> y <strong>TLS 1.1</strong>, cree las claves si no existen (TLS 1.0, Client, Server).</li>
<li>Dentro de las claves <strong>Client</strong> y <strong>Server</strong> de <strong>TLS 1.0</strong> y <strong>TLS 1.1</strong>, cree o modifique el valor DWORD (32-bit):
<ul>
<li><code>Enabled:</code> Valor = 0</li>
</ul>
</li>
</ol>

<h3>En Versiones Superiores (Windows Server 2016, 2019)</h3>
<p>En estas versiones, TLS 1.2 ya viene habilitado por defecto. El trabajo principal es deshabilitar las versiones más antiguas para fortalecer la seguridad. TLS 1.3 no es compatible.</p>

<h4>Vía PowerShell para deshabilitar TLS 1.0 y 1.1</h4>
<pre><code>
# Deshabilitar TLS 1.0 y TLS 1.1 en Windows Server 2016/2019
# Rutas para los protocolos a deshabilitar
$ProtocolsToDisable = @("TLS 1.0", "TLS 1.1")

foreach ($Protocol in $ProtocolsToDisable) {
$ProtocolPath = "HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\$Protocol"
# Crear claves si no existen
if (-not (Test-Path "$ProtocolPath\Client")) { New-Item -Path "$ProtocolPath\Client" -Force | Out-Null}
if (-not (Test-Path "$ProtocolPath\Server")) { New-Item -Path "$ProtocolPath\Server" -Force | Out-Null}

# Deshabilitar Cliente y Servidor para el protocolo
New-ItemProperty -Path "$ProtocolPath\Client" -Name "Enabled" -Value 0 -PropertyType "DWord" -Force
New-ItemProperty -Path "$ProtocolPath\Server" -Name "Enabled" -Value 0 -PropertyType "DWord" -Force
Write-Host "El protocolo $Protocol ha sido deshabilitado."
}
Write-Host "Se requiere un reinicio del servidor para aplicar los cambios."
</code></pre>

<h3>En Windows Server 2022</h3>
<p>Windows Server 2022 es la primera versión de Windows Server con soporte para TLS 1.3, que está habilitado por defecto junto con TLS 1.2. Lo ideal es deshabilitar TLS 1.0 y 1.1, lo cual se puede hacer con el mismo script de PowerShell para Server 2016/2019.</p>

<h3>En Versiones Inferiores (Windows Server 2008 R2)</h3>
<p>Esta versión es antigua y requiere atención especial. TLS 1.2 no está habilitado por defecto.</p>

<h4>Habilitar TLS 1.2</h4>
<ol>
<li><strong>Instalar Actualización:</strong> Primero, asegúrese de que la actualización KB3140245 está instalada para agregar el soporte de TLS 1.2 a nivel de sistema operativo.</li>
<li><strong>Habilitar vía Registro:</strong> Siga los mismos pasos de registro descritos para Windows Server 2012 R2 para crear las claves y valores para TLS 1.2 (Client y Server) y establecer <code>Enabled</code> en 1 y <code>DisabledByDefault</code> en 0.</li>
</ol>

<h2>Tabla de Compatibilidad de Lenguajes de Programación </h2>
<p>
La siguiente tabla presenta una comparación de distintos lenguajes de programación en cuanto a su compatibilidad con el protocolo TLS.
Se detallan las librerías o mecanismos que cada lenguaje utiliza por defecto, el nivel de soporte para las versiones TLS 1.2 y 1.3,
así como las versiones mínimas comunes necesarias para habilitar dicho soporte.
También se incluyen notas relevantes que explican particularidades, limitaciones o dependencias de cada entorno.
El objetivo es ofrecer una visión general que facilite identificar el nivel de seguridad y requisitos adicionales en cada lenguaje.
Esta información resulta útil para desarrolladores y administradores que requieran implementar conexiones seguras en sus proyectos.
</p>
{| class="wikitable" style="margin:auto; width:70%; text-align:center; font-size:90%;"
| Python || ssl (OpenSSL) || TLS 1.2 / 1.3 || Depende de OpenSSL || TLS 1.0/1.1 deshabilitados en 3.10+.
|-
| Java || JSSE || TLS 1.2 / 1.3 || Java 8 (1.8), 11 (11.3) || TLS 1.3 desde Java 11.
|-
| C# / .NET || System.Net.Security || TLS 1.2 / 1.3 || Depende de S.O. || TLS controlado por SChannel en Windows.
|-
| PHP || openssl || TLS 1.2 / 1.3 || PHP 7.4+ con OpenSSL 1.1.1 || TLS 1.3 desde OpenSSL 1.1.1+.
|-
| Node.js || tls (OpenSSL) || TLS 1.2 / 1.3 || OpenSSL 1.1.1+ || TLSv1.0/1.1 deshabilitados desde Node 10.
|-
| Go || crypto/tls || TLS 1.2 / 1.3 || Go 1.13+ || Go 1.20 deja de ofrecer 1.13.
|-
| Ruby || OpenSSL || TLS 1.2 / 1.3 || Ruby 2.5+ || Depende de OpenSSL del sistema.
|-
| Perl || IO::Socket::SSL || TLS 1.2 / 1.3 || OpenSSL backend || Configurable.
|-
| Rust || rustls o openssl || TLS 1.2 / 1.3 || rustls → solo moderno || No soporta SSLv3 ni TLS obsoletos.
|-
| C / C++ || OpenSSL / GnuTLS || TLS 1.2 / 1.3 || Depende de la versión || Base para muchos otros.
|-
| Swift || Network.framework / CFNetwork || TLS 1.2 / 1.3 || iOS 12+ / macOS 10.14+ || TLS 1.3 soportado.
|-
| Kotlin || Usa pila Java || TLS 1.2 / 1.3 || Igual que Java || Depende de JVM.
|-
| Visual Basic (VB6) || Ninguno nativo (usa WinInet/COM) || No nativo || Requiere librerías externas || Se apoya en SChannel del SO.
|-
| Visual FoxPro || Ninguno nativo || No soporta || Requiere OCX externos || SSL/TLS posible vía ActiveX o llamadas WinAPI.
|-
| Pascal (Delphi/FreePascal) || Indy (Internet Direct) || TLS 1.0 / 1.2 (con librerías) || TLS 1.3 requiere librerías externas || No soporta TLS por defecto; se usan componentes.
|-
| COBOL || Depende del compilador (Ej. Micro Focus, GnuCOBOL) || No nativo || TLS mediante librerías externas (Ej. OpenSSL) || Entornos mainframe usan módulos externos.
|-
| Fortran || Ninguno nativo || No soporta || Requiere bindings a C || Soporte indirecto usando OpenSSL vía C.
|-
| Clipper / dBase || Ninguno nativo || No soporta || Solo vía wrappers modernos || Requiere librerías externas.
|-
| PowerBuilder || Ninguno nativo || TLS vía WinInet/COM || Depende de versión || Requiere usar API de Windows.
|}

<h3>Adicionales: Instalación de sslscan</h3>
<p>Este proyecto es una herramienta open source y funciona tanto en Windows como en Linux.</p>

<h4>1. Instalación En windows</h4>
<p>Puedes descargarlo desde github "bajo el nombre sslscan-2.2.0.zip": https://github.com/rbsec/sslscan/releases/tag/2.2.0</P>
[[Archivo:sslscan_zip.png|400px|center]]
</br>

<p>Luego descomprima y agregue la ruta donde escoja descomprimir la aplicación a sus variables de entorno</p>
[[Archivo:Propiedad_sistema.png|400px|center]]
<br>
[[Archivo:Variables_entorno.png|400px|center]]
<p>Una vez realizado estos pasos, puedes iniciar powershell y ejecutar el comando sslscan -- version y debera dar la siguiente respuesta:</p>
[[Archivo:Comando_SSL.png|400px|center]]

<h4>2. Instalación En Linux</h4>
<p>Se recomienda seguir el tutorial indicado en la misma web del creador de la aplicación: https://github.com/rbsec/sslscan</P>
<p>y realizar la compilación del programa</p>
[[Archivo:Compilacion_programa.png|400px|center]]
</br>

<h4>Nota Importante:</h4><p>En cada versión de linux los comandos pueden variar; por favor ajuste los mismos a la versión que esté utilizando. Para hacer uso de la aplicación (en Linux o Windows) solo debe hacer uso del comando sslscan url a escanear.</p>
<p>Ejemplo: sslscan [http://emision21v4.thefactoryhka.com.co emision21v4.thefactoryhka.com.co]</p>
[[Archivo:SSLSCAN_emision21V4.png|400px|center]]

<h4>Nota Importante:</h4><p>Si el aplicativo indica la palabra “'''enabled'''” al lado del protocolo significa:</p>
<ol>
<li>Su servidor o computador soporta el protocolo de comunicación</li>
<li>El servidor destino tiene habilitado el protocolo</li>
</ol>

<p>No hace falta realizar configuraciones adicionales</p>

Archivo:Sslscan zip.png

2025-08-26T00:59:37Z

Amurillo:

Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web

2025-08-20T13:42:44Z

Amurillo: