Sector Salud Resolución 948 de 14 de Mayo 2026
Resolución 0948 de 14 de Mayo de 2026
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.
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.
Fechas Clave de Implementación
| Fecha | Hito | Impacto para el Integrador |
|---|---|---|
| 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. | ||
| 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. |
URL Web Service SOAP Versión 4
URL Web Service REST
- URL Producción: https://emision21-api.thefactoryhka.com.co
@IMPORTANTE: Asegúrese de utilizar la Versión 4 del servicio SOAP (emision21v4) para que la extensión UBL del sector salud sea generada correctamente según los lineamientos de la Resolución 0948:2026.
Resumen de Cambios Estructurales
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:
| N° | Cambio | Descripción | Obligatoriedad |
|---|---|---|---|
| Reubicación de Recaudos y Anticipos | Copago, Cuota Moderadora, Pagos Compartidos y Anticipos se eliminan del UBLExtension (Extensión Salud) y pasan obligatoriamente al nodo estándar de la DIAN <cac:PrepaidPayment> con el atributo schemeID="conceptoRecaudo". | ||
| 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 <Nombre>22</Nombre> con un valor numérico del 1 al 6 que justifica la ausencia de contrato. | (cuando no hay CUCON) | |
| 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 <cbc:Note> a nivel raíz para incrustar la cadena del CUCON: <cbc:Note>CUCON:123...</cbc:Note> | (cuando aplica) | |
| Nota a Nivel de Línea (InvoiceLine) | Se habilita el campo cbc:Note 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. | ||
| 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. |
Actualización de Cabecera — CustomTagGeneral
Con la entrada en vigencia de la Resolución 0948, el nodo CustomTagGeneral del XML fiscal debe ser actualizado en dos elementos:
- La URL del Responsable cambia de la web del Ministerio de Salud a la web del SISPRO:
https://web.sispro.gov.co - La etiqueta del acto administrativo debe actualizarse de "Resolución 2275:2023" a Resolución 0948:2026.
<ActoAdministrativo>Resolución 0948:2026</ActoAdministrativo> <UrlResponsable>https://web.sispro.gov.co</UrlResponsable>
@IMPORTANTE: 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.
Campos Adicionales Factura Electrónica Sector Salud
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.
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
Cambio 1: Reubicación de Recaudos y Anticipos en PrepaidPayment
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 (UBLExtension) y deben mapearse única y obligatoriamente en el nodo estándar de la DIAN <cac:PrepaidPayment> en la raíz de la factura, con el atributo schemeID="conceptoRecaudo".
Información sobre el grupo PrepaidPayment
✓ Copago
✓ Cuota moderadora
✓ Pagos compartidos en planes voluntarios de salud
✓ Anticipos
Códigos de Tipo de Recaudo
| Código | Concepto de Recaudo | Nodo XML Generado |
|---|---|---|
| Copago | <cac:PrepaidPayment schemeID="conceptoRecaudo"> | |
| Cuota Moderadora | <cac:PrepaidPayment schemeID="conceptoRecaudo"> | |
| Pagos Compartidos en Planes Voluntarios | <cac:PrepaidPayment schemeID="conceptoRecaudo"> | |
| Anticipo | <cac:PrepaidPayment schemeID="conceptoRecaudo"> | |
| No Aplica | <cac:PrepaidPayment schemeID="conceptoRecaudo"> |
@IMPORTANTE: El servicio admite el reporte de hasta 4 nodos <cac:PrepaidPayment> por factura. La sumatoria de todos los recaudos reportados debe coincidir con el valor del campo totalAnticipos del Objeto Factura.
Para integracion alternativa como la DLL los campos del identificador 06B (Copago, Cuota Moderadora y Pagos Compartidos) dentro de la clase CamposGenerales ID06B deben enviarse vacíos.
Implementación REST (JSON)
En el servicio REST se debe utilizar el arreglo anticipos dentro del Objeto Factura, incluyendo en cada nodo el campo extras con nombre="recaudo" y el código del concepto en valor. Los campos de Copago, Cuota Moderadora y Pagos Compartidos dentro de CamposGenerales 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
]
}
]
}
}
Implementación SOAP (XML)
En el servicio SOAP se utiliza el nodo <anticipos> dentro del Objeto Factura. Cada <Anticipos> debe contener el subnodo <extras><Extensible> con <nombre>recaudo</nombre> y el código correspondiente en <valor>:
<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>
Implementación DLL
Desde la integración por DLL, se debe utilizar la clase Anticipos ID 04 del Objeto Factura. El campo Extras de cada anticipo debe contener un objeto Extensible con Nombre = "recaudo" y el código del concepto en Valor. Los campos 06B del CamposGenerales se asignan como cadena vacía:
Anticipos= "02A||2024-02-27||1|Copago|41.00|||recaudo|01|" Anticipos1= "02A||2024-02-27||2|Cuota Moderadora|41.00|||recaudo|01|" Anticipos2= "02A||2024-02-27||3|Pagos Compartidos|41.00|||recaudo|01|" ID02A = Anticipos + "%" + Anticipos1 + "%" + Anticipos2
Total de anticipos del ID02 = sumatoria de todos los montos recaudados, este valor se resta del total del documento TotalAnticipos = "123.00"
Cambio 2: Nuevo Nodo FACTURA_SIN_CONTRATO
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:
- Cuando sí existe CUCON: el campo
NUMERO_CONTRATO(Nombre="14") se llena con el hash del CUCON y el Nuevo Campo 22 no se envía. - Cuando NO existe CUCON: el campo
NUMERO_CONTRATO(Nombre="14") viaja vacío y es obligatorio incluir el Nuevo campo adicionalNombre="22"con el código numérico que justifica la ausencia de contrato.
Códigos de Justificación — FACTURA_SIN_CONTRATO (Nombre=22)
| Código (Valor) | Justificación de Ausencia de Contrato |
|---|---|
| ATENCION DE URGENCIAS | |
| ATENCION A CARGO DE ADRES O DE ASEGURADORA SOAT, PLANES VOLUNTARIOS DE SALUD | |
| ATENCION EN SALUD POR FALLOS DE TUTELA/ORDENES JUDICIALES | |
| 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 | |
| ATENCION EN SALUD EN CASOS EXCEPCIONALES POR COTIZACIONES O AUTORIZACIONES SIN CONTRATO ATENCIONES ADICIONALES EXCEPCIONALES | |
| GESTION RECUPERACION DE ORGANOS PARA TRASPLANTE EN CUMPLIMIENTO LEY ESTATUTARIA 1751 DE 2015 |
@IMPORTANTE: El campo Nombre="22" debe ubicarse dentro del arreglo CamposGenerales de la clase DatosPacienteSalud, después del campo Nombre="15" (Número de Póliza). Su ausencia cuando NUMERO_CONTRATO está vacío generará rechazo a partir del 1 de junio de 2026.
Implementación REST (JSON) — Factura Sin Contrato
"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"
}
}
Implementación SOAP (XML) — Factura Sin Contrato
<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>
Implementación DLL — Factura Sin Contrato
Desde la integración por DLL, el campo FACTURA_SIN_CONTRATO se gestiona a través del campo Extras del Objeto Factura usando el identificador 04 y el código de campo extra 4001, siguiendo el formato de cadena pipe-delimitada:
FACTURA SIN CONTRATO - Resolución 0948:2026
Formato del campo Extras: "ID|||CampoExtra|0|Tipo|Valor"
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: Urgencias (código 1) String = "04|||4001|0|01|1"
' Ejemplo: Sin contrato general (código 6) String = "04|||4001|0|01|6"
@IMPORTANTE: El campo Extra 4001 debe enviarse, si dentro del arreglo CamposGenerales ID06B el campo NUMERO_CONTRATO está vacío generará rechazo a partir del 1 de junio de 2026.
Cambio 3: Compras Directas SIN RIPS
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 cbc:Note clase cbc:informacionAdicional
a nivel de la raíz de la factura, utilizando el prefijo CUCON: seguido del hash del contrato.
@IMPORTANTE: 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 tipoSector no debe ser "2" (Sector Salud), y la clase sectorSalud no se incluye en la estructura.
Implementación REST (JSON) — Compra Directa sin RIPS
"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
}
Implementación SOAP (XML) — Compra Directa sin RIPS
Esto genera el nodo cbc:Note a nivel raíz del XML fiscal -->
<informacionAdicional>
<arr:string>CUCON:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855</arr:string>
</informacionAdicional>
Implementación DLL — Compra Directa sin RIPS
Desde la integración por DLL, el CUCON se reporta usando el identificador 02I (Información Adicional). Este genera el nodo cbc:Note con el prefijo CUCON: 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
Cambio 4: Nota Aclaratoria a Nivel de Línea (InvoiceLine)
La Resolución 0948 habilita el campo cbc:Note a nivel de línea de detalle de la factura (nodo InvoiceLine). 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.
Este campo ya existía en la estructura de HKA Integración como el campo nota de la clase FacturaDetalle. La Resolución 0948 lo formaliza y amplía su uso para el sector salud.
Implementación REST (JSON) — Nota a Nivel de Línea
<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>
Implementación SOAP (XML) — Nota a Nivel de Línea
<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>
Ejemplos Completos por Escenario
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).
ESCENARIO SS-CUFE — Acreditación con Recaudos Previos
SS-CUFE Con Contrato — Request REST
<syntaxhighlight lang="javascript"> {
"tokenEmpresa": "Plantilla:TokenEmpresa", "tokenPassword": "Plantilla: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": [ "[email protected]" ] } ], "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>
SS-CUFE Con Contrato — Request SOAP
<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>[email protected]</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>
SS-CUFE Sin Contrato — Request REST
<syntaxhighlight lang="javascript"> {
"tokenEmpresa": "Plantilla:TokenEmpresa", "tokenPassword": "Plantilla: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": "Plantilla: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>
SS-CUFE Sin Contrato — Request SOAP
<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>
ESCENARIO SS-Reporte — Reporte de Recaudo Realizado por la ERP
SS-Reporte Con Contrato — Request REST
<syntaxhighlight lang="javascript"> {
"tokenEmpresa": "Plantilla:TokenEmpresa", "tokenPassword": "Plantilla: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": "Plantilla: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>
SS-Reporte Con Contrato — Request SOAP
<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>
ESCENARIO SS-SinAporte — Sin Recaudos Previos
SS-SinAporte Con Contrato — Request REST
<syntaxhighlight lang="javascript"> {
"tokenEmpresa": "Plantilla:TokenEmpresa", "tokenPassword": "Plantilla: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": "Plantilla: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>
SS-SinAporte Con Contrato — Request SOAP
<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>
SS-SinAporte Sin Contrato — Request REST
<syntaxhighlight lang="javascript"> {
"tokenEmpresa": "Plantilla:TokenEmpresa", "tokenPassword": "Plantilla: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": "Plantilla: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>
URLs del Servicio HKA Integración — Resolución 0948
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:
Copyright © 2016 The Factory HKA. Todos los derechos reservados.