SECTOR SALUD#
Tipos de operación y estructura incluidos dentro del JSON (DTO) genérico, con información de extensión para el sector salud.
Esta estructura permite incorporar los datos específicos requeridos para la facturación electrónica de servicios de salud, conforme a las disposiciones y estándares definidos para este sector.
1. OperationType (SECTOR SALUD)
Invoice.OperationType
/Invoice/cbc:CustomizationID
Un documento de venta será reconocido para el Sector Salud si el valor del OperationType corresponde a uno de los siguientes códigos:
SS-CUFE
SS-CUDE
SS-POS
SS-SNum
SS-Recaudo
SS-Reporte
SS-SinAporte
El listado de los diferentes tipos de operación están disponibles en el método del WEB API de Saphety: OperationType.
2. Name schemeName (SECTOR SALUD)
/Invoice/ext:UBLExtension/ext:ExtensionContent/CustomTagGeneral/Interoperabilidad/Group/Collection schemeName
Nombre del colaborardor o del sector en donde se presta el servicio Ejm: Pediatría.
3. Name (SECTOR SALUD)
/Invoice/ext:UBLExtension/ext:ExtensionContent/CustomTagGeneral/Interoperabilidad/Group/Collection/AdditionaInformation/Name
Se debe informar cada grupo por el valor que se desee incluir. Nombre, llave o maestro de la información a reportar.
4. NameValues.Value (SECTOR SALUD)
Invoice.HealthcareData.Collections.NameValues.Value
/Invoice/ext:UBLExtension/ext:ExtensionContent/CustomTagGeneral/Interoperabilidad/Group/Collection/AdditionaInformation/Value
Valor del nombre, llave o maestro a informar.
Puede ser igual al nombre del atributo.
5. NameValues.CodeListName (SECTOR SALUD)
Invoice.HealthcareData.Collections.NameValues.CodeListName
/Invoice/ext:UBLExtension/ext:ExtensionContent/CustomTagGeneral/Interoperabilidad/Group/Collection/AdditionaInformation/Value scheme Name
Se usa para identificar la lista de códigos.
6. NameValues.CodeListCode (SECTOR SALUD)
Invoice.HealthcareData.Collections.NameValues.CodeListCode
/Invoice/ext:UBLExtension/ext:ExtensionContent/CustomTagGeneral/Interoperabilidad/Group/Collection/AdditionaInformation/Value schemeID
El código se ingresa aquí, la descripción asociada va en el elemento “valor”.
DTO SECTOR SALUD#
JSON (DTO) - SECTOR SALUD
{
"Currency": "COP",
"SeriePrefix": "SETP",
"SerieNumber": "990041507",
"IssueDate": "2024-04-17T12:12:12",
"DueDate": "2024-04-17T12:12:12",
"DeliveryDate": "2024-04-17T12:12:12",
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"SerieExternalKey": "{{serieexternalkeyFV}}",
"OperationType": "SS-CUFE",
"BillingPeriod": { /// Opcional
"From": "2024-04-01T12:12:12",
"To": "2024-04-10T12:12:12"
},
"IssuerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
],
"CustomerParty": {
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
},
"Name": "Saphety Transacciones Electrónicas S.A.S",
"Address": {
"DepartmentCode": "11",
"CityCode": "11001",
"AddressLine": "Calle 97a No. 9 - 45",
"Country": "CO"
}
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00",
"RoundingAmount": "0.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00",
"RoundingAmount": "0.00"
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "136850.00",
"TaxableAmount": "115000.00",
"PrePaidTotalAmount": "8000.00" /*Campo Anticipo*/
},
"PrepaidPayments": [
{ /*Sección para informar Anticipos*/
"PaidDate": "2023-11-27T12:12:12", /*Campo Anticipo*/
"PaidAmount": "8000.00" /*Campo Anticipo*/
}
],
"HealthcareData": {
"Collections": [
{
"Name": "Pepito Perez",// Nombre del colaborador o del sector en donde se presta el servicio
"NameValues": [
{
"Name": "CODIGO_PRESTADOR",
"Value": "codigo_prestador_de_servicios"
},
{
"Name": "TIPO_DOCUMENTO_IDENTIFICACION",
"Value": "Cédula de ciudadanía",
"CodeListName": "salud_identificacion.gc",
"CodeListCode": "CC"
},
{
"Name": "NUMERO_DOCUMENTO_IDENTIFICACION",
"Value": "1234567891"
},
{
"Name": "PRIMER_APELLIDO",
"Value": "Primer_Apellido_del_usuario"
},
{
"Name": "SEGUNDO_APELLIDO",
"Value": "Segundo_Apellido_del_usuario"
},
{
"Name": "PRIMER_NOMBRE",
"Value": "Primer_Nombre_del_usuario"
},
{
"Name": "SEGUNDO_NOMBRE",
"Value": "Segundo_Nombre_del_usuario"
},
{
"Name": "TIPO_USUARIO",
"Value": "Contributivo cotizante",
"CodeListName": "salud_tipo_usuario.gc",
"CodeListCode": "01"
},
{
"Name": "MODALIDAD_CONTRATACION",
"Value": "Grupos Relacionados por Diagnóstico",
"CodeListName": "salud_modalidad_pago.gc",
"CodeListCode": "02"
},
{
"Name": "OBERTURA_PLAN_BENEFICIOS",
"Value": "Cobertura Póliza SOAT",
"CodeListName": "salud_cobertura.gc",
"CodeListCode": "04"
},
{
"Name": "NUMERO_AUTORIZACION",
"Value": "A1234;604567;AX-2345"
},
{
"Name": "NUMERO_MIPRES",
"Value": "1 A1234;604567;AX-234534566"
},
{
"Name": "NUMERO_ENTREGA_MIPRES",
"Value": "2 A1234;604567;AX-234534566"
},
{
"Name": "NUMERO_CONTRATO",
"Value": "XPTO3"
},
{
"Name": "NUMERO_POLIZA",
"Value": "NUMERO de POLIZA"
},
{
"Name": "COPAGO",
"Value": "1000000"
},
{
"Name": "CUOTA_MODERADORA",
"Value": "2000000"
},
{
"Name": "CUOTA_RECUPERACION",
"Value": "3000000"
},
{
"Name": "PAGOS_COMPARTIDOS",
"Value": "4000000"
}
]
},
{
"Name": "Pediatria",// Nombre del colaborador o del sector en donde se presta el servicio
"NameValues": [
{
"Name": "CODIGO_PRESTADOR",
"Value": "codigo_prestador_de_servicios"
},
{
"Name": "TIPO_DOCUMENTO_IDENTIFICACION",
"Value": "Cédula de ciudadanía",
"CodeListName": "salud_identificacion.gc",
"CodeListCode": "CC"
},
{
"Name": "NUMERO_DOCUMENTO_IDENTIFICACION",
"Value": "1234567891"
},
{
"Name": "PRIMER_APELLIDO",
"Value": "Primer_Apellido_del_usuario"
},
{
"Name": "SEGUNDO_APELLIDO",
"Value": "Segundo_Apellido_del_usuario"
},
{
"Name": "PRIMER_NOMBRE",
"Value": "Primer_Nombre_del_usuario"
},
{
"Name": "SEGUNDO_NOMBRE",
"Value": "Segundo_Nombre_del_usuario"
},
{
"Name": "TIPO_USUARIO",
"Value": "Contributivo cotizante",
"CodeListName": "salud_tipo_usuario.gc",
"CodeListCode": "01"
},
{
"Name": "MODALIDAD_CONTRATACION",
"Value": "Grupos Relacionados por Diagnóstico",
"CodeListName": "salud_modalidad_pago.gc",
"CodeListCode": "02"
},
{
"Name": "OBERTURA_PLAN_BENEFICIOS",
"Value": "Cobertura Póliza SOAT",
"CodeListName": "salud_cobertura.gc",
"CodeListCode": "04"
},
{
"Name": "NUMERO_AUTORIZACION",
"Value": "A1234;604567;AX-2345"
},
{
"Name": "NUMERO_MIPRES",
"Value": "1 A1234;604567;AX-234534566"
},
{
"Name": "NUMERO_ENTREGA_MIPRES",
"Value": "2 A1234;604567;AX-234534566"
},
{
"Name": "NUMERO_CONTRATO",
"Value": "XPTO3"
},
{
"Name": "NUMERO_POLIZA",
"Value": "NUMERO de POLIZA"
},
{
"Name": "COPAGO",
"Value": "1000000"
},
{
"Name": "CUOTA_MODERADORA",
"Value": "2000000"
},
{
"Name": "CUOTA_RECUPERACION",
"Value": "3000000"
},
{
"Name": "PAGOS_COMPARTIDOS",
"Value": "4000000"
}
]
}
]
}
}
Important
Informamos que la generación del documento electrónico de factura electrónica esta implementada conforme a la estructura definida por el Anexo Técnico 1.9 de la DIAN.
Desde Saphety, cumplimos con lo establecido en el anexo técnico vigente de factura electrónica, el cual define la estructura principal de la factura electrónica. Para el sector salud, Saphety incorpora una extensión dentro del objeto DTO (Mensaje JSON), específicamente en la sección healthcareData, sin alterar la estructura general de la factura.