Ir al contenido

Factura de hospitales y clínicas (documento sector 17) en la v3: campos del XML y ejemplo de montos

Estructura de la cabecera y del detalle observada en la certificación, campos propios del sector y cálculo de un ejemplo
13 de noviembre de 2026 por
Factura de hospitales y clínicas (documento sector 17) en la v3: campos del XML y ejemplo de montos
impuestos.wiki

Qué es este documento sector

En la certificación compartida en un grupo de soporte, la factura del sector hospitales y clínicas se envía con codigoDocumentoSector 17 y con una estructura XML propia, cuyo elemento raíz es facturaElectronicaHospitalClinica y cuyo esquema es facturaElectronicaHospitalClinica.xsd. Por eso no sirven los campos de una factura de compra y venta. Antes de probar, conviene descargar el XSD vigente del sector desde la documentación del SIAT.

Campos de la cabecera observados

  • codigoCliente y codigoMetodoPago: el código del cliente lo asigna el sistema del contribuyente. El método de pago usa la paramétrica (por ejemplo, 1 para efectivo). El valor 5 (Otros) se usa solo si el método no está disponible en la paramétrica.
  • modalidadServicio: descripción del servicio prestado (en el caso, «Post Operatorio»).
  • numeroTarjeta, montoGiftCard, descuentoAdicional, codigoExcepcion: se envían como vacíos (xsi:nil) cuando no aplican.

Campos propios del detalle

CampoUso observado
especialidad y especialidadDetalleEspecialidad médica y descripción del procedimiento
nroQuirofanoSalaOperacionesNúmero de quirófano o sala de operaciones
especialidadMedico, nombreApellidoMedicoDatos del médico que realizó el servicio
nitDocumentoMedico, nroMatriculaMedico, nroFacturaMedicoIdentificación del médico y su factura, cuando corresponda

Los campos generales del detalle (actividadEconomica, codigoProductoSin, codigoProducto, cantidad, unidadMedida, precioNetoUnitario, montoDescuento, subTotal) se llenan como en otros sectores. Recuerde que actividadEconomica y codigoProductoSin deben cumplir las validaciones de actividad y producto (ver el artículo sobre los errores 1016, 940 y 1017).

Ejemplo de montos

En el caso compartido, una prestación tuvo estos valores:

  1. Cantidad 1 y precio neto unitario 80,00 Bs; subtotal neto 80,00 Bs.
  2. IVA = 13 % × 80,00 = 10,40 Bs.
  3. Monto a pagar = 80,00 + 10,40 = 90,40 Bs.

El cuadre entre subtotal, IVA y monto a pagar debe verificarse con las fórmulas del sector antes de enviar.

Qué revisar antes de certificar

  • Que el XML use el nombre de raíz y el XSD del sector 17.
  • Que los campos vacíos se envíen con xsi:nil cuando no aplican, en lugar de omitirlos.
  • Que el servicio web usado sea el del sector hospitales y no el de otro documento sector.

Nota: la estructura describe lo observado en un caso de certificación compartido en el grupo. No se verificó contra el XSD oficial en esta wiki.

Documentos y capturas del caso

numeroDocumento Alfanumérico Sí Número que corresponde al Tipo de Documento utilizado y al cual se realizará la facturación.
numeroDocumento Alfanumérico Sí Número que corresponde al Tipo de Documento utilizado y al cual se realizará la facturación.

Fuentes y normativa

Este artículo resume experiencia práctica de soporte; no se encontró una norma específica que lo respalde en nuestra lista de fuentes verificadas. Verifica siempre con la normativa vigente del Servicio de Impuestos Nacionales (SIN).

Errores 1016, 940 y 1017 al certificar un sector en la v3 del SIAT: actividad, producto y documento sector
Qué significa cada código, por qué aparecen juntos en la certificación de un sector y cómo revisar cada punto antes de reclamar al SIN