Factura electrónica sector salud

Esta guía te indica cómo construir la factura electrónica para operaciones del sector salud.

1. Tipos de documento (`code`)

Debes usar los mismos códigos de la factura electrónica de venta:

`code`	Tipo de documento
`01`	Factura electrónica de venta

2. Tipos de operación (`typeOperation`) para sector salud

La diferencia frente a la factura estándar está en typeOperation:

`typeOperation`	Descripción
`SS-CUFE`	Operación de salud con aportes.
`SS-CUDE`	Operación de salud con aportes.
`SS-Recaudo`	Operación de recaudo en el sector salud.
`SS-Reporte`	Operación de reporte en el sector salud.
`SS-SinAporte`	Operación de salud sin aporte.

Reglas sobre aportes:

Cuando typeOperation sea SS-CUFE o SS-CUDE, los aportes que ingreses se tomarán como anticipos y se restarán del total en la factura.

Cuando typeOperation sea SS-Reporte, los aportes que ingreses se registran a modo informativo y no se restarán del total en la factura.

3. Atributo adicional obligatorio: `healthSector`

Además de code y typeOperation, debes incluir el objeto healthSector:

{
  "healthSector": {
    "serviceProviderCode": "0123456789",
    "paymentMethod": "01",
    "coverageOrBenefitPlan": "01",
    "contractNumber": "031554",
    "policyNumber": "256489782",
    "copayment": 0,
    "moderatorFee": 0,
    "sharedPaymentsInVoluntaryPlans": 0,
    "advance": 0
  }
}

4. Modalidad de pago (`paymentMethod`)

Debes enviar paymentMethod dentro de healthSector usando uno de estos códigos:

`paymentMethod`	Descripción
`01`	Pago individual por caso.
`02`	Pago global prospectivo.
`03`	Pago por capitación.
`04`	Pago por evento.
`05`	Otra modalidad (específica).

5. Cobertura o plan de beneficios (`coverageOrBenefitPlan`)

Debes enviar coverageOrBenefitPlan dentro de healthSector usando uno de estos códigos:

`coverageOrBenefitPlan`	Descripción
`01`	Plan de beneficios en salud financiado con UPC
`02`	Presupuesto maximo
`03`	Prima EPS / EOC, no asegurados SOAT
`04`	Cobertura Poliza SOAT
`05`	Cobertura ARL
`06`	Cobertura ADRES
`07`	Cobertura Salud Publica
`08`	Cobertura entidad territorial, recursos de oferta
`09`	Urgencias poblacion migrante
`10`	Plan complementario en salud
`11`	Plan medicina prepagada
`12`	Otras polizas en salud
`13`	Cobertura Regimen Especial o Excepcion
`14`	Cobertura Fondo Nacional de Salud de las Personas Privadas de la Libertad
`15`	Particular

6. Regla práctica

code: usa 01 o 02.

typeOperation: usa uno de los valores SS-* permitidos.

healthSector: inclúyelo completo con la información de la operación de salud.

paymentMethod: usa uno de los códigos 01 a 05.

coverageOrBenefitPlan: usa uno de los códigos 01 a 15.

7. Ejemplo JSON completo

{
  "code": "01",
  "typeOperation": "SS-CUFE",
  "healthSector": {
    "serviceProviderCode": "0123456789",
    "paymentMethod": "01",
    "coverageOrBenefitPlan": "01",
    "contractNumber": "031554",
    "policyNumber": "256489782",
    "copayment": 0,
    "moderatorFee": 0,
    "sharedPaymentsInVoluntaryPlans": 0,
    "advance": 0
  }
}

8. Errores comunes

Usar un typeOperation distinto de los valores SS-* definidos.

Omitir el objeto healthSector.

Enviar paymentMethod con la descripción en texto en lugar del código.

Enviar coverageOrBenefitPlan con la descripción en texto en lugar del código.

Enviar las fechas de servicio en un formato diferente al que espera tu API.

1. Tipos de documento (code)#

2. Tipos de operación (typeOperation) para sector salud#

3. Atributo adicional obligatorio: healthSector#

4. Modalidad de pago (paymentMethod)#

5. Cobertura o plan de beneficios (coverageOrBenefitPlan)#

6. Regla práctica#

7. Ejemplo JSON completo#

8. Errores comunes#