Factura sector salud

Dos cosas distintas (no las mezcles)

Capacidad	Qué es	Dónde
Factura sector salud	Misma FE (`/invoice`) + bloque `health_fields` (usuarios, coberturas, MIPRES…)	Esta página
RIPS / SISPRO	Módulo `/api/rips/*` para armar y enviar RIPS	RIPS y SISPRO

Muchas IPS usan ambas: facturan a la EPS con health_fields y además generan RIPS.

Endpoint

Igual que una factura normal:

POST /api/ubl2.1/invoice
POST /api/ubl2.1/invoice/{testSetId}
Authorization: Bearer <token_empresa>
Content-Type: application/json

La diferencia es el objeto opcional health_fields.

Ejemplo completo: invoice-health.example.json
Postman: carpeta 09 → SendInvoice-TestSetId Health.

Estructura `health_fields`

"health_fields": {
  "invoice_period_start_date": "2026-06-01",
  "invoice_period_end_date": "2026-06-30",
  "health_type_operation_id": 1,
  "print_users_info_to_pdf": true,
  "users_info": [
    {
      "provider_code": "AF-0000500-85-XX-001",
      "health_type_document_identification_id": 1,
      "identification_number": "A89008003",
      "surname": "OBANDO",
      "second_surname": "LONDONO",
      "first_name": "ALEXANDER",
      "middle_name": "ANDRES",
      "health_type_user_id": 1,
      "health_contracting_payment_method_id": 2,
      "health_coverage_id": 5,
      "autorization_numbers": "A12345;604567",
      "mipres": "RNA3D345;664FF04567",
      "mipres_delivery": "RN6645G-345;…",
      "contract_number": "1000-2021-0005698",
      "policy_number": "1045-2FG01-0567228",
      "co_payment": "3300.00",
      "moderating_fee": "5800.00",
      "recovery_fee": "105000.00",
      "shared_payment": "225000.00"
    }
  ]
}

Cabecera salud

Campo	Uso
`invoice_period_start_date` / `end_date`	Periodo de facturación del servicio
`health_type_operation_id`	Tipo de operación salud (catálogo)
`print_users_info_to_pdf`	Imprime usuarios en la representación gráfica
`users_info[]`	Uno o más usuarios / afiliados

Por usuario (`users_info`)

Campo	Uso
`provider_code`	Código del prestador
`health_type_document_identification_id`	Tipo doc. del usuario
`identification_number`	Documento
`surname`, `second_surname`, `first_name`, `middle_name`	Nombres
`health_type_user_id`	Tipo de usuario
`health_contracting_payment_method_id`	Modalidad de contratación
`health_coverage_id`	Cobertura
`autorization_numbers`	Autorizaciones (`;` separados)
`mipres` / `mipres_delivery`	Códigos MIPRES
`contract_number` / `policy_number`	Contrato / póliza
`co_payment`, `moderating_fee`, `recovery_fee`, `shared_payment`	Valores de recaudo

El resto del JSON (customer, lines, taxes, totals) es el de una factura estándar.

Catálogos (IDs)

GET /api/table/health_type_document_identifications
GET /api/table/health_type_users
GET /api/table/health_contracting_payment_methods
GET /api/table/health_coverages

También vía GET /api/ubl2.1/listing (modelos HealthTypeOperation, HealthTypeUser, etc.).

Ver Catálogos.

NC / ND con salud

Las notas crédito/débito pueden llevar información de salud en líneas / PDF según plantilla. Empieza con la FE salud correcta y luego NC/ND referenciando el CUFE.

Checklist IPS

Empresa + certificado + resolución FE
Catálogos health_* cargados
Emitir con health_fields (esta guía)
Si aplica RIPS → módulo RIPS
Consultar estado / PDF

WhatsApp sector salud