Servicios públicos domiciliarios

Para emitir un documento expedido para los servicios públicos domiciliarios se parte de la estructura base del documento equivalente, con los ajustes que se describen a continuación.

SoftwareSeguridad (`SeguridadSoftwareType`)

Datos para que el sistema valide la identificación y autorización del sistema que se está integrando.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`TipoDocumento`	Tipo de documento enviado	Sí	`SPD` - Documento de servicios públicos domiciliarios

EncabezadoData (`EncabezadoType`)

Datos generales del documento.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`FacTipoFactura`	Código del tipo de documento que se está emitiendo.	Sí	`60` - Documento Expedido para los servicios publicos
`FacCodOperacion`	Código del tipo de operación.	Sí	- Facturación normal: `601` - Facturación en sitio: `602`

SPDFactura (`SPDFacturaType`)

Información propia del documento de servicios públicos domiciliarios.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`NroReferenciaPago`	Corresponde a la referencia de pago del servicio publico	Sí
`FechaLimitePago`	Corresponde a la fecha limite o vencimiento del pago del servicio publico	Sí	Formato: `aaaa-mm-dd`. Ejemplo: `2019-08-01`
`ExtensionServicio`	Corresponde a los datos del servicio publico domiciliario (Lista)	Sí	Ver SPDExtensionServicioType
`ExtensionOtraEmpresa`	Corresponde a los datos del servicio publico domiciliario de recaudo de un tercero (Lista)	Sí	Ver SPDExtensionServicioType

Extensión del servicio

ExtensionServicio y ExtensionOtraEmpresa usan la misma estructura (SPDExtensionServicioType); ExtensionOtraEmpresa aplica al recaudo de un tercero.

ExtensionServicio y ExtensionOtraEmpresa (`SPDExtensionServicioType`)

Información de los prestadores de servicios publicos

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`NombreServicio`	Nombre del servicio prestado	Sí
`EmpresaEmite`	Nombre de la empresa que emite la factura SPD	Sí
`EmpresaRecauda`	Nombre de la empresa que recauda	Sí
`Servicio_SPD`	Estructura de datos con la información del servicio prestado (Lista)	Sí	Ver SPDServicioType

Servicio_SPD (`SPDServicioType`)

En este grupo se detalla la información del servicio publico que no se muestra a nivel de item

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`ContratoSPD`	Numero de contrato del SPD	Sí
`FechaContrato`	fecha del contrato SPD	Sí
`NotaContrato`	Listado de notas adicionales (Lista)	No	Es un listado de string
`Tercero`	Información del tercero	Sí	Aplica solo para ExtensionOtraEmpresa Ver SPDTerceroType
`Suscriptor`	Información del Suscriptor	Sí	Ver SPDSuscriptorType
`SuscriptorConsumo`	Información del consumo (Lista)	Sí	Ver SPDConsumoType

Tercero (`SPDTerceroType`)

Información de la caja de venta

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`tipoIdentificacionTercero`	Tipo de identificacion del tercero	Sí	Ver lista
`identificacionTercero`	Numero de identificacion del tercero	Sí
`dvIdentificacionTercero`	Digito de verificacion del tercero	Condicional	`tipoIdentificacionTercero`: 31
`nombreTercero`	Nombre del tercero	Sí

Suscriptor (`SPDSuscriptorType`)

Grupo para informar los datos del suscriptor y/o usuario del servicio prestado por parte de un tercero.

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`NombreSuscriptor`	Nombre del Suscriptor	Sí
`DireccionSuscriptor`	Direccion del Suscriptor	Sí
`DirAdicionalSuscriptor`	Direccion adicional del suscriptor	Sí
`CiudadSuscriptor`	Nombre de la Ciudad de residencia del Suscriptor	Sí
`DepartamentoSuscriptor`	Nombre del departamento de residencia del suscriptor	Sí
`EstratoSuscriptor`	Estrato del Suscriptor	Sí	Ver lista
`EmailSuscriptor`	Correo electrónico del suscriptor	Sí

SuscriptorConsumo (`SPDConsumoType`)

Grupo para informar valores del servicio que no sean expresados a nivel de línea de producto

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`CicloConsumo`	Campo para informar el ciclo o cantidad del servicio facturado.	Sí
`UndTiempoCicloConsumo`	Corresponde al ciclo de facturación de cada empresa de servicios públicos. Ejemplo: Mes, Trimestral, Anual.	Sí	Ver lista
`NotaConsumo`	Listado de notas adicionales (Lista)	No	Es un listado de string
`Servicio`	Grupo para informar el servicio facturado (Lista)	Sí

Servicio (`SPDMedidasConsumoType`)

Grupo para informar el servicio facturado de las empresas de servicios públicos

Ocurrencia: 1-1 (Obligatorio)

Campo	Descripción	Obligatorio	Observaciones
`TotalConsumo`	Cantidad medida total	Sí
`UndConsumo`	Unidad de medida de la medida total	Sí
`ValorTotalConsumo`	Valor total del servicio consumido, incluyendo debitos (subsidios y/o beneficios) y creditos (recargos bajo cualquier concepto)	Sí
`CantidadConsumo`	Cantidad de unidades del consumo	Sí
`UndCantConsumo`	Unidad de medida de la cantidad de consumo	Sí
`VlrParcialConsumo`	Valor parcial del consumo, sin aplicar debitos y creditos.	Sí
`DescuentosCargosConsumo`	Listado de descuentos y/o recargos aplicados (Lista)	Sí	Ver SPDDescuentosCargosType
`VlrUnitario`	Valor por unidad del producto o servicio	Sí
`CantidadReal`	Cantidad real sobre la cual se aplica el precio	Sí
`UnidadReal`	Unidad de medida de la cantidad real	Sí
`Medidor`	Grupo para informar la lectura del contador (Lista)	Sí	Ver SPDMedidorType
`HistoricoConsumo`	Grupo de elemento para Información del histórico del consumo del servicio en lo Ultimos meses	Sí	Ver SPDHistoricoConsumoType
`Residuos`	Grupo de elementos para informar residuos del periodo facturado. (Lista)	Sí	Ver SPDResiduosType
`AcuerdosPago`	Grupo para informar acuerdos de pago (Lista)	Sí	Ver SPDRAcuerdosPagoType