tfhkacolwiki - Contribuciones del usuario [es]

Manual DLL hkafact21 - Emisión V4

2022-04-21T18:04:43Z

Lvargas:

<includeonly>=</includeonly>== Objetivo ==<includeonly>=</includeonly>
 
El presente manual tiene como propósito dar a conocer los detalles de los cambios a nivel del consumo de la librería HKAFACT21 para validación previa respecto a la versión del modelo de facturación de validación posterior (HKAFACT).

<includeonly>=</includeonly>== Alcance ==<includeonly>=</includeonly>
 
<DIV ALIGN=justify>El presente documento abarca desde la instalación de la API hasta las funciones utilizables para el consumo del Servicio Web de Integración para el modelo de facturación de validación previa. La librería hkafact21 es compatible con cualquier desarrollo cuya base sea plataformas WIN32</DIV>

'''Nota:''' En el mismo se describen cada uno de los strings que constituyen el objeto factura. Para obtener mayor información sobre la obligatoriedad de los campos (requeridos/opcionales) ver '''MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)'''

<includeonly>=</includeonly>== Definiciones y Términos ==<includeonly>=</includeonly>
 
*'''C++:''' lenguaje de programación diseñado para extender al lenguaje de programación C con mecanismos que permiten la manipulación de objetos. En ese sentido, desde el punto de vista de los lenguajes orientados a objetos, el C++ es un lenguaje híbrido, con la particularidad de poder redefinir los operadores, y de crear nuevos tipos que se comporten como tipos fundamentales.
*'''DLL:''' Biblioteca de enlace dinámico o más comúnmente DLL (sigla en inglés de dynamic-link library) es el término con el que se refiere a los archivos con código ejecutable que se cargan bajo demanda de un programa por parte del sistema operativo.
*'''SDK:''' Un kit de desarrollo de software es un conjunto de herramientas de desarrollo de software que le permite al programador o desarrollador de software crear una aplicación informática para un sistema concreto.
*'''Servicio Web de Integración:''' Servicio Web de The Factory HKA Colombia SAS puesto a disposición a propietarios de software administrativos o de gestión para la generación de factura electrónica.

<includeonly>=</includeonly>== Procedimiento ==<includeonly>=</includeonly>
 
<DIV ALIGN=justify>Instalación: En el SDK descargado, se encontrará con tres herramientas; la librería de integración (hkafact21.dll), el presente manual y un demo funcional de código. Antes de comenzar a hacer uso de la librería en el desarrollo, lo primero que se debe hacer es registrar y referenciar la librería en nuestro proyecto. Esto se consigue siguiendo los siguientes pasos: </DIV>
#Creamos una nueva carpeta.
# Descomprimimos el contenido del SDK en la capeta previamente creada.
# Copiamos la librería hkafact21.dll.
# Pegamos la librería en la carpeta System32 de Windows.
# Finalmente, declaramos las distintas funciones a utilizar de la librería.
 
'''@IMPORTANTE:'''
 
#En el caso de que al final de la cadena (Identificador), el campo se encuentre vacío se debe agregar un pipe “|” al final.
#Si el identificador no es obligatorio, este pueden enviarse con el identificador seguido de un pipe (Ejemplo: ID02A = "02A|").
#Si los identificadores son repetibles puede concatenarse con el separador “% “seguido del identificador con los campos correspondientes a la cadena que desea repetir.
 
<includeonly>=</includeonly>== MÉTODO ENVIAR==<includeonly>=</includeonly>
 
Función que permite generar el documento electrónico.
 
=== Declaración ===
<center>
<pre> INT Enviar (string URL, string tokenEmpresa, string tokenPassword, string DatosCliente, string FacturaGlobal, string AnticAutCargDesc, string CpDr, string EntMerc, string ImpuestosFactura, string MpOcTe, string TcTcaIa, string Extras, string DetalleDeFactura, string Adjuntos, string SectorSalud, bool debugMode)</pre></center>

=== String URL ===
*URL del servicio de emisión.

=== String tokenEmpresa ===
*Token asignado por la plataforma de TFHKA.

=== String tokenPassword ===
*Token asignado por la plataforma de TFHKA.

=== String datosCliente ===
*Datos que componen la información del adquiriente.

===== Cliente_DatosGenerales =====
(20 Campos, 19 pipes “|”):
<center>
<pre>ID01=01|nombreRazonSocial|tipoPersona|segundoNombre|apellido|numeroDocumento|tipoIdentificacion
|email|telefono|notificar|actividadEconomicaCIIU|nombreComercial|nombreContacto
|nota|numeroIdentificacionDV
|telefax|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Cliente_Destinatario ====
(11 Campos, 9 pipes “|”):
<center>
<pre>ID01B=01A|CanalDeEntrega|email|fechaProgramada|mensajePersonalizado|nitProveedorReceptor
|telefono|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Cliente_DetallesTributarios ====
(6 Campos, 5 pipes “|”):
<center>
<pre>ID01B=01B|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Cliente_InformacionLegal ====
(8 Campos, 7 pipes “|”):
<center>
<pre>ID01E=01E|codigoEstablecimiento|nombreRegistroRUT|numeroIdentificacion|numeroIdentificacionDV|
numeroMatriculaMercantil|prefijoFacturacion|tipoIdentificacion
</pre>
</center>
 

==== Cliente_ResponsabilidadesRut ====
(7 Campos, 6 pipes “|”):
<center>
<pre>ID01F=01F|obligaciones|regimen|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
|prefijoFacturacion|tipoIdentificacion
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DireccionCliente ====
(30 Campos, 29 pipes “|”):
<center>
<pre>ID01C=01C|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento|
correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion|lenguaje
|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso|region|subDivision|ubicación
|zonaPostal|Extensible1.controlInterno1|Extensible1.controlInterno2|
Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DireccionFiscalCliente ====
(30 Campos, 29 pipes “|”):
<center>
<pre>ID01D=01D|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento
|correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion|lenguaje
|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso|region|subDivision|ubicación
|zonaPostal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''datos_Cliente=''' ID01 %ID01A%ID01B%ID01E%ID01F%%ID01C %%ID01D</center>

'''Observaciones:'''
* Los identificadores 01A, 01B, 01F son repetibles
 

=== String FacturaGlobalL ===
Datos generales del objeto factura.

==== FacturaGlobal ====
(23 Campos, 22 pipes “|”):
<center>
<pre>datos_factura=02|tipoDocumento|consecutivoDocumento|rangoNumeracion|fechaEmision|fechaVencimiento|moneda
|propina|totalDescuentos|totalSinImpuestos|totalMonto|cantidadDecimales|fechaFinPeriodoFacturacion
|fechaInicioPeriodoFacturacion|fechaPagoImpuestos|redondeoAplicado|tipoOperacion|
totalAnticipos|totalBaseImponible|totalBrutoConImpuesto|totalCargosAplicados
|totalProductos|tipoSector
</pre>
</center>
 

=== String AnticAutCargDesc ===
Anticipos, autorizaciones, Cargos y descuentos aplicados en el comprobante.

==== Anticipos ====
(11 Campos, 10 pipes “|”):
<center>
<pre>ID02A=02A|fechaDeRecibido|fechadePago|horaDePago|id|instrucciones|montoPagado|
Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Autorizado ====
(15 Campos, 14 pipes “|”):
<center>
<pre>ID02B=02B|email|nombreComercial|nombreContacto|nota|numeroDocumento|numeroDocumentoDV
|razonSocial|telefax|telefono|tipoIdentificacion|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== cargosDescuentos ====
(12 Campos, 11 pipes “|”):
<center>
<pre>ID02C=02C|codigo|descripcion|indicador|monto|montoBase|porcentaje|secuencia|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''AnticAutCargDesc =''' ID02A %%ID02B %%ID02C%%</center>

'''Observaciones:'''
* Los identificadores 02A, 02B son repetibles
 

=== String CpDr ===
Condiciones de pago y documentos referenciados para el comprobante.

==== CondicionPago ====
(20 Campos, 19 pipes “|”):
<center>
<pre>ID02D=02D|codigoEvento|comentario|duracionPeriodo|duracionPeriodoMedida|fechaVencimiento|identificador
|medioPagoAsociado|monto|montoMulta|montoPenalidad|periodoDesde|periodoHasta|porcentajeDescuento
|porcentajePago|referenciaAnticipo|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DocumentosReferenciados ====
(18 Campos, 17 pipes “|”): Puedo no enviarse 02E1
<center>
<pre>ID02E=02E|codigoEstatusDocumento|codigoInterno|cufeDocReferenciado|fecha|fechaFinValidez|fechaInicioValidez
|numeroDocumento|tipoCUFE|tipoDocumento|tipoDocumentoCodigo|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor|conceptoRecaudo|
monto|numeroIdentificacion ¬02E1|descripción
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''CpDr =''' ID02D%%ID02E </center>

'''Observaciones:'''
* Los identificadores 02D, 02E son repetibles
 

=== String EntMerc (Este indientificador no es obligatorio) ===
Datos referentes a la entrega de la mercancía.Anticipos, autorizaciones, Cargos y descuentos aplicados en el comprobante.

==== entregaMercancia ====
<center>
<pre>ID02F=02F|fechaEfectivaSalida|fechaEstimada|fechaReal|fechaSolicitada|identificacionTransporte|
matriculaTransporte|Extensible1.controlInterno1|Extensible1.controlInterno2|
Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== datosTransportista ====
<center>
<pre>ID02F1=02F1|email|indicadordeAtencion|indicadordeCuidado|nombreContacto|nombreResponsableEntrega
|nota|numeroIdentificacion|numeroIdentificacionDV|numeroMatriculaMercantil|prefijoFacturacion
|telefax|telefono|tipoIdentificacion|transportadorNombre|transportadorNumeroDocumento
|transportadorNumeroDocumentoDV|transportadorTipoIdentificacion|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== detallesTributariosTransportista ====
<center>
<pre>ID02F1A=02F1A|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre
|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== direccionTransportista ====
<center>
<pre>ID02F1B=02F1B|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento
|correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion
|lenguaje|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso|region
|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== responsabilidadRUT ====
<center>
<pre>ID02F1C=02F1C|obligaciones|regimen|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== transportadorDireccion ====
<center>
<pre>ID02F1D=02F1D|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad
|codigoDepartamento|correccionHusoHorario|departamento|departamentoOrg
|direccion|distrito|habitacion|lenguaje|municipio|nombreEdificio|numeroEdificio
|numeroParcela|pais|piso|region|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== direccionDespacho ====
<center>
<pre>ID02F2=02F2|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad
|codigoDepartamento|correccionHusoHorario|departamento|departamentoOrg
|direccion|distrito|habitacion|lenguaje|municipio|nombreEdificio|numeroEdificio
|numeroParcela|pais|piso|region|subDivision|ubicación|zonaPostal|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== direccionEntrega ====
<center>
<pre>ID02F3=02F3aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento
|correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion
|lenguaje|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso
|region|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
Si se envía:
'''EntMerc =''' ID02F%%ID02F1%%
 
 
Si no se desea envía:
'''EntMerc =''' ""
 
 
'''Observaciones:'''
*Los identificadores ID02F1A, 02F1B1, 02F1C, 02F1D1, 02F2A, 02F3A son repetibles
 

=== String ImpuestosFactura ===
Esta cadena contiene la información referente a los impuestos aplicados en el documento.
 

==== ImpuestosGenerales ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID02G=02G|baseImponibleTOTALImp|codigoTOTALImp|controlInterno|porcentajeTOTALImp
|unidadMedida|unidadMedidaTributo|valorTOTALImp|valorTributoUnidad|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== ImpuestosTotales ====
(8 Campos, 7 pipes “|”):
<center>
<pre>ID02H=02H|codigoTOTALImp|montoTotal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor|redondeoAplicado
</pre>
 
<center>'''ImpuestosFactura =''' ID02G%%ID02H</center>
</center>
'''Nota:''' En caso de enviar el campo redondeoAplicado vacío se tomará por defecto 0.00

'''Nota:''' Si el campo redondeoAplicado se encuentra vacío debe enviar un pipe (|) al final de la cadena.
 
Obsercaciones:
*Los identificadores ID02G, ID02H son repetibles
 
=== String MpOcTe ===
Esta cadena contiene la información referente a Medios de pagos, Orden de compra y términos de entrega.
 

==== MediosPago ====
(15 Campos, 14 pipes “|”):
<center>
<pre>ID02J=02J|codigoBanco|codigoCanalPago|codigoReferencia|fechaDeVencimiento|medioPago|metodoDePago
|nombreBanco|numeroDeReferencia|numeroDias|numeroTransferencia|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== MediosPago ====
(15 Campos, 14 pipes “|”):
<center>
<pre>ID02J=02J|codigoBanco|codigoCanalPago|codigoReferencia|fechaDeVencimiento|medioPago|metodoDePago
|nombreBanco|numeroDeReferencia|numeroDias|numeroTransferencia|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Orden_Compra ====
(12 Campos, 11 pipes “|”):
<center>
<pre>ID02K=02K|codigoCliente|fecha|numeroOrden|numeroPedido|tipoCUFE|tipoOrden
|uuid|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Terminos_Entrega ====
(10 Campos, 9 pipes “|”):
<center>
<pre>ID02N=02N|codigoCondicionEntrega|costoTransporte|identificacion|monto
|responsableEntrega|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''MpOcTe =''' ID02J%%ID02K%%ID02N</center>
 
'''Observaciones:'''
*Los identificadores ID02J, ID02K son repetibles
 

=== String TcTcaIa ===
Esta cadena contiene la información referente a la tasa de cambio, tasa de cambio alternativa e información adicional.
 

==== TasaCambio ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID02L=02L|baseMonedaDestino|baseMonedaOrigen|fechaDeTasaDeCambio|indicadorDeTasa
|monedaDestino|monedaOrigen|operadorCalculo|tasaDeCambio|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== TasaCambioAlternativa ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID02M=02M|baseMonedaDestino|baseMonedaOrigen|fechaDeTasaDeCambio|indicadorDeTasa
|monedaDestino|monedaOrigen|operadorCalculo|tasaDeCambio|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== InformacionAdicional ====
(2 Campos, 1 pipes “|”):
<center>
<pre>ID02I=02I|Texto
</pre>
</center>
 
<center>'''TcTcaIa=''' ID02L%%ID02M%%ID02I</center>
 
'''Observaciones:'''
*Los identificadores ID02I son repetibles
 

=== String DetalleDeFactura ===
Esta cadena contiene la información referente a los items
 

==== DetalleDeFactura ====
(43 Campos, 42 pipes “|”):
<center>
<pre>ID03=03|cantidaPorEmpaque|CantidadReal|CantidadRealUnidadMedida|cantidadUnidades
|codigoFabricante|codigoIdentificacionPais|codigoProducto|codigoTipoPrecio|descripcion
|descripcionTecnica|estandarCodigo|estandarCodigoID|estandarCodigoIdentificador|estandarCodigoProducto
|estandarOrganizacion|estandarSubcodigoProducto|mandatorioNumeroIdentificacion|mandatorioNumeroIdentificacionDV
|mandatorioTipoIdentificacion|marca|modelo|muestraGratis|NombreFabricante|nota|precioReferencia
|precioTotal|precioTotalSinImpuestos|PrecioVentaUnitario|secuencia|seriales|subCodigoFabricante
|subcodigoProducto|tipoAIU|unidadMedida|informacionAdicional|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor|descripcion2|descripcion3| idEsquema
</pre>
</center>
'''Nota:''' Si envía vacío el campo idEsquema se debe enviar un pipe (|) al final de la cadena
 

==== DF_CargosDescuentos ====
(12 Campos, 11 pipes “|”):
<center>
<pre>ID03A=03A|codigo|descripcion|indicador|monto|montoBase|porcentaje|secuencia
|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DF_ImpDet ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID03C=03C|baseImponibleTOTALImp|codigoTOTALImp|controlInterno|porcentajeTOTALImp
|unidadMedida|unidadMedidaTributo|valorTOTALImp|valorTributoUnidad|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DF_ImpTot ====
(8 Campos, 7 pipes “|”):
<center>
<pre>ID03D=03D|codigoTOTALImp|montoTotal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor|redondeoAplicado
</pre>
</center>
'''Nota:''' En caso de enviar el campo redondeoAplicado vacio se tomara por defecto 0.00

'''Nota:''' Si el campo redondeoAplicado se encuentra vacío debe enviar un pipe (|) al final de la cadena 
 
 
'''Observaciones:'''
*Separación entre campos del ítem: $$
 

==== DF_InformacionAdicional ====
(7 Campos, 6 pipes “|”):
<center>
<pre>ID03E=03E|nombre|valor|código|cantidad|secuencia|unidadMedidaTransporte
</pre>
</center>
 
'''Nota:'''Si el campo unidadMedidaTransporte se encuentra vacío debe enviar un pipe (|) al final de la cadena

'''Observaciones:'''
*Separación entre ítems: ¬(Ejemplo: item1¬item2)

<center>'''DetalleDeFactura ='''ID03$$ID03A$$ID03C$$ID03D$$ID03E (Si se envía descuento) </center>
 
<center>'''DetalleDeFactura ='''ID03$$ID03C$$ID03D$$ID03E $$ID03E (Si NO se envía descuento) </center>
 
<center>'''DetalleDeFactura ='''ID03$$ID03C$$ID03D (Si NO se envía descuento ni información Adicional) </center>
 

=== String Extras ===
Esta cadena contiene los campos extras que se deseen agregar al objeto factura.
 
<center>'''Extras = '''04ID03A|controlInterno1|controlInterno2|nombre|pdf|valor|xml</center>
'''Observaciones:'''
*El string Extras es repetible.
 

=== String SectorSalud ===
Esta cadena contiene la información referente al sector salud:
 

==== sectorSalud ====
(4 Campos, 3 pipes “|”):
<center>
<pre>ID06=06|TipoIdentificacion|IdPersonalizacion|TipoEscenario
</pre>
</center>
 

==== DireccionResidencia ====
(30 Campos, 29 pipes “|”):
<center>
<pre>ID06A=06A|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad
|codigoDepartamento|correccionHusoHorario|departamento|departamentoOrg|direccion
|distrito|habitacion|lenguaje|municipio|nombreEdificio|numeroEdificio|numeroParcela
|pais|piso|region|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
 

==== CamposGenerales ====
(3 Campos, 2 pipes “|”):

Esta cadena contiene la información referente a los Pacientes.
<center>
<pre>ID06B=06B|Nombre|Valor
</pre>
</center>
 
'''Nota:'''Los camposGenerales se encuentran numerados según el orden establecido en la resolución.
*El string CamposGenerales es repetible.
<center>'''Separación entre Pacientes:''' “¬” (Ejemplo: Paciente1¬Paciente2)
</center>
 

==== Sextras ====
(7 Campos, 6 pipes “|”):
<center>
<pre>ID06C=06C|controlInterno1|controlInterno2|nombre|pdf|valor|xml
</pre>
</center>
*El string Extras es repetible.
<center>'''SectorSalud= ''' ID06 +“%” + ID06A + “%%” + ID06B + “%%”+ ID06C
</center>
 

=== String Adjunto ===
Caracter que establece si el documento que se emite contendrá o no adjuntos. Valores posibles:
 
* “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA.
* “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA.
* “10” No se admiten adjuntos. Se genera solo XML sin representación Gráfica estándar por The Factory HKA.
* “11” Admite archivos adjuntos. Se genera solo XML sin representación gráfica estándar por The Factory HKA.

=== String debugMode ===
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta de método Enviar ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult.txt con la siguiente estructura:

:01|codigo|consecutivoDocumento|cufe|fechaRespuesta|hash|mensaje|resultado|tipoCufe|1|nombre|fechaAceptacionDIAN

:01A|mensajeValidacion

:01B|reglasValidacionDIAN
 
'''Nota:'''El string del QR se escribe en un archivo de texto llamado string_QR.txt

'''Nota:'''La dll también dispone del método EnviarCustom, similar al anterior con la diferencia de que este método permite generar el archivo plano de resultado con un nombre diferente y en un directorio distinto al local mediante el parámetro NombreArchivo. Para más detalles ver código ejemplo suministrado en el SDK.
 
 
<includeonly>=</includeonly>== Método EnviarArchivo ==<includeonly>=</includeonly>
 
Función que permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método Enviar con el parámetro adjuntos en “1” o en “11”.
 

<big>''' Declaración '''</big>
<center>
<pre> INT EnviarArchivo (string URLAdj, string tokenEmpresa, string tokenPassword, string ndocumento, string enviar, string formato, string nombre, string tipo, string email, string ruta, bool debugMode).</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String ndocumento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento al cual se adjuntará el archivo).
 

<big>''' String enviar '''</big>
 
Parámetro que indica la finalización de la carga de adjuntos. Posee dos valores:
* “0” Adjunta el archivo y lo asocia al documento electrónico sin enviar el email al Adquiriente.
* “1” Adjunta el archivo y lo asocia al documento electrónico y envía el email al Adquiriente.

<big>'''String formato '''</big>
 
Extension del archivo adjunto, formatos permitidos: png, bmp, jpg, pdf, doc, docx, xsl, xlsx, ppt, pptx.
 

<big>'''String nombre '''</big>
 
Nombre que tomará el archive adjunto.
 

<big>'''String tipo '''</big>
 
“1” Declaramos en la Clase Adjunto (Class.Adjunto) en Tipo "1" cuando queremos generar la representación gráfica obtenida por el ERP. 
“2” Declaramos en la Clase Adjunto (Class.Adjunto) en Tipo "2" Cuando se van a enviar otros documentos adicionales a la factura, es decir, que estos documentos van a quedar en una cola sin que se haga ningún tipo de envío sin antes indicárselo a la plataforma. Para esto, el parámetro <enviar> se debe declarar en cero '0', para indicarle a nuestra plataforma que sincronice el adjunto pero sin enviarlo. Finalmente cuando se declare el último adjunto se debe declarar el parámetro <enviar> en "1", así nuestra plataforma entiende que es el último adjunto, por tanto envía este último documento más los anteriores que se encontraban en la cola.

 

<big>'''String email'''</big>
 
Correo al cual se dese enviar el XML (AttachedDocument), la Representación Gráfica y los anexos o adjuntos.
 

<big>''' String ruta '''</big>
 
Cadena de caracteres con la ubicación del archivo que será enviado a través del servicio.
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

'''@IMPORTANTE:'''

Al emitir un documento electrónico con el parámetro Adjunto en “1” u “11” el email no se enviará al adquiriente hasta no consumir el método '''EnviarArchivo.'''
 

=== Respuesta de método EnviarArchivo===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult.txt con la siguiente estructura:

:01|codigo| mensaje|resultado
 
<includeonly>=</includeonly>== Método EstadoDocumento ==<includeonly>=</includeonly>
 
Función que permite consultar el estado de un documento emitido previamente.
 

<big>''' Declaración '''</big>
<center>
<pre> INT EstadoDocumento (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String ndocumento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento al cual se adjuntará el archivo).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método EstadoDocumento===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult.txt con la siguiente estructura:

:01|codigo|estatusDocumento|ambiente|cadenaCufe|consecutivo|cufe|descripcionDocumento|descripcionEstatusDocumento|entregaMetodoDIAN
:|esValidoDIAN|estatusDocumento|fechaDocumento|mensaje|mensajeDocumento|poseeAdjuntos|poseeRepresentacionGrafica|resultado
:|tipoCufe|tipoDocumento|trackID|fechaAceptacionDIAN

:01A|ambienteDIAN|codigo|comentario|cufe|descripcionEvento|emisorNumeroDocumento|emisorNumeroDocumentoDV|emisorRazonSocial
:|emisorTipoIdentificacion|fechaEmision|fechaRecepcion|hash|idPerfilDIAN|mensaje|nombreArchivoXML|nota|numeroDelEvento
:|receptorNumeroDocumento|receptorNumeroDocumentoDV|receptorRazonSocial|receptorTipoIdentificacion|resultado|tipoCufe|
:tipoEvento|versionUBL|xml

:01A1|codigoInterno1|codigoInterno2|nombre|valor

:01B|canalDeEntrega|email|entregaEstatus|entregaEstatusDescripcion|entregaFecha|fechaProgramada|mensajePersonalizado
:|nitProveedorReceptor|recepcionEmailComentario|recepcionEmailEstatus|recepcionEmailFecha|recepcionEmailIPAddress|telefono

:01C|reglasValidacionDIAN

 
'''Nota:'''El string del QR se escribe en un archivo de texto llamado string_QR.txt

'''Nota:'''La dll también dispone del método EstadoDocumentoCustom, similar al anterior con la diferencia de que este método permite generar el archivo plano de resultado con un nombre diferente y en un directorio distinto al local mediante el parámetro NombreArchivo. Para más detalles ver código ejemplo suministrado en el SDK.
 
 
<includeonly>=</includeonly>== Método FoliosRestantes ==<includeonly>=</includeonly>
 
Función que permite consultar la cantidad de folios disponibles
 

<big>''' Declaración '''</big>
<center>
<pre> INT FoliosRestantes (string URL, string tokenEmpresa, string tokenPassword, string otro, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<bi>''' String otro '''</big>
 
Actualmente en desuso, campo reservado para futuras versiones.
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método FoliosRestantes:===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

:código|foliosRestantes|mensaje|resultados.
 
 
<includeonly>=</includeonly>== Método EnvioCorreoAdjuntos ==<includeonly>=</includeonly>
 
Función que permite reenviar el correo de notificación que se emite cuando se genera un documento electrónico con adjuntos
 

<big>''' Declaración '''</big>
<center>
<pre> INT EnvioCorreoAdjuntos (string URL, string tokenEmpresa, string tokenPassword, string documento,
string correo, string adjunto, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere reenviar).
 

<big>''' String correo'''</big>
 
Correo al cual se dese enviar el XML (AttachedDocument) y la Representación Gráfica Estándar si aplica.
 

<big>''' String adjunto'''</big>
 
Carácter que establece si el documento será reenviado con adjuntos. Valores posibles:
* “0” Realiza el reenvió del correo sin adjuntos
* “1” Realiza el reenvió del correo con los adjuntos almacenados durante la emisión del documento.

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método EnvioCorreoAdjuntos===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

:código|mensaje|resultados.
 
'''Nota:''La dll también dispone del método EnvioCorreo, similar al anterior con la diferencia de que este no contiene el parámetro adjunto.
 
 
<includeonly>=</includeonly>== Método DescargarXML ==<includeonly>=</includeonly>
 
Función que permite descargar el XML Fiscal de un documento emitido previamente (solo el documento electrónico Invoice, CreditNote y DebitNote). El archivo XML es creado en el directorio local de la aplicación.
 

<big>''' Declaración '''</big>
<center>
<pre> INT DescargarXML (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode))</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere consultar).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método DescargarXML ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

código|mensaje|resultados.
 
 
<includeonly>=</includeonly>== Método DescargarPDF ==<includeonly>=</includeonly>
 
Función que permite descargar la Representación Gráfica Estándar de un documento emitido previamente. El archivo PDF es creado en el directorio local de la aplicación.
 

<big>''' Declaración '''</big>
<center>
<pre>INT DescargarPDF (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere consultar).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método DescargarPDF ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

código|mensaje|resultados.
 

'''@IMPORTANTE:'''

Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
 
 
<includeonly>=</includeonly>== Método GenerarContenedor ==<includeonly>=</includeonly>
 
Función que permite descargar el XML AttachedDocument de un documento emitido previamente (Este archivo contiene el XML de un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha). El archivo XML es creado en el directorio local de la aplicación.
 

<big>''' Declaración '''</big>
<center>
<pre>INT GenerarContenedor (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere consultar).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método GenerarContenedor ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

código|mensaje|Fecha|Hash|resultados.
 
 
<includeonly>=</includeonly>== Ejemplo Strings Método Enviar ==<includeonly>=</includeonly>
 
<center>
<pre>
* Url= http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc '
* TokenEmp='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
* TokenPas='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
</pre>
</center>
 
<big>'''GESTION DE STRINGS PARA PARAMETRO: datos_Cliente'''</big>
 
 
* ID01="01|Cristche|1|Evardho|ParedesMarquina|746260|31|email@gmail.com|3185853106|SI|0812|CHEV DEV|Cristche Paredes|cliente importante|0|123123123|||||"
* ID01A = "01A|0|email1@thefactoryhka.com;email2@gmail.com|2019-07-31 13:01:01|Mensaje programadito||1235467|||||"
* ID01B = "01B|01|||||"
* ID01E = "01E|1|Cristche Paredes|746260|0|456456|FE1|31"
* ID01F = "01F|O-13|04|||||"
* ID01C = "01C|Fulano|Sutano|1|POXBOX01|Principal|Los Chaimas|Bogotá, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los :Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID01D = "01D|Fulano|Sutano|1|POXBOX01|Principal|Los Chaimas|Bogotá, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los :Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
:datos_Cliente = ID01 + "%" + ID01A + "%" + ID01B + "%" + ID01E + "%" + ID01F + "%%" + ID01C + "%%" + ID01D
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: datos_factura'''</big>
 
 
* datos_factura= " 02|01|CONSECUTIVO|RANGO-CAMPODESDE|2019-11-29 00:00:00|2019-10-29|COP|0.00|0.00|5980.00|7116.20|2||||0.00|10|0.00|5980.00|7116.20|0.00|1|"
* **datos_factura ="02|01|CONSECUTIVO|RANGO-CAMPODESDE|2019-11-29 00:00:00|2019-10-29|COP|0.00|0.00|5980.00|7116.20|2||||0.00|10|0.00|5980.00|7116.20|0.00|1|2" (Con el campo tipoSector)
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: anticAutorizado_CargDesc''''</big>
 
 
* ID02A = "02A|2019-07-21|2019-07-21|12:12:12|1|instruccion|||||" (No es obligatorio)
* ID02A = "02A|"
* ID02B = "02B|" (No es obligatorio para nada)
* ID02B = "02B|"
* ID02C = "02C|11|descripcion del descuento|0|100.00|1980.00|5.00|1|||||" (No es obligatorio)
* ID02C = "02C|"
* anticAutorizado_CargDesc = ID02A + "%%" + ID02B + "%%" + ID02C
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: CP_DR''''</big>
 
 
* ID02D = "02D||nota en codicion de pago|10|1|2019-07-31|1|1|100.00|50.00|150.00|2019-07-21|2019-07-31|10.00|90.00|111222333" (No es obligatorio)
* ID02D = "02D|"
* ID02E="02E|6|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|2019-07-29|2019-07-29|PRUE21|CUFE-SHA384|Factura de Ventas|01|||||| || ¬02E1|descipcion documento referenciado" (Condicionado)
* ID02E="02E|5|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|2019-07-29|2019-07-29|PRUE21|CUFE-SHA384|Factura de Ventas|01|||||Copago|100.00|900895784 (con los campos conceptoRecaudo,monto,numeroIdentificacion)
* ID02E = "02E|"
* CP_DR = ID02D + "%%" + ID02E
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: EntMerc'''</big>
 
 
* ID02F = "02F|2019-06-27 11:32:30|2019-06-29 11:32:30|2019-07-01 11:32:30|2019-07-01 11:32:30|1|ABCD123|||||"
* ID02F1 = "02F1|mail@gmail.com|1|1|Fulanito Gonzales|Pedrito Perez|Mercancia delicada|800123456|2|QWERT|PRUE|123456789|3451269|31|Juan Lopez|40012365|1|13|||||"
* ID02F1A = "02F1A|01|||||"
* ID02F1B = "02F1B|ResponsableEntrega|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID02F1C = "02F1C|O-12|04|||||"
* ID02F1D = "02F1D|TransportadorDireccion|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID02F2 = "02F2|direccionDespacho|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID02F3 = "02F3|direccionEntrega|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||%02F3A|4|74|41|4|N|O|"
* EntMerc = ID02F + "%%" + ID02F1 + "%%" + ID02F1A + "%%" + ID02F1B + "%%" + ID02F1C + "%%" + ID02F1D + "%%" + ID02F2 + "%%" + ID02F3
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: ImpuestosFactura'''</big>
 
 
* ID02G = "02G|1980|01||19.00|KGM|94|376.20|0.00|||||"
* ID02H ="02H|01|1136.20|||||0.00"
* **ID02H ="02H|01|1136.20||||||" (sin el campo redondeoAplicado)
* ImpuestosFactura = ID02G + "%%" + ID02H
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: MPOCTE'''</big>
 
 
* ID02J = "02J|3356|0312|123QBCV|2019-01-01|10|1|Bancolombia|Referencia de pago 1|22|982467|||||"
* ID02K = "02K|987654|2019-04-29 00:00:00|1233456|321456|CUFE-SHA384|1|85b5cfa4-16af-48a0-9388-501e519ed659|||||" (No es obligatorio)
* ID02K = "02K|"
* ID02N = "02N|CFR|100.00|200311301|100.00|cliente|||||" (Condicionado)
* ID02N = "02N|"
* MPOCTE = ID02J + "%%" + ID02K + "%%" + ID02N
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: TC_TCA_IA'''</big>
 
 
* ID02L = "02L|0000001.00|0000001.00|2019-01-01|123456|USD|COP|Division|000000.50|||||" (Condicionado)
* ID02L = "02L|"
* 'ID02M = "02M|0000001.00|0000001.00|2019-01-01|123456|USD|COP|Division|000000.50|||||" (No es obligatorio)
* ID02M = "02M|"
* 'ID02I = "02I|Informacion Adicional de Pruebita" (No es obligatorio)
* ID02I = "02I|"
* TC_TCA_IA = ID02L + "%%" + ID02M + "%%" + ID02I
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: Extras'''</big>
 
 
* Extras = "04|||443|1|pedro picapiedra|1"
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: DetalleDeFactura'''</big>
 
 
* ID03 = "03|1|1|94|1|||ABC123||Productico de prueba 1|primer producto para enviar al web service|999|||123||||||||0||nota en el producto01||2356.20|1980.00|1980.00|1|||||94||||||descripcion2|descripcion3||" (sin el campo idEsquema)
* ID03 = "03|1|1|94|1|||ABC123||Productico de prueba 1|primer producto para enviar al web service|999|||123||||||||0||nota en el producto01||2356.20|1980.00|1980.00|1|||||94||||||descripcion2|descripcion3|1" (con el campo idEsquema)
* 'ID03A = "03A|00|descuento comercial 123456789|0|0.00|0.00|0.00|1|||||"(Descuento en el detalle)
* ID03C = "03C|1980.00|01||19.00|KGM|94|376.20||||||"
* ID03D = "03D|01|376.20|||||0.00"
* ID03E = "03E|03|24350| |2500000|1|WSD "
* 'DetalleDeFactura = ID03 + "$$" + ID03A + "$$" + ID03C + "$$" + ID03D + "$$" + ID03E (con Descuento Detalle)
* DetalleDeFactura = ID03 + "$$" + ID03C + "$$" + ID03D + "$$" + ID03E
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: SectorSalud'''</big>
 
 
* ID06= "06|01|SS-CUFE|02"
* ID06A= "06A|Fulano|Sutano|1|POXBOX01|Principal|Los Chaimas|Bogotá, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
 

<big><center>**Los camposGenerales se encuentran numerados según el orden establecido en la resolución.</center></big>
 
<pre>ID06B = "06B|1|CODIGO_PRESTADOR"+ "%" + "06B|2|TIPO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|3|NUMERO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|4|PRIMER_APELLIDO"+ “%” + "06B|5|SEGUNDO_APELLIDO"+ "%" + "06B|6|PRIMER_NOMBRE" + "%" + "06B|7|SEGUNDO_NOMBRE" + "%" + "06B|8|TIPO_USUARIO" + "%" + "06B|9|MODALIDAD_CONTRATACION" + "%" + "06B|10|COBERTURA_PLAN_BENEFICIOS" + "%" + "06B|11|NUMERO_AUTORIZACION" + "%" + "06B|12|NUMERO_MIPRES" + "%" + "06B|13|NUMERO_ENTREGA_MIPRES" + "%" + "06B|14|NUMERO_CONTRATO" + "%" + "06B|15|NUMERO_POLIZA" + "%" + "06B|16|COPAGO" + "%" + "06B|17|CUOTA_MODERADORA" + "%" + "06B|18|CUOTA_RECUPERACION" + "%" + "06B|19|PAGOS_COMPARTIDOS"</pre>
 

<big><center>*** Varios pacientes:</center></big>
 
<pre>ID06B1 = "06B|1|CODIGO_PRESTADOR"+ "%" + "06B|2|TIPO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|3|NUMERO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|4|PRIMER_APELLIDO"+ “%” + "06B|5|SEGUNDO_APELLIDO"+ "%" + "06B|6|PRIMER_NOMBRE" + "%" + "06B|7|SEGUNDO_NOMBRE" + "%" + "06B|8|TIPO_USUARIO" + "%" + "06B|9|MODALIDAD_CONTRATACION" + "%" + "06B|10|COBERTURA_PLAN_BENEFICIOS" + "%" + "06B|11|NUMERO_AUTORIZACION" + "%" + "06B|12|NUMERO_MIPRES" + "%" + "06B|13|NUMERO_ENTREGA_MIPRES" + "%" + "06B|14|NUMERO_CONTRATO" + "%" + "06B|15|NUMERO_POLIZA" + "%" + "06B|16|COPAGO" + "%" + "06B|17|CUOTA_MODERADORA" + "%" + "06B|18|CUOTA_RECUPERACION" + "%" + "06B|19|PAGOS_COMPARTIDOS"</pre>
 
<pre>ID06B2 = "06B|1|CODIGO_PRESTADOR"+ "%" + "06B|2|TIPO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|3|NUMERO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|4|PRIMER_APELLIDO"+ “%” + "06B|5|SEGUNDO_APELLIDO"+ "%" + "06B|6|PRIMER_NOMBRE" + "%" + "06B|7|SEGUNDO_NOMBRE" + "%" + "06B|8|TIPO_USUARIO" + "%" + "06B|9|MODALIDAD_CONTRATACION" + "%" + "06B|10|COBERTURA_PLAN_BENEFICIOS" + "%" + "06B|11|NUMERO_AUTORIZACION" + "%" + "06B|12|NUMERO_MIPRES" + "%" + "06B|13|NUMERO_ENTREGA_MIPRES" + "%" + "06B|14|NUMERO_CONTRATO" + "%" + "06B|15|NUMERO_POLIZA" + "%" + "06B|16|COPAGO" + "%" + "06B|17|CUOTA_MODERADORA" + "%" + "06B|18|CUOTA_RECUPERACION" + "%" + "06B|19|PAGOS_COMPARTIDOS"</pre>
 

<big><center>Pacientes= ID06B1 + "¬" + ID06B2</center></big>
 
<pre>ID06C = "06C|||5170000|1|100.50|1"
SectorSalud= ID06 + "%" + ID06A + "%%" + ID06B + "%%" + ID06C
SectorSalud= ID06 + "%" + ID06A + "%%" + + "%%" + ID06C (Varios Pacientes)</pre>
 
Adjuntos= "0"
 
'''Enviar (url, tokenEmp, tokenPas, datos_Cliente, Factura_Global, Antic_Autorizado_CargDesc, CondPago_DocReferencia, Entrega_Mercancia, Impuestos_Factura, MedPago_OC_TermEntrega, TasaCamb_TasaCambAlt_InfAdic, Extras, Detalle_De_Factura, Adjuntos, SectorSalud, debugMode)'''
 
 
<includeonly>=</includeonly>== Ejemplo Strings Método EnviarArchivo==<includeonly>=</includeonly>
 
<center>
<pre>
* Url= 'http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc'
* TokenEmp='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
* TokenPas='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
</pre>
</center>
* Ndocumento = “PRUE1”
* Enviar = “1”
* Formato =”pdf”
* Nombre = “Adjunto”
* Tipo = “2”
* Email = “integracion_fel_co@thefactoryhka.com”
* Ruta = “C:\Adjunto.PDF”
 

<includeonly>=</includeonly>== Personalización del Correo ==<includeonly>=</includeonly>
 
El arreglo “extras” también permite manejar algunas funcionalidades especiales de la plataforma, como la de correo electrónico personalizado mediante el uso de los campos extensibles 11, 13 y 14. Para obtener más detalles, referirse al '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#Correo_electr.C3.B3nico_personalizado MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)]''' sección ''PERSONALIZACIÓN DEL CORREO''
 
 
<includeonly>=</includeonly>== Generación De Notas Con Y Sin Referencia a Documentos ==<includeonly>=</includeonly>
 
En el anexo técnico V1.8 se plantea la emisión de notas de crédito y débito bajo los siguientes escenarios:
 

* Emisión de notas de Val. previa con referencia a facturas de Val. Previa
* Emisión de notas de Val. previa con referencia a facturas de Val. Posterior
* Emisión de notas de Val. previa sin referencia

Para ello se debe tener en cuenta la estructura de la clase documentosReferenciados y el campo tipoOperación para cada escenarios. Para obtener más detalles, referirse al '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#GENERACI.C3.93N_DE_NOTAS_CON_Y_SIN_REFERENCIA_A_DOCUMENTO MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)]]''' sección ''GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTOS'' donde se ejemplifica cada uno de estos casos.
 
 
<includeonly>=</includeonly>== Transmisión De Documentos De Contingencia Tipo 03 ==<includeonly>=</includeonly>
 
La transmisión de documentos de contingencia está sujeta a la estructura de la clase documentosReferenciados y el campo tipoDocumento. Este escenario junto con las condiciones en las cuales aplica y la respuesta obtenida por parte de la DIAN se especifican en el '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#TRANSMISI.C3.93N_DE_DOCUMENTOS_DE_CONTINGENCIA_TIPO_03_.28ATRIBUIBLE_AL_EMISOR.29 MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)]''' sección ''TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)''.
 
 
<includeonly>=</includeonly>== Radicar Documentos Electrónicos En Plataformas De Recepción ==<includeonly>=</includeonly>
 
El XML que se debe radicar en las plataformas de recepción es el que envía nuestro servicio en la notificación de correo llamado '''AttachedDocument''' (Contenedor de Documentos), la estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha, este XML también puede ser descargado a través del método '''GenerarContenedor'''.
 
La estructura de este archivo se ejemplifica en en el '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#Radicar_documentos_electr.C3.B3nicos_en_plataformas_de_recepci.C3.B3n MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL PREVIA)]''' sección ''RADICAR DOCUMENTOS ELECTRÓNICOS EN PLATAFORMAS DE RECEPCIÓN''
 
 
<includeonly>=</includeonly>== Ambiente De Habilitación ==<includeonly>=</includeonly>
 
El ambiente de pruebas liberado (ambiente demo) corresponde a un entorno de pruebas propio del proveedor tecnológico ('''The Factory HKA''') con el objetivo de que los desarrolladores y Casas de Software puedan realizar pruebas de los ajustes realizados a los ERP bajo el modelo de facturación con validación previa. Las pruebas realizadas en este ambiente NO serán enviadas al web service de habilitación de la DIAN.

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Manual DLL hkafact21 - Emisión V4

2022-04-21T15:23:13Z

Lvargas:

<includeonly>=</includeonly>== Objetivo ==<includeonly>=</includeonly>
 
El presente manual tiene como propósito dar a conocer los detalles de los cambios a nivel del consumo de la librería HKAFACT21 para validación previa respecto a la versión del modelo de facturación de validación posterior (HKAFACT).

<includeonly>=</includeonly>== Alcance ==<includeonly>=</includeonly>
 
<DIV ALIGN=justify>El presente documento abarca desde la instalación de la API hasta las funciones utilizables para el consumo del Servicio Web de Integración para el modelo de facturación de validación previa. La librería hkafact21 es compatible con cualquier desarrollo cuya base sea plataformas WIN32</DIV>

'''Nota:''' En el mismo se describen cada uno de los strings que constituyen el objeto factura. Para obtener mayor información sobre la obligatoriedad de los campos (requeridos/opcionales) ver '''MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)'''

<includeonly>=</includeonly>== Definiciones y Términos ==<includeonly>=</includeonly>
 
*'''C++:''' lenguaje de programación diseñado para extender al lenguaje de programación C con mecanismos que permiten la manipulación de objetos. En ese sentido, desde el punto de vista de los lenguajes orientados a objetos, el C++ es un lenguaje híbrido, con la particularidad de poder redefinir los operadores, y de crear nuevos tipos que se comporten como tipos fundamentales.
*'''DLL:''' Biblioteca de enlace dinámico o más comúnmente DLL (sigla en inglés de dynamic-link library) es el término con el que se refiere a los archivos con código ejecutable que se cargan bajo demanda de un programa por parte del sistema operativo.
*'''SDK:''' Un kit de desarrollo de software es un conjunto de herramientas de desarrollo de software que le permite al programador o desarrollador de software crear una aplicación informática para un sistema concreto.
*'''Servicio Web de Integración:''' Servicio Web de The Factory HKA Colombia SAS puesto a disposición a propietarios de software administrativos o de gestión para la generación de factura electrónica.

<includeonly>=</includeonly>== Procedimiento ==<includeonly>=</includeonly>
 
<DIV ALIGN=justify>Instalación: En el SDK descargado, se encontrará con tres herramientas; la librería de integración (hkafact21.dll), el presente manual y un demo funcional de código. Antes de comenzar a hacer uso de la librería en el desarrollo, lo primero que se debe hacer es registrar y referenciar la librería en nuestro proyecto. Esto se consigue siguiendo los siguientes pasos: </DIV>
#Creamos una nueva carpeta.
# Descomprimimos el contenido del SDK en la capeta previamente creada.
# Copiamos la librería hkafact21.dll.
# Pegamos la librería en la carpeta System32 de Windows.
# Finalmente, declaramos las distintas funciones a utilizar de la librería.
 
'''@IMPORTANTE:'''
 
#En el caso de que al final de la cadena (Identificador), el campo se encuentre vacío se debe agregar un pipe “|” al final.
#Si el identificador no es obligatorio, este pueden enviarse con el identificador seguido de un pipe (Ejemplo: ID02A = "02A|").
#Si los identificadores son repetibles puede concatenarse con el separador “% “seguido del identificador con los campos correspondientes a la cadena que desea repetir.
 
<includeonly>=</includeonly>== MÉTODO ENVIAR==<includeonly>=</includeonly>
 
Función que permite generar el documento electrónico.
 
=== Declaración ===
<center>
<pre> INT Enviar (string URL, string tokenEmpresa, string tokenPassword, string DatosCliente, string FacturaGlobal, string AnticAutCargDesc, string CpDr, string EntMerc, string ImpuestosFactura, string MpOcTe, string TcTcaIa, string Extras, string DetalleDeFactura, string Adjuntos, string SectorSalud, bool debugMode)</pre></center>

=== String URL ===
*URL del servicio de emisión.

=== String tokenEmpresa ===
*Token asignado por la plataforma de TFHKA.

=== String tokenPassword ===
*Token asignado por la plataforma de TFHKA.

=== String datosCliente ===
*Datos que componen la información del adquiriente.

===== Cliente_DatosGenerales =====
(20 Campos, 19 pipes “|”):
<center>
<pre>ID01=01|nombreRazonSocial|tipoPersona|segundoNombre|apellido|numeroDocumento|tipoIdentificacion
|email|telefono|notificar|actividadEconomicaCIIU|nombreComercial|nombreContacto
|nota|numeroIdentificacionDV
|telefax|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Cliente_Destinatario ====
(11 Campos, 9 pipes “|”):
<center>
<pre>ID01B=01A|CanalDeEntrega|email|fechaProgramada|mensajePersonalizado|nitProveedorReceptor
|telefono|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Cliente_DetallesTributarios ====
(6 Campos, 5 pipes “|”):
<center>
<pre>ID01B=01B|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Cliente_InformacionLegal ====
(8 Campos, 7 pipes “|”):
<center>
<pre>ID01E=01E|codigoEstablecimiento|nombreRegistroRUT|numeroIdentificacion|numeroIdentificacionDV|
numeroMatriculaMercantil|prefijoFacturacion|tipoIdentificacion
</pre>
</center>
 

==== Cliente_ResponsabilidadesRut ====
(7 Campos, 6 pipes “|”):
<center>
<pre>ID01F=01F|obligaciones|regimen|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
|prefijoFacturacion|tipoIdentificacion
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DireccionCliente ====
(30 Campos, 29 pipes “|”):
<center>
<pre>ID01C=01C|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento|
correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion|lenguaje
|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso|region|subDivision|ubicación
|zonaPostal|Extensible1.controlInterno1|Extensible1.controlInterno2|
Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DireccionFiscalCliente ====
(30 Campos, 29 pipes “|”):
<center>
<pre>ID01D=01D|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento
|correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion|lenguaje
|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso|region|subDivision|ubicación
|zonaPostal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''datos_Cliente=''' ID01 %ID01A%ID01B%ID01E%ID01F%%ID01C %%ID01D</center>

'''Observaciones:'''
* Los identificadores 01A, 01B, 01F son repetibles
 

=== String FacturaGlobalL ===
Datos generales del objeto factura.

==== FacturaGlobal ====
(23 Campos, 22 pipes “|”):
<center>
<pre>datos_factura=02|tipoDocumento|consecutivoDocumento|rangoNumeracion|fechaEmision|fechaVencimiento|moneda
|propina|totalDescuentos|totalSinImpuestos|totalMonto|cantidadDecimales|fechaFinPeriodoFacturacion
|fechaInicioPeriodoFacturacion|fechaPagoImpuestos|redondeoAplicado|tipoOperacion|
totalAnticipos|totalBaseImponible|totalBrutoConImpuesto|totalCargosAplicados
|totalProductos|tipoSector
</pre>
</center>
 

=== String AnticAutCargDesc ===
Anticipos, autorizaciones, Cargos y descuentos aplicados en el comprobante.

==== Anticipos ====
(11 Campos, 10 pipes “|”):
<center>
<pre>ID02A=02A|fechaDeRecibido|fechadePago|horaDePago|id|instrucciones|montoPagado|
Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Autorizado ====
(15 Campos, 14 pipes “|”):
<center>
<pre>ID02B=02B|email|nombreComercial|nombreContacto|nota|numeroDocumento|numeroDocumentoDV
|razonSocial|telefax|telefono|tipoIdentificacion|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== cargosDescuentos ====
(12 Campos, 11 pipes “|”):
<center>
<pre>ID02C=02C|codigo|descripcion|indicador|monto|montoBase|porcentaje|secuencia|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''AnticAutCargDesc =''' ID02A %%ID02B %%ID02C%%</center>

'''Observaciones:'''
* Los identificadores 02A, 02B son repetibles
 

=== String CpDr ===
Condiciones de pago y documentos referenciados para el comprobante.

==== CondicionPago ====
(20 Campos, 19 pipes “|”):
<center>
<pre>ID02D=02D|codigoEvento|comentario|duracionPeriodo|duracionPeriodoMedida|fechaVencimiento|identificador
|medioPagoAsociado|monto|montoMulta|montoPenalidad|periodoDesde|periodoHasta|porcentajeDescuento
|porcentajePago|referenciaAnticipo|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DocumentosReferenciados ====
(18 Campos, 17 pipes “|”): Puedo no enviarse 02E1
<center>
<pre>ID02E=02E|codigoEstatusDocumento|codigoInterno|cufeDocReferenciado|fecha|fechaFinValidez|fechaInicioValidez
|numeroDocumento|tipoCUFE|tipoDocumento|tipoDocumentoCodigo|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor|conceptoRecaudo|
monto|numeroIdentificacion ¬02E1|descripción
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''CpDr =''' ID02D%%ID02E </center>

'''Observaciones:'''
* Los identificadores 02D, 02E son repetibles
 

=== String EntMerc (Este indientificador no es obligatorio) ===
Datos referentes a la entrega de la mercancía.Anticipos, autorizaciones, Cargos y descuentos aplicados en el comprobante.

==== entregaMercancia ====
<center>
<pre>ID02F=02F|fechaEfectivaSalida|fechaEstimada|fechaReal|fechaSolicitada|identificacionTransporte|
matriculaTransporte|Extensible1.controlInterno1|Extensible1.controlInterno2|
Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== datosTransportista ====
<center>
<pre>ID02F1=02F1|email|indicadordeAtencion|indicadordeCuidado|nombreContacto|nombreResponsableEntrega
|nota|numeroIdentificacion|numeroIdentificacionDV|numeroMatriculaMercantil|prefijoFacturacion
|telefax|telefono|tipoIdentificacion|transportadorNombre|transportadorNumeroDocumento
|transportadorNumeroDocumentoDV|transportadorTipoIdentificacion|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== detallesTributariosTransportista ====
<center>
<pre>ID02F1A=02F1A|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre
|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== direccionTransportista ====
<center>
<pre>ID02F1B=02F1B|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento
|correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion
|lenguaje|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso|region
|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== responsabilidadRUT ====
<center>
<pre>ID02F1C=02F1C|obligaciones|regimen|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== transportadorDireccion ====
<center>
<pre>ID02F1D=02F1D|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad
|codigoDepartamento|correccionHusoHorario|departamento|departamentoOrg
|direccion|distrito|habitacion|lenguaje|municipio|nombreEdificio|numeroEdificio
|numeroParcela|pais|piso|region|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== direccionDespacho ====
<center>
<pre>ID02F2=02F2|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad
|codigoDepartamento|correccionHusoHorario|departamento|departamentoOrg
|direccion|distrito|habitacion|lenguaje|municipio|nombreEdificio|numeroEdificio
|numeroParcela|pais|piso|region|subDivision|ubicación|zonaPostal|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== direccionEntrega ====
<center>
<pre>ID02F3=02F3aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad|codigoDepartamento
|correccionHusoHorario|departamento|departamentoOrg|direccion|distrito|habitacion
|lenguaje|municipio|nombreEdificio|numeroEdificio|numeroParcela|pais|piso
|region|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
Si se envía:
'''EntMerc =''' ID02F%%ID02F1%%
 
 
Si no se desea envía:
'''EntMerc =''' ""
 
 
'''Observaciones:'''
*Los identificadores ID02F1A, 02F1B1, 02F1C, 02F1D1, 02F2A, 02F3A son repetibles
 

=== String ImpuestosFactura ===
Esta cadena contiene la información referente a los impuestos aplicados en el documento.
 

==== ImpuestosGenerales ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID02G=02G|baseImponibleTOTALImp|codigoTOTALImp|controlInterno|porcentajeTOTALImp
|unidadMedida|unidadMedidaTributo|valorTOTALImp|valorTributoUnidad|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== ImpuestosTotales ====
(8 Campos, 7 pipes “|”):
<center>
<pre>ID02H=02H|codigoTOTALImp|montoTotal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor|redondeoAplicado
</pre>
 
<center>'''ImpuestosFactura =''' ID02G%%ID02H</center>
</center>
'''Nota:''' En caso de enviar el campo redondeoAplicado vacío se tomará por defecto 0.00

'''Nota:''' Si el campo redondeoAplicado se encuentra vacío debe enviar un pipe (|) al final de la cadena.
 
Obsercaciones:
*Los identificadores ID02G, ID02H son repetibles
 
=== String MpOcTe ===
Esta cadena contiene la información referente a Medios de pagos, Orden de compra y términos de entrega.
 

==== MediosPago ====
(15 Campos, 14 pipes “|”):
<center>
<pre>ID02J=02J|codigoBanco|codigoCanalPago|codigoReferencia|fechaDeVencimiento|medioPago|metodoDePago
|nombreBanco|numeroDeReferencia|numeroDias|numeroTransferencia|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== MediosPago ====
(15 Campos, 14 pipes “|”):
<center>
<pre>ID02J=02J|codigoBanco|codigoCanalPago|codigoReferencia|fechaDeVencimiento|medioPago|metodoDePago
|nombreBanco|numeroDeReferencia|numeroDias|numeroTransferencia|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Orden_Compra ====
(12 Campos, 11 pipes “|”):
<center>
<pre>ID02K=02K|codigoCliente|fecha|numeroOrden|numeroPedido|tipoCUFE|tipoOrden
|uuid|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== Terminos_Entrega ====
(10 Campos, 9 pipes “|”):
<center>
<pre>ID02N=02N|codigoCondicionEntrega|costoTransporte|identificacion|monto
|responsableEntrega|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 
<center>'''MpOcTe =''' ID02J%%ID02K%%ID02N</center>
 
'''Observaciones:'''
*Los identificadores ID02J, ID02K son repetibles
 

=== String TcTcaIa ===
Esta cadena contiene la información referente a la tasa de cambio, tasa de cambio alternativa e información adicional.
 

==== TasaCambio ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID02L=02L|baseMonedaDestino|baseMonedaOrigen|fechaDeTasaDeCambio|indicadorDeTasa
|monedaDestino|monedaOrigen|operadorCalculo|tasaDeCambio|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== TasaCambioAlternativa ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID02M=02M|baseMonedaDestino|baseMonedaOrigen|fechaDeTasaDeCambio|indicadorDeTasa
|monedaDestino|monedaOrigen|operadorCalculo|tasaDeCambio|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== InformacionAdicional ====
(2 Campos, 1 pipes “|”):
<center>
<pre>ID02I=02I|Texto
</pre>
</center>
 
<center>'''TcTcaIa=''' ID02L%%ID02M%%ID02I</center>
 
'''Observaciones:'''
*Los identificadores ID02I son repetibles
 

=== String DetalleDeFactura ===
Esta cadena contiene la información referente a los items
 

==== DetalleDeFactura ====
(43 Campos, 42 pipes “|”):
<center>
<pre>ID03=03|cantidaPorEmpaque|CantidadReal|CantidadRealUnidadMedida|cantidadUnidades
|codigoFabricante|codigoIdentificacionPais|codigoProducto|codigoTipoPrecio|descripcion
|descripcionTecnica|estandarCodigo|estandarCodigoID|estandarCodigoIdentificador|estandarCodigoProducto
|estandarOrganizacion|estandarSubcodigoProducto|mandatorioNumeroIdentificacion|mandatorioNumeroIdentificacionDV
|mandatorioTipoIdentificacion|marca|modelo|muestraGratis|NombreFabricante|nota|precioReferencia
|precioTotal|precioTotalSinImpuestos|PrecioVentaUnitario|secuencia|seriales|subCodigoFabricante
|subcodigoProducto|tipoAIU|unidadMedida|informacionAdicional|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor|descripcion2|descripcion3| idEsquema
</pre>
</center>
'''Nota:''' Si envía vacío el campo idEsquema se debe enviar un pipe (|) al final de la cadena
 

==== DF_CargosDescuentos ====
(12 Campos, 11 pipes “|”):
<center>
<pre>ID03A=03A|codigo|descripcion|indicador|monto|montoBase|porcentaje|secuencia
|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DF_ImpDet ====
(13 Campos, 12 pipes “|”):
<center>
<pre>ID03C=03C|baseImponibleTOTALImp|codigoTOTALImp|controlInterno|porcentajeTOTALImp
|unidadMedida|unidadMedidaTributo|valorTOTALImp|valorTributoUnidad|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
'''Nota:''' Si Extensible1.valor se debe enviar un pipe (|) al final de la cadena
 

==== DF_ImpTot ====
(8 Campos, 7 pipes “|”):
<center>
<pre>ID03D=03D|codigoTOTALImp|montoTotal|Extensible1.controlInterno1|Extensible1.controlInterno2
|Extensible1.nombre|Extensible1.valor|redondeoAplicado
</pre>
</center>
'''Nota:''' En caso de enviar el campo redondeoAplicado vacio se tomara por defecto 0.00

'''Nota:''' Si el campo redondeoAplicado se encuentra vacío debe enviar un pipe (|) al final de la cadena 
 
 
'''Observaciones:'''
*Separación entre campos del ítem: $$
 

==== DF_InformacionAdicional ====
(7 Campos, 6 pipes “|”):
<center>
<pre>ID03E=03E|nombre|valor|código|cantidad|secuencia|unidadMedidaTransporte
</pre>
</center>
 
'''Nota:'''Si el campo unidadMedidaTransporte se encuentra vacío debe enviar un pipe (|) al final de la cadena

'''Observaciones:'''
*Separación entre ítems: ¬(Ejemplo: item1¬item2)

<center>'''DetalleDeFactura ='''ID03$$ID03A$$ID03C$$ID03D$$ID03E (Si se envía descuento) </center>
 
<center>'''DetalleDeFactura ='''ID03$$ID03C$$ID03D$$ID03E $$ID03E (Si NO se envía descuento) </center>
 
<center>'''DetalleDeFactura ='''ID03$$ID03C$$ID03D (Si NO se envía descuento ni información Adicional) </center>
 

=== String Extras ===
Esta cadena contiene los campos extras que se deseen agregar al objeto factura.
 
<center>'''Extras = '''04ID03A|controlInterno1|controlInterno2|nombre|pdf|valor|xml</center>
'''Observaciones:'''
*El string Extras es repetible.
 

=== String SectorSalud ===
Esta cadena contiene la información referente al sector salud:
 

==== sectorSalud ====
(4 Campos, 3 pipes “|”):
<center>
<pre>ID06=06|TipoIdentificacion|IdPersonalizacion|TipoEscenario
</pre>
</center>
 

==== DireccionResidencia ====
(30 Campos, 29 pipes “|”):
<center>
<pre>ID06A=06A|aCuidadoDe|aLaAtenciónDe|bloque|buzon|calle|calleAdicional|ciudad
|codigoDepartamento|correccionHusoHorario|departamento|departamentoOrg|direccion
|distrito|habitacion|lenguaje|municipio|nombreEdificio|numeroEdificio|numeroParcela
|pais|piso|region|subDivision|ubicación|zonaPostal|Extensible1.controlInterno1
|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
</pre>
</center>
 

==== CamposGenerales ====
(3 Campos, 2 pipes “|”):

Esta cadena contiene la información referente a los Pacientes.
<center>
<pre>ID06B=06B|Nombre|Valor
</pre>
</center>
 
'''Nota:'''Los camposGenerales se encuentran numerados según el orden establecido en la resolución.
*El string CamposGenerales es repetible.
<center>'''Separación entre Pacientes:''' “¬” (Ejemplo: Paciente1¬Paciente2)
</center>
 

==== Sextras ====
(7 Campos, 6 pipes “|”):
<center>
<pre>ID06C=06C|controlInterno1|controlInterno2|nombre|pdf|valor|xml
</pre>
</center>
*El string Extras es repetible.
<center>'''SectorSalud= ''' ID06 +“%” + ID06A + “%%” + ID06B + “%%”+ ID06C
</center>
 

=== String Adjunto ===
Caracter que establece si el documento que se emite contendrá o no adjuntos. Valores posibles:
 
* “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA.
* “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA.
* “10” No se admiten adjuntos. Se genera solo XML sin representación Gráfica estándar por The Factory HKA.
* “11” Admite archivos adjuntos. Se genera solo XML sin representación gráfica estándar por The Factory HKA.

=== String debugMode ===
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta de método Enviar ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult.txt con la siguiente estructura:

:01|codigo|consecutivoDocumento|cufe|fechaRespuesta|hash|mensaje|resultado|tipoCufe|1|nombre|fechaAceptacionDIAN

:01A|mensajeValidacion

:01B|reglasValidacionDIAN
 
'''Nota:'''El string del QR se escribe en un archivo de texto llamado string_QR.txt

'''Nota:'''La dll también dispone del método EnviarCustom, similar al anterior con la diferencia de que este método permite generar el archivo plano de resultado con un nombre diferente y en un directorio distinto al local mediante el parámetro NombreArchivo. Para más detalles ver código ejemplo suministrado en el SDK.
 
 
<includeonly>=</includeonly>== Método EnviarArchivo ==<includeonly>=</includeonly>
 
Función que permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método Enviar con el parámetro adjuntos en “1” o en “11”.
 

<big>''' Declaración '''</big>
<center>
<pre> INT EnviarArchivo (string URLAdj, string tokenEmpresa, string tokenPassword, string ndocumento, string enviar, string formato, string nombre, string tipo, string email, string ruta, bool debugMode).</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String ndocumento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento al cual se adjuntará el archivo).
 

<big>''' String enviar '''</big>
 
Parámetro que indica la finalización de la carga de adjuntos. Posee dos valores:
* “0” Adjunta el archivo y lo asocia al documento electrónico sin enviar el email al Adquiriente.
* “1” Adjunta el archivo y lo asocia al documento electrónico y envía el email al Adquiriente.

<big>'''String formato '''</big>
 
Extension del archivo adjunto, formatos permitidos: png, bmp, jpg, pdf, doc, docx, xsl, xlsx, ppt, pptx.
 

<big>'''String nombre '''</big>
 
Nombre que tomará el archive adjunto.
 

<big>'''String tipo '''</big>
 
“2” Cuando se va a enviar otros documentos adicionales a la factura, adicional a esto el parámetro <enviar> en "0" esto para indicarle a nuestra plataforma que sincronice el adjunto pero que aún no lo envíe ya que cuando se declara el parámetro <enviar> en "1" que es para indicarle a nuestra plataforma que es el último adjunto.
 

<big>'''String email'''</big>
 
Correo al cual se dese enviar el XML (AttachedDocument), la Representación Gráfica y los anexos o adjuntos.
 

<big>''' String ruta '''</big>
 
Cadena de caracteres con la ubicación del archivo que será enviado a través del servicio.
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

'''@IMPORTANTE:'''

Al emitir un documento electrónico con el parámetro Adjunto en “1” u “11” el email no se enviará al adquiriente hasta no consumir el método '''EnviarArchivo.'''
 

=== Respuesta de método EnviarArchivo===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult.txt con la siguiente estructura:

:01|codigo| mensaje|resultado
 
<includeonly>=</includeonly>== Método EstadoDocumento ==<includeonly>=</includeonly>
 
Función que permite consultar el estado de un documento emitido previamente.
 

<big>''' Declaración '''</big>
<center>
<pre> INT EstadoDocumento (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String ndocumento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento al cual se adjuntará el archivo).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método EstadoDocumento===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult.txt con la siguiente estructura:

:01|codigo|estatusDocumento|ambiente|cadenaCufe|consecutivo|cufe|descripcionDocumento|descripcionEstatusDocumento|entregaMetodoDIAN
:|esValidoDIAN|estatusDocumento|fechaDocumento|mensaje|mensajeDocumento|poseeAdjuntos|poseeRepresentacionGrafica|resultado
:|tipoCufe|tipoDocumento|trackID|fechaAceptacionDIAN

:01A|ambienteDIAN|codigo|comentario|cufe|descripcionEvento|emisorNumeroDocumento|emisorNumeroDocumentoDV|emisorRazonSocial
:|emisorTipoIdentificacion|fechaEmision|fechaRecepcion|hash|idPerfilDIAN|mensaje|nombreArchivoXML|nota|numeroDelEvento
:|receptorNumeroDocumento|receptorNumeroDocumentoDV|receptorRazonSocial|receptorTipoIdentificacion|resultado|tipoCufe|
:tipoEvento|versionUBL|xml

:01A1|codigoInterno1|codigoInterno2|nombre|valor

:01B|canalDeEntrega|email|entregaEstatus|entregaEstatusDescripcion|entregaFecha|fechaProgramada|mensajePersonalizado
:|nitProveedorReceptor|recepcionEmailComentario|recepcionEmailEstatus|recepcionEmailFecha|recepcionEmailIPAddress|telefono

:01C|reglasValidacionDIAN

 
'''Nota:'''El string del QR se escribe en un archivo de texto llamado string_QR.txt

'''Nota:'''La dll también dispone del método EstadoDocumentoCustom, similar al anterior con la diferencia de que este método permite generar el archivo plano de resultado con un nombre diferente y en un directorio distinto al local mediante el parámetro NombreArchivo. Para más detalles ver código ejemplo suministrado en el SDK.
 
 
<includeonly>=</includeonly>== Método FoliosRestantes ==<includeonly>=</includeonly>
 
Función que permite consultar la cantidad de folios disponibles
 

<big>''' Declaración '''</big>
<center>
<pre> INT FoliosRestantes (string URL, string tokenEmpresa, string tokenPassword, string otro, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<bi>''' String otro '''</big>
 
Actualmente en desuso, campo reservado para futuras versiones.
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método FoliosRestantes:===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

:código|foliosRestantes|mensaje|resultados.
 
 
<includeonly>=</includeonly>== Método EnvioCorreoAdjuntos ==<includeonly>=</includeonly>
 
Función que permite reenviar el correo de notificación que se emite cuando se genera un documento electrónico con adjuntos
 

<big>''' Declaración '''</big>
<center>
<pre> INT EnvioCorreoAdjuntos (string URL, string tokenEmpresa, string tokenPassword, string documento,
string correo, string adjunto, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere reenviar).
 

<big>''' String correo'''</big>
 
Correo al cual se dese enviar el XML (AttachedDocument) y la Representación Gráfica Estándar si aplica.
 

<big>''' String adjunto'''</big>
 
Carácter que establece si el documento será reenviado con adjuntos. Valores posibles:
* “0” Realiza el reenvió del correo sin adjuntos
* “1” Realiza el reenvió del correo con los adjuntos almacenados durante la emisión del documento.

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método EnvioCorreoAdjuntos===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

:código|mensaje|resultados.
 
'''Nota:''La dll también dispone del método EnvioCorreo, similar al anterior con la diferencia de que este no contiene el parámetro adjunto.
 
 
<includeonly>=</includeonly>== Método DescargarXML ==<includeonly>=</includeonly>
 
Función que permite descargar el XML Fiscal de un documento emitido previamente (solo el documento electrónico Invoice, CreditNote y DebitNote). El archivo XML es creado en el directorio local de la aplicación.
 

<big>''' Declaración '''</big>
<center>
<pre> INT DescargarXML (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode))</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere consultar).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método DescargarXML ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

código|mensaje|resultados.
 
 
<includeonly>=</includeonly>== Método DescargarPDF ==<includeonly>=</includeonly>
 
Función que permite descargar la Representación Gráfica Estándar de un documento emitido previamente. El archivo PDF es creado en el directorio local de la aplicación.
 

<big>''' Declaración '''</big>
<center>
<pre>INT DescargarPDF (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere consultar).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método DescargarPDF ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

código|mensaje|resultados.
 

'''@IMPORTANTE:'''

Si durante la emisión del documento (método '''Enviar''') el parámetro '''adjuntos''' se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).
 
 
<includeonly>=</includeonly>== Método GenerarContenedor ==<includeonly>=</includeonly>
 
Función que permite descargar el XML AttachedDocument de un documento emitido previamente (Este archivo contiene el XML de un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha). El archivo XML es creado en el directorio local de la aplicación.
 

<big>''' Declaración '''</big>
<center>
<pre>INT GenerarContenedor (string URL, string tokenEmpresa, string tokenPassword, string documento, bool debugMode)</pre></center>

<big>''' String URLAdj'''</big>
 
*URL del servicio de carga de Adjuntos (Sin ?wsdl).
 

<big>''' String tokenEmpresa ''' </big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>'''String tokenPassword'''</big>
 
*Token asignado por la plataforma de TFHKA.
 

<big>''' String documento '''</big>
 
Prefijo y consecutivo del Documento electrónico concatenado sin separadores (Documento que se quiere consultar).
 

<big>'''String debugMode'''</big>
 
Flag para indicar a la dll que registre el log de debug en pruebas.
 

=== Respuesta método GenerarContenedor ===
Las respuestas se darán en un archivo de texto plano con nombre hkafact21fresult con la siguiente estructura:

código|mensaje|Fecha|Hash|resultados.
 
 
<includeonly>=</includeonly>== Ejemplo Strings Método Enviar ==<includeonly>=</includeonly>
 
<center>
<pre>
* Url= http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc '
* TokenEmp='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
* TokenPas='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
</pre>
</center>
 
<big>'''GESTION DE STRINGS PARA PARAMETRO: datos_Cliente'''</big>
 
 
* ID01="01|Cristche|1|Evardho|ParedesMarquina|746260|31|email@gmail.com|3185853106|SI|0812|CHEV DEV|Cristche Paredes|cliente importante|0|123123123|||||"
* ID01A = "01A|0|email1@thefactoryhka.com;email2@gmail.com|2019-07-31 13:01:01|Mensaje programadito||1235467|||||"
* ID01B = "01B|01|||||"
* ID01E = "01E|1|Cristche Paredes|746260|0|456456|FE1|31"
* ID01F = "01F|O-13|04|||||"
* ID01C = "01C|Fulano|Sutano|1|POXBOX01|Principal|Los Chaimas|Bogotá, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los :Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID01D = "01D|Fulano|Sutano|1|POXBOX01|Principal|Los Chaimas|Bogotá, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los :Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
:datos_Cliente = ID01 + "%" + ID01A + "%" + ID01B + "%" + ID01E + "%" + ID01F + "%%" + ID01C + "%%" + ID01D
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: datos_factura'''</big>
 
 
* datos_factura= " 02|01|CONSECUTIVO|RANGO-CAMPODESDE|2019-11-29 00:00:00|2019-10-29|COP|0.00|0.00|5980.00|7116.20|2||||0.00|10|0.00|5980.00|7116.20|0.00|1|"
* **datos_factura ="02|01|CONSECUTIVO|RANGO-CAMPODESDE|2019-11-29 00:00:00|2019-10-29|COP|0.00|0.00|5980.00|7116.20|2||||0.00|10|0.00|5980.00|7116.20|0.00|1|2" (Con el campo tipoSector)
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: anticAutorizado_CargDesc''''</big>
 
 
* ID02A = "02A|2019-07-21|2019-07-21|12:12:12|1|instruccion|||||" (No es obligatorio)
* ID02A = "02A|"
* ID02B = "02B|" (No es obligatorio para nada)
* ID02B = "02B|"
* ID02C = "02C|11|descripcion del descuento|0|100.00|1980.00|5.00|1|||||" (No es obligatorio)
* ID02C = "02C|"
* anticAutorizado_CargDesc = ID02A + "%%" + ID02B + "%%" + ID02C
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: CP_DR''''</big>
 
 
* ID02D = "02D||nota en codicion de pago|10|1|2019-07-31|1|1|100.00|50.00|150.00|2019-07-21|2019-07-31|10.00|90.00|111222333" (No es obligatorio)
* ID02D = "02D|"
* ID02E="02E|6|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|2019-07-29|2019-07-29|PRUE21|CUFE-SHA384|Factura de Ventas|01|||||| || ¬02E1|descipcion documento referenciado" (Condicionado)
* ID02E="02E|5|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|2019-07-29|2019-07-29|PRUE21|CUFE-SHA384|Factura de Ventas|01|||||Copago|100.00|900895784 (con los campos conceptoRecaudo,monto,numeroIdentificacion)
* ID02E = "02E|"
* CP_DR = ID02D + "%%" + ID02E
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: EntMerc'''</big>
 
 
* ID02F = "02F|2019-06-27 11:32:30|2019-06-29 11:32:30|2019-07-01 11:32:30|2019-07-01 11:32:30|1|ABCD123|||||"
* ID02F1 = "02F1|mail@gmail.com|1|1|Fulanito Gonzales|Pedrito Perez|Mercancia delicada|800123456|2|QWERT|PRUE|123456789|3451269|31|Juan Lopez|40012365|1|13|||||"
* ID02F1A = "02F1A|01|||||"
* ID02F1B = "02F1B|ResponsableEntrega|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID02F1C = "02F1C|O-12|04|||||"
* ID02F1D = "02F1D|TransportadorDireccion|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID02F2 = "02F2|direccionDespacho|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
* ID02F3 = "02F3|direccionEntrega|Sutano|1|POXBOX01|Principal|Los Chaimas|BOGOTÁ, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||%02F3A|4|74|41|4|N|O|"
* EntMerc = ID02F + "%%" + ID02F1 + "%%" + ID02F1A + "%%" + ID02F1B + "%%" + ID02F1C + "%%" + ID02F1D + "%%" + ID02F2 + "%%" + ID02F3
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: ImpuestosFactura'''</big>
 
 
* ID02G = "02G|1980|01||19.00|KGM|94|376.20|0.00|||||"
* ID02H ="02H|01|1136.20|||||0.00"
* **ID02H ="02H|01|1136.20||||||" (sin el campo redondeoAplicado)
* ImpuestosFactura = ID02G + "%%" + ID02H
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: MPOCTE'''</big>
 
 
* ID02J = "02J|3356|0312|123QBCV|2019-01-01|10|1|Bancolombia|Referencia de pago 1|22|982467|||||"
* ID02K = "02K|987654|2019-04-29 00:00:00|1233456|321456|CUFE-SHA384|1|85b5cfa4-16af-48a0-9388-501e519ed659|||||" (No es obligatorio)
* ID02K = "02K|"
* ID02N = "02N|CFR|100.00|200311301|100.00|cliente|||||" (Condicionado)
* ID02N = "02N|"
* MPOCTE = ID02J + "%%" + ID02K + "%%" + ID02N
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: TC_TCA_IA'''</big>
 
 
* ID02L = "02L|0000001.00|0000001.00|2019-01-01|123456|USD|COP|Division|000000.50|||||" (Condicionado)
* ID02L = "02L|"
* 'ID02M = "02M|0000001.00|0000001.00|2019-01-01|123456|USD|COP|Division|000000.50|||||" (No es obligatorio)
* ID02M = "02M|"
* 'ID02I = "02I|Informacion Adicional de Pruebita" (No es obligatorio)
* ID02I = "02I|"
* TC_TCA_IA = ID02L + "%%" + ID02M + "%%" + ID02I
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: Extras'''</big>
 
 
* Extras = "04|||443|1|pedro picapiedra|1"
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: DetalleDeFactura'''</big>
 
 
* ID03 = "03|1|1|94|1|||ABC123||Productico de prueba 1|primer producto para enviar al web service|999|||123||||||||0||nota en el producto01||2356.20|1980.00|1980.00|1|||||94||||||descripcion2|descripcion3||" (sin el campo idEsquema)
* ID03 = "03|1|1|94|1|||ABC123||Productico de prueba 1|primer producto para enviar al web service|999|||123||||||||0||nota en el producto01||2356.20|1980.00|1980.00|1|||||94||||||descripcion2|descripcion3|1" (con el campo idEsquema)
* 'ID03A = "03A|00|descuento comercial 123456789|0|0.00|0.00|0.00|1|||||"(Descuento en el detalle)
* ID03C = "03C|1980.00|01||19.00|KGM|94|376.20||||||"
* ID03D = "03D|01|376.20|||||0.00"
* ID03E = "03E|03|24350| |2500000|1|WSD "
* 'DetalleDeFactura = ID03 + "$$" + ID03A + "$$" + ID03C + "$$" + ID03D + "$$" + ID03E (con Descuento Detalle)
* DetalleDeFactura = ID03 + "$$" + ID03C + "$$" + ID03D + "$$" + ID03E
 

<big>'''GESTION DE STRINGS PARA PARAMETRO: SectorSalud'''</big>
 
 
* ID06= "06|01|SS-CUFE|02"
* ID06A= "06A|Fulano|Sutano|1|POXBOX01|Principal|Los Chaimas|Bogotá, D.C.|11|-66.01|Bogotá|Soporte|Kr #71D 76-15|Los Andes|Principal|es|11001|Chaima|16a|78|CO|2|sur|parcela||111061|||||"
 

<big><center>**Los camposGenerales se encuentran numerados según el orden establecido en la resolución.</center></big>
 
<pre>ID06B = "06B|1|CODIGO_PRESTADOR"+ "%" + "06B|2|TIPO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|3|NUMERO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|4|PRIMER_APELLIDO"+ “%” + "06B|5|SEGUNDO_APELLIDO"+ "%" + "06B|6|PRIMER_NOMBRE" + "%" + "06B|7|SEGUNDO_NOMBRE" + "%" + "06B|8|TIPO_USUARIO" + "%" + "06B|9|MODALIDAD_CONTRATACION" + "%" + "06B|10|COBERTURA_PLAN_BENEFICIOS" + "%" + "06B|11|NUMERO_AUTORIZACION" + "%" + "06B|12|NUMERO_MIPRES" + "%" + "06B|13|NUMERO_ENTREGA_MIPRES" + "%" + "06B|14|NUMERO_CONTRATO" + "%" + "06B|15|NUMERO_POLIZA" + "%" + "06B|16|COPAGO" + "%" + "06B|17|CUOTA_MODERADORA" + "%" + "06B|18|CUOTA_RECUPERACION" + "%" + "06B|19|PAGOS_COMPARTIDOS"</pre>
 

<big><center>*** Varios pacientes:</center></big>
 
<pre>ID06B1 = "06B|1|CODIGO_PRESTADOR"+ "%" + "06B|2|TIPO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|3|NUMERO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|4|PRIMER_APELLIDO"+ “%” + "06B|5|SEGUNDO_APELLIDO"+ "%" + "06B|6|PRIMER_NOMBRE" + "%" + "06B|7|SEGUNDO_NOMBRE" + "%" + "06B|8|TIPO_USUARIO" + "%" + "06B|9|MODALIDAD_CONTRATACION" + "%" + "06B|10|COBERTURA_PLAN_BENEFICIOS" + "%" + "06B|11|NUMERO_AUTORIZACION" + "%" + "06B|12|NUMERO_MIPRES" + "%" + "06B|13|NUMERO_ENTREGA_MIPRES" + "%" + "06B|14|NUMERO_CONTRATO" + "%" + "06B|15|NUMERO_POLIZA" + "%" + "06B|16|COPAGO" + "%" + "06B|17|CUOTA_MODERADORA" + "%" + "06B|18|CUOTA_RECUPERACION" + "%" + "06B|19|PAGOS_COMPARTIDOS"</pre>
 
<pre>ID06B2 = "06B|1|CODIGO_PRESTADOR"+ "%" + "06B|2|TIPO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|3|NUMERO_DOCUMENTO_IDENTIFICACION" + "%" + "06B|4|PRIMER_APELLIDO"+ “%” + "06B|5|SEGUNDO_APELLIDO"+ "%" + "06B|6|PRIMER_NOMBRE" + "%" + "06B|7|SEGUNDO_NOMBRE" + "%" + "06B|8|TIPO_USUARIO" + "%" + "06B|9|MODALIDAD_CONTRATACION" + "%" + "06B|10|COBERTURA_PLAN_BENEFICIOS" + "%" + "06B|11|NUMERO_AUTORIZACION" + "%" + "06B|12|NUMERO_MIPRES" + "%" + "06B|13|NUMERO_ENTREGA_MIPRES" + "%" + "06B|14|NUMERO_CONTRATO" + "%" + "06B|15|NUMERO_POLIZA" + "%" + "06B|16|COPAGO" + "%" + "06B|17|CUOTA_MODERADORA" + "%" + "06B|18|CUOTA_RECUPERACION" + "%" + "06B|19|PAGOS_COMPARTIDOS"</pre>
 

<big><center>Pacientes= ID06B1 + "¬" + ID06B2</center></big>
 
<pre>ID06C = "06C|||5170000|1|100.50|1"
SectorSalud= ID06 + "%" + ID06A + "%%" + ID06B + "%%" + ID06C
SectorSalud= ID06 + "%" + ID06A + "%%" + + "%%" + ID06C (Varios Pacientes)</pre>
 
Adjuntos= "0"
 
'''Enviar (url, tokenEmp, tokenPas, datos_Cliente, Factura_Global, Antic_Autorizado_CargDesc, CondPago_DocReferencia, Entrega_Mercancia, Impuestos_Factura, MedPago_OC_TermEntrega, TasaCamb_TasaCambAlt_InfAdic, Extras, Detalle_De_Factura, Adjuntos, SectorSalud, debugMode)'''
 
 
<includeonly>=</includeonly>== Ejemplo Strings Método EnviarArchivo==<includeonly>=</includeonly>
 
<center>
<pre>
* Url= 'http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc'
* TokenEmp='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
* TokenPas='xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
</pre>
</center>
* Ndocumento = “PRUE1”
* Enviar = “1”
* Formato =”pdf”
* Nombre = “Adjunto”
* Tipo = “2”
* Email = “integracion_fel_co@thefactoryhka.com”
* Ruta = “C:\Adjunto.PDF”
 

<includeonly>=</includeonly>== Personalización del Correo ==<includeonly>=</includeonly>
 
El arreglo “extras” también permite manejar algunas funcionalidades especiales de la plataforma, como la de correo electrónico personalizado mediante el uso de los campos extensibles 11, 13 y 14. Para obtener más detalles, referirse al '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#Correo_electr.C3.B3nico_personalizado MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)]''' sección ''PERSONALIZACIÓN DEL CORREO''
 
 
<includeonly>=</includeonly>== Generación De Notas Con Y Sin Referencia a Documentos ==<includeonly>=</includeonly>
 
En el anexo técnico V1.8 se plantea la emisión de notas de crédito y débito bajo los siguientes escenarios:
 

* Emisión de notas de Val. previa con referencia a facturas de Val. Previa
* Emisión de notas de Val. previa con referencia a facturas de Val. Posterior
* Emisión de notas de Val. previa sin referencia

Para ello se debe tener en cuenta la estructura de la clase documentosReferenciados y el campo tipoOperación para cada escenarios. Para obtener más detalles, referirse al '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#GENERACI.C3.93N_DE_NOTAS_CON_Y_SIN_REFERENCIA_A_DOCUMENTO MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)]]''' sección ''GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTOS'' donde se ejemplifica cada uno de estos casos.
 
 
<includeonly>=</includeonly>== Transmisión De Documentos De Contingencia Tipo 03 ==<includeonly>=</includeonly>
 
La transmisión de documentos de contingencia está sujeta a la estructura de la clase documentosReferenciados y el campo tipoDocumento. Este escenario junto con las condiciones en las cuales aplica y la respuesta obtenida por parte de la DIAN se especifican en el '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#TRANSMISI.C3.93N_DE_DOCUMENTOS_DE_CONTINGENCIA_TIPO_03_.28ATRIBUIBLE_AL_EMISOR.29 MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL. PREVIA)]''' sección ''TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)''.
 
 
<includeonly>=</includeonly>== Radicar Documentos Electrónicos En Plataformas De Recepción ==<includeonly>=</includeonly>
 
El XML que se debe radicar en las plataformas de recepción es el que envía nuestro servicio en la notificación de correo llamado '''AttachedDocument''' (Contenedor de Documentos), la estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha, este XML también puede ser descargado a través del método '''GenerarContenedor'''.
 
La estructura de este archivo se ejemplifica en en el '''[https://felcowiki.thefactoryhka.com.co/index.php/Caracteristicas_adicionales_-_Indice_Manual_Integraci%C3%B3n_Directa#Radicar_documentos_electr.C3.B3nicos_en_plataformas_de_recepci.C3.B3n MANUAL DE INTEGRACION DIRECTA (EMISIÓN - VAL PREVIA)]''' sección ''RADICAR DOCUMENTOS ELECTRÓNICOS EN PLATAFORMAS DE RECEPCIÓN''
 
 
<includeonly>=</includeonly>== Ambiente De Habilitación ==<includeonly>=</includeonly>
 
El ambiente de pruebas liberado (ambiente demo) corresponde a un entorno de pruebas propio del proveedor tecnológico ('''The Factory HKA''') con el objetivo de que los desarrolladores y Casas de Software puedan realizar pruebas de los ajustes realizados a los ERP bajo el modelo de facturación con validación previa. Las pruebas realizadas en este ambiente NO serán enviadas al web service de habilitación de la DIAN.

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Generalities - Direct Integration Manual Index - Electronic Bill

2022-04-20T22:06:55Z

Lvargas:

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support?==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====Technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
===Direct integration scheme for SOAP URL Electronic Invoice===
We have a SOAP web service for testing in which initial validations are made against the DIAN,
this allows them to validate the structure of the Invoice object and data source proposed by TFHKA. 
 

'''URL DEMO Environment (test environment in which the emissions are not transmitted to the DIAN):'''
 

[http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl] --> Emission Service
 
[http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl] --> Attached Service
 
[http://demoemision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl http://demoemision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl ] --> Reporting Service
 
 
'''URL productive environment (environment in which the emissions corresponding to the authorization set are
made and subsequently the issuance of documents in operation):'''
 

[https://emision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl https://emision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl] --> Emission Service (HTTPS)
 
[https://emision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl https://emision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl] --> Attached Service(HTTPS)
 
[https://emision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl https://emision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl] --> Reporting Service (HTTPS)
 
 
<center>@IMPORTANT:The SOAP service url in production is only functional under the https protocol.</center>
 
'''NOTE:''' If you cannot access said configuration in the system interface, please contact your software house or ERP developer so that they can validate what has been previously described. If the problem is not solved with the aforementioned, please send an email to the integration area [mailto:integracion_fel_co@thefactoryhka.com integracion_fel_co@thefactoryhka.com] with the following information:

* Request sent to WS.
* Capture of the configuration made in the system where the indicated information of the URLs and tokens is displayed.
{{clear}}

<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===What is the electronic invoice with prior validation?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}
===Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-04-20T21:19:36Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Version record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Technical requirements for direct integration|Technical requirements for direct integration]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Direct integration scheme for SOAP URL Electronic Invoice|Direct integration scheme for SOAP URL Electronic Invoice]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Web Soap Broadcast Service Methods - Direct Integration Manual Index|Web Soap Broadcast Service Methods]]==<includeonly>=</includeonly>
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Enviar Method|Enviar Method]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Anticipos|Class.Anticipos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Autorizado|Class.Autorizado]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Cliente|Class.Cliente]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.CondicionPago|Class.CondicionPago]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Destinatario|Class.Destinatario]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Entrega|Class.Entrega]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Extras|Class.Extras]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Extensible|Class.Extensible]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.MediosDePago|Class.MediosDePago]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Direccion|Class.Direccion]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Coordenadas|Class.Coordenadas]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Tributos|Class.Tributos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Obligaciones|Class.Obligaciones]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.sectorSalud|Class.sectorSalud]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Beneficiario|Class.Beneficiario]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.GeneralSalud|Class.GeneralSalud]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#EstadoDocumento Method|EstadoDocumento Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#EnvioCorreo Method|EnvioCorreo Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargaPDF Method|DescargaPDF Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargaXML Method|DescargaXML Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#FoliosRestantes Method|FoliosRestantes Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#CargarCertificado Method|CargarCertificado Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargarEventoXML Method|DescargarEventoXML Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#GenerarContenedor Method|GenerarContenedor Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#GenerarEvento Method|GenerarEvento Method]]

<includeonly>=</includeonly>==[[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill|Web soap service attachment methods]]==<includeonly>=</includeonly>
#[[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#“CargarAdjuntos” Method|“CargarAdjuntos” Method]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#SCENARIOS ISSUANCE OF DOCUMENTS WITH GRAPHIC REPRESENTATION|SCENARIOS ISSUANCE OF DOCUMENTS WITH GRAPHIC REPRESENTATION]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#Standard Graphical Representation (Using the Attachment parameter of the Send method as '0' or '1')|Standard Graphical Representation (Using the Attachment parameter of the Send method as '0' or '1')]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#Custom graphic representation by TFHKA|Custom graphic representation by TFHKA]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#Graphic representation sent as an attachment from the administrative system or ERP (Use of the attachments parameter of the method Send in '11')|Graphic representation sent as an attachment from the administrative system or ERP (Use of the attachments parameter of the method Send in '11')]]

<includeonly>=</includeonly>==[[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill|Web soap reporting service methods]]==<includeonly>=</includeonly>
# [[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill#“DescargarReporte” Method|“DescargarReporte” Method]]
# [[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill#“ProgramarReporte” Method|“ProgramarReporte” Method]]
# [[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill#“SolicitudReporteSincrono” Method|“SolicitudReporteSincrono” Method]]

<includeonly>=</includeonly>==[[Additional features - Direct Integration Manual Index|Additional features]]==<includeonly>=</includeonly>
# [[Additional features - Direct Integration Manual Index#Use of extra fields|Use of extra fields]]
# [[Additional features - Direct Integration Manual Index#Code table for extra fields|Code table for extra fields]]
# [[Additional features - Direct Integration Manual Index#Personalized email|Personalized email]]
# [[Additional features - Direct Integration Manual Index#GENERATION OF NOTES WITH AND WITHOUT DOCUMENT REFERENCE|GENERATION OF NOTES WITH AND WITHOUT DOCUMENT REFERENCE]]
## [[Additional features - Direct Integration Manual Index#Credit and debit notes that affect prior validation invoices|Credit and debit notes that affect prior validation invoices]]
## [[Additional features - Direct Integration Manual Index#Credit and debit notes that do not affect invoices|Credit and debit notes that do not affect invoices]]
## [[Additional features - Direct Integration Manual Index#TRANSMISSION OF CONTINGENCY DOCUMENTS TYPE 03 (ATTRIBUTABLE TO THE ISSUER)|TRANSMISSION OF CONTINGENCY DOCUMENTS TYPE 03 (ATTRIBUTABLE TO THE ISSUER)]]
# [[Additional features - Direct Integration Manual Index#Submit electronic documents on reception platforms|Submit electronic documents on reception platforms]]
# [[Additional features - Direct Integration Manual Index#Standard of the name of XML electronic documents|Standard of the name of XML electronic documents]]
# [[Additional features - Direct Integration Manual Index#Enablement environment|Enablement environment]]
<includeonly>=</includeonly>==[[Property code tables for document issuance - Direct Integration Manual Index |Property code tables for document issuance]]==<includeonly>=</includeonly>
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 1|Table 1]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 2|Table 2]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 3|Table 3]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 4|Table 4]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 5|Table 5]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 6|Table 6]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 7|Table 7]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 8|Table 8]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 9|Table 9]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 10|Table 10]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 11|Table 11]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 12|Table 12]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 13|Table 13]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 14|Table 14]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 15|Table 15]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 16|Table 16]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 17|Table 17]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 18|Table 18]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 19|Table 19]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 20|Table 20]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 21|Table 21]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 22|Table 22]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 23|Table 23]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 24|Table 24]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 25|Table 25]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 26|Table 26]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 27|Table 27]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 28|Table 28]]

<includeonly>=</includeonly>==[[Catalog of web service response errors - Direct Integration Manual Index - Electronic Bill|Catalog of web service response errors]]==<includeonly>=</includeonly>

 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. All rights reserved.</center>

 
{{clear}}

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-04-12T16:23:07Z

Lvargas: /* Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre */

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Deberá contener el nombre de la ciudad correspondiente cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 

==Proceso tecnológico en el Sistema de Facturación Electrónica ==
'''Habilitación'''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
'''Sujetos obligados '''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
'''Suplemento C: Inconvenientes tecnológicos'''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
==Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
==Tipos de operación Procedencia de Vendedor: cbc:CustomizationID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
==Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
1. Por cada una de las operaciones en las que se adquieren bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente. 
2. Por operaciones acumuladas semanalmente que se realicen con un mismo proveedor en las que se adquieren bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente. 

'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
 
En la URL versión 4, se debe reportar en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|600px|sinmarco|centro|docSoporte]]
 

==Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName==

 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
==Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| ReteIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 

==Tipo de organización jurídica (Personas): cbc:AdditionalAccountID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
==Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme==
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
*6.En la URL versión 4, en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|docSoporte]]
 

<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente===

'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 

==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
'''Inconvenientes tecnológicos por parte de la DIAN'''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
'''Inconvenientes tecnológicos por parte del sujeto'''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 

 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-04-12T16:16:54Z

Lvargas: /* Nuevas Reglas de Validación */

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Deberá contener el nombre de la ciudad correspondiente cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 

==Proceso tecnológico en el Sistema de Facturación Electrónica ==
'''Habilitación'''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
'''Sujetos obligados '''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
'''Suplemento C: Inconvenientes tecnológicos'''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
==Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
==Tipos de operación Procedencia de Vendedor: cbc:CustomizationID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
==Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
1. Por cada una de las operaciones en las que se adquieren bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente. 
2. Por operaciones acumuladas semanalmente que se realicen con un mismo proveedor en las que se adquieren bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente. 

'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
 
En la URL versión 4, se debe reportar en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|600px|sinmarco|centro|docSoporte]]
 

==Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName==

 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
==Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
==Tipo de organización jurídica (Personas): cbc:AdditionalAccountID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
==Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme==
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
*6.En la URL versión 4, en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|docSoporte]]
 

<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente===

'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 

==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
'''Inconvenientes tecnológicos por parte de la DIAN'''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
'''Inconvenientes tecnológicos por parte del sujeto'''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 

 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Archivo:DocSoporte.png

2022-04-08T21:54:16Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-04-08T20:52:41Z

Lvargas: /* Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme */

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 
==Proceso tecnológico en el Sistema de Facturación Electrónica ==
'''Habilitación'''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
'''Sujetos obligados '''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
'''Suplemento C: Inconvenientes tecnológicos'''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
==Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
==Tipos de operación Procedencia de Vendedor: cbc:CustomizationID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
==Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
1. Por cada una de las operaciones en las que se adquieren bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente. 
2. Por operaciones acumuladas semanalmente que se realicen con un mismo proveedor en las que se adquieren bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente. 

'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
 
En la URL versión 4, se debe reportar en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|600px|sinmarco|centro|docSoporte]]
 

==Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName==

 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
==Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
==Tipo de organización jurídica (Personas): cbc:AdditionalAccountID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
==Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme==
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
*6.En la URL versión 4, en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|docSoporte]]
 

<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente===

'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 

==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
'''Inconvenientes tecnológicos por parte de la DIAN'''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
'''Inconvenientes tecnológicos por parte del sujeto'''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 

 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-04-08T20:49:12Z

Lvargas: /* Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description */

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 
==Proceso tecnológico en el Sistema de Facturación Electrónica ==
'''Habilitación'''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
'''Sujetos obligados '''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
'''Suplemento C: Inconvenientes tecnológicos'''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
==Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
==Tipos de operación Procedencia de Vendedor: cbc:CustomizationID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
==Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
1. Por cada una de las operaciones en las que se adquieren bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente. 
2. Por operaciones acumuladas semanalmente que se realicen con un mismo proveedor en las que se adquieren bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente. 

'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
 
En la URL versión 4, se debe reportar en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|600px|sinmarco|centro|docSoporte]]
 

==Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName==

 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
==Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
==Tipo de organización jurídica (Personas): cbc:AdditionalAccountID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
==Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme==
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
*6.En la URL versión 4, en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|DocSoporte]]
 

<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente===

'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 
==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
'''Inconvenientes tecnológicos por parte de la DIAN'''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
'''Inconvenientes tecnológicos por parte del sujeto'''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 

 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-04-08T20:47:36Z

Lvargas:

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 
==Proceso tecnológico en el Sistema de Facturación Electrónica ==
'''Habilitación'''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
'''Sujetos obligados '''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
'''Suplemento C: Inconvenientes tecnológicos'''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
==Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
==Tipos de operación Procedencia de Vendedor: cbc:CustomizationID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
==Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
1. Por cada una de las operaciones en las que se adquieren bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente. 
2. Por operaciones acumuladas semanalmente que se realicen con un mismo proveedor en las que se adquieren bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente. 

'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
 
En la URL versión 4, se debe reportar en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|docSoporte]]
 
==Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName==

 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
==Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
==Tipo de organización jurídica (Personas): cbc:AdditionalAccountID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
==Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme==
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
*6.En la URL versión 4, en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|DocSoporte]]
 

<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente===

'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 
==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
'''Inconvenientes tecnológicos por parte de la DIAN'''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
'''Inconvenientes tecnológicos por parte del sujeto'''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 

 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-04-08T20:31:27Z

Lvargas:

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 
==Proceso tecnológico en el Sistema de Facturación Electrónica ==
'''Habilitación'''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
'''Sujetos obligados '''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
'''Suplemento C: Inconvenientes tecnológicos'''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
==Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
==Tipos de operación Procedencia de Vendedor: cbc:CustomizationID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
==Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
1. Por cada una de las operaciones en las que se adquieren bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente. 
2. Por operaciones acumuladas semanalmente que se realicen con un mismo proveedor en las que se adquieren bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente. 

'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
==Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName==

 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
==Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
==Tipo de organización jurídica (Personas): cbc:AdditionalAccountID==
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
==Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme==
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
*6.En la URL versión 4, en la clase detalle <detalleDeFactura<FacturaDetalle>>, ingresar la información requerida: 
1.<descripcion> Servicio recibido. 
2.<descripcion2>Reportar la fecha de compra en un formato año-mes-dia. 
3.<descripcion3>(1) Si es por operación (2) Si es un acumulado semanal. 

[[Archivo:docSoporte.png|800px|sinmarco|centro|DocSoporte]]
 

<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente===

'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 
==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
'''Inconvenientes tecnológicos por parte de la DIAN'''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
'''Inconvenientes tecnológicos por parte del sujeto'''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 

 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Caracteristicas adicionales - Indice Manual Integración Directa

2022-03-03T15:07:37Z

Lvargas: /* Notas de crédito y débito que no afecten a facturas */

<includeonly>=</includeonly>==Caracteristicas adicionales ==<includeonly>=</includeonly>
===Uso de campos extras===
El arreglo “extras” permite incorporar campos opcionales que se insertarán en el XML-Invoice y en la representación impresa según se desee.

Los campos extras no son obligatorios por la DIAN, pero en ciertos casos son importantes y necesarios en el modelo de negocio del emisor. Estos incorporan información adicional dentro del documento, como por ejemplo, detalles del pago, la entrega, el transporte, coordenadas geográficas, lote de productos, vencimiento de la mercancía, servicios médicos, servicios aeronáuticos, información libre, entre muchos otros.

Los campos extensibles están diseñados según parámetros establecidos en la Cámara Colombiana de Comercio Electrónico y la DIAN, con el propósito de ser interoperables (esto aún no está definido en su totalidad para el modelo de validación previa). La información a insertar en un campo extensible debe cumplir con criterios asociados al campo específico a insertar. La estructura del objeto “extras” es la siguiente:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="6"|String
|controlInterno1
|<nowiki>AN|100 </nowiki>
|Etiqueta asignada para la Representación Impresa PDF.
|-
|controlInterno2
|rowspan="2"|Depende del campo
|Permite asociar dos o más campos mediante un índice (si los campos son asociables)
|-
|nombre
|Código del campo extensible a referenciar (existen códigos definidos por TFHKA para información especifica y también pueden usarse códigos libres)
|-
|pdf
|<nowiki>N|1</nowiki>
|Indicación de mostrar el campo en la representación gráfica PDF (“0” = No mostrar / “1” = Mostrar)
|-
|valor
|Depende del campo
|Valor del campo a agregar.
|-
|xml
|<nowiki>N|1</nowiki>
|Indicación de mostrar el campo en el XML (“0” = No mostrar / “1” = Mostrar)
|}
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Ejemplo de uso de Campos Extensible 443 (Vendedor)
|- valign="center"
|
<ser:Extras>
<ser:controlInterno1>Vendedor</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>443</ser:nombre>
<ser:pdf>1</ser:pdf>
<ser:valor>Pablo Marmol</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|-
! style="background:#f2f2f2; text-align:center;"|Campo Insertado en el PDF
|- valign="center"
|
[[Archivo:CampoExtensibleVendedor.png|800px|sinmarco|centro|CampoExtensibleVendedor]]
|}
'''@IMPORTANTE:''' Se recomienda que la propiedad Extras.xml se coloque con el valor ‘0’, ya que The Factory HKA implementa el uso de CDATAS anidados en la estructura del XML para reflejar los campos extras, sin embargo algunas plataformas de recepción no pueden interpretar este estándar y pueden existir rechazos al momento de radicar el documento si a esta propiedad se le asignan al valor ‘1’

La etiqueta que se asigne en Extras.ControlInterno1 es de libre elección, mientras se respete el formato estipulado. Sin embargo, será necesario conocer los demás parámetros, que serán suministrados con los campos disponibles:
* El código del campo, para colocar en Extras.nombre.
* Si el campo es repetible y asociable, para colocar un índice común en Extras.ControlInterno2.
* El formato del valor del campo, para que la información que se coloque Extras.valor sea válida.
Además de los campos disponibles (códigos reservados por TFHKA), se ha contemplado el uso de campos LIBRES, para insertar identificadores y valores genéricos. Este campo es repetible.
: Note el siguiente ejemplo para insertar un campo libre:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Ejemplo
|- valign="center"
|
<ser:Extras>
<ser:controlInterno1>LISTA DE PRECIOS</ser:controlInterno1>
<ser:controlInterno2</ser:controlInterno2>
<ser:nombre>1</ser:nombre>
<ser:pdf>1</ser:pdf>
<ser:valor>MAYORISTA</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|-
! style="background:#f2f2f2; text-align:center;"|Campo Insertado en el PDF
|- valign="center"
|
[[Archivo:CamposLibresMayorista.png|800px|sinmarco|centro|Uso de Campos Libres para insertar identificadores y valores genéricos]]
|}

===Tabla de códigos para campos extras===
En este momento los códigos ó propiedad Extras.nombre para campos extras reservados por TFHKA (cualquier otro código utilizado es considerado como libre) son los siguientes:
; Campos Extensibles reservados por TFHKA
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Código
! style="background:#f2f2f2; text-align:center;"|Etiqueta PDF
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Formato de valor
! style="background:#f2f2f2; text-align:center;"|Observaciones
|- valign="center"
|-
|122333
|Aceptación Física
|Aceptación Física
|<nowiki>AN|1000</nowiki>
|
|-
|100200
|Pie de página
|Pie de página
|<nowiki>AN|1000</nowiki>
|-
|5170000
|Total Base Excluida
|Total Base Excluida
|Formato Libre
|Para totales el R.G
|-
|5170001
|TOTAL Descuento Detalle
|TOTAL Descuento Detalle
|Formato Libre
|Para totales el R.G
|-
|5170002
|TOTAL Retenciones
|TOTAL Retenciones
|Formato Libre
|Para totales el R.G
|-
|5170003
|TOTAL a Pagar
|TOTAL a Pagar
|Formato Libre
|Para totales el R.G
|-
|5170004
|TOTAL A PAGAR en Letras
|TOTAL A PAGAR en Letras
|Formato Libre
|Para totales el R.G
|}
'''@IMPORTANTE:''' El campo Aceptación Física se puede aplicar en dos escenarios. El primer escenario, en donde la factura es aceptada tácitamente y solo el XML es generado (el archivo PDF no se genera en nuestra plataforma), asumiendo que la entrega de la representación gráfica es responsabilidad del usuario. El segundo escenario, en el cual la factura es aceptado tácitamente y se genera el XML y el PDF en nuestra plataforma, los cuales serán enviados vía correo electrónico si el campo “notificar” se encuentra seteado en “SI”. Para este último escenario, es necesario que el campo “controlInterno2” se encuentre en “1”.
<pre style="color: red">ADVERTENCIA: Si utiliza la opción controlInterno2 = "", nuestra plataforma no generará representación estándar HKA, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal, en el correo del adquiriente (sección visualizar documento), realizar la descarga a través del método DescargaPDF del servicio ni reenviar la misma a través del método EnvioCorreo.</pre>
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Ejemplo del uso del campo extensible 122333 en el XML
|- valign="center"
|
<ser:Extras>
<ser:controlInterno1/>
<ser:controlInterno2>1<ser:controlInterno2>
<ser:nombre>122333</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>1</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|}
===Correo electrónico personalizado===
El arreglo “extras” también permite manejar algunas funcionalidades especiales de la plataforma, como la de correo electrónico personalizado. Para que esta información no aparezca en la representación gráfica, el parámetro pdf del objeto “extras” debe ir en “0”.

@IMPORTANTE: Se recomienda que la propiedad '''Extras.xml''' se coloque con el valor ‘0’, ya que The Factory HKA implementa el uso de CDATAS anidados en la estructura del XML para reflejar los campos extras, sin embargo algunas plataformas de recepción no pueden interpretar este estándar y pueden existir rechazos al momento de radicar el documento si a esta propiedad se le asignan el valor ‘1’

@IMPORTANTE: Se recomienda que la propiedad '''Extras.pdf''' se coloque con el valor ‘0’, con el fin de que la información indicada no se visualice en la representación gráfica estándar.
La funcionalidad de correo electrónico personalizado permite configurar transacción a transacción el asunto, la dirección de respuesta y el cuerpo del correo electrónico. La vía para exponer esta información será a través de campos extras.
; Campos Extensibles para Correo Electrónico Personalizado
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Código
! style="background:#f2f2f2; text-align:center;"|Etiqueta PDF
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Formato de valor
! style="background:#f2f2f2; text-align:center;"|Observaciones
|- valign="center"
|-
|11
|Cuerpo del Correo Electrónico
|Cuerpo del Correo Electrónico
|<nowiki>AN | 1000</nowiki>
|String que contiene el código html del cuerpo del email.
|-
|13
|Asunto del Correo Electrónico
|Asunto del Correo Electrónico
|<nowiki>AN | 100</nowiki>
|Definido en el Anexo Técnico V1.7-2020 de la <nowiki>DIAN**</nowiki>
|-
|14
|Responder a
|Responder a
|<nowiki>AN | 100</nowiki>
|Debe colocarse una única dirección de email
|-
|1700
|Linea de Negocio
|Linea de Negocio
|<nowiki>AN|100</nowiki>
|(Opcional) Inclusión de línea de negocio en el asunto del correo
|}
<nowiki>**</nowiki> El asunto debe cumplir con el siguiente formato:
: NIT del Facturador Electrónico; Nombre del Facturador Electrónico; Número del Documento Electrónico; Código del tipo de documento según Tabla 1; Nombre comercial del facturador; Linea de negocio (este ultimo opcional, acuerdo comercial entre las partes).
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Ejemplo de uso de Campos Extensibles 11,13 y 14 para personalizar el Correo Electrónico
|- valign="center"
|
<ser:extras>
<ser:Extras>
<ser:controlInterno1>Cuerpo del Correo Electrónico</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>11</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>String de prueba Cuerpo del correo electronico
@email.documento.urlAcuseRecibo</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
<ser:Extras>
<ser:controlInterno1>Asunto del Correo Electrónico</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>13</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>@email.emisor.razonSocial le ha enviado la
@email.documento.tipoDocumento @email.documento.numeroDocumento
</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
<ser:Extras>
<ser:controlInterno1>Responder a</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>14</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>notificaciones@thefactoryhka.com</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|}
Para que el correo electrónico tenga la capacidad de adoptar los datos propios de la transacción, se plantea un juego de variables de código, las cuales serán sustituidas en la plataforma por el valor propio generado en la misma. A continuación se exponen estas variables:
; Campos Extensibles para Correo Electrónico Personalizado
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Sección
! style="background:#f2f2f2; text-align:center;"|Descriptor
! style="background:#f2f2f2; text-align:center;"|Valor Referencial
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Ubicación
|- valign="center"
|-
|rowspan="7"|Datos Factura
|Número de Documento Electrónico
|@email.documento.numeroDocumento
|Único
|Asunto/Cuerpo
|-
|CUFE
|@email.documento.cufe
|Único
|Asunto/Cuerpo
|-
|Fecha Emisión
|@email.documento.fechaEmision
|Único
|Asunto/Cuerpo
|-
|Hora de Emisión
|@email.documento.horaEmision
|Único
|Asunto/Cuerpo
|-
|Tipo de Documento Electrónico
|@email.documento.tipoDocumento
|Único
|Asunto/Cuerpo
|-
|Tipo de Factura
|@email.documento.tipoFactura
|Único
|Asunto/Cuerpo
|-
|-
|Responder A
|@email.documento.responderA
|Único
|Cuerpo
|-
|rowspan="5"|Emisor
|Tipo Contribuyente
|@email.emisor.tipoContribuyente
|Único
|Asunto/Cuerpo
|-
|Tipo de Documento de Identidad
|@email.emisor.tipoIdentidad
|Único
|Asunto/Cuerpo
|-
|Número de Documento de Identidad
|@email.emisor.numeroIdentidad
|Único
|Asunto/Cuerpo
|-
|Razón Social
|@email.emisor.razonSocial
|Único
|Asunto/Cuerpo
|-
|Logo
|@email.emisor.logo
|Único
|Cuerpo
|-
|rowspan="4"|Adquiriente
|Tipo Contribuyente
|@email.receptor.tipoContribuyente
|Único
|Asunto/Cuerpo
|-
|Tipo de Documento de Identidad
|@email.receptor.tipoIdentidad
|Único
|Asunto/Cuerpo
|-
|Número de Documento de Identidad
|@email.receptor.numeroIdentidad
|Único
|Asunto/Cuerpo
|-
|Razón Social
|@email.receptor.razonSocial
|Único
|Asunto/Cuerpo
|-
|Acuse
|Acuse de Recibo
|@email.documento.urlAcuseRecibo
|Único
|Cuerpo
|}
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Ejemplo de String para Cuerpo de correo electrónico en html
|- valign="center"
|
<nowiki>Estimado @email.receptor.razonSocial, ha recibido un DOCUMENTO ELECTRÓNICO por parte de @email.emisor.razonSocial; envío que se efectúa mediante el Proveedor Tecnológico The Factory HKA Colombia SAS<div style="text-align:center;"><a style=" background-color: #154380; border: 1px solid #ffffff; border-radius: 20px; color: #ffffff; display: inline-block; font-family: sans-serif; font-size: 25px; font-weight: bold; line-height: 60px; text-align: center; text-decoration: none; width: 300px; -webkit-text-size-adjust: none;" class="btn btn-block btn-info" href="@email.documento.urlAcuseRecibo" target="_blank">Acuse de Recibo</a> </div> Por favor revise el documento electrónico e ingrese en el botón de Acuse Este E-mail ha sido enviado automáticamente, no responder a esta cuenta. @email.advertenciaLa información contenida en este E-mail es confidencial. Si por error recibe este mensaje, favor reenviarlo y borrar</div></nowiki>
|}
@IMPORTANTE: Para que el servicio tome la configuración dinámica del campo “Cuerpo del Correo Electrónico”, el atributo @email.documento.urlAcuseRecibo deberá estar presente.
{{clear}}
=== GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO ===
Para la generación de notas crédito y débito, se describen 3 escenarios:

==== Notas de crédito y débito que afecten a facturas de validación previa ====
Para la emisión de notas de crédito y débito deben enviarse obligatoriamente dos arreglos de documentos referenciados, el primero indicando el codigoInterno = '4' el cual corresponde a los motivos por los cuales se genera la NC/ND ('''DiscrepancyResponse''') y un segundo arreglo, indicando el codigoInterno = '5' en el cual se reflejan los datos de la factura afectada por la NC/NC ('''BillingReference''').
: Ejemplo:
<pre>
<a:documentosReferenciados>
<a:DocumentoReferenciado>
<a:codigoEstatusDocumento>2</a:codigoEstatusDocumento>
<a:codigoInterno>4</a:codigoInterno>
<a:descripción>
<b:string>Anulación de factura electrónica</b:string>
</a:descripcion>
<a:fecha>2019-10-07</a:fecha>
<a:numeroDocumento>F4PM3</a:numeroDocumento>
</a:DocumentoReferenciado>
<a:DocumentoReferenciado>
<codigoInterno>5</codigoInterno> <cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1KqmCLKgxPpH6u5LiKrJvTb6FEyfVuoCcV0baab6b59cdc8b3</cufeDocReferenciado>
<fecha>2019-10-07</fecha>
<numeroDocumento>F4PM3</numeroDocumento>
</a:DocumentoReferenciado>
</a:documentosReferenciados>
</pre>
@IMPORTANTE: El campo '''cufeDocReferenciado''' debe contener un total de 96 caracteres y el valor del campo '''FacturaGeneral.tipoOperacion''' debe ser 20 (para NC) y 30 (para ND).

==== Notas de crédito y débito que no afecten a facturas ====
Tener en cuenta que en cada escenario se debe indicar correctamente el campo '''FacturaGeneral.tipoOperacion''':
* Código 22 para Notas Crédito.
* Código 32 para Notas Débito.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:Notas.tipoOperacion.png|800px|sinmarco|centro|Notas.tipoOperacion]]

@IMPORTANTE: La clase Documentos Referenciados debe enviarse en NULL.

=== TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR) ===
Los inconvenientes tecnológicos por parte del facturador electrónico implican que la facturación electrónica tenga las siguientes características:
* Generar la facturación con numeración de contingencia en papel o por computador.
* El facturador electrónico deberá generar una carta declarando el inconveniente tegnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía y remitirla al correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente: o Asunto: Nit de la empresa separado con un guion el digito de verificación; Nombre de la empresa.
** Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal.
** Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
*** Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar la contingencia o superación de los inconvenientes tecnológicos.
*** Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.
* El facturador tendrá 48 horas a partir de la fecha en que supera la contingencia para transmitir las facturas electrónicas en formato XML a la DIAN.
* Las facturas electrónicas generadas y emitidas en contingencia pasarán la malla de validaciones de anexo, es decir, la DIAN responderá con un Application Response de Documento Validado por la DIAN, que informará las notificaciones a que haya lugar.
* Una vez el facturador electrónico salga de contingencia deberá proceder al proceso de generación normal.
* Para los documentos de notas crédito y notas débito, el facturador NO debe usar la numeración de contingencia, sino el consecutivo propio normal. Las notas enviadas a la DIAN se validarán de manera normal en la DIAN. Por lo anterior, no existe el concepto de nota en contingencia, por lo que debe cuidarse enviar primeramente las Facturas de Contingencia antes de generar notas sobre las mismas y se recomienda generarlas en un ambiente de operación normal.

====¿Cómo transmitir un documento de contingencia Tipo 03?====
La transmisión del documento se realiza por medio del método '''Enviar''' del Web Service de Emisión que brinda The Factory HKA, indicando el atributo '''tipoDocumento''' del objeto '''FacturaGeneral''' igual a ‘03’ y enviar en la sección de '''documentosReferenciados''' un objeto de tipo '''DocumentosReferenciados''' indicando lo siguiente:
* '''codigoInterno''' = ‘1’
* '''fecha''' = ‘Fecha de emisión del documento de contingencia’
* '''numeroDocumento''' = ‘número del consecutivo del documento de contingencia emitido’
* '''tipoCodigoDocumento''' = ‘Tipo de documento de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico a transmitir, según lo estipulado en el numeral 12.1.4 de la versión 1.8 del Anexo Técnico de la DIAN ’.
:: Tipos de documentos de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Código
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|FTC
|Factura Talonario Contingencia
|-
|FTP
|Factura Talonario Papel
|}

==== ¿Cuál será el código de respuesta de transmisión exitosa que retornará el WS de TFHKA? ====
El método Enviar retornará código 201 ó 208 ante la recepción exitosa del documento en nuestra plataforma, con el siguiente mensaje: “El documento se recibió como Documento Electrónico de Contingencia Tipo 03, este se entregará de manera asíncrona a la DIAN, para más información favor consumir EstadoDocumento luego de 48 horas.” En dicho Response se contará con CUDE y UBL.

==== ¿Cuándo puedo consultar el resultado de la transmisión del documento hacia la DIAN? ====
Pasadas 48 horas luego de la radicación del documento en la plataforma, pueden consultar el estatus del mismo para conocer el resultado de la transacción ante la DIAN.

==== Generación de código QR de respuesta rápida para facturas de contingencia ====
Para la generación del Código de respuesta rápido – Código QR, en los casos que la factura de venta de talonario o de papel se genere a través de sistemas informáticos electrónicos deberán corresponder a la siguiente tabla:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Detalle
|-
|NumFac: [NUMERO_FACTURA]
|-
|FecFac: [FECHA_FACTURA]
|-
|HorFac: [HORA_FACTURA(con GMT)]
|-
|NitFac: [NIT FACTURADOR]
|-
|DocAdq: [NUMERO_ID_ADQUIRIENTE]
|-
|ValFac: [VALOR_FACTURA]
|-
|ValIva: [VALOR_IVA]
|-
|ValOtroIm: [VALOR_OTROS_IMPUESTOS]
|-
|ValTolFac: [VALOR_TOTAL_FACTURA]
|}
; Ejemplo:
<pre>
NumFac: CTG2
FecFac: 2020-06-16
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 1003.00
ValIva: 190.57
ValOtroIm: 0.00
ValTolFac: 1193.57
</pre>
: Ejemplo SOAP Request de Factura de Contingencia Tipo 03:

[[Archivo:Ejemplo SOAP Request de Factura de Contingencia Tipo 03.png|800px|sinmarco|centro|Ejemplo SOAP Request de Factura de Contingencia Tipo 03]]

@IMPORTANTE: No es requerido que se notifique a los adquiriente los documentos de contingencia transmitidos a la DIAN, ya que el documento entregado físicamente al mismo durante el período en que mantuvo la contingencia, corresponde al documento legal de la transacción realizada. La transmisión de dicha información a la DIAN es con el fin de notificar al ente regulador las transacciones realizadas durante dicho periodo. Por lo anteriormente descrito, se recomienda enviar el campo '''notificar''' = ‘NO’ y no realizar el envío de la información correspondiente al '''Destinatario''':

[[Archivo:Ejemplo SOAP Request de Factura de Contingencia Tipo 03. Notifica NO.png|800px|sinmarco|centro|Ejemplo SOAP Request de Factura de Contingencia Tipo 03 sin notificar]]

==== Notas a Documentos en Contingencia ====
Como se mencionó anteriormente, las notas de crédito o débito no tienen esquema de contingencia, por lo tanto las mismas se deben generar en la operación normal. Partiendo de este principio, surgen los siguientes escenarios:
# Si la nota a emitir se expide electrónicamente:
#:a. ''Afectando a una factura electrónica:'' Se realiza la emisión de la nota en operación normal de facturación, tomando en cuenta informar la referencia a documentos en el atributo '''documentosReferenciados''' del objeto '''FacturaGeneral''', enviando dos objetos de tipo '''DocumentosReferenciados''' indicando lo siguiente:
#::i. ''Objeto 1 (para generar DiscrepancyResponse):'' los campos codigoEstatusDocumento; codigoInterno=‘4’ y cufeDocReferenciado.
#::ii. ''Objeto 2 (para generar Billingreference):'' los campos codigoInterno=‘5’; cufeDocReferenciado; fecha; tipoCUFE y numeroDocumento.
#:b. ''Afectando a una factura de contingencia:'' La emisión de la nota en este escenario dependerá de:
#::i. ''Factura de Contingencia se encuentra transmitida a la DIAN:'' Se realiza la emisión de la nota en operación normal de facturación, tomando en cuenta informar la referencia a documentos en el atributo '''documentosReferenciados''' del objeto '''FacturaGeneral''', enviando dos objetos de tipo '''DocumentosReferenciados''' indicando lo siguiente:
#::: ''Objeto 1 (para generar DiscrepancyResponse):'' los campos codigoEstatusDocumento; codigoInterno=‘4’ y cufeDocReferenciado=’CUDE del documento’.
#::: ''Objeto 2 (para generar Billingreference):'' los campos codigoInterno=‘5’; cufeDocReferenciado=’CUDE del documento’; fecha; tipoCUFE y numeroDocumento.
#::ii. ''Factura de contingencia no se ha transmitido a la DIAN:'' Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
# Si la nota a emitir se expide “en contingencia”:
#:a. ''Afectando a una factura electrónica:'' Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
#:b. ''Afectando a una factura de contingencia:'' Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.

===Radicar documentos electrónicos en plataformas de recepción===
El XML que se debe radicar en las plataformas de recepción es el que nuestro servicio envía en la notificación de correo llamado '''AttachedDocument''' (Contenedor de Documentos), la estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha, este XML también puede ser descargado a través del método '''GenerarContenedor'''.

[[Archivo:RadicarAttachedDocument (Contenedor de Documentos).png|800px|sinmarco|centro|Radicar AttachedDocument (Contenedor de Documentos)]]

[[Archivo:RadicarAttachedDocument (Contenedor de Documentos)UBL.png|800px|sinmarco|centro|Radicar AttachedDocument (Contenedor de Documentos) UBL]]

===Estándar del nombre de los documentos electrónicos XML===
La DIAN establece en el Anexo técnico la nomenclatura que deben poseer los documentos electrónicos.

@IMPORTANTE: A través del Response del método Enviar pueden capturar el nombre del documento y posteriormente utilizar esta propiedad, a través del método GenerarContenedor descargar el AttachedDocument y realizar el reemplazo de las dos primeras iniciales por “ad”.

[[Archivo:nomenclaturaDIANdocumentoselectrónicos.png|800px|sinmarco|centro|nomenclaturaDIANdocumentoselectrónicos]]

===Ambiente de habilitación===
El ambiente de pruebas liberado (ambiente demo) corresponde a un entorno de pruebas propio del proveedor tecnológico (The Factory HKA) con el objetivo de que los desarrolladores y Casas de Software puedan realizar pruebas de los ajustes realizados a los ERP bajo el modelo de facturación con validación previa.

La etapa de habilitación, en la cual las pruebas realizadas por los clientes son enviadas al web service de pruebas de la DIAN, se realizará en ambiente productivo del servicio de TFHKA. Culminadas satisfactoriamente estas pruebas, la DIAN los habilitará como facturadores electrónicos.

Posteriormente, podrán iniciar las emisiones de documentos electrónicos en operación normal.

====Transmisión de Documentos de prueba a la DIAN en ambiente DEMO====
En estos momentos se encuentra funcional la emisión de documentos de pruebas ('''ambiente DEMO''') directamente contra la DIAN, es decir, poder realizar pruebas de integración desde su ERP con el 100% de validaciones DIAN sin pasar por el XSLT local.

Para reproducir este escenario de pruebas se debe tener en cuenta la siguiente configuración en el portal web DEMO:
# Ingresar al portal Demo a través de la siguiente URL: [https://demofactura.thefactoryhka.com.co/auth/login]
# Realizar la siguiente configuración:
#:a. El cliente Emisor debe verificar que en los Datos Fiscales se encuentre configurado su NIT, independientemente si posee cargado el certificado propio ó el de The factory HKA:
[[Archivo:ConfigDatosFiscales.png|800px|sinmarco|centro|Configurar Datos Fiscales]]
#:b Se debe tener solicitado la resolución de habilitación otorgada por la DIAN (resolución para set de pruebas de habilitación), esta resolución debe ser configurada en el portal web DEMO como se muestra en la siguiente imagen (tener en cuenta que la modalidad puede ser 'Manual con Prefijo' o 'Manual sin Prefijo', esto depende del ERP):
[[Archivo:ConfigResolucion.png|800px|sinmarco|centro|Configurar Resolución]]
#:@IMPORTANTE: El secuencial debe estar configurado con tipo de ambiente Producción2.1, por lo tanto no se deberá ingresar el campo setTestID. '''Se recomienda indicar un Rango Inicial a partir de un millón (1000000), esto con el fin de contar con un rango amplio para pruebas contra la DIAN sin afectar el rango a usar en las emisiones correspondientes al Set de Habilitación a realizarse en el ambiente productivo.'''
#:c. Solicitar a través de correo al equipo de Integración ó Soporte la activación del secuencial creado previamente en portal DEMO con la opción de envío a la DIAN:
:::* [mailto:integracion_fel_co@thefactoryhka.com integracion_fel_co@thefactoryhka.com] (Área de Integración)
:::* [mailto:soporte_fel_co@thefactoryhka.com soporte_fel_co@thefactoryhka.com] (Área de Soporte)
::: En el correo se deberá indicar NIT del Emisor y prefijo configurado, que pueden ser SETT ó SETP dependiendo del prefijo que la DIAN otorgó al Emisor para su habilitación.

<pre style="color: red">@NOTA: Las emisiones realizadas en ambiente de pruebas con el secuencial de habilitación no afectarán las emisiones correspondientes al set de habilitación en el ambiente productivo. Adicionalmente, estas emisiones no se consideran parte del set de habilitación.</pre>

Property code tables for document issuance - Direct Integration Manual Index

2022-03-03T15:03:34Z

Lvargas: /* Table 19 */

<includeonly>=</includeonly>==Tables of property codes for issuance of documents==<includeonly>=</includeonly>
In the following section you will find information regarding the different tables of property codes defined by the DIAN in the technical annex.
==Table 1==
{| class="wikitable" style="width: 100%;"
|+ Types of Documents
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.3. Type of Document: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
! style="color:white;background:#2F5496; text-align:center;"|Use
|- valign="center"
|-
|01
|Electronic Sales Invoice
|rowspan="4"|Types of Invoice
|-
|02
|Electronic Sales Invoice - export
|-
|03
|Transmission electronic document - type 03
|-
|04
|Electronic Sales Invoice - type 04
|-
|91
|Credit note
|rowspan="4"|Exclusive in document references (DocumentReference elements)
|-
|92
|Debit note
|}
|}
==Table 2==
{| class="wikitable" style="width: 100%;"
|+ Operation types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.5. Operation types
For billss:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|10
|Start*
|-
|09
|AIU
|-
|11
|Mandates
|-
|12
|Transportation
|-
|13
|Exchange
|}
Note: (*) Value by default Health Operation

{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|}

For Credit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|20
|Note Credit that references an electronic invoice*
|-
|22
|Credit note without reference to invoices*
|-
|}
Note: (*) The default value is 20, the above means that if a value is not reported, it is assumed to be 20 and the corresponding set of validations will be applied. (*) Preferable for use of rebate notes or conditional discounts. Notes type 22 do not have rejection validation. Post Control Object. For Debit Notes:
For Debit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|30
|Note Debit that references an electronic invoice*
|-
|32
|Debit note without reference to invoices*
|-
|}
Note: The default value is 30, the above means that if a value is not reported, add 30 and apply the corresponding set of validations. Notes type 32 and 33 do not have rejection validation. Post Control Object.
|}
'''@IMPORTANT:''' Notes type 22 and 32 do not have rejection validation. (Post control object).

==Table 3==
{| class="wikitable" style="width: 100%;"
|+ Identification Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.1. Identification document (Type of Fiscal Identifier):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|11
|Civil registration
|-
|12
|ID card
|-
|13
|Certificate of Citizenship
|-
|21
|Alien Card
|-
|22
|Immigration certificate
|-
|31
|NIT
|-
|41
|Passport
|-
|42
|Foreign ID
|-
|47
|PEP
|-
|50
|NIT from another country
|-
|91
|NUIP*
|}
|}
'''@IMPORTANT:''' (*) It should only be used for the acquirer, since this type of document does not belong to the document types in the RUT database.

==Table 4==
{| class="wikitable" style="width: 100%;"
|+ Descount Code
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.8. Descount Codes
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|00
|Unconditional discount
|-
|01
|Conditional Discount
|}
|}
==Table 5==
{| class="wikitable" style="width: 100%;"
|+ TType of person
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Legal person and assimilated
|-
|2
|Natural person and assimilated
|}
|}
==Table 6==
{| class="wikitable" style="width: 100%;"
|+ Units of Measure
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.6. Units of amount: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|04
|small spray
|BIL
|trillion dollars
|HUR
|hour
|-
|05
|lift
|BJ
|bucket
|HY
|hundred yardas
|-
|08
|Lot Heat
|BK
|Basket
|IA
|Inch Pound
|-
|10
|group
|BL
|bullet
|IC
|count per inch
|-
|11
|equip
|BLD
|dry barrel
|IE
|person
|-
|13
|ration
|BLL
|barrel (EE.UU.)(petroleo, etc.)
|IF
|inches of water
|-
|14
|shot
|BO
|bottle
|II
|column inch
|-
|15
|stick
|BP
|hundred board feet
|IL
|inch per minute
|-
|16
|hundred and fifteen kg drum
|BQL
|becquerel
|IM
|printing
|-
|17
|hundred pound drum
|BR
|bar
|INH
|inch
|}
|}
'''@IMPORTANT:''' This catalog is more extensive, for more information refer to the section of the corresponding Annex.
==Table 7==
{| class="wikitable" style="width: 100%;"
|+ Reference pricing codes
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.9. Type of legal organization (Persons): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|Commercial value
|}
Note: For commercial samples or gifts, '01' must be sent in the field '''codigoTipoPrecio'''
|}
==Table 8==
{| class="wikitable" style="width: 100%;"
|+ Codes for products and services
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|To use
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Efficient Purchase: use content of the "Code" column
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Global Product Identification Numbers - GTIN
* Ver 8.2
* When there are fewer than 14 numbers in a data structure (for example, GTIN8), the numbers must be right-justified in a 14-digit field padded with zeros in the leftmost positions.
|-
|020
|rate item
|195
|style="text-align:left;"|rate item
|-
|999
|Taxpayer Adoption Standard
|
|style="text-align:left;"|
* The value in the @schemeName attribute will not be validated
* The @schemeAgencyID attribute must not be used
|}
Note: For commercial samples or gifts, '01' must be sent in the '''codigoTipoPrecio''' field.
'''@IMPORTANT:''' For more information on the code for products and services, refer to the section of the corresponding Annex.
==Table 9==
{| class="wikitable" style="width: 100%;"
|+ Credit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.4. Correction concept for credit notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Partial return of goods and/or partial non-acceptance of service
|-
|2
|style="text-align:left;"|Electronic invoice cancellation
|-
|3
|style="text-align:left;"|Rebate or partial or total discount
|-
|4
|style="text-align:left;"|Price Adjust
|-
|5
|style="text-align:left;"|others
|}
|}

==Table 10==
{| class="wikitable" style="width: 100%;"
|+ Debit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.6. Concept of Correction for Debit Notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Interests
|-
|2
|style="text-align:left;"|Expenses receivable
|-
|3
|style="text-align:left;"|Value change
|-
|4
|style="text-align:left;"|others
|}
==Table 11==
{| class="wikitable" style="width: 100%;"
|+ Tax Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identifier
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Value Added Tax
|-
|02
|IC
|style="text-align:left;"|Consumption Tax
|-
|03
|ICA
|style="text-align:left;"|Industry, Commerce and Notice Tax
|-
|04
|INC
|style="text-align:left;"|National Consumption Tax
|-
|05
|ReteIVA
|style="text-align:left;"|Withholding on IVA
|-
|06
|ReteRenta
|style="text-align:left;"|Withholding on Income
|-
|07
|ReteICA
|style="text-align:left;"|Withholding on the ICA
|-
|08
|IC Porcentual
|style="text-align:left;"|Tax on Consumption of Plastic Bag
|-
|20
|FtoHorticultura
|style="text-align:left;"|Fruit and Vegetable Promotion Fee
|-
|21
|Timbre
|style="text-align:left;"|Stamp Tax
|-
|22
|INC Bolsas
|style="text-align:left;"|National Tax on Plastic Bag Consumption
|-
|23
|INCarbono
|style="text-align:left;"|National Carbon Tax
|-
|24
|INCombustibles
|style="text-align:left;"|National Tax on Fuels
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Surcharge on fuels
|-
|26
|Sordicom
|style="text-align:left;"|Retail Contribution (Fuels)
|-
|30
|IC Datos
|style="text-align:left;"|Data Consumption Tax
|-
|ZY
|No causa
|style="text-align:left;"|Not responsible for tax
|-
|ZZ
|Name of the tax figure
|style="text-align:left;"|Other taxes, rates, contributions, and similar
|}
|}
==Table 12==
{| class="wikitable" style="width: 100%;"
|+ Tax Fees
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.8. Rate Tables for Tax
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Reporting tax
! style="color:white;background:#2F5496; text-align:center;"|Possible values for the cbc:Percent field
The rate to report will depend on the tax aspect of the reported tax.
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|rate
| 
|-
| Concept|| rate || (cbc:Percent)||  
|-
| Exempt|| 0.00 ||  |
|-
| Goods/Services at 5|| 5.00 ||  |
|-
| Contracts signed with the state before law 1819|| 16.00 ||  
|-
| General rate|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|rate
| 
|-
| Item           || (cbc:Percent)||  
|-
| Special rate|| 2.00 ||  
|-
| Special rate|| 4.00 ||  |
|-
| General rate|| 8.00 ||  |
|-
| Special rate|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|}
|}
@IMPORTANT: This catalog '''fees for Tax''' is more extensive, for more information refer to the section of the corresponding Annex.

==Table 13==
{| class="wikitable" style="width: 100%;"
|+ Payment methods
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.2. Payment methods: cbc:PaymentMeansCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|1
|Instrument not defined
|39
|Corporate Exchange Business Loan (CTX)
|-
|2
|Crédito ACH
|40
|Business Debit Corporate Exchange (CTX)
|-
|3
|Débito ACH
|41
|Concentration Cash/Credit Disbursement Plus (CCD+)
|-
|4
|ACH demand debit reversal
|42
|Bank collection
|-
|5
|Reversal of ACH demand credit
|43
|Cash concentration / Debit plus Disbursement (CCD+)
|-
|6
|ACH Demand Credit
|44
|Exchange Note
|-
|7
|ACH demand debit
|45
|Transfer Bank Credit
|-
|8
|Maintain
|46
|Interbank Debit Transfer
|-
|9
|National or Regional Clearing
|47
|Bank Debit Transfer
|-
|10
|Cash
|48
|Credit card
|-
|11
|Credit Savings Reversal
|49
|Debit Card
|-
|12
|Reversion Debit Savings
|50
|Postdraft
|-
|13
|Savings Credit
|51
|French banking standard Telex
|-
|14
|Debit Saving
|52
|Urgent business payment
|-
|15
|Bookentry Credit
|53
|Urgent Treasury Payment
|-
|16
|Bookentry Debit
|60
|Note promisoria
|-
|17
|Concentration of demand in cash/Credit Disbursement (CCD)
|61
|Promissory note signed by the creditor
|-
|18
|Concentration of demand in cash / Disbursement (CCD) debit
|62
|Promissory note signed by the creditor, endorsed by the bank
|-
|19
|Corporate Business Payment Credit (CTP)
|63
|Promissory note signed by the creditor, endorsed by a third party
|-
|20
|Check
|64
|Note promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Promissory note signed by a bank guaranteed by another bank
|-
|22
|Certified bank project
|66
|Signed promissory note
|-
|23
| Bank check
|67
|Promissory note signed by a third party guaranteed by a bank
|-
|24
|Foreign exchange note awaiting acceptance
|70
|Withdrawal of note by creditor
|-
|25
|Certified check
|71
|Bonds
|-
|26
|Local Check
|72
|Vouchers
|-
|27
|Debit Payment Corporate Business (CTP)
|74
|Withdrawal of note by the creditor on a bank
|-
|28
|Credit Business Corporate Exchange (CTX)
|75
|Withdrawal of note by the creditor, guaranteed by another bank
|-
|29
|Debit Business Corporate Exchange (CTX)
|76
|Withdrawal of note by the creditor, on a bank guaranteed by a third party
|-
|30
|Credit Transfer
|77
|Withdrawal of a note by the creditor on a third party
|-
|31
|Transfer Debit
|78
|Withdrawal of a note by the creditor on a third party guaranteed by a bank
|-
|32
|Concentration Cash / Disbursement Credit plus (CCD+)
|91
|Transferable bank note
|-
|33
|Concentration Cash / Disbursement Debit plus (CCD+)
|92
|Local transferable check
|-
|34
|Pre-arranged payment and deposit (PPD)
|93
|Referenced draft
|-
|35
|Cash concentration savings / Credit Disbursement (CCD)
|94
|Urgent transfer
|-
|36
|Cash concentration savings / Credit Disbursement (CCD)
|95
|Open format draft
|-
|37
|Payment Corporate Business Savings Credit (CTP)
|96
|Requested payment method not used
|-
|38
|Payment Corporate Business Debit Savings (CTP)
|97
|Clearing between partners
|-
|
|
|ZZZ
|Mutual Agreement
|}
|}
==Table 14==
{| class="wikitable" style="width: 100%;"
|+ Form to Payment Method
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.1. Payment methods: cbc:PaymentMeans/ID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Cash
|-
|2
|Credit
|}
|}
==Table 15==
{| class="wikitable" style="width: 100%;"
|+ Terms of delivery (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.6. Terms of delivery (INCOTERMS): …/cbc:LossRiskResponsibilityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|CFR
|Cost & Freight
|-
|CIF
|Cost, freight and insurance
|-
|CIP
|Transport and Insurance Paid to
|-
|CPT
|Carriage Paid To
|-
|DAP
|Delivered to Place
|-
|DAT
|Delivered at Terminal
|-
|DDP
|Delivered Duty Paid
|-
|EXW
|In Factory
|-
|FAS
|Free alongside ship
|-
|FCA
|Freight Carrier
|-
|FOB
|Free on board
|}
|}
==Table 16==
{| class="wikitable" style="width: 100%;"
|+ Departments (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.2. Departments (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}
==Table 17==
{| class="wikitable" style="width: 100%;"
|+ Tax responsibilities
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.7. Tax responsibilities: cbc:TaxLevelCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|0-13
|Major contributor
|-
|0-15
|Self-Locking
|-
|0-23
|Sales tax withholding agent
|-
|0-47
|Simple Taxation System – SIMPLE
|-
|R-99-PN
|Does not apply - Others
|}
|}
==Table 18==
{| class="wikitable" style="width: 100%;"
|+ tax details
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Taxes: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|IVA
|-
|04
|INC
|-
|ZA
|IVA e INC
|-
|ZZ
|Does not apply
|}
|}
==Table 19==
{| class="wikitable" style="width: 100%;"
|+ Municipality
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.3. Municipality: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Department Code
! style="color:white;background:#2F5496; text-align:center;"|Municipal Code
! style="color:white;background:#2F5496; text-align:center;"|Department Name
! style="color:white;background:#2F5496; text-align:center;"|Municipal Name
|- valign="center"
|-
|05
|05044
|Antioquia
|ANZÁ
|-
|05
|05045
|Antioquia
|APARTADÓ
|-
|05
|05051
|Antioquia
|ARBOLETES
|-
|05
|05055
|Antioquia
|ARGELIA
|-
|05
|05059
|Antioquia
|ARMENIA
|-
|05
|05079
|Antioquia
|BARBOSA
|-
|05
|05086
|Antioquia
|BELMIRA
|-
|05
|05088
|Antioquia
|BELLO
|-
|05
|05091
|Antioquia
|BETANIA
|-
|05
|05093
|Antioquia
|BETULIA
|-
|05
|05101
|Antioquia
|CIUDAD BOLÍVAR
|-
|05
|05107
|Antioquia
|BRICEÑO
|-
|05
|05113
|Antioquia
|BURITICÁ
|-
|05
|05120
|Antioquia
|CÁCERES
|-
|05
|05125
|Antioquia
|CAICEDO
|-
|05
|05129
|Antioquia
|CALDAS
|-
|05
|05134
|Antioquia
|CAMPAMENTO
|-
|05
|05138
|Antioquia
|CAÑASGORDAS
|-
|05
|05142
|Antioquia
|CARACOLÍ
|-
|05
|05145
|Antioquia
|CARAMANTA
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANT:''' This catalog ''' municipalities''' is more extensive, for more information refer to the section of the corresponding Annex.

==Table 20==
{| class="wikitable" style="width: 100%;"
|+ Postal zone
|- valign="center"
|colspan="2"|Anex 1.7-2020 - 6.4.4. Reference to other documents cbc:PostalZone 
In Colombia, the postal code consists of 6 digits (example: 578986) that initially indicate the geographical position, followed by the routing and finally the one that locates us within the postal area, as follows:

'''National Departments''' 
The first two digits represent the national departments, using the current Dane coding. Codes less than 10 must start with a leading zero.

'''Departmental routing postal zones''' 
The third and fourth position define the routing postal zones to facilitate the classification through the Postal Code: 00 is reserved for the capital of the department. From 01 to 89, each department can be divided into up to 89 postal routing zones.

'''Postal district by municipality or locality''' 
The last two positions of the National Postal Code allow one hundred postal districts to be assigned to each of the ten postal zones created in each department. That is, up to a thousand different districts can be assigned in each department, for a total of thirty-three thousand at the national level.
|}
@IMPORTANT: For more information, refer to the corresponding Annex section.
==Table 21==
{| class="wikitable" style="width: 100%;"
|+Reference to non-tax documents
|- valign="center"
|colspan="2"|'''Anex 1.8 - 13.1.4. Reference to non-tax documents: cbc:DocumentTypeCode''' 
This element refers to the'''xpath /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode'''. These documents represent commercial and mercantile actions that protect or support transactions related to this electronic document.

The XML electronic documents adopted by the DIAN should not be included in this fragment since these documents do not contain the standard identifications such as CUFE or CUDE.

As it is a delivery order, the '''OrderReference''', element group must be used. When reporting more than one, the AdditionalDocumentReference group must be available.

This field of this group of information is optional to reference commercial issues at the will of the electronic biller, therefore, the codes are assigned by it.
|}

<center>'''TABLES OF CODES FOR THE ISSUANCE OF DOCUMENTS IN THE HEALTH SECTOR'''</center>
==Table 22==
{| class="wikitable" style="width: 100%;"
|+ Identification Document Type- Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Abv
! style="color:white;background:#2F5496; text-align:center;"|Type of Identification Document
|- valign="center"
|-
|CC
|Citizenship card
|-
|CE
|Immigration Certificate
|-
|CD
|Diplomatic ID
|-
|PA
|Passport
|-
|SC
|Safe conduct
|-
|PE
|special stay permit
|-
|RC
|Civil registration of birth
|-
|TI
|Identity Card
|-
|CN
|Live birth certificate
|-
|AS
|Adult Unidentified
|-
|MS
|Unidentified Minor
|-
|DE
|Foreign Document
|-
|SI
|Without Identification
|}
|}
==Table 23==
{| class="wikitable" style="width: 100%;"
|+ User Type - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|User type
|- valign="center"
|-
|01
|Contributing taxpayer
|-
|02
|Contributory beneficiary
|-
|03
|Additional contributory
|-
|04
|Subsidised
|-
|05
|Not regim
|-
|06
|Special or Contributing Exception
|-
|07
|Special or Exception beneficiary
|-
|08
|Individual
|-
|09
|Policyholder/Protected ARL
|-
|10
|Policyholder/Protected SOAT
|-
|11
|Policy holder/Protected voluntary health plans
|}
|}
==Table 24==
{| class="wikitable" style="width: 100%;"
|+ Hiring Modalities - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Hiring Modalities
|- valign="center"
|-
|01
|Package / Basket / Comprehensive Health Set
|-
|02
|Diagnosis-related Groups
|-
|03
|Comprehensive by risk group
|-
|04
|Payment by contact by specialty
|-
|05
|Payment per scenario of care
|-
|06
|Payment per service type
|-
|07
|Prospective global payment per episode
|-
|08
|Global prospective payment by risk group
|-
|09
|Prospective lump sum payment by specialty
|-
|10
|Prospective global payment by level of complexity
|-
|11
|Capacitation
|-
|12
|For service
|}
|}
==Table 25==
{| class="wikitable" style="width: 100%;"
|+ CService coverage or plan - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Service coverage or plan
|- valign="center"
|-
|01
|Health benefit plan financed by UPC
|-
|02
|Maximum budget
|-
|03
|EPS/EOC premium, uninsured SOAT
|-
|04
|Coverage SOAT Policy
|-
|05
|ARL cover
|-
|06
|ADRES coverage
|-
|07
|Public Health Cover
|-
|08
|Coverage of the territorial entity, supply resources
|-
|09
|Emergencies migrant population
|-
|10
|Supplemental health plan
|-
|11
|Prepaid Medical Plan
|-
|12
|Other health policies
|-
|13
|Special Regime Coverage or Exception
|-
|14
|National Health Fund Coverage for Persons Deprived of Liberty
|-
|15
|Private
|}
|}
==Table 26==
{| class="wikitable" style="width: 100%;"
|+ Collection Concepts
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|16
|Copayment
|-
|17
|Moderator Fee
|-
|18
|Recovery Fee
|-
|19
|Shared plans in voluntary health plans
|}
|}
==Table 27==
{| class="wikitable" style="width: 100%;"
|+ Scenario Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|Record of the Concept of collection to the patient
|-
|2
|Registration of the concept of accreditation to the EPS
|-
|3
|Record of operations without accreditation to the EPS
|-
|4
|Issuance of FEL without prior collection
|-
|5
|Including in a FEL the value to be credited for the collection
|}
|}
==Table 28==
{| class="wikitable" style="width: 100%;"
|+ Additional Data Fields
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Label
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|CODIGO_PRESTADOR
|Code assigned in the General System of Social Security in Health (SGSSS) to health service providers that are in the Special Registry of Health Service Providers (REPS) or the Code assigned by the Ministry of Health and Social Protection for public health laboratories.
|-
|2
|TIPO_DOCUMENTO_IDENTIFICACION
|User identification type
:[[Tables of property codes for issuance of documents - Direct Integration Manual Index#Table 22|Table 22]]
|-
|3
|NUMERO_DOCUMENTO_IDENTIFICACION
|Registration of the identification document number according to the type of user document
|-
|4
|PRIMER_APELLIDO
|First surname of the user as specified in the identification document.
|-
|5
|SEGUNDO_APELLIDO
|Second surname of the user as specified in the identification document.
|-
|6
|PRIMER_NOMBRE
|User's first name as specified in the identification document
|-
|7
|SEGUNDO_NOMBRE
|Second name of the user according to what is specified in the identification document
|-
|8
|TIPO_USUARIO
|Registration of the person's affiliation condition or relationship with the coverage or benefit plan.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 23|Table 23]]
|-
|9
|MODALIDAD_CONTRATACION
|Registration of the contracting and payment modality agreed to be billed. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 24|Table 24]]
|
|-
|10
|COBERTURA_PLAN_BENEFICIOS
|Registration of the entity responsible for financing the coverage or benefit plan. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 25|Table 25]]
|-
|11
|NUMERO_AUTORIZACION
|Compulsory: When there is the response authorization number or the request number, as the case may be. For emergencies, SOAT and ARL are empty
|-
|12
|NUMERO_MIPRES
|Assigned by MIPRES
|-
|13
|NUMERO_ENTREGA_MIPRES
|Assigned by MIPRES
|-
|14
|NUMERO_CONTRATO
|Number of the billing contract
|-
|15
|NUMERO_POLIZA
|Number of SOAT policy or voluntary health plans. Mandatory: When it comes to SOAT services or voluntary health plans. Diligence when it comes to care for a traffic accident or for care as a private individual for a health policy
|-
|16
|COPAGO
|Value actually paid by the user and collected by the service provider
|-
|17
|CUOTA_MODERADORA
|Value actually paid by the user and collected by the service provider
|-
|18
|CUOTA_RECUPERACION
|Value actually paid by the user and collected by the service provider
|-
|19
|PAGOS_COMPARTIDOS
|Value actually paid by the user and collected by the service provider
|}
|}

Property code tables for document issuance - Direct Integration Manual Index

2022-03-03T14:59:49Z

Lvargas:

<includeonly>=</includeonly>==Tables of property codes for issuance of documents==<includeonly>=</includeonly>
In the following section you will find information regarding the different tables of property codes defined by the DIAN in the technical annex.
==Table 1==
{| class="wikitable" style="width: 100%;"
|+ Types of Documents
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.3. Type of Document: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
! style="color:white;background:#2F5496; text-align:center;"|Use
|- valign="center"
|-
|01
|Electronic Sales Invoice
|rowspan="4"|Types of Invoice
|-
|02
|Electronic Sales Invoice - export
|-
|03
|Transmission electronic document - type 03
|-
|04
|Electronic Sales Invoice - type 04
|-
|91
|Credit note
|rowspan="4"|Exclusive in document references (DocumentReference elements)
|-
|92
|Debit note
|}
|}
==Table 2==
{| class="wikitable" style="width: 100%;"
|+ Operation types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.5. Operation types
For billss:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|10
|Start*
|-
|09
|AIU
|-
|11
|Mandates
|-
|12
|Transportation
|-
|13
|Exchange
|}
Note: (*) Value by default Health Operation

{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|}

For Credit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|20
|Note Credit that references an electronic invoice*
|-
|22
|Credit note without reference to invoices*
|-
|}
Note: (*) The default value is 20, the above means that if a value is not reported, it is assumed to be 20 and the corresponding set of validations will be applied. (*) Preferable for use of rebate notes or conditional discounts. Notes type 22 do not have rejection validation. Post Control Object. For Debit Notes:
For Debit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|30
|Note Debit that references an electronic invoice*
|-
|32
|Debit note without reference to invoices*
|-
|}
Note: The default value is 30, the above means that if a value is not reported, add 30 and apply the corresponding set of validations. Notes type 32 and 33 do not have rejection validation. Post Control Object.
|}
'''@IMPORTANT:''' Notes type 22 and 32 do not have rejection validation. (Post control object).

==Table 3==
{| class="wikitable" style="width: 100%;"
|+ Identification Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.1. Identification document (Type of Fiscal Identifier):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|11
|Civil registration
|-
|12
|ID card
|-
|13
|Certificate of Citizenship
|-
|21
|Alien Card
|-
|22
|Immigration certificate
|-
|31
|NIT
|-
|41
|Passport
|-
|42
|Foreign ID
|-
|47
|PEP
|-
|50
|NIT from another country
|-
|91
|NUIP*
|}
|}
'''@IMPORTANT:''' (*) It should only be used for the acquirer, since this type of document does not belong to the document types in the RUT database.

==Table 4==
{| class="wikitable" style="width: 100%;"
|+ Descount Code
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.8. Descount Codes
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|00
|Unconditional discount
|-
|01
|Conditional Discount
|}
|}
==Table 5==
{| class="wikitable" style="width: 100%;"
|+ TType of person
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Legal person and assimilated
|-
|2
|Natural person and assimilated
|}
|}
==Table 6==
{| class="wikitable" style="width: 100%;"
|+ Units of Measure
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.6. Units of amount: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|04
|small spray
|BIL
|trillion dollars
|HUR
|hour
|-
|05
|lift
|BJ
|bucket
|HY
|hundred yardas
|-
|08
|Lot Heat
|BK
|Basket
|IA
|Inch Pound
|-
|10
|group
|BL
|bullet
|IC
|count per inch
|-
|11
|equip
|BLD
|dry barrel
|IE
|person
|-
|13
|ration
|BLL
|barrel (EE.UU.)(petroleo, etc.)
|IF
|inches of water
|-
|14
|shot
|BO
|bottle
|II
|column inch
|-
|15
|stick
|BP
|hundred board feet
|IL
|inch per minute
|-
|16
|hundred and fifteen kg drum
|BQL
|becquerel
|IM
|printing
|-
|17
|hundred pound drum
|BR
|bar
|INH
|inch
|}
|}
'''@IMPORTANT:''' This catalog is more extensive, for more information refer to the section of the corresponding Annex.
==Table 7==
{| class="wikitable" style="width: 100%;"
|+ Reference pricing codes
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.9. Type of legal organization (Persons): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|Commercial value
|}
Note: For commercial samples or gifts, '01' must be sent in the field '''codigoTipoPrecio'''
|}
==Table 8==
{| class="wikitable" style="width: 100%;"
|+ Codes for products and services
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|To use
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Efficient Purchase: use content of the "Code" column
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Global Product Identification Numbers - GTIN
* Ver 8.2
* When there are fewer than 14 numbers in a data structure (for example, GTIN8), the numbers must be right-justified in a 14-digit field padded with zeros in the leftmost positions.
|-
|020
|rate item
|195
|style="text-align:left;"|rate item
|-
|999
|Taxpayer Adoption Standard
|
|style="text-align:left;"|
* The value in the @schemeName attribute will not be validated
* The @schemeAgencyID attribute must not be used
|}
Note: For commercial samples or gifts, '01' must be sent in the '''codigoTipoPrecio''' field.
'''@IMPORTANT:''' For more information on the code for products and services, refer to the section of the corresponding Annex.
==Table 9==
{| class="wikitable" style="width: 100%;"
|+ Credit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.4. Correction concept for credit notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Partial return of goods and/or partial non-acceptance of service
|-
|2
|style="text-align:left;"|Electronic invoice cancellation
|-
|3
|style="text-align:left;"|Rebate or partial or total discount
|-
|4
|style="text-align:left;"|Price Adjust
|-
|5
|style="text-align:left;"|others
|}
|}

==Table 10==
{| class="wikitable" style="width: 100%;"
|+ Debit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.6. Concept of Correction for Debit Notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Interests
|-
|2
|style="text-align:left;"|Expenses receivable
|-
|3
|style="text-align:left;"|Value change
|-
|4
|style="text-align:left;"|others
|}
==Table 11==
{| class="wikitable" style="width: 100%;"
|+ Tax Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identifier
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Value Added Tax
|-
|02
|IC
|style="text-align:left;"|Consumption Tax
|-
|03
|ICA
|style="text-align:left;"|Industry, Commerce and Notice Tax
|-
|04
|INC
|style="text-align:left;"|National Consumption Tax
|-
|05
|ReteIVA
|style="text-align:left;"|Withholding on IVA
|-
|06
|ReteRenta
|style="text-align:left;"|Withholding on Income
|-
|07
|ReteICA
|style="text-align:left;"|Withholding on the ICA
|-
|08
|IC Porcentual
|style="text-align:left;"|Tax on Consumption of Plastic Bag
|-
|20
|FtoHorticultura
|style="text-align:left;"|Fruit and Vegetable Promotion Fee
|-
|21
|Timbre
|style="text-align:left;"|Stamp Tax
|-
|22
|INC Bolsas
|style="text-align:left;"|National Tax on Plastic Bag Consumption
|-
|23
|INCarbono
|style="text-align:left;"|National Carbon Tax
|-
|24
|INCombustibles
|style="text-align:left;"|National Tax on Fuels
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Surcharge on fuels
|-
|26
|Sordicom
|style="text-align:left;"|Retail Contribution (Fuels)
|-
|30
|IC Datos
|style="text-align:left;"|Data Consumption Tax
|-
|ZY
|No causa
|style="text-align:left;"|Not responsible for tax
|-
|ZZ
|Name of the tax figure
|style="text-align:left;"|Other taxes, rates, contributions, and similar
|}
|}
==Table 12==
{| class="wikitable" style="width: 100%;"
|+ Tax Fees
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.8. Rate Tables for Tax
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Reporting tax
! style="color:white;background:#2F5496; text-align:center;"|Possible values for the cbc:Percent field
The rate to report will depend on the tax aspect of the reported tax.
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|rate
| 
|-
| Concept|| rate || (cbc:Percent)||  
|-
| Exempt|| 0.00 ||  |
|-
| Goods/Services at 5|| 5.00 ||  |
|-
| Contracts signed with the state before law 1819|| 16.00 ||  
|-
| General rate|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|rate
| 
|-
| Item           || (cbc:Percent)||  
|-
| Special rate|| 2.00 ||  
|-
| Special rate|| 4.00 ||  |
|-
| General rate|| 8.00 ||  |
|-
| Special rate|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|}
|}
@IMPORTANT: This catalog '''fees for Tax''' is more extensive, for more information refer to the section of the corresponding Annex.

==Table 13==
{| class="wikitable" style="width: 100%;"
|+ Payment methods
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.2. Payment methods: cbc:PaymentMeansCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|1
|Instrument not defined
|39
|Corporate Exchange Business Loan (CTX)
|-
|2
|Crédito ACH
|40
|Business Debit Corporate Exchange (CTX)
|-
|3
|Débito ACH
|41
|Concentration Cash/Credit Disbursement Plus (CCD+)
|-
|4
|ACH demand debit reversal
|42
|Bank collection
|-
|5
|Reversal of ACH demand credit
|43
|Cash concentration / Debit plus Disbursement (CCD+)
|-
|6
|ACH Demand Credit
|44
|Exchange Note
|-
|7
|ACH demand debit
|45
|Transfer Bank Credit
|-
|8
|Maintain
|46
|Interbank Debit Transfer
|-
|9
|National or Regional Clearing
|47
|Bank Debit Transfer
|-
|10
|Cash
|48
|Credit card
|-
|11
|Credit Savings Reversal
|49
|Debit Card
|-
|12
|Reversion Debit Savings
|50
|Postdraft
|-
|13
|Savings Credit
|51
|French banking standard Telex
|-
|14
|Debit Saving
|52
|Urgent business payment
|-
|15
|Bookentry Credit
|53
|Urgent Treasury Payment
|-
|16
|Bookentry Debit
|60
|Note promisoria
|-
|17
|Concentration of demand in cash/Credit Disbursement (CCD)
|61
|Promissory note signed by the creditor
|-
|18
|Concentration of demand in cash / Disbursement (CCD) debit
|62
|Promissory note signed by the creditor, endorsed by the bank
|-
|19
|Corporate Business Payment Credit (CTP)
|63
|Promissory note signed by the creditor, endorsed by a third party
|-
|20
|Check
|64
|Note promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Promissory note signed by a bank guaranteed by another bank
|-
|22
|Certified bank project
|66
|Signed promissory note
|-
|23
| Bank check
|67
|Promissory note signed by a third party guaranteed by a bank
|-
|24
|Foreign exchange note awaiting acceptance
|70
|Withdrawal of note by creditor
|-
|25
|Certified check
|71
|Bonds
|-
|26
|Local Check
|72
|Vouchers
|-
|27
|Debit Payment Corporate Business (CTP)
|74
|Withdrawal of note by the creditor on a bank
|-
|28
|Credit Business Corporate Exchange (CTX)
|75
|Withdrawal of note by the creditor, guaranteed by another bank
|-
|29
|Debit Business Corporate Exchange (CTX)
|76
|Withdrawal of note by the creditor, on a bank guaranteed by a third party
|-
|30
|Credit Transfer
|77
|Withdrawal of a note by the creditor on a third party
|-
|31
|Transfer Debit
|78
|Withdrawal of a note by the creditor on a third party guaranteed by a bank
|-
|32
|Concentration Cash / Disbursement Credit plus (CCD+)
|91
|Transferable bank note
|-
|33
|Concentration Cash / Disbursement Debit plus (CCD+)
|92
|Local transferable check
|-
|34
|Pre-arranged payment and deposit (PPD)
|93
|Referenced draft
|-
|35
|Cash concentration savings / Credit Disbursement (CCD)
|94
|Urgent transfer
|-
|36
|Cash concentration savings / Credit Disbursement (CCD)
|95
|Open format draft
|-
|37
|Payment Corporate Business Savings Credit (CTP)
|96
|Requested payment method not used
|-
|38
|Payment Corporate Business Debit Savings (CTP)
|97
|Clearing between partners
|-
|
|
|ZZZ
|Mutual Agreement
|}
|}
==Table 14==
{| class="wikitable" style="width: 100%;"
|+ Form to Payment Method
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.1. Payment methods: cbc:PaymentMeans/ID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Cash
|-
|2
|Credit
|}
|}
==Table 15==
{| class="wikitable" style="width: 100%;"
|+ Terms of delivery (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.6. Terms of delivery (INCOTERMS): …/cbc:LossRiskResponsibilityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|CFR
|Cost & Freight
|-
|CIF
|Cost, freight and insurance
|-
|CIP
|Transport and Insurance Paid to
|-
|CPT
|Carriage Paid To
|-
|DAP
|Delivered to Place
|-
|DAT
|Delivered at Terminal
|-
|DDP
|Delivered Duty Paid
|-
|EXW
|In Factory
|-
|FAS
|Free alongside ship
|-
|FCA
|Freight Carrier
|-
|FOB
|Free on board
|}
|}
==Table 16==
{| class="wikitable" style="width: 100%;"
|+ Departments (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.2. Departments (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}
==Table 17==
{| class="wikitable" style="width: 100%;"
|+ Tax responsibilities
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.7. Tax responsibilities: cbc:TaxLevelCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|0-13
|Major contributor
|-
|0-15
|Self-Locking
|-
|0-23
|Sales tax withholding agent
|-
|0-47
|Simple Taxation System – SIMPLE
|-
|R-99-PN
|Does not apply - Others
|}
|}
==Table 18==
{| class="wikitable" style="width: 100%;"
|+ tax details
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Taxes: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|IVA
|-
|04
|INC
|-
|ZA
|IVA e INC
|-
|ZZ
|Does not apply
|}
|}
==Table 19==
{| class="wikitable" style="width: 100%;"
|+ Municipality
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.3. Municipality: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code Department
! style="color:white;background:#2F5496; text-align:center;"|Code Municipal
! style="color:white;background:#2F5496; text-align:center;"|Name Department
! style="color:white;background:#2F5496; text-align:center;"|Name Municipal
|- valign="center"
|-
|05
|05044
|Antioquia
|ANZÁ
|-
|05
|05045
|Antioquia
|APARTADÓ
|-
|05
|05051
|Antioquia
|ARBOLETES
|-
|05
|05055
|Antioquia
|ARGELIA
|-
|05
|05059
|Antioquia
|ARMENIA
|-
|05
|05079
|Antioquia
|BARBOSA
|-
|05
|05086
|Antioquia
|BELMIRA
|-
|05
|05088
|Antioquia
|BELLO
|-
|05
|05091
|Antioquia
|BETANIA
|-
|05
|05093
|Antioquia
|BETULIA
|-
|05
|05101
|Antioquia
|CIUDAD BOLÍVAR
|-
|05
|05107
|Antioquia
|BRICEÑO
|-
|05
|05113
|Antioquia
|BURITICÁ
|-
|05
|05120
|Antioquia
|CÁCERES
|-
|05
|05125
|Antioquia
|CAICEDO
|-
|05
|05129
|Antioquia
|CALDAS
|-
|05
|05134
|Antioquia
|CAMPAMENTO
|-
|05
|05138
|Antioquia
|CAÑASGORDAS
|-
|05
|05142
|Antioquia
|CARACOLÍ
|-
|05
|05145
|Antioquia
|CARAMANTA
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANT:''' This catalog ''' municipalities''' is more extensive, for more information refer to the section of the corresponding Annex.
==Table 20==
{| class="wikitable" style="width: 100%;"
|+ Postal zone
|- valign="center"
|colspan="2"|Anex 1.7-2020 - 6.4.4. Reference to other documents cbc:PostalZone 
In Colombia, the postal code consists of 6 digits (example: 578986) that initially indicate the geographical position, followed by the routing and finally the one that locates us within the postal area, as follows:

'''National Departments''' 
The first two digits represent the national departments, using the current Dane coding. Codes less than 10 must start with a leading zero.

'''Departmental routing postal zones''' 
The third and fourth position define the routing postal zones to facilitate the classification through the Postal Code: 00 is reserved for the capital of the department. From 01 to 89, each department can be divided into up to 89 postal routing zones.

'''Postal district by municipality or locality''' 
The last two positions of the National Postal Code allow one hundred postal districts to be assigned to each of the ten postal zones created in each department. That is, up to a thousand different districts can be assigned in each department, for a total of thirty-three thousand at the national level.
|}
@IMPORTANT: For more information, refer to the corresponding Annex section.
==Table 21==
{| class="wikitable" style="width: 100%;"
|+Reference to non-tax documents
|- valign="center"
|colspan="2"|'''Anex 1.8 - 13.1.4. Reference to non-tax documents: cbc:DocumentTypeCode''' 
This element refers to the'''xpath /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode'''. These documents represent commercial and mercantile actions that protect or support transactions related to this electronic document.

The XML electronic documents adopted by the DIAN should not be included in this fragment since these documents do not contain the standard identifications such as CUFE or CUDE.

As it is a delivery order, the '''OrderReference''', element group must be used. When reporting more than one, the AdditionalDocumentReference group must be available.

This field of this group of information is optional to reference commercial issues at the will of the electronic biller, therefore, the codes are assigned by it.
|}

<center>'''TABLES OF CODES FOR THE ISSUANCE OF DOCUMENTS IN THE HEALTH SECTOR'''</center>
==Table 22==
{| class="wikitable" style="width: 100%;"
|+ Identification Document Type- Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Abv
! style="color:white;background:#2F5496; text-align:center;"|Type of Identification Document
|- valign="center"
|-
|CC
|Citizenship card
|-
|CE
|Immigration Certificate
|-
|CD
|Diplomatic ID
|-
|PA
|Passport
|-
|SC
|Safe conduct
|-
|PE
|special stay permit
|-
|RC
|Civil registration of birth
|-
|TI
|Identity Card
|-
|CN
|Live birth certificate
|-
|AS
|Adult Unidentified
|-
|MS
|Unidentified Minor
|-
|DE
|Foreign Document
|-
|SI
|Without Identification
|}
|}
==Table 23==
{| class="wikitable" style="width: 100%;"
|+ User Type - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|User type
|- valign="center"
|-
|01
|Contributing taxpayer
|-
|02
|Contributory beneficiary
|-
|03
|Additional contributory
|-
|04
|Subsidised
|-
|05
|Not regim
|-
|06
|Special or Contributing Exception
|-
|07
|Special or Exception beneficiary
|-
|08
|Individual
|-
|09
|Policyholder/Protected ARL
|-
|10
|Policyholder/Protected SOAT
|-
|11
|Policy holder/Protected voluntary health plans
|}
|}
==Table 24==
{| class="wikitable" style="width: 100%;"
|+ Hiring Modalities - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Hiring Modalities
|- valign="center"
|-
|01
|Package / Basket / Comprehensive Health Set
|-
|02
|Diagnosis-related Groups
|-
|03
|Comprehensive by risk group
|-
|04
|Payment by contact by specialty
|-
|05
|Payment per scenario of care
|-
|06
|Payment per service type
|-
|07
|Prospective global payment per episode
|-
|08
|Global prospective payment by risk group
|-
|09
|Prospective lump sum payment by specialty
|-
|10
|Prospective global payment by level of complexity
|-
|11
|Capacitation
|-
|12
|For service
|}
|}
==Table 25==
{| class="wikitable" style="width: 100%;"
|+ CService coverage or plan - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Service coverage or plan
|- valign="center"
|-
|01
|Health benefit plan financed by UPC
|-
|02
|Maximum budget
|-
|03
|EPS/EOC premium, uninsured SOAT
|-
|04
|Coverage SOAT Policy
|-
|05
|ARL cover
|-
|06
|ADRES coverage
|-
|07
|Public Health Cover
|-
|08
|Coverage of the territorial entity, supply resources
|-
|09
|Emergencies migrant population
|-
|10
|Supplemental health plan
|-
|11
|Prepaid Medical Plan
|-
|12
|Other health policies
|-
|13
|Special Regime Coverage or Exception
|-
|14
|National Health Fund Coverage for Persons Deprived of Liberty
|-
|15
|Private
|}
|}
==Table 26==
{| class="wikitable" style="width: 100%;"
|+ Collection Concepts
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|16
|Copayment
|-
|17
|Moderator Fee
|-
|18
|Recovery Fee
|-
|19
|Shared plans in voluntary health plans
|}
|}
==Table 27==
{| class="wikitable" style="width: 100%;"
|+ Scenario Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|Record of the Concept of collection to the patient
|-
|2
|Registration of the concept of accreditation to the EPS
|-
|3
|Record of operations without accreditation to the EPS
|-
|4
|Issuance of FEL without prior collection
|-
|5
|Including in a FEL the value to be credited for the collection
|}
|}
==Table 28==
{| class="wikitable" style="width: 100%;"
|+ Additional Data Fields
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Label
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|CODIGO_PRESTADOR
|Code assigned in the General System of Social Security in Health (SGSSS) to health service providers that are in the Special Registry of Health Service Providers (REPS) or the Code assigned by the Ministry of Health and Social Protection for public health laboratories.
|-
|2
|TIPO_DOCUMENTO_IDENTIFICACION
|User identification type
:[[Tables of property codes for issuance of documents - Direct Integration Manual Index#Table 22|Table 22]]
|-
|3
|NUMERO_DOCUMENTO_IDENTIFICACION
|Registration of the identification document number according to the type of user document
|-
|4
|PRIMER_APELLIDO
|First surname of the user as specified in the identification document.
|-
|5
|SEGUNDO_APELLIDO
|Second surname of the user as specified in the identification document.
|-
|6
|PRIMER_NOMBRE
|User's first name as specified in the identification document
|-
|7
|SEGUNDO_NOMBRE
|Second name of the user according to what is specified in the identification document
|-
|8
|TIPO_USUARIO
|Registration of the person's affiliation condition or relationship with the coverage or benefit plan.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 23|Table 23]]
|-
|9
|MODALIDAD_CONTRATACION
|Registration of the contracting and payment modality agreed to be billed. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 24|Table 24]]
|
|-
|10
|COBERTURA_PLAN_BENEFICIOS
|Registration of the entity responsible for financing the coverage or benefit plan. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 25|Table 25]]
|-
|11
|NUMERO_AUTORIZACION
|Compulsory: When there is the response authorization number or the request number, as the case may be. For emergencies, SOAT and ARL are empty
|-
|12
|NUMERO_MIPRES
|Assigned by MIPRES
|-
|13
|NUMERO_ENTREGA_MIPRES
|Assigned by MIPRES
|-
|14
|NUMERO_CONTRATO
|Number of the billing contract
|-
|15
|NUMERO_POLIZA
|Number of SOAT policy or voluntary health plans. Mandatory: When it comes to SOAT services or voluntary health plans. Diligence when it comes to care for a traffic accident or for care as a private individual for a health policy
|-
|16
|COPAGO
|Value actually paid by the user and collected by the service provider
|-
|17
|CUOTA_MODERADORA
|Value actually paid by the user and collected by the service provider
|-
|18
|CUOTA_RECUPERACION
|Value actually paid by the user and collected by the service provider
|-
|19
|PAGOS_COMPARTIDOS
|Value actually paid by the user and collected by the service provider
|}
|}

Property code tables for document issuance - Direct Integration Manual Index

2022-03-03T14:58:21Z

Lvargas:

<includeonly>=</includeonly>==Tables of property codes for issuance of documents==<includeonly>=</includeonly>
In the following section you will find information regarding the different tables of property codes defined by the DIAN in the technical annex.
==Table 1==
{| class="wikitable" style="width: 100%;"
|+ Types of Documents
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.3. Type of Document: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
! style="color:white;background:#2F5496; text-align:center;"|Use
|- valign="center"
|-
|01
|Electronic Sales Invoice
|rowspan="4"|Types of Invoice
|-
|02
|Electronic Sales Invoice - export
|-
|03
|Transmission electronic document - type 03
|-
|04
|Electronic Sales Invoice - type 04
|-
|91
|Credit note
|rowspan="4"|Exclusive in document references (DocumentReference elements)
|-
|92
|Debit note
|}
|}
==Table 2==
{| class="wikitable" style="width: 100%;"
|+ Operation types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.5. Operation types
For billss:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|10
|Start*
|-
|09
|AIU
|-
|11
|Mandates
|-
|12
|Transportation
|-
|13
|Exchange
|}
Note: (*) Value by default Health Operation

{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|}
Note: The explanation and validity of the Operation types for the health sector will be reported at http://url.minsalud.gov.co/facturacion-electronica once the Ministry of Health informs all the actors regulated by them.
For Credit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|20
|Note Credit that references an electronic invoice*
|-
|22
|Credit note without reference to invoices*
|-
|}
Note: (*) The default value is 20, the above means that if a value is not reported, it is assumed to be 20 and the corresponding set of validations will be applied. (*) Preferable for use of rebate notes or conditional discounts. Notes type 22 do not have rejection validation. Post Control Object. For Debit Notes:
For Debit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|30
|Note Debit that references an electronic invoice*
|-
|32
|Debit note without reference to invoices*
|-
|}
Note: The default value is 30, the above means that if a value is not reported, add 30 and apply the corresponding set of validations. Notes type 32 and 33 do not have rejection validation. Post Control Object.
|}
'''@IMPORTANT:''' Notes type 22 and 32 do not have rejection validation. (Post control object).

==Table 3==
{| class="wikitable" style="width: 100%;"
|+ Identification Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.1. Identification document (Type of Fiscal Identifier):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|11
|Civil registration
|-
|12
|ID card
|-
|13
|Certificate of Citizenship
|-
|21
|Alien Card
|-
|22
|Immigration certificate
|-
|31
|NIT
|-
|41
|Passport
|-
|42
|Foreign ID
|-
|47
|PEP
|-
|50
|NIT from another country
|-
|91
|NUIP*
|}
|}
'''@IMPORTANT:''' (*) It should only be used for the acquirer, since this type of document does not belong to the document types in the RUT database.

==Table 4==
{| class="wikitable" style="width: 100%;"
|+ Descount Code
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.8. Descount Codes
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|00
|Unconditional discount
|-
|01
|Conditional Discount
|}
|}
==Table 5==
{| class="wikitable" style="width: 100%;"
|+ TType of person
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Legal person and assimilated
|-
|2
|Natural person and assimilated
|}
|}
==Table 6==
{| class="wikitable" style="width: 100%;"
|+ Units of Measure
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.6. Units of amount: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|04
|small spray
|BIL
|trillion dollars
|HUR
|hour
|-
|05
|lift
|BJ
|bucket
|HY
|hundred yardas
|-
|08
|Lot Heat
|BK
|Basket
|IA
|Inch Pound
|-
|10
|group
|BL
|bullet
|IC
|count per inch
|-
|11
|equip
|BLD
|dry barrel
|IE
|person
|-
|13
|ration
|BLL
|barrel (EE.UU.)(petroleo, etc.)
|IF
|inches of water
|-
|14
|shot
|BO
|bottle
|II
|column inch
|-
|15
|stick
|BP
|hundred board feet
|IL
|inch per minute
|-
|16
|hundred and fifteen kg drum
|BQL
|becquerel
|IM
|printing
|-
|17
|hundred pound drum
|BR
|bar
|INH
|inch
|}
|}
'''@IMPORTANT:''' This catalog is more extensive, for more information refer to the section of the corresponding Annex.
==Table 7==
{| class="wikitable" style="width: 100%;"
|+ Reference pricing codes
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.9. Type of legal organization (Persons): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|Commercial value
|}
Note: For commercial samples or gifts, '01' must be sent in the field '''codigoTipoPrecio'''
|}
==Table 8==
{| class="wikitable" style="width: 100%;"
|+ Codes for products and services
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|To use
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Efficient Purchase: use content of the "Code" column
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Global Product Identification Numbers - GTIN
* Ver 8.2
* When there are fewer than 14 numbers in a data structure (for example, GTIN8), the numbers must be right-justified in a 14-digit field padded with zeros in the leftmost positions.
|-
|020
|rate item
|195
|style="text-align:left;"|rate item
|-
|999
|Taxpayer Adoption Standard
|
|style="text-align:left;"|
* The value in the @schemeName attribute will not be validated
* The @schemeAgencyID attribute must not be used
|}
Note: For commercial samples or gifts, '01' must be sent in the '''codigoTipoPrecio''' field.
'''@IMPORTANT:''' For more information on the code for products and services, refer to the section of the corresponding Annex.
==Table 9==
{| class="wikitable" style="width: 100%;"
|+ Credit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.4. Correction concept for credit notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Partial return of goods and/or partial non-acceptance of service
|-
|2
|style="text-align:left;"|Electronic invoice cancellation
|-
|3
|style="text-align:left;"|Rebate or partial or total discount
|-
|4
|style="text-align:left;"|Price Adjust
|-
|5
|style="text-align:left;"|others
|}
|}

==Table 10==
{| class="wikitable" style="width: 100%;"
|+ Debit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.6. Concept of Correction for Debit Notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Interests
|-
|2
|style="text-align:left;"|Expenses receivable
|-
|3
|style="text-align:left;"|Value change
|-
|4
|style="text-align:left;"|others
|}
==Table 11==
{| class="wikitable" style="width: 100%;"
|+ Tax Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identifier
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Value Added Tax
|-
|02
|IC
|style="text-align:left;"|Consumption Tax
|-
|03
|ICA
|style="text-align:left;"|Industry, Commerce and Notice Tax
|-
|04
|INC
|style="text-align:left;"|National Consumption Tax
|-
|05
|ReteIVA
|style="text-align:left;"|Withholding on IVA
|-
|06
|ReteRenta
|style="text-align:left;"|Withholding on Income
|-
|07
|ReteICA
|style="text-align:left;"|Withholding on the ICA
|-
|08
|IC Porcentual
|style="text-align:left;"|Tax on Consumption of Plastic Bag
|-
|20
|FtoHorticultura
|style="text-align:left;"|Fruit and Vegetable Promotion Fee
|-
|21
|Timbre
|style="text-align:left;"|Stamp Tax
|-
|22
|INC Bolsas
|style="text-align:left;"|National Tax on Plastic Bag Consumption
|-
|23
|INCarbono
|style="text-align:left;"|National Carbon Tax
|-
|24
|INCombustibles
|style="text-align:left;"|National Tax on Fuels
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Surcharge on fuels
|-
|26
|Sordicom
|style="text-align:left;"|Retail Contribution (Fuels)
|-
|30
|IC Datos
|style="text-align:left;"|Data Consumption Tax
|-
|ZY
|No causa
|style="text-align:left;"|Not responsible for tax
|-
|ZZ
|Name of the tax figure
|style="text-align:left;"|Other taxes, rates, contributions, and similar
|}
|}
==Table 12==
{| class="wikitable" style="width: 100%;"
|+ Tax Fees
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.8. Rate Tables for Tax
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Reporting tax
! style="color:white;background:#2F5496; text-align:center;"|Possible values for the cbc:Percent field
The rate to report will depend on the tax aspect of the reported tax.
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|rate
| 
|-
| Concept|| rate || (cbc:Percent)||  
|-
| Exempt|| 0.00 ||  |
|-
| Goods/Services at 5|| 5.00 ||  |
|-
| Contracts signed with the state before law 1819|| 16.00 ||  
|-
| General rate|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|rate
| 
|-
| Item           || (cbc:Percent)||  
|-
| Special rate|| 2.00 ||  
|-
| Special rate|| 4.00 ||  |
|-
| General rate|| 8.00 ||  |
|-
| Special rate|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|}
|}
@IMPORTANT: This catalog '''fees for Tax''' is more extensive, for more information refer to the section of the corresponding Annex.

==Table 13==
{| class="wikitable" style="width: 100%;"
|+ Payment methods
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.2. Payment methods: cbc:PaymentMeansCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|1
|Instrument not defined
|39
|Corporate Exchange Business Loan (CTX)
|-
|2
|Crédito ACH
|40
|Business Debit Corporate Exchange (CTX)
|-
|3
|Débito ACH
|41
|Concentration Cash/Credit Disbursement Plus (CCD+)
|-
|4
|ACH demand debit reversal
|42
|Bank collection
|-
|5
|Reversal of ACH demand credit
|43
|Cash concentration / Debit plus Disbursement (CCD+)
|-
|6
|ACH Demand Credit
|44
|Exchange Note
|-
|7
|ACH demand debit
|45
|Transfer Bank Credit
|-
|8
|Maintain
|46
|Interbank Debit Transfer
|-
|9
|National or Regional Clearing
|47
|Bank Debit Transfer
|-
|10
|Cash
|48
|Credit card
|-
|11
|Credit Savings Reversal
|49
|Debit Card
|-
|12
|Reversion Debit Savings
|50
|Postdraft
|-
|13
|Savings Credit
|51
|French banking standard Telex
|-
|14
|Debit Saving
|52
|Urgent business payment
|-
|15
|Bookentry Credit
|53
|Urgent Treasury Payment
|-
|16
|Bookentry Debit
|60
|Note promisoria
|-
|17
|Concentration of demand in cash/Credit Disbursement (CCD)
|61
|Promissory note signed by the creditor
|-
|18
|Concentration of demand in cash / Disbursement (CCD) debit
|62
|Promissory note signed by the creditor, endorsed by the bank
|-
|19
|Corporate Business Payment Credit (CTP)
|63
|Promissory note signed by the creditor, endorsed by a third party
|-
|20
|Check
|64
|Note promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Promissory note signed by a bank guaranteed by another bank
|-
|22
|Certified bank project
|66
|Signed promissory note
|-
|23
| Bank check
|67
|Promissory note signed by a third party guaranteed by a bank
|-
|24
|Foreign exchange note awaiting acceptance
|70
|Withdrawal of note by creditor
|-
|25
|Certified check
|71
|Bonds
|-
|26
|Local Check
|72
|Vouchers
|-
|27
|Debit Payment Corporate Business (CTP)
|74
|Withdrawal of note by the creditor on a bank
|-
|28
|Credit Business Corporate Exchange (CTX)
|75
|Withdrawal of note by the creditor, guaranteed by another bank
|-
|29
|Debit Business Corporate Exchange (CTX)
|76
|Withdrawal of note by the creditor, on a bank guaranteed by a third party
|-
|30
|Credit Transfer
|77
|Withdrawal of a note by the creditor on a third party
|-
|31
|Transfer Debit
|78
|Withdrawal of a note by the creditor on a third party guaranteed by a bank
|-
|32
|Concentration Cash / Disbursement Credit plus (CCD+)
|91
|Transferable bank note
|-
|33
|Concentration Cash / Disbursement Debit plus (CCD+)
|92
|Local transferable check
|-
|34
|Pre-arranged payment and deposit (PPD)
|93
|Referenced draft
|-
|35
|Cash concentration savings / Credit Disbursement (CCD)
|94
|Urgent transfer
|-
|36
|Cash concentration savings / Credit Disbursement (CCD)
|95
|Open format draft
|-
|37
|Payment Corporate Business Savings Credit (CTP)
|96
|Requested payment method not used
|-
|38
|Payment Corporate Business Debit Savings (CTP)
|97
|Clearing between partners
|-
|
|
|ZZZ
|Mutual Agreement
|}
|}
==Table 14==
{| class="wikitable" style="width: 100%;"
|+ Form to Payment Method
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.1. Payment methods: cbc:PaymentMeans/ID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Cash
|-
|2
|Credit
|}
|}
==Table 15==
{| class="wikitable" style="width: 100%;"
|+ Terms of delivery (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.6. Terms of delivery (INCOTERMS): …/cbc:LossRiskResponsibilityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|CFR
|Cost & Freight
|-
|CIF
|Cost, freight and insurance
|-
|CIP
|Transport and Insurance Paid to
|-
|CPT
|Carriage Paid To
|-
|DAP
|Delivered to Place
|-
|DAT
|Delivered at Terminal
|-
|DDP
|Delivered Duty Paid
|-
|EXW
|In Factory
|-
|FAS
|Free alongside ship
|-
|FCA
|Freight Carrier
|-
|FOB
|Free on board
|}
|}
==Table 16==
{| class="wikitable" style="width: 100%;"
|+ Departments (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.2. Departments (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}
==Table 17==
{| class="wikitable" style="width: 100%;"
|+ Tax responsibilities
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.7. Tax responsibilities: cbc:TaxLevelCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|0-13
|Major contributor
|-
|0-15
|Self-Locking
|-
|0-23
|Sales tax withholding agent
|-
|0-47
|Simple Taxation System – SIMPLE
|-
|R-99-PN
|Does not apply - Others
|}
|}
==Table 18==
{| class="wikitable" style="width: 100%;"
|+ tax details
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Taxes: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|IVA
|-
|04
|INC
|-
|ZA
|IVA e INC
|-
|ZZ
|Does not apply
|}
|}
==Table 19==
{| class="wikitable" style="width: 100%;"
|+ Municipality
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.3. Municipality: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code Department
! style="color:white;background:#2F5496; text-align:center;"|Code Municipal
! style="color:white;background:#2F5496; text-align:center;"|Name Department
! style="color:white;background:#2F5496; text-align:center;"|Name Municipal
|- valign="center"
|-
|05
|05044
|Antioquia
|ANZÁ
|-
|05
|05045
|Antioquia
|APARTADÓ
|-
|05
|05051
|Antioquia
|ARBOLETES
|-
|05
|05055
|Antioquia
|ARGELIA
|-
|05
|05059
|Antioquia
|ARMENIA
|-
|05
|05079
|Antioquia
|BARBOSA
|-
|05
|05086
|Antioquia
|BELMIRA
|-
|05
|05088
|Antioquia
|BELLO
|-
|05
|05091
|Antioquia
|BETANIA
|-
|05
|05093
|Antioquia
|BETULIA
|-
|05
|05101
|Antioquia
|CIUDAD BOLÍVAR
|-
|05
|05107
|Antioquia
|BRICEÑO
|-
|05
|05113
|Antioquia
|BURITICÁ
|-
|05
|05120
|Antioquia
|CÁCERES
|-
|05
|05125
|Antioquia
|CAICEDO
|-
|05
|05129
|Antioquia
|CALDAS
|-
|05
|05134
|Antioquia
|CAMPAMENTO
|-
|05
|05138
|Antioquia
|CAÑASGORDAS
|-
|05
|05142
|Antioquia
|CARACOLÍ
|-
|05
|05145
|Antioquia
|CARAMANTA
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANT:''' This catalog ''' municipalities''' is more extensive, for more information refer to the section of the corresponding Annex.
==Table 20==
{| class="wikitable" style="width: 100%;"
|+ Postal zone
|- valign="center"
|colspan="2"|Anex 1.7-2020 - 6.4.4. Reference to other documents cbc:PostalZone 
In Colombia, the postal code consists of 6 digits (example: 578986) that initially indicate the geographical position, followed by the routing and finally the one that locates us within the postal area, as follows:

'''National Departments''' 
The first two digits represent the national departments, using the current Dane coding. Codes less than 10 must start with a leading zero.

'''Departmental routing postal zones''' 
The third and fourth position define the routing postal zones to facilitate the classification through the Postal Code: 00 is reserved for the capital of the department. From 01 to 89, each department can be divided into up to 89 postal routing zones.

'''Postal district by municipality or locality''' 
The last two positions of the National Postal Code allow one hundred postal districts to be assigned to each of the ten postal zones created in each department. That is, up to a thousand different districts can be assigned in each department, for a total of thirty-three thousand at the national level.
|}
@IMPORTANT: For more information, refer to the corresponding Annex section.
==Table 21==
{| class="wikitable" style="width: 100%;"
|+Reference to non-tax documents
|- valign="center"
|colspan="2"|'''Anex 1.8 - 13.1.4. Reference to non-tax documents: cbc:DocumentTypeCode''' 
This element refers to the'''xpath /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode'''. These documents represent commercial and mercantile actions that protect or support transactions related to this electronic document.

The XML electronic documents adopted by the DIAN should not be included in this fragment since these documents do not contain the standard identifications such as CUFE or CUDE.

As it is a delivery order, the '''OrderReference''', element group must be used. When reporting more than one, the AdditionalDocumentReference group must be available.

This field of this group of information is optional to reference commercial issues at the will of the electronic biller, therefore, the codes are assigned by it.
|}

<center>'''TABLES OF CODES FOR THE ISSUANCE OF DOCUMENTS IN THE HEALTH SECTOR'''</center>
==Table 22==
{| class="wikitable" style="width: 100%;"
|+ Identification Document Type- Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Abv
! style="color:white;background:#2F5496; text-align:center;"|Type of Identification Document
|- valign="center"
|-
|CC
|Citizenship card
|-
|CE
|Immigration Certificate
|-
|CD
|Diplomatic ID
|-
|PA
|Passport
|-
|SC
|Safe conduct
|-
|PE
|special stay permit
|-
|RC
|Civil registration of birth
|-
|TI
|Identity Card
|-
|CN
|Live birth certificate
|-
|AS
|Adult Unidentified
|-
|MS
|Unidentified Minor
|-
|DE
|Foreign Document
|-
|SI
|Without Identification
|}
|}
==Table 23==
{| class="wikitable" style="width: 100%;"
|+ User Type - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|User type
|- valign="center"
|-
|01
|Contributing taxpayer
|-
|02
|Contributory beneficiary
|-
|03
|Additional contributory
|-
|04
|Subsidised
|-
|05
|Not regim
|-
|06
|Special or Contributing Exception
|-
|07
|Special or Exception beneficiary
|-
|08
|Individual
|-
|09
|Policyholder/Protected ARL
|-
|10
|Policyholder/Protected SOAT
|-
|11
|Policy holder/Protected voluntary health plans
|}
|}
==Table 24==
{| class="wikitable" style="width: 100%;"
|+ Hiring Modalities - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Hiring Modalities
|- valign="center"
|-
|01
|Package / Basket / Comprehensive Health Set
|-
|02
|Diagnosis-related Groups
|-
|03
|Comprehensive by risk group
|-
|04
|Payment by contact by specialty
|-
|05
|Payment per scenario of care
|-
|06
|Payment per service type
|-
|07
|Prospective global payment per episode
|-
|08
|Global prospective payment by risk group
|-
|09
|Prospective lump sum payment by specialty
|-
|10
|Prospective global payment by level of complexity
|-
|11
|Capacitation
|-
|12
|For service
|}
|}
==Table 25==
{| class="wikitable" style="width: 100%;"
|+ CService coverage or plan - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Service coverage or plan
|- valign="center"
|-
|01
|Health benefit plan financed by UPC
|-
|02
|Maximum budget
|-
|03
|EPS/EOC premium, uninsured SOAT
|-
|04
|Coverage SOAT Policy
|-
|05
|ARL cover
|-
|06
|ADRES coverage
|-
|07
|Public Health Cover
|-
|08
|Coverage of the territorial entity, supply resources
|-
|09
|Emergencies migrant population
|-
|10
|Supplemental health plan
|-
|11
|Prepaid Medical Plan
|-
|12
|Other health policies
|-
|13
|Special Regime Coverage or Exception
|-
|14
|National Health Fund Coverage for Persons Deprived of Liberty
|-
|15
|Private
|}
|}
==Table 26==
{| class="wikitable" style="width: 100%;"
|+ Collection Concepts
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|16
|Copayment
|-
|17
|Moderator Fee
|-
|18
|Recovery Fee
|-
|19
|Shared plans in voluntary health plans
|}
|}
==Table 27==
{| class="wikitable" style="width: 100%;"
|+ Scenario Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|Record of the Concept of collection to the patient
|-
|2
|Registration of the concept of accreditation to the EPS
|-
|3
|Record of operations without accreditation to the EPS
|-
|4
|Issuance of FEL without prior collection
|-
|5
|Including in a FEL the value to be credited for the collection
|}
|}
==Table 28==
{| class="wikitable" style="width: 100%;"
|+ Additional Data Fields
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Label
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|CODIGO_PRESTADOR
|Code assigned in the General System of Social Security in Health (SGSSS) to health service providers that are in the Special Registry of Health Service Providers (REPS) or the Code assigned by the Ministry of Health and Social Protection for public health laboratories.
|-
|2
|TIPO_DOCUMENTO_IDENTIFICACION
|User identification type
:[[Tables of property codes for issuance of documents - Direct Integration Manual Index#Table 22|Table 22]]
|-
|3
|NUMERO_DOCUMENTO_IDENTIFICACION
|Registration of the identification document number according to the type of user document
|-
|4
|PRIMER_APELLIDO
|First surname of the user as specified in the identification document.
|-
|5
|SEGUNDO_APELLIDO
|Second surname of the user as specified in the identification document.
|-
|6
|PRIMER_NOMBRE
|User's first name as specified in the identification document
|-
|7
|SEGUNDO_NOMBRE
|Second name of the user according to what is specified in the identification document
|-
|8
|TIPO_USUARIO
|Registration of the person's affiliation condition or relationship with the coverage or benefit plan.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 23|Table 23]]
|-
|9
|MODALIDAD_CONTRATACION
|Registration of the contracting and payment modality agreed to be billed. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 24|Table 24]]
|
|-
|10
|COBERTURA_PLAN_BENEFICIOS
|Registration of the entity responsible for financing the coverage or benefit plan. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 25|Table 25]]
|-
|11
|NUMERO_AUTORIZACION
|Compulsory: When there is the response authorization number or the request number, as the case may be. For emergencies, SOAT and ARL are empty
|-
|12
|NUMERO_MIPRES
|Assigned by MIPRES
|-
|13
|NUMERO_ENTREGA_MIPRES
|Assigned by MIPRES
|-
|14
|NUMERO_CONTRATO
|Number of the billing contract
|-
|15
|NUMERO_POLIZA
|Number of SOAT policy or voluntary health plans. Mandatory: When it comes to SOAT services or voluntary health plans. Diligence when it comes to care for a traffic accident or for care as a private individual for a health policy
|-
|16
|COPAGO
|Value actually paid by the user and collected by the service provider
|-
|17
|CUOTA_MODERADORA
|Value actually paid by the user and collected by the service provider
|-
|18
|CUOTA_RECUPERACION
|Value actually paid by the user and collected by the service provider
|-
|19
|PAGOS_COMPARTIDOS
|Value actually paid by the user and collected by the service provider
|}
|}

Property code tables for document issuance - Direct Integration Manual Index

2022-03-03T14:55:01Z

Lvargas: Página creada con «<includeonly>=</includeonly>==Tables of property codes for issuance of documents==<includeonly>=</includeonly> In the following section you will find information regarding…»

<includeonly>=</includeonly>==Tables of property codes for issuance of documents==<includeonly>=</includeonly>
In the following section you will find information regarding the different tables of property codes defined by the DIAN in the technical annex.
==Table 1==
{| class="wikitable" style="width: 100%;"
|+ Types of Documents
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.3. Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
! style="color:white;background:#2F5496; text-align:center;"|Use
|- valign="center"
|-
|01
|Electronic Sales Invoice
|rowspan="4"|Types of Invoice
|-
|02
|Electronic Sales Invoice - export
|-
|03
|Transmission electronic document - type 03
|-
|04
|Electronic Sales Invoice - type 04
|-
|91
|Credit note
|rowspan="4"|Exclusive in document references (DocumentReference elements)
|-
|92
|Debit note
|}
|}
==Table 2==
{| class="wikitable" style="width: 100%;"
|+ Operation types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.1.5. Operation types
For billss:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|10
|Start*
|-
|09
|AIU
|-
|11
|Mandates
|-
|12
|Transportation
|-
|13
|Exchange
|}
Note: (*) Value by default Health Operation

{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|}
Note: The explanation and validity of the Operation types for the health sector will be reported at http://url.minsalud.gov.co/facturacion-electronica once the Ministry of Health informs all the actors regulated by them.
For Credit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|20
|Note Credit that references an electronic invoice*
|-
|22
|Credit note without reference to invoices*
|-
|}
Note: (*) The default value is 20, the above means that if a value is not reported, it is assumed to be 20 and the corresponding set of validations will be applied. (*) Preferable for use of rebate notes or conditional discounts. Notes type 22 do not have rejection validation. Post Control Object. For Debit Notes:
For Debit Notes:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Value
|- valign="center"
|-
|30
|Note Debit that references an electronic invoice*
|-
|32
|Debit note without reference to invoices*
|-
|}
Note: The default value is 30, the above means that if a value is not reported, add 30 and apply the corresponding set of validations. Notes type 32 and 33 do not have rejection validation. Post Control Object.
|}
'''@IMPORTANT:''' Notes type 22 and 32 do not have rejection validation. (Post control object).

==Table 3==
{| class="wikitable" style="width: 100%;"
|+ Identification Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.1. Identification document (Type of Fiscal Identifier):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|11
|Civil registration
|-
|12
|ID card
|-
|13
|Certificate of Citizenship
|-
|21
|Alien Card
|-
|22
|Immigration certificate
|-
|31
|NIT
|-
|41
|Passport
|-
|42
|Foreign ID
|-
|47
|PEP
|-
|50
|NIT from another country
|-
|91
|NUIP*
|}
|}
'''@IMPORTANT:''' (*) It should only be used for the acquirer, since this type of document does not belong to the document types in the RUT database.

==Table 4==
{| class="wikitable" style="width: 100%;"
|+ Descount Code
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.8. Descount Codes
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|00
|Unconditional discount
|-
|01
|Conditional Discount
|}
|}
==Table 5==
{| class="wikitable" style="width: 100%;"
|+ TType of person
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Legal person and assimilated
|-
|2
|Natural person and assimilated
|}
|}
==Table 6==
{| class="wikitable" style="width: 100%;"
|+ Units of Measure
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.6. Units of amount: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|04
|small spray
|BIL
|trillion dollars
|HUR
|hour
|-
|05
|lift
|BJ
|bucket
|HY
|hundred yardas
|-
|08
|Lot Heat
|BK
|Basket
|IA
|Inch Pound
|-
|10
|group
|BL
|bullet
|IC
|count per inch
|-
|11
|equip
|BLD
|dry barrel
|IE
|person
|-
|13
|ration
|BLL
|barrel (EE.UU.)(petroleo, etc.)
|IF
|inches of water
|-
|14
|shot
|BO
|bottle
|II
|column inch
|-
|15
|stick
|BP
|hundred board feet
|IL
|inch per minute
|-
|16
|hundred and fifteen kg drum
|BQL
|becquerel
|IM
|printing
|-
|17
|hundred pound drum
|BR
|bar
|INH
|inch
|}
|}
'''@IMPORTANT:''' This catalog is more extensive, for more information refer to the section of the corresponding Annex.
==Table 7==
{| class="wikitable" style="width: 100%;"
|+ Reference pricing codes
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.9. Type of legal organization (Persons): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|Commercial value
|}
Note: For commercial samples or gifts, '01' must be sent in the field '''codigoTipoPrecio'''
|}
==Table 8==
{| class="wikitable" style="width: 100%;"
|+ Codes for products and services
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.3. Type of legal organization (People): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|To use
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Efficient Purchase: use content of the "Code" column
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Global Product Identification Numbers - GTIN
* Ver 8.2
* When there are fewer than 14 numbers in a data structure (for example, GTIN8), the numbers must be right-justified in a 14-digit field padded with zeros in the leftmost positions.
|-
|020
|rate item
|195
|style="text-align:left;"|rate item
|-
|999
|Taxpayer Adoption Standard
|
|style="text-align:left;"|
* The value in the @schemeName attribute will not be validated
* The @schemeAgencyID attribute must not be used
|}
Note: For commercial samples or gifts, '01' must be sent in the '''codigoTipoPrecio''' field.
'''@IMPORTANT:''' For more information on the code for products and services, refer to the section of the corresponding Annex.
==Table 9==
{| class="wikitable" style="width: 100%;"
|+ Credit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.8-2021 - 13.3.4. Correction concept for credit notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Partial return of goods and/or partial non-acceptance of service
|-
|2
|style="text-align:left;"|Electronic invoice cancellation
|-
|3
|style="text-align:left;"|Rebate or partial or total discount
|-
|4
|style="text-align:left;"|Price Adjust
|-
|5
|style="text-align:left;"|others
|}
|}

==Table 10==
{| class="wikitable" style="width: 100%;"
|+ Debit Note Reasons
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.6. Concept of Correction for Debit Notes: cac:DiscrepancyResponse/cbc:ResponseCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|style="text-align:left;"|Interests
|-
|2
|style="text-align:left;"|Expenses receivable
|-
|3
|style="text-align:left;"|Value change
|-
|4
|style="text-align:left;"|others
|}
==Table 11==
{| class="wikitable" style="width: 100%;"
|+ Tax Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identifier
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Value Added Tax
|-
|02
|IC
|style="text-align:left;"|Consumption Tax
|-
|03
|ICA
|style="text-align:left;"|Industry, Commerce and Notice Tax
|-
|04
|INC
|style="text-align:left;"|National Consumption Tax
|-
|05
|ReteIVA
|style="text-align:left;"|Withholding on IVA
|-
|06
|ReteRenta
|style="text-align:left;"|Withholding on Income
|-
|07
|ReteICA
|style="text-align:left;"|Withholding on the ICA
|-
|08
|IC Porcentual
|style="text-align:left;"|Tax on Consumption of Plastic Bag
|-
|20
|FtoHorticultura
|style="text-align:left;"|Fruit and Vegetable Promotion Fee
|-
|21
|Timbre
|style="text-align:left;"|Stamp Tax
|-
|22
|INC Bolsas
|style="text-align:left;"|National Tax on Plastic Bag Consumption
|-
|23
|INCarbono
|style="text-align:left;"|National Carbon Tax
|-
|24
|INCombustibles
|style="text-align:left;"|National Tax on Fuels
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Surcharge on fuels
|-
|26
|Sordicom
|style="text-align:left;"|Retail Contribution (Fuels)
|-
|30
|IC Datos
|style="text-align:left;"|Data Consumption Tax
|-
|ZY
|No causa
|style="text-align:left;"|Not responsible for tax
|-
|ZZ
|Name of the tax figure
|style="text-align:left;"|Other taxes, rates, contributions, and similar
|}
|}
==Table 12==
{| class="wikitable" style="width: 100%;"
|+ Tax Fees
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.8. Rate Tables for Tax
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Reporting tax
! style="color:white;background:#2F5496; text-align:center;"|Possible values for the cbc:Percent field
The rate to report will depend on the tax aspect of the reported tax.
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|rate
| 
|-
| Concept|| rate || (cbc:Percent)||  
|-
| Exempt|| 0.00 ||  |
|-
| Goods/Services at 5|| 5.00 ||  |
|-
| Contracts signed with the state before law 1819|| 16.00 ||  
|-
| General rate|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|rate
| 
|-
| Item           || (cbc:Percent)||  
|-
| Special rate|| 2.00 ||  
|-
| Special rate|| 4.00 ||  |
|-
| General rate|| 8.00 ||  |
|-
| Special rate|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|}
|}
@IMPORTANT: This catalog '''fees for Tax''' is more extensive, for more information refer to the section of the corresponding Annex.

==Table 13==
{| class="wikitable" style="width: 100%;"
|+ Payment methods
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.2. Payment methods: cbc:PaymentMeansCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|1
|Instrument not defined
|39
|Corporate Exchange Business Loan (CTX)
|-
|2
|Crédito ACH
|40
|Business Debit Corporate Exchange (CTX)
|-
|3
|Débito ACH
|41
|Concentration Cash/Credit Disbursement Plus (CCD+)
|-
|4
|ACH demand debit reversal
|42
|Bank collection
|-
|5
|Reversal of ACH demand credit
|43
|Cash concentration / Debit plus Disbursement (CCD+)
|-
|6
|ACH Demand Credit
|44
|Exchange Note
|-
|7
|ACH demand debit
|45
|Transfer Bank Credit
|-
|8
|Maintain
|46
|Interbank Debit Transfer
|-
|9
|National or Regional Clearing
|47
|Bank Debit Transfer
|-
|10
|Cash
|48
|Credit card
|-
|11
|Credit Savings Reversal
|49
|Debit Card
|-
|12
|Reversion Debit Savings
|50
|Postdraft
|-
|13
|Savings Credit
|51
|French banking standard Telex
|-
|14
|Debit Saving
|52
|Urgent business payment
|-
|15
|Bookentry Credit
|53
|Urgent Treasury Payment
|-
|16
|Bookentry Debit
|60
|Note promisoria
|-
|17
|Concentration of demand in cash/Credit Disbursement (CCD)
|61
|Promissory note signed by the creditor
|-
|18
|Concentration of demand in cash / Disbursement (CCD) debit
|62
|Promissory note signed by the creditor, endorsed by the bank
|-
|19
|Corporate Business Payment Credit (CTP)
|63
|Promissory note signed by the creditor, endorsed by a third party
|-
|20
|Check
|64
|Note promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Promissory note signed by a bank guaranteed by another bank
|-
|22
|Certified bank project
|66
|Signed promissory note
|-
|23
| Bank check
|67
|Promissory note signed by a third party guaranteed by a bank
|-
|24
|Foreign exchange note awaiting acceptance
|70
|Withdrawal of note by creditor
|-
|25
|Certified check
|71
|Bonds
|-
|26
|Local Check
|72
|Vouchers
|-
|27
|Debit Payment Corporate Business (CTP)
|74
|Withdrawal of note by the creditor on a bank
|-
|28
|Credit Business Corporate Exchange (CTX)
|75
|Withdrawal of note by the creditor, guaranteed by another bank
|-
|29
|Debit Business Corporate Exchange (CTX)
|76
|Withdrawal of note by the creditor, on a bank guaranteed by a third party
|-
|30
|Credit Transfer
|77
|Withdrawal of a note by the creditor on a third party
|-
|31
|Transfer Debit
|78
|Withdrawal of a note by the creditor on a third party guaranteed by a bank
|-
|32
|Concentration Cash / Disbursement Credit plus (CCD+)
|91
|Transferable bank note
|-
|33
|Concentration Cash / Disbursement Debit plus (CCD+)
|92
|Local transferable check
|-
|34
|Pre-arranged payment and deposit (PPD)
|93
|Referenced draft
|-
|35
|Cash concentration savings / Credit Disbursement (CCD)
|94
|Urgent transfer
|-
|36
|Cash concentration savings / Credit Disbursement (CCD)
|95
|Open format draft
|-
|37
|Payment Corporate Business Savings Credit (CTP)
|96
|Requested payment method not used
|-
|38
|Payment Corporate Business Debit Savings (CTP)
|97
|Clearing between partners
|-
|
|
|ZZZ
|Mutual Agreement
|}
|}
==Table 14==
{| class="wikitable" style="width: 100%;"
|+ Form to Payment Method
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.4.1. Payment methods: cbc:PaymentMeans/ID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|1
|Cash
|-
|2
|Credit
|}
|}
==Table 15==
{| class="wikitable" style="width: 100%;"
|+ Terms of delivery (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.3.6. Terms of delivery (INCOTERMS): …/cbc:LossRiskResponsibilityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|CFR
|Cost & Freight
|-
|CIF
|Cost, freight and insurance
|-
|CIP
|Transport and Insurance Paid to
|-
|CPT
|Carriage Paid To
|-
|DAP
|Delivered to Place
|-
|DAT
|Delivered at Terminal
|-
|DDP
|Delivered Duty Paid
|-
|EXW
|In Factory
|-
|FAS
|Free alongside ship
|-
|FCA
|Freight Carrier
|-
|FOB
|Free on board
|}
|}
==Table 16==
{| class="wikitable" style="width: 100%;"
|+ Departments (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.2. Departments (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|ISO code
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}
==Table 17==
{| class="wikitable" style="width: 100%;"
|+ Tax responsibilities
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.7. Tax responsibilities: cbc:TaxLevelCode
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|0-13
|Major contributor
|-
|0-15
|Self-Locking
|-
|0-23
|Sales tax withholding agent
|-
|0-47
|Simple Taxation System – SIMPLE
|-
|R-99-PN
|Does not apply - Others
|}
|}
==Table 18==
{| class="wikitable" style="width: 100%;"
|+ tax details
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.2.2. Taxes: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Meaning
|- valign="center"
|-
|01
|IVA
|-
|04
|INC
|-
|ZA
|IVA e INC
|-
|ZZ
|Does not apply
|}
|}
==Table 19==
{| class="wikitable" style="width: 100%;"
|+ Municipality
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anex 1.7-2020 - 6.4.3. Municipality: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code Department
! style="color:white;background:#2F5496; text-align:center;"|Code Municipal
! style="color:white;background:#2F5496; text-align:center;"|Name Department
! style="color:white;background:#2F5496; text-align:center;"|Name Municipal
|- valign="center"
|-
|05
|05044
|Antioquia
|ANZÁ
|-
|05
|05045
|Antioquia
|APARTADÓ
|-
|05
|05051
|Antioquia
|ARBOLETES
|-
|05
|05055
|Antioquia
|ARGELIA
|-
|05
|05059
|Antioquia
|ARMENIA
|-
|05
|05079
|Antioquia
|BARBOSA
|-
|05
|05086
|Antioquia
|BELMIRA
|-
|05
|05088
|Antioquia
|BELLO
|-
|05
|05091
|Antioquia
|BETANIA
|-
|05
|05093
|Antioquia
|BETULIA
|-
|05
|05101
|Antioquia
|CIUDAD BOLÍVAR
|-
|05
|05107
|Antioquia
|BRICEÑO
|-
|05
|05113
|Antioquia
|BURITICÁ
|-
|05
|05120
|Antioquia
|CÁCERES
|-
|05
|05125
|Antioquia
|CAICEDO
|-
|05
|05129
|Antioquia
|CALDAS
|-
|05
|05134
|Antioquia
|CAMPAMENTO
|-
|05
|05138
|Antioquia
|CAÑASGORDAS
|-
|05
|05142
|Antioquia
|CARACOLÍ
|-
|05
|05145
|Antioquia
|CARAMANTA
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANT:''' This catalog ''' municipalities''' is more extensive, for more information refer to the section of the corresponding Annex.
==Table 20==
{| class="wikitable" style="width: 100%;"
|+ Postal zone
|- valign="center"
|colspan="2"|Anex 1.7-2020 - 6.4.4. Reference to other documents cbc:PostalZone 
In Colombia, the postal code consists of 6 digits (example: 578986) that initially indicate the geographical position, followed by the routing and finally the one that locates us within the postal area, as follows:

'''National Departments''' 
The first two digits represent the national departments, using the current Dane coding. Codes less than 10 must start with a leading zero.

'''Departmental routing postal zones''' 
The third and fourth position define the routing postal zones to facilitate the classification through the Postal Code: 00 is reserved for the capital of the department. From 01 to 89, each department can be divided into up to 89 postal routing zones.

'''Postal district by municipality or locality''' 
The last two positions of the National Postal Code allow one hundred postal districts to be assigned to each of the ten postal zones created in each department. That is, up to a thousand different districts can be assigned in each department, for a total of thirty-three thousand at the national level.
|}
@IMPORTANT: For more information, refer to the corresponding Annex section.
==Table 21==
{| class="wikitable" style="width: 100%;"
|+Reference to non-tax documents
|- valign="center"
|colspan="2"|'''Anex 1.8 - 13.1.4. Reference to non-tax documents: cbc:DocumentTypeCode''' 
This element refers to the'''xpath /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode'''. These documents represent commercial and mercantile actions that protect or support transactions related to this electronic document.

The XML electronic documents adopted by the DIAN should not be included in this fragment since these documents do not contain the standard identifications such as CUFE or CUDE.

As it is a delivery order, the '''OrderReference''', element group must be used. When reporting more than one, the AdditionalDocumentReference group must be available.

This field of this group of information is optional to reference commercial issues at the will of the electronic biller, therefore, the codes are assigned by it.
|}

<center>'''TABLES OF CODES FOR THE ISSUANCE OF DOCUMENTS IN THE HEALTH SECTOR'''</center>
==Table 22==
{| class="wikitable" style="width: 100%;"
|+ Identification Document Type- Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Abv
! style="color:white;background:#2F5496; text-align:center;"|Type of Identification Document
|- valign="center"
|-
|CC
|Citizenship card
|-
|CE
|Immigration Certificate
|-
|CD
|Diplomatic ID
|-
|PA
|Passport
|-
|SC
|Safe conduct
|-
|PE
|special stay permit
|-
|RC
|Civil registration of birth
|-
|TI
|Identity Card
|-
|CN
|Live birth certificate
|-
|AS
|Adult Unidentified
|-
|MS
|Unidentified Minor
|-
|DE
|Foreign Document
|-
|SI
|Without Identification
|}
|}
==Table 23==
{| class="wikitable" style="width: 100%;"
|+ User Type - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|User type
|- valign="center"
|-
|01
|Contributing taxpayer
|-
|02
|Contributory beneficiary
|-
|03
|Additional contributory
|-
|04
|Subsidised
|-
|05
|Not regim
|-
|06
|Special or Contributing Exception
|-
|07
|Special or Exception beneficiary
|-
|08
|Individual
|-
|09
|Policyholder/Protected ARL
|-
|10
|Policyholder/Protected SOAT
|-
|11
|Policy holder/Protected voluntary health plans
|}
|}
==Table 24==
{| class="wikitable" style="width: 100%;"
|+ Hiring Modalities - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Hiring Modalities
|- valign="center"
|-
|01
|Package / Basket / Comprehensive Health Set
|-
|02
|Diagnosis-related Groups
|-
|03
|Comprehensive by risk group
|-
|04
|Payment by contact by specialty
|-
|05
|Payment per scenario of care
|-
|06
|Payment per service type
|-
|07
|Prospective global payment per episode
|-
|08
|Global prospective payment by risk group
|-
|09
|Prospective lump sum payment by specialty
|-
|10
|Prospective global payment by level of complexity
|-
|11
|Capacitation
|-
|12
|For service
|}
|}
==Table 25==
{| class="wikitable" style="width: 100%;"
|+ CService coverage or plan - Health Sector
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Service coverage or plan
|- valign="center"
|-
|01
|Health benefit plan financed by UPC
|-
|02
|Maximum budget
|-
|03
|EPS/EOC premium, uninsured SOAT
|-
|04
|Coverage SOAT Policy
|-
|05
|ARL cover
|-
|06
|ADRES coverage
|-
|07
|Public Health Cover
|-
|08
|Coverage of the territorial entity, supply resources
|-
|09
|Emergencies migrant population
|-
|10
|Supplemental health plan
|-
|11
|Prepaid Medical Plan
|-
|12
|Other health policies
|-
|13
|Special Regime Coverage or Exception
|-
|14
|National Health Fund Coverage for Persons Deprived of Liberty
|-
|15
|Private
|}
|}
==Table 26==
{| class="wikitable" style="width: 100%;"
|+ Collection Concepts
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|16
|Copayment
|-
|17
|Moderator Fee
|-
|18
|Recovery Fee
|-
|19
|Shared plans in voluntary health plans
|}
|}
==Table 27==
{| class="wikitable" style="width: 100%;"
|+ Scenario Types
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|Record of the Concept of collection to the patient
|-
|2
|Registration of the concept of accreditation to the EPS
|-
|3
|Record of operations without accreditation to the EPS
|-
|4
|Issuance of FEL without prior collection
|-
|5
|Including in a FEL the value to be credited for the collection
|}
|}
==Table 28==
{| class="wikitable" style="width: 100%;"
|+ Additional Data Fields
|- valign="center"
|-style="text-align:center;"
|colspan="2"|
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Name
! style="color:white;background:#2F5496; text-align:center;"|Label
! style="color:white;background:#2F5496; text-align:center;"|Description
|- valign="center"
|-
|1
|CODIGO_PRESTADOR
|Code assigned in the General System of Social Security in Health (SGSSS) to health service providers that are in the Special Registry of Health Service Providers (REPS) or the Code assigned by the Ministry of Health and Social Protection for public health laboratories.
|-
|2
|TIPO_DOCUMENTO_IDENTIFICACION
|User identification type
:[[Tables of property codes for issuance of documents - Direct Integration Manual Index#Table 22|Table 22]]
|-
|3
|NUMERO_DOCUMENTO_IDENTIFICACION
|Registration of the identification document number according to the type of user document
|-
|4
|PRIMER_APELLIDO
|First surname of the user as specified in the identification document.
|-
|5
|SEGUNDO_APELLIDO
|Second surname of the user as specified in the identification document.
|-
|6
|PRIMER_NOMBRE
|User's first name as specified in the identification document
|-
|7
|SEGUNDO_NOMBRE
|Second name of the user according to what is specified in the identification document
|-
|8
|TIPO_USUARIO
|Registration of the person's affiliation condition or relationship with the coverage or benefit plan.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 23|Table 23]]
|-
|9
|MODALIDAD_CONTRATACION
|Registration of the contracting and payment modality agreed to be billed. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 24|Table 24]]
|
|-
|10
|COBERTURA_PLAN_BENEFICIOS
|Registration of the entity responsible for financing the coverage or benefit plan. Mandatory.
:[[Property code tables for document issuance - Direct Integration Manual Index#Table 25|Table 25]]
|-
|11
|NUMERO_AUTORIZACION
|Compulsory: When there is the response authorization number or the request number, as the case may be. For emergencies, SOAT and ARL are empty
|-
|12
|NUMERO_MIPRES
|Assigned by MIPRES
|-
|13
|NUMERO_ENTREGA_MIPRES
|Assigned by MIPRES
|-
|14
|NUMERO_CONTRATO
|Number of the billing contract
|-
|15
|NUMERO_POLIZA
|Number of SOAT policy or voluntary health plans. Mandatory: When it comes to SOAT services or voluntary health plans. Diligence when it comes to care for a traffic accident or for care as a private individual for a health policy
|-
|16
|COPAGO
|Value actually paid by the user and collected by the service provider
|-
|17
|CUOTA_MODERADORA
|Value actually paid by the user and collected by the service provider
|-
|18
|CUOTA_RECUPERACION
|Value actually paid by the user and collected by the service provider
|-
|19
|PAGOS_COMPARTIDOS
|Value actually paid by the user and collected by the service provider
|}
|}

Additional features - Direct Integration Manual Index

2022-03-03T14:50:50Z

Lvargas: Página creada con «<includeonly>=</includeonly>==Additional features ==<includeonly>=</includeonly> ===Use of extra fields=== The “extras” array allows optional fields to be inserted in t…»

<includeonly>=</includeonly>==Additional features ==<includeonly>=</includeonly>
===Use of extra fields===
The “extras” array allows optional fields to be inserted in the XML-Invoice and in the printed representation as desired.

The extra fields are not required by the DIAN, but in certain cases they are important and necessary in the issuer's business model. These incorporate additional information within the document, such as payment details, delivery, transportation, geographic coordinates, batch of products, merchandise expiration, medical services, aeronautical services, free information, among many others.

The extensible fields are designed according to parameters established in the Colombian Chamber of Electronic Commerce and the DIAN, with the purpose of being interoperable (this is not yet fully defined for the prior validation model). The information to be inserted in an extensible field must meet criteria associated with the specific field to be inserted. The structure of the “extras” object is as follows:

{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="6"|String
|controlInterno1
|<nowiki>AN|100 </nowiki>
|Assigned label for PDF Printed Representation.
|-
|controlInterno2
|rowspan="2"|Depends on the field
|It allows associating two or more fields by means of an index (if the fields are associable)
|-
|nombre
|Code of the extensible field to be referenced (there are codes defined by TFHKA for specific information and free codes can also be used).
|-
|pdf
|<nowiki>N|1</nowiki>
|Indication of showing the field in the PDF graphic representation (“0” u003d Do not show / “1” u003d Show).
|-
|valor
|Depends on the field
|Value of the field to add.
|-
|xml
|<nowiki>N|1</nowiki>
|Indication to show the field in the XML (“0” u003d Do not show / “1” u003d Show)
|}
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Example of use of Extensible Fields 443 (Seller)
|- valign="center"
|
<ser:Extras>
<ser:controlInterno1>Vendedor</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>443</ser:nombre>
<ser:pdf>1</ser:pdf>
<ser:valor>Pablo Marmol</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|-
! style="background:#f2f2f2; text-align:center;"|Field inserted into the PDF
|- valign="center"
|
[[Archivo:CampoExtensibleVendedor.png|800px|sinmarco|centro|CampoExtensibleVendedor]]
|}
'''@IMPORTANT:''' It is recommended that the Extras.xml property be set to '0', as The Factory HKA implements the use of nested CDATAS in the XML structure to reflect the extra fields, however some receiving platforms cannot interpret this standard and there may be rejections at the time of filing the document if this property is assigned the value '1'

The label that is assigned in Extras.ControlInternal1 is of free choice, as long as the stipulated format is respected. However, it will be necessary to know the other parameters, which will be supplied with the available fields:
* The code of the field, to place in Extras.name.
* If the field is repeatable and associable, to place a common index on Extras.InternalControl2.
* The format of the field value, so that the information placed Extras.value is valid.
In addition to the available fields (codes reserved by TFHKA), the use of FREE fields has been considered, to insert generic identifiers and values.
: Please note the following example to insert a free field:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Example
|- valign="center"
|
<ser:Extras>
<ser:controlInterno1>PRICE LIST</ser:controlInterno1>
<ser:controlInterno2</ser:controlInterno2>
<ser:nombre>1</ser:nombre>
<ser:pdf>1</ser:pdf>
<ser:valor>WHOLESALER</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|-
! style="background:#f2f2f2; text-align:center;"|Field inserted into the PDF
|- valign="center"
|
[[Archivo:CamposLibresMayorista.png|800px|sinmarco|centro|Uso de Campos Libres para insertar Identifieres y valores genéricos]]
|}

===Code table for extra fields===
At this moment the codes or Extras.name property for extra fields reserved by TFHKA (any other code used is considered free) are the following:
; Extensible Fields reserved by TFHKA
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Code
! style="background:#f2f2f2; text-align:center;"|PDF label
! style="background:#f2f2f2; text-align:center;"|Description
! style="background:#f2f2f2; text-align:center;"|Value format
! style="background:#f2f2f2; text-align:center;"|Observations
|- valign="center"
|-
|122333
|Physical Acceptance
|Physical Acceptance
|<nowiki>AN|1000</nowiki>
|
|-
|100200
|Footer
|Footer
|<nowiki>AN|1000</nowiki>
|-
|5170000
|Total Excluded Base
|Total Excluded Base
|Free Format
|For totals the R.G.
|-
|5170001
|TOTAL Detail Discount
|TOTAL Detail Discount
|Free Format
|For totals the R.G.
|-
|5170002
|TOTAL Withholdings
|TOTAL Withholdings
|Free Format
|For totals the R.G.
|-
|5170003
|TOTAL to Pay
|TOTAL to Pay
|Free Format
|For totals the R.G.
|-
|5170004
|TOTAL TO PAY in Letters
|TOTAL TO PAY in Letters
|Free Format
|For totals the R.G.
|}
'''@IMPORTANT:''' The Physical Acceptance field can be applied in two scenarios. The first scenario, where the invoice is tacitly accepted and only the XML is generated (the PDF file is not generated on our platform), assuming that the delivery of the graphical representation is the responsibility of the user. The second scenario, in which the invoice is tacitly accepted and the XML and PDF are generated on our platform, which will be sent via email if the “notify” field is set to “YES”. For this last scenario, it is necessary that the "controlInterno2" field be set to "1".
<pre style="color: red">WARNING: If you use the option controlInterno2 u003d , our platform will not generate standard HKA representation, therefore PDF is not hosted on it and no It will be possible to view the graphic representation from the portal, in the purchaser's mail (view document section), download it through the service's DownloadPDF method, or forward it through the EnvioCorreo method.</pre>
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Example of the use of the extensible field 122333 in the XML
|- valign="center"
|
<ser:Extras>
<ser:controlInterno1/>
<ser:controlInterno2>1<ser:controlInterno2>
<ser:nombre>122333</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>1</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|}
===Personalized email===
The “extras” arrangement also allows you to handle some special features of the platform, such as personalized email. So that this information does not appear in the graphical representation, the pdf parameter of the “extras” object must be set to “0”.

@IMPORTANT: It is recommended that the '''Extras.xml''' property be set to '0', as The Factory HKA implements the use of nested CDATAS in the XML structure to reflect the extra fields, however some receiving platforms cannot interpret this standard and there may be rejections at the time of filing the document if this property is assigned the value '1'.

@IMPORTANT: It is recommended that the '''Extras.pdf''' is set to the value '0', so that the indicated information is not displayed in the standard graphical representation.
The custom email functionality allows you to configure the email subject, reply address and body on a transaction-by-transaction basis. The way to expose this information will be through extra fields.
; Expandable Fields for Personalized Email
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Code
! style="background:#f2f2f2; text-align:center;"|PDF label
! style="background:#f2f2f2; text-align:center;"|Description
! style="background:#f2f2f2; text-align:center;"|Value format
! style="background:#f2f2f2; text-align:center;"|Observations
|- valign="center"
|-
|11
|Email Body
|Email Body
|<nowiki>AN | 1000</nowiki>
|String that contains the html code of the email body.
|-
|13
|Subject of the Email
|Subject of the Email
|<nowiki>AN | 100</nowiki>
|Defined in the Technical Annex V1.7-2020 of the <nowiki>DIAN**</nowiki>
|-
|14
|Respond to
|Respond to
|<nowiki>AN | 100</nowiki>
|A single email address must be entered
|-
|1700
|Line of Business
|Line of Business
|<nowiki>AN|100</nowiki>
|(Optional) Inclusion of line of business in the email subject
|}
<nowiki>**</nowiki> The subject must comply with the following format:
: NIT of the Electronic Biller; Name of the Electronic Biller; Electronic Document Number; Document type code according to Table 1; Biller's business name; Business line (this last one optional, commercial agreement between the parties).
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Example of use of Extensible Fields 11,13 and 14 to personalize the Email
|- valign="center"
|
<ser:extras>
<ser:Extras>
<ser:controlInterno1>Email Body</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>11</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>Test String Email Body
@email.documento.urlAcuseRecibo</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
<ser:Extras>
<ser:controlInterno1>Subject of the Email</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>13</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>@email.emisor.razonSocial has sent you the
@email.documento.TypeDocumento @email.documento.numeroDocumento
</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
<ser:Extras>
<ser:controlInterno1>Respond to</ser:controlInterno1>
<ser:controlInterno2></ser:controlInterno2>
<ser:nombre>14</ser:nombre>
<ser:pdf>0</ser:pdf>
<ser:valor>notifications@thefactoryhka.com</ser:valor>
<ser:xml>0</ser:xml>
</ser:Extras>
|}
In order for the email to have the capacity to adopt the data of the transaction, a set of code variables is proposed, which will be replaced in the platform by the own value generated in it. These variables are shown below:
; Expandable Fields for Personalized Email
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Section
! style="background:#f2f2f2; text-align:center;"|Descriptor
! style="background:#f2f2f2; text-align:center;"|Referential value
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Location
|- valign="center"
|-
|rowspan="7"|Invoice information
|Electronic Document Number
|@email.documento.numeroDocumento
|Unique
|Subject/Body
|-
|CUFE
|@email.documento.cufe
|Unique
|Subject/Body
|-
|Date of Issue
|@email.documento.fechaEmision
|Unique
|Subject/Body
|-
|Time of Issue
|@email.documento.horaEmision
|Unique
|Subject/Body
|-
|Type of Electronic Document
|@email.documento.TypeDocumento
|Unique
|Subject/Body
|-
|Type of Invoice
|@email.documento.TypeFactura
|Unique
|Subject/Body
|-
|-
|Respond to
|@email.documento.responderA
|Unique
|Cuerpo
|-
|rowspan="5"|Issuing
|Type of Taxpayer
|@email.emisor.TypeContribuyente
|Unique
|Subject/Body
|-
|Type of Identity Document
|@email.emisor.TypeIdentidad
|Unique
|Subject/Body
|-
|Identity Document Number
|@email.emisor.numeroIdentidad
|Unique
|Subject/Body
|-
|Company Name
|@email.emisor.razonSocial
|Unique
|Subject/Body
|-
|Logo
|@email.emisor.logo
|Unique
|Cuerpo
|-
|rowspan="4"|Purchaser
|Type Contribuyente
|@email.receptor.TypeContribuyente
|Unique
|Subject/Body
|-
|Type of Identity Document
|@email.receptor.TypeIdentidad
|Unique
|Subject/Body
|-
|Identity Document Number
|@email.receptor.numeroIdentidad
|Unique
|Subject/Body
|-
|Company Name
|@email.receptor.razonSocial
|Unique
|Subject/Body
|-
|Acknowledge
|Receipt Acknowledgment
|@email.documento.urlAcuseRecibo
|Unique
|Cuerpo
|}
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Example of String for Email Body in html
|- valign="center"
|
<nowiki>Dear @email.receptor.razonSocial, you have received an ELECTRONIC DOCUMENT from @email.emisor.razonSocial; shipment made through the Technology Provider The Factory HKA Colombia SAS<div style="text-align:center;"><a style=" background-color: #154380; border: 1px solid #ffffff; border-radius: 20px; color: #ffffff; display: inline-block; font-family: sans-serif; font-size: 25px; font-weight: bold; line-height: 60px; text-align: center; text-decoration: none; width: 300px; -webkit-text-size-adjust: none;" class="btn btn-block btn-info" href="@email.documento.urlAcuseRecibo" target="_blank">Acknowledgment of receipt</a> </div> Please review the electronic document and press the Acknowledgment button This E-mail has been sent automatically, do not Respond to this account. @email.advertenciaThe information contained in this E-mail is confidential. If you received this email by an error, Please forward and delete</div></nowiki>
|}
@IMPORTANT: In order for the service to take the dynamic configuration of the “Email Body” field, the @email.documento.urlAcuseRecibo attribute must be present.
{{clear}}
=== GENERATION OF NOTES WITH AND WITHOUT DOCUMENT REFERENCE ===
For the generation of credit and debit notes, 3 scenarios are described:

==== Credit and debit notes that affect prior validation invoices ====
For the issuance of credit and debit notes, two referenced document arrangements must be sent, the first indicating the internal code u003d '4' which corresponds to the reasons for which the NC/ND ('''DiscrepancyResponse''') is generated and a second arrangement, indicating the internal code u003d '5' in which the data of the invoice affected by the NC/NC ('''BillingReference''').
: Example:
<pre>
<a:documentosReferenciados>
<a:DocumentoReferenciado>
<a:codigoEstatusDocumento>2</a:codigoEstatusDocumento>
<a:codigoInterno>4</a:codigoInterno>
<a:Description>
<b:string>Cancellation of electronic invoice</b:string>
</a:descripcion>
<a:fecha>2019-10-07</a:fecha>
<a:numeroDocumento>F4PM3</a:numeroDocumento>
</a:DocumentoReferenciado>
<a:DocumentoReferenciado>
<codigoInterno>5</codigoInterno> <cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1KqmCLKgxPpH6u5LiKrJvTb6FEyfVuoCcV0baab6b59cdc8b3</cufeDocReferenciado>
<fecha>2019-10-07</fecha>
<numeroDocumento>F4PM3</numeroDocumento>
</a:DocumentoReferenciado>
</a:documentosReferenciados>
</pre>
@IMPORTANT: The '''cufeDocReferenciado''' field must contain a total of 96 characters and the value of the FacturaGeneral.tipoOperacion field must be 20 (for NC) and 30 (for ND).

==== Credit and debit notes that do not affect invoices ====
Bear in mind that in each scenario the '''FacturaGeneral.TypeOperacion'''field must be correctly indicated:
* Code 22 for Credit Notes.
* Code 32 for Debit Notes.
According to what is described in the Technical Annex version 1.8

[[Archivo:Notas.TypeOperacion.png|800px|sinmarco|centro|Notas.TypeOperacion]]

@IMPORTANT: The Referenced Documents class must be sent in NULL.

=== TRANSMISSION OF CONTINGENCY DOCUMENTS TYPE 03 (ATTRIBUTABLE TO THE ISSUER) ===
The technological drawbacks on the part of the electronic biller imply that electronic invoicing has the following characteristics:
* Generate billing with contingency numbering on paper or by computer.
* The electronic biller must generate a letter declaring the technological inconvenience or overcoming it, which must be signed by the legal representative of the company and send it to the email contingencia.facturadorvp@dian.gov.co with the following: o Subject: Nit of the company separated with a dash the verification digit; Company name.
** Attached: PDF of the letter where they are declared in contingency with the signature of the legal representative.
** Body of the mail: Contact information (Names, telephone / Contact cell phone).
*** Note: This email will only be for receiving emails from electronic billers to report the contingency or overcome technological inconveniences.
*** Note: Additionally, if you want to deliver these records in writing, you can do so through filings, which must be sent to the DIAN - central level - electronic invoice.
* The invoicer will have 48 hours from the date on which the contingency is exceeded to transmit the electronic invoices in XML format to the DIAN.
* The electronic invoices generated and issued in contingency will pass the annex validation mesh, that is, the DIAN will respond with an Application Response of Document Validated by the DIAN, which will inform the notifications that may take place.
* Once the electronic invoicer leaves the contingency, it must proceed to the normal generation process.
* For credit note and debit note documents, the biller must NOT use the contingency numbering, but rather the normal consecutive number. The notes sent to the DIAN will be validated in the normal way in the DIAN. Due to the above, there is no concept of a contingency note, so care must be taken to first send the Contingency Invoices before generating notes on them and it is recommended to generate them in a normal operating environment.

====How to transmit a Type 03 contingency document?====
The transmission of the document is done through the '''Enviar''' of the Issuance Web Service provided by The Factory HKA, indicating the '''TypeDocumento''' attribute of the '''FacturaGeneral''' object equal to '03' and sending an object in the '''documentosReferenciados''' section, of the Issuance Web Service provided by The Factory HKA, indicating the '''TypeDocumento''' attribute of the '''FacturaGeneral''' object equal to '03' and sending an object of Type '''DocumentosReferenciados''' indicating the following:, of Type '''Referenced Documents''' indicating the following:
* '''codigoInterno''' = ‘1’
* '''fecha''' = ‘Date of issuance of the contingency document’
* '''numeroDocumento''' = ‘consecutive number of the issued contingency document’
* '''TypeCodigoDocumento''' = ‘Type of support document for the billing process for contingencies attributable to the electronic biller to be transmitted, as stipulated in numeral 12.1.4 of version 1.8 of the DIAN Technical Annex ’.
:: Types of supporting documents for the contingency billing process attributable to the electronic biller
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Code
! style="background:#f2f2f2; text-align:center;"|Description
|-
|FTC
|Invoice Checkbook Contingency
|-
|FTP
|Invoice Check Book Paper
|}

==== What will be the successful transmission response code that will be returned by the TFHKA WS? ====
The Send method will return code 201 or 208 upon successful receipt of the document on our platform, with the following message: "The document was received as an Electronic Contingency Document Type 03, it will be delivered asynchronously to the DIAN, for more information please consume DocumentStatus after 48 hours.” In said Response there will be CUDE and UBL.

==== When can I consult the result of the transmission of the document to the DIAN? ====
After 48 hours after filing the document on the platform, you can check its status to find out the result of the transaction before the DIAN.

==== Quick response QR code generation for contingency invoices ====
For the generation of the Quick Response Code - QR Code, in cases where the checkbook or paper sales invoice is generated through electronic computer systems, it must correspond to the following table:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Detail
|-
|NumFac: [NUMERO_FACTURA]
|-
|FecFac: [FECHA_FACTURA]
|-
|HorFac: [HORA_FACTURA(con GMT)]
|-
|NitFac: [NIT FACTURADOR]
|-
|DocAdq: [NUMERO_ID_ADQUIRIENTE]
|-
|ValFac: [VALOR_FACTURA]
|-
|ValIva: [VALOR_IVA]
|-
|ValOtroIm: [VALOR_OTROS_IMPUESTOS]
|-
|ValTolFac: [VALOR_TOTAL_FACTURA]
|}
; Ejemplo:
<pre>
NumFac: CTG2
FecFac: 2020-06-16
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 1003.00
ValIva: 190.57
ValOtroIm: 0.00
ValTolFac: 1193.57
</pre>
: SOAP Request Example of Contingency Invoice Type 03

[[Archivo:Ejemplo SOAP Request de Factura de Contingencia Type 03.png|800px|sinmarco|centro|Ejemplo SOAP Request de Factura de Contingencia Type 03]]

@IMPORTANT: It is not required that the acquirer be notified of the contingency documents transmitted to the DIAN, since the document physically delivered to it during the period in which the contingency was maintained corresponds to the legal document of the transaction carried out. The transmission of said information to the DIAN is for the purpose of notifying the regulatory entity of the transactions carried out during said period. Due to the above, it is recommended to send the '''notify''' field u003d 'NO' and not send the corresponding information to the '''Recipient''':

[[Archivo:Ejemplo SOAP Request de Factura de Contingencia Type 03. Notifica NO.png|800px|sinmarco|centro|Ejemplo SOAP Request de Factura de Contingencia Type 03 sin notificar]]

==== Notes to Documents in Contingency ====
As mentioned above, credit or debit notes do not have a contingency scheme, therefore, they must be generated in normal operations. Starting from this principle, the following scenarios emerge:
# If the note to be issued is electronically issued:
#:a. ''Affecting an electronic invoice:'' The note is issued in normal billing operation, taking into account informing the reference to documents in the attribute '''documentosReferenciados''' of the object '''FacturaGeneral''', sending two objects of Type '''DocumentosReferenciados ''' indicating the following:
#::i. ''Object 1 (to generate DiscrepancyResponse):'' the fields codigoEstatusDocumento; codigoInternou003d'4' and cufeDocReferenciado.
#::ii. ''Object 2 (to generate Billingreference):'' the fields codigoInterno=‘5’; cufeDocReferenciado; fecha; TypeCUFE and numeroDocumento.
#:b. ''Affecting a contingency invoice:'' The issuance of the note in this scenario will depend on:
#::i. ''Contingency Bill is transmitted to the DIAN:'' The note is issued in normal billing operation, taking into account informing the reference to documents in the attribute '''documentosReferenciados''' of the object '''FacturaGeneral''', sending two objects of Type '''DocumentosReferenciados''' indicating the following:
#::: ''Object 1 (to generate DiscrepancyResponse):'' the fields codigoEstatusDocumento; codigoInterno=‘4’ and cufeDocReferenciado=’CUDE of the document’.
#::: ''Object 2 (to generate Billingreference):'' the fields codigoInterno=‘5’; cufeDocReferenciado=’CUDE of the document’; date; TypeCUFE and numeroDocumento.
#::ii. ''Contingency invoice has not been transmitted to the DIAN:'' The issuance of the note "in contingency" (indicating consecutive and issue date of the affected invoice), with commitment of subsequent delivery to the DIAN, synchronized with the filing of the contingency invoice before the entity.
# Si la nota a emitir se expide “en contingencia”:
#:a. ''Afectando a una factura electrónica:'' The issuance of the note "in contingency" (indicating consecutive and issue date of the affected invoice), with commitment of subsequent delivery to the DIAN, synchronized with the filing of the contingency invoice before the entity.
#:b. ''Afectando a una factura de contingencia:'' The issuance of the note "in contingency" (indicating consecutive and issue date of the affected invoice), with commitment of subsequent delivery to the DIAN, synchronized with the filing of the contingency invoice before the entity.

===Submit electronic documents on reception platforms===
The XML that must be filed in the reception platforms is the one that our service sends in the mail notification called '''AttachedDocument''' (Document Container), the structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date, this XML can also be downloaded through the '''GenerarContenedor''' method.

[[Archivo:RadicarAttachedDocument (Contenedor de Documentos).png|800px|sinmarco|centro|Radicar AttachedDocument (Contenedor de Documentos)]]

[[Archivo:RadicarAttachedDocument (Contenedor de Documentos)UBL.png|800px|sinmarco|centro|Radicar AttachedDocument (Contenedor de Documentos) UBL]]

===Standard of the name of XML electronic documents===
The DIAN establishes in the Technical Annex the nomenclature that electronic documents must have.

@IMPORTANT: Through the Response of the Send method, they can capture the name of the document and later use this property, through the GenerarContenedor method, download the AttachedDocument and replace the first two initials with “ad”.

[[Archivo:nomenclaturaDIANdocumentoselectrónicos.png|800px|sinmarco|centro|nomenclaturaDIANdocumentoselectrónicos]]

===Enablement environment===
The released test environment (demo environment) corresponds to a technology provider's own test environment (The Factory HKA) with the aim that developers and Software Houses can test the adjustments made to the ERP under the billing model.

The enabling stage, in which the tests performed by the clients are sent to the DIAN testing web service, will be carried out in the productive environment of the TFHKA service. Once these tests have been satisfactorily completed, the DIAN will enable them as electronic billers.

Subsequently, they may start the issuance of electronic documents in normal operation.

====Transmission of Evidence Documents to the DIAN in a DEMO environment====
At this time, the issuance of test documents ('''DEMO environment''') directly against the DIAN is functional, that is, being able to carry out integration tests from your ERP with 100% DIAN validations without going through the local XSLT.

To reproduce this test scenario, the following configuration must be taken into account in the DEMO web portal:
# Enter to the Demo portal through the following URL: [https://demofactura.thefactoryhka.com.co/auth/login]
# Make the following settings:
#:a. The Issuing client must verify that their NIT is configured in the Fiscal Data, regardless of whether they have their own certificate loaded or that of The factory HKA:
[[Archivo:ConfigDatosFiscales.png|800px|sinmarco|centro|Configurar Datos Fiscales]]
#:b You must have requested the authorization resolution granted by the DIAN (resolution for a set of authorization tests), this resolution must be configured in the DEMO web portal as shown in the following image (bear in mind that the mode can be 'Manual with Prefix' or 'Manual without Prefix', this depends on the ERP):, with Prefix' or 'Manual without Prefix', it depends on the ERP):
[[Archivo:ConfigResolucion.png|800px|sinmarco|centro|Configurar Resolución]]
#:@IMPORTANT: The sequential must be configured with the Production2.1 environment Type, therefore the setTestID field must not be entered. '''It is recommended to indicate an Initial Range from one million (1,000,000), this in order to have a wide range for tests against the DIAN without affecting the range to be used in the emissions corresponding to the Enabling Set to be carried out in the productive environment.'''
#:c. Request by mail to the Integration or Support team the activation of the sequence previously created in the DEMO portal with the option of sending it to the DIAN:
:::* [mailto:integracion_fel_co@thefactoryhka.com integracion_fel_co@thefactoryhka.com] (Integration Department)
:::* [mailto:soporte_fel_co@thefactoryhka.com soporte_fel_co@thefactoryhka.com] (Support Department)
::: The e-mail must indicate the NIT of the Issuer and the configured prefix, which may be SETT or SETP depending on the prefix that the DIAN granted to the Issuer for its authorization.

<pre style="color: red">@NOTA: The emissions carried out in the testing environment with the enabling sequence will not affect the emissions corresponding to the enabling set in the production environment. Additionally, these emissions are not considered part of the rating set.</pre>

Direct Integration Manual Index - Electronic Bill

2022-03-03T14:43:31Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Version record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Web Soap Broadcast Service Methods - Direct Integration Manual Index|Web Soap Broadcast Service Methods]]==<includeonly>=</includeonly>
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Enviar Method|Enviar Method]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Anticipos|Class.Anticipos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Autorizado|Class.Autorizado]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Cliente|Class.Cliente]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.CondicionPago|Class.CondicionPago]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Destinatario|Class.Destinatario]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Entrega|Class.Entrega]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Extras|Class.Extras]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Extensible|Class.Extensible]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.MediosDePago|Class.MediosDePago]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Direccion|Class.Direccion]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Coordenadas|Class.Coordenadas]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Tributos|Class.Tributos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Obligaciones|Class.Obligaciones]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.sectorSalud|Class.sectorSalud]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Beneficiario|Class.Beneficiario]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.GeneralSalud|Class.GeneralSalud]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#EstadoDocumento Method|EstadoDocumento Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#EnvioCorreo Method|EnvioCorreo Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargaPDF Method|DescargaPDF Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargaXML Method|DescargaXML Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#FoliosRestantes Method|FoliosRestantes Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#CargarCertificado Method|CargarCertificado Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargarEventoXML Method|DescargarEventoXML Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#GenerarContenedor Method|GenerarContenedor Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#GenerarEvento Method|GenerarEvento Method]]

<includeonly>=</includeonly>==[[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill|Web soap service attachment methods]]==<includeonly>=</includeonly>
#[[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#“CargarAdjuntos” Method|“CargarAdjuntos” Method]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#SCENARIOS ISSUANCE OF DOCUMENTS WITH GRAPHIC REPRESENTATION|SCENARIOS ISSUANCE OF DOCUMENTS WITH GRAPHIC REPRESENTATION]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#Standard Graphical Representation (Using the Attachment parameter of the Send method as '0' or '1')|Standard Graphical Representation (Using the Attachment parameter of the Send method as '0' or '1')]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#Custom graphic representation by TFHKA|Custom graphic representation by TFHKA]]
# [[Web soap service attachment methods - Direct Integration Manual Index - Electronic Bill#Graphic representation sent as an attachment from the administrative system or ERP (Use of the attachments parameter of the method Send in '11')|Graphic representation sent as an attachment from the administrative system or ERP (Use of the attachments parameter of the method Send in '11')]]

<includeonly>=</includeonly>==[[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill|Web soap reporting service methods]]==<includeonly>=</includeonly>
# [[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill#“DescargarReporte” Method|“DescargarReporte” Method]]
# [[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill#“ProgramarReporte” Method|“ProgramarReporte” Method]]
# [[Web soap reporting service methods - Direct Integration Manual Index - Electronic Bill#“SolicitudReporteSincrono” Method|“SolicitudReporteSincrono” Method]]

<includeonly>=</includeonly>==[[Additional features - Direct Integration Manual Index|Additional features]]==<includeonly>=</includeonly>
# [[Additional features - Direct Integration Manual Index#Use of extra fields|Use of extra fields]]
# [[Additional features - Direct Integration Manual Index#Code table for extra fields|Code table for extra fields]]
# [[Additional features - Direct Integration Manual Index#Personalized email|Personalized email]]
# [[Additional features - Direct Integration Manual Index#GENERATION OF NOTES WITH AND WITHOUT DOCUMENT REFERENCE|GENERATION OF NOTES WITH AND WITHOUT DOCUMENT REFERENCE]]
## [[Additional features - Direct Integration Manual Index#Credit and debit notes that affect prior validation invoices|Credit and debit notes that affect prior validation invoices]]
## [[Additional features - Direct Integration Manual Index#Credit and debit notes that do not affect invoices|Credit and debit notes that do not affect invoices]]
## [[Additional features - Direct Integration Manual Index#TRANSMISSION OF CONTINGENCY DOCUMENTS TYPE 03 (ATTRIBUTABLE TO THE ISSUER)|TRANSMISSION OF CONTINGENCY DOCUMENTS TYPE 03 (ATTRIBUTABLE TO THE ISSUER)]]
# [[Additional features - Direct Integration Manual Index#Submit electronic documents on reception platforms|Submit electronic documents on reception platforms]]
# [[Additional features - Direct Integration Manual Index#Standard of the name of XML electronic documents|Standard of the name of XML electronic documents]]
# [[Additional features - Direct Integration Manual Index#Enablement environment|Enablement environment]]
<includeonly>=</includeonly>==[[Property code tables for document issuance - Direct Integration Manual Index |Property code tables for document issuance]]==<includeonly>=</includeonly>
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 1|Table 1]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 2|Table 2]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 3|Table 3]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 4|Table 4]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 5|Table 5]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 6|Table 6]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 7|Table 7]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 8|Table 8]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 9|Table 9]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 10|Table 10]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 11|Table 11]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 12|Table 12]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 13|Table 13]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 14|Table 14]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 15|Table 15]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 16|Table 16]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 17|Table 17]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 18|Table 18]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 19|Table 19]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 20|Table 20]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 21|Table 21]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 22|Table 22]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 23|Table 23]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 24|Table 24]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 25|Table 25]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 26|Table 26]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 27|Table 27]]
# [[Property code tables for document issuance - Direct Integration Manual Index #Table 28|Table 28]]

<includeonly>=</includeonly>==[[Catalog of web service response errors - Direct Integration Manual Index - Electronic Bill|Catalog of web service response errors]]==<includeonly>=</includeonly>

{{clear}}

Métodos servicio adjuntos web soap - Indice Manual Integración Directa

2022-03-02T14:24:21Z

Lvargas:

<includeonly>=</includeonly>==Web soap attachment service methods==<includeonly>=</includeonly>
The SOAP Web Attachment Service exposes a single method that will be used n times per generated electronic document, where n is the number of attached files that the electronic invoice that is being processed has (bear in mind that since it is an email where the invoice with its graphic representation and the attachments, then there is a limit of attachments based on the weight (in KB) of the same).
===“CargarAdjuntos” Method===
It allows attaching or sending files (attachments) by email during the issuance of the electronic document. This method is executed after consuming the '''Send''' method with the attachments parameter set to “1” or “11”. The flow of the method is presented below:
 
 
[[Archivo:Diagrama de Envió de adjuntos.png|1000px|thumb|Diagrama de Envío de adjuntos]]
 
 
'''@IMPORTANT:''' The '''CargarAdjuntos''' method receives among its parameters a field to indicate the sending of the mail, that is, if the field or property '''send''' receives a "0" then the document continues to wait for more attachments and if it receives "1" it sends with the attachments that have been uploaded so far.
 
 
 
; REQUEST: Parameters to Send
 
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by The Factory HKA Colombia
|-
|tokenPassword
|-
|Adjunto
|Adjunto
|Control data of the document that you want to attach
|}
Where Class.Adjunto contains the information below:
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|byte[]
|Archivo
|Byte array of the file to attach
|-
|Array <string>
|email
|Mail to which you want to send the XML (AttachedDocument) with all the attachments loaded so far (sending is activated when send is "1")
|-
|String
|Enviar
|
: "0" Attach file and associate it to the electronic document without sending the email to the Purchaser
: "1" Attach the file to the electronic document and immediately send an email to the Acquirer
|-
|String
|Formato
|Attachment extension, allowed formats:
: (png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx,rar)
|-
|String
|Nombre
|Name that the attached file will take
|-
|String
|numeroDocumento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|String
|Type
| 1: Graphic representation generated by the ERP 2: Type of attached document or attachments
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Mensaje
|This error identification message
|-
|Array <String>
|mensajesValidacion
|Messages in case of refusal
|-
|String
|resultado
|Result
|}
{{clear}}

==='''SCENARIOS ISSUANCE OF DOCUMENTS WITH GRAPHIC REPRESENTATION'''===

===Standard Graphical Representation (Using the Attachment parameter of the Send method as '0' or '1')===

Under this scenario, the issuer of electronic documents has the standard graphic representation generated by TFHKA, which will
be delivered to the acquirer in the notification email of the electronic document. During the issuance of the document, extra fields
reserved by TFHKA may be included in the standard graphic representation, which will include predetermined labels in it in order to
provide the reader of the representation with clarity about the amounts and information reported. The extra fields reserved by TFHKA in
the standard graphic representation are detailed below:

{| class="wikitable" style="width: 100%;"
|+
|- valign="center"
|-style="text-align:center;"
|colspan="2"|EXTENSIBLE FIELDS RESERVED BY TFHKA
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Code
! style="color:white;background:#2F5496; text-align:center;"|PDF Label
! style="color:white;background:#2F5496; text-align:center;"|Description
! style="color:white;background:#2F5496; text-align:center;"|PDF Label
! style="color:white;background:#2F5496; text-align:center;"|Observations
|- valign="center"
|100200
|Footer
|Footer
|AN|100
|
|-
|5170000
|Total Base Excluded
|Total Base Excluded
|Free format
|For totals the R.G
|-
|5170001
|TOTAL Discount Detail
|TOTAL Discount Detail
|Free format
|For totals the R.G
|-
|5170002
|TOTAL Withholdings
|TOTAL Withholdings
|Free format
|For totals the R.G
|-
|5170003
|TOTAL to Pay
|TOTAL to Pay
|Free format
|For totals the R.G
|-
|5170004
|TOTAL TO PAY in Letters
|TOTAL TO PAY in Letters
|Free format
|For totals the R.G
|}
|}
[[Archivo:CamposExtrasReservados.png|centro|CamposExtrasReservados]]
[[Archivo:EtiquetasRG.png|centro|EtiquetasRG]]

===Custom graphic representation by TFHKA===

In the event that the issuer contracts a graphic representation service with TFHKA, it must be taken into account that it is a development
project which entails time and associated costs. In addition to the time associated with the development of the personalized template by
TFHKA, the adaptation of the development in the accounting system must be taken into account, which must be carried out by the software house
or its developer, in order to report the extra fields. in which the information to be displayed will be reflected.

The extra fields mentioned above are provided by the TFHKA graphics team, once a version approved by the contributor is available for use.

@IMPORTANT: As can be seen, this scenario involves the development of both parties (ERP and TFHKA), therefore before contracting this service, the scope and customization costs must be determined.

===Graphic representation sent as an attachment from the administrative system or ERP (Use of the attachments parameter of the method Send in '11')===

In the case in which the issuer contracts a graphic representation service with the software house, developer or person in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:

* The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
* Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
* The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
* The elements of law required by any supervisory entity from the issuer of the documents.
* The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
* The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
* TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation before the DIAN.

'''During the synchronization of the attached files, the following aspects must be taken into account:'''

* The files to be synchronized must be Base64 encoded.
* It is recommended to indicate the emails reported in the Class.Recipient.email[] array as recipient emails.
* The names of the attached files to be synchronized must be different.
* Only the synchronization of one (1) file is allowed with the type parameter u003d '1', corresponding to the graphic representation of the electronic document.
* For the common attachments to be synchronized, which do not correspond to the graphic representation of the document, the type parameter of the Loading Attachments method must be set to '2', corresponding to Attachments or common attachments.
* All attachments to be synchronized must not exceed the weight of 1.8 MB, this in order to comply with the provisions of the Technical Annex of the DIAN regarding the maximum weight of 2MB of the .ZIP file delivered in the email notification.

Web Soap Broadcast Service Methods - Direct Integration Manual Index

2022-03-01T17:29:11Z

Lvargas:

<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly>
The parameters to be incorporated in the methods of this Web Service must comply with the format and the corresponding directives according to the following rules:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Format
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| A || Alphabetic character
|-
| N || Numeric character
|-
| AN || AlphaNumeric character
|-
| <nowiki> A|3 </nowiki> || 3 Alphabetic characters (fixed length)
|-
| <nowiki> N|3 </nowiki> || 3 Numeric characters (fixed length)
|-
| <nowiki> AN|3 </nowiki> || 3 alphaNumeric characters (fixed length)
|-
| <nowiki> A|..3 </nowiki> || Up to 3 Alphabetic characters (variable length)
|-
| <nowiki> N|..3 </nowiki> || Up to 3 Numeric characters (variable length)
|-
| <nowiki> AN|..3 </nowiki> || Up to 3 alphaNumeric characters (variable length)
|-
| <nowiki> N|2..6 </nowiki> || Between 2 and 6 Numeric characters (variable length)
|-
| INT32 || Whole. (Maximum Value: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Mandatory
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| YES || If it is mandatory for the DIAN
|-
| NOT || It is not mandatory for the DIAN
|-
| C/C || It is required where applicable (or under certain conditions by the client's business model)
|}
{{clear}}

===Enviar Method===
The function in charge of building and sending the electronic documents to the technology provider.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by technology provider
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|See the detail of the Invoice Object below
|-
|String
|adjuntos
|
Possible values:
: “0” Attachments are not allowed. XML and standard graphic representation is generated by The Factory HKA
: “1” Supports attachments. XML and standard graphic representation is generated by The Factory HKA
: “10” Attachments are not allowed. Only XML is generated without standard Graphic representation by The Factory HKA
: “11” Supports attachments. Only XML is generated without standard graphical representation by The Factory HKA
|}

'''@IMPORTANT:''' If the value “1” or “11” is sent in the '''attachments''' parameter, no email will be sent until the method is consumed '''CargarAdjuntos''' (ServicE Adjuntos Web SOAP). For documents that accept attachments, the field'''Destinatario.email''' of the client is required and the '''notify''' field must be set to “YES”.

<pre style="color: red">WARNING: If options '10' or '11' are used in the attachments parameter, our platform will not generate standard graphic representation (PDF), therefore PDF is not hosted on it and the graphic representation cannot be viewed from the platform. web portal, in the notification email to the acquirer (view document section), nor download through the DescargaPDF method of the SOAP Web Broadcast Service or forward the graphical representation through the EnvioCorreo method, since it is being assumed that it has been generated locally by the billing software (ERP).</pre>

Next, the diagram of the '''invoice object for the billing model with prior validation''' is exposed, where the changes in its structure can be seen with respect to the object used in the model with post validation :

* In Blue new classes/attributes that were not present in the post validation model.
* In Yellow existing classes/attributes in the post-validation model that underwent changes in pre-validation.
* In Orange existing classes/attributes in post-validation model that are deprecated (removed) in pre-validation.
 

The invoice object for the billing model with prior validation is described in greater detail below:
 

<center>'''Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagram Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Cliente]]
 
'''Diagram Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagram Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagram Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagram Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagram Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagram Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagram Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagram Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}
====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|anticipos
|Array <Anticipos>
| -
|NOT
|
: Information related to advances
: '''PATH''': /root/cac:PrepaidPayment
: (see detail in [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NOT
|
: Information of the person authorized to download documents
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver see detail in [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|YES
|
: The number of decimals to be used is sent (minimum 0, maximum 6)
: Rejection If more decimals are received in the amounts than those indicated in this field
: '''PATH''': Does not apply
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NOT
|
: Information related to a charge or a discount on an invoice scale that does not affect the tax base
: '''PATH''': /root/cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|YES
|
: Acquirer Information
: '''PATH''':/root/cac:AccountingCustomerParty
: (see detail in [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NOT
|
: Information related to the payment condition
: '''PATH''': /root/cac:PaymentTerms
: (see detail in [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..20
|YES
|
: Correlative/consecutive of the electronic document
: prefix concatenation (<nowiki>AN|..4</nowiki>) + the consecutive DIAN,
: according to the configuration in the web portal:
:: Manual with prefix: prefix required (No hyphen). Example: “PREF2147483647”
:: Manual without prefix: prefix not required. Example: “2147483647”
: Rejection Additional characters such as spaces or hyphens are not allowed
: Rejection Consecutive number must be equal to or greater than the initial value of the numbering range granted by the DIAN
: Rejection Consecutive number must be equal to or less than the final value of the numbering range granted by the DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|YES
|
: Details or product information
: '''PATH''': /root/cac:InvoiceLine
: (see detail in [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Information describing a referenced document
: '''Required''' on tipoDocumento invoices contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse and BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NOT
|
: Delivery information (Delivery) of goods
: '''PATH''': /root/cac:Delivery
: (see detail in [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|YES
|
: Date and time of issuance of the document, in format: YYYY-MM-DD HH:MM:SS
: Notification If the issue date is earlier than five (5) days from the calendar date
: Rejection If the issue date is later than ten calendar days
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Date/Time of the end of the billing period (Interval of dates to which the bill refers, for example in public services), in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Billing period start date/time, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Tax payment date, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Due date of the invoice, in format: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|YES
|
: General or global tax information
: Rejection If the taxes/withholdings reported in this arrangement do not correspond to what is reported in the details
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of general taxes/withholdings by type of impuesto/retención
: Rejection If the total value of the tax/withholding indicated is different from the sum of those reported in the impuestosGenrales arrangement
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NOT
|
: Additional information or free text related to the document
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|YES
|
: Information related to the payment of the invoice
: '''PATH''': /root/cac:PaymentMeans
: (see detail in [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|YES
|
: Currency or currency of the document
: Use ISO 4217 codes (Example Colombian Pesos “COP”)
: Rejection If the value does not correspond to one of the ISO 4217 codes
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NOT
|
: Information related to the purchase order
: '''PATH''': /root/cac:OrderReference
: (see detail in [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|YES
|
: Consecutive from which the series begins for the document to be issued, the prefix (with hyphen) must always be placed regardless of the sequential mode.
: Example: 'PREF-1123456'
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Rounding applied to arrive at totalMonto
: Rejection If rounding is greater than the greater value between 500 pesos or 0.1% of the total value of the invoice
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Information related to emissions from the Health Sector'''Required: When typeSector = '2'''' is informed
: (see detail in [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Information related to the exchange rate of foreign currency to Colombian peso (COP)
: '''Required''' If documenttype is export/international or if the base currency is different from “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (see detail in [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NOT
|
: Information used as an alternative method to report conversions to other currencies
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (see detail in [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Information related to the delivery
: '''Required''' If documenttype is export/international
: '''PATH''': /root/cac:DeliveryTerms
: (see detail in [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|YES
|
: Document type
: '''PATH''': Invoice, CreditNote, DebitNote
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|YES
|
: To issue documents from the Health Sector, indicate code '2' in this field
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|YES
|
: Operation type indicator
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Sum of all advance payments
: Rejection Si totalAnticipos does not correspond to the sum of the Anticipos.montoPagado attributes in the advances array
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Taxable Base Value: Sum of Taxable Bases for the calculation of taxes at the invoice level
: Rejection If totalBaseImponible is not equal to the sum of occurrences FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total gross value with taxes
: Rejection If totalGrossWithTax is not equal to the sum: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Charge: Sum of all charges applied at the invoice level
: Rejection If totalCargosAplicados does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Discount: Sum of all the discounts applied at the invoice level
: Rejection If totalDescuentos does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value to pay of the document: Total value of items (including charges and discounts at item level) + value of taxes + value of charges – value of discounts – value of advances
: Rejection If totalMonto is not consistent with the total value of items + value of taxes + value of charges – value of discounts – value of advances + rounding appliedno es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|YES
|
: Number or quantity of product lines (rows) present in the document
: Rejection If the value of totalProductos is different from the number of occurrences of rans in the detalleDeFactura array
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Gross Value before taxes: Sum of the gross values of the invoice lines
: Rejection If totalSinImpuestos does not correspond to the sum of the attributes precioTotalSinImpuestos in the detalleDeFactura array
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|YES
|
: Date on which the payment was received, in format: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Date on which the payment was made, in format: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NOT
|
: Time in which the payment was made, in format:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|YES
|
: Internal identification of the payment
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|YES
|
: Payment Instructions
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|YES
|
: Value of the advance payment, it cannot be higher than the total value of the invoice
: Notification If montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}
====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|direccion
|Direccion
| -
|NOT
|
: Direction
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Tradename
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Identification number
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Check digit
: '''Obligatory''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Business name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Telephone
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|YES
|
: ID Type
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: See list of possible values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Code to categorize the discount
: '''Mandatory''': If it is a discount at invoice level (general)
: Rejection If it is a discount and some of the values are not reported in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|Description
|String
|<nowiki>AN|10..5000</nowiki>
|YES
|
: Free text to inform the reason for the discount
: '''PATH''': …/cbc:AllowanceChargeReason
: Notification : If a charge or discount is reported and this item is not reported
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indicator of whether it is Charge "1" or Discount "0"
: Rejection : If this item contains information other than “1” or “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the charge or discount, if it is a discount, it cannot be higher than the base value
: Rejection : If it is Discount and monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Base Value to calculate the discount or charge,
: Rejection: If the montoBase is negative, if it is a discount it cannot be greater than the total value of the invoice
: Rejection: If montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Discount percentage
: Rejection If this element > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|YES
|
: Sequence order indicator
: '''PATH''': …/cbc:ID
|}
====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NOT
|
: Corresponds to the economic activity code CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NOT
|
: Last name of the acquirer.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: It allows specifying the means and data of the electronic delivery of the document
: '''Required''': If notify field = 'YES'
: '''PATH''': Not defined
: (see detail in [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|YES
|
:Tax details of the acquirer
: Rejection If the class is not informed
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Information detailing the receiving address of the acquirer
: '''Recommended''': This ransf address is the one that is painted in the standard graphical representation
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
:Tax address of the acquirer.
: '''Mandatory''': If the purchaser is responsible
: Notification If the acquirer is responsible and this class was not informed
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: E-mail of the acquirer that will go to the fiscal XML/UBL
: (only one email is sent in this field)
: '''PATH''': Does not apply node
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Legal information of the client
: Notification : If tipoPersona = '1' is reported and the attribute is not reported
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (see detail in [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Commercial name of the acquirer
: '''Obligatory''' If the commercial name will be shown in the Graphic Rep.
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''Recommended''': If the person is natural, concatenate in this field the full name (names + surnames)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NOT
|
: Additional contact note
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|YES
|
: Activates the sending of email to the acquirer.
: Possible values: “YES” or “NO”
: '''PATH''': Does not apply
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Number of the Document or Fiscal Identification of the purchaser
: '''Mandatory''' If the acquirer is responsible, he must inform the NIT
: Rejection If tipoIdentificacion is '31' and the NIT structure is invalid
: Rejection : It is generated if the value of AdditionalAccountID = “2” and it is not mentioned.
: Note : To identify the final consumer, the following document “222222222222” is used
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: NIT verification digit of the acquirer
: '''Required''': If TipoIndentificacion = 31, it must be informed
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|YES
|
: Obligations and regime of the acquirer
: Rejection If the class is not informed
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Second name of the acquirer.
: '''PATH''': Not defined
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NOT
|
: Purchaser's phone
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Acquirer ID Type
: ReRejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Note: To identify the final consumer, the code “13” is used.
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|YES
|
: Person type identifier
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}
====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NOT
|
: Event Code
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NOT
|
: Period Length
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NOT
|
: Period length unit of measure
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|YES
|
: Due date
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Payment conditions
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Associated payment method
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|YES
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Amount of the fine
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Penalty Amount
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period from
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period until
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Discount rate
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Payment Percentage
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Advance reference number
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}
====Class.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Unit quantity of this item per package.
: For example, if the item consists of three “six packs”, the quantity to be reported in QuantityPerPackage is 6, while the quantity to be reported in QuantityActual is 3, and the total number of cans being described is 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Real amount on which the price applies
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|YES
|
: Unit of the quantity on which the price applies
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Number of units of the product/service billed
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Information on charges and discounts
: '''Mandatory''' This arrangement must be reported at the item level, if and only if the charge or discount affects the item's tax base.
: If a general individual charge to the invoice generates VAT, it must be reported as an item
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Manufacturer code corresponding to the item
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Identifier code of the country of origin of the item or service
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Vendor code corresponding to the item
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Reported price type code
: '''Required''' For commercial samples (value = 01)
: Rejection If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|Description
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[1]
|-
|Description2
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[2]
|-
|Description3
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[3]
|-
|DescriptionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Technical data associated with the product or service
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Information describing a referenced document
: '''Required''' In invoices tipoDocumento Contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Standard code (item or service identification according to a standard)
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: Notification If it is an export invoice (tipoDocumento = 02), and the tariff subheading was not reported
: Notification If the code does not exist in a closed standard.
: Example: UNSPSC
: Notification If the code does not follow the rule of formation of an open code, but with verifiable values
: Example: GTIN, Example: Tariff headings
: '''Note''': In this case the code 999 (Taxpayer adoption standard) can be used to avoid reclassifying the products
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: Rejection If standardCodigo = 010 and estandarCodigoID is different from 9
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|NO
|
: Product code according to the standard informed in estandarCodigo
: View attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: organization standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub code of the product standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|YES
|
: tax information
: Rejection If there is more than one element with the same value in the attribute FacturaImpuestos.codigoTOTALImp
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Additionally, it should NOT be informed for invoices of the simple group I regime, nor for items whose concept in AIU contracts is not part of the tax base.
: At the item level, it only applies to taxes that must be reported at the item level, for example: VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of taxes for all types
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Rejection If the value of the total value of the indicated tax is different from the sum of what is reported in FacturaImpuestos. valorTOTALImp.
: At the item level, it only applies to taxes that must be reported at the item level, for example, VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: It serves to add specific product information that may be requested by authorities or entities other than the DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (see detail in [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the agent
: '''Obligatory''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Verifier Digit of the agent's NIT
: '''Required''' for mandated invoices
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Agent identification type
: '''Required''' For mandated invoices
: Notification If mandatorioNumeroIdentificacion is informed and the value of this field is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item brand.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item model.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicator of whether the item is free or not (no commercial value)
: '''Required''' For commercial samples
: Possible values: “1” (It is a free sample) or “0” (It is not a free sample)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Name of the manufacturer of the product/service
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Free text to add additional information to the article
: '''Mandatory''' Inform in the case of invoices for AIU-type service contracts. For the Administration item. In this case, the note must begin with the text: "AIU services contract for:" The taxpayer must include the object of the invoiced contract
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Value of the item or service.
: Corresponds to the value of the reference price of the item that is given as a sample or gift without commercial value
: '''Required''' For commercial samples
: Rejection If the precioReferencua attribute is reported, then the value of TotalPriceWithoutTaxes must be (0.00), since it is a commercial sample or gift
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Total price of the product or service.
: (quantityUnits*UnitSalePrice +charges-discounts +taxes)
: '''Required''' For use in graphical representations
: '''PATH''': Undefined
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the line without taxes.
: (QuantityUnits*UnitSalePrice +charges-discounts)
: Rejection If the TotalPriceWithoutTaxes attribute is reported as 0.00, then the ReferencePrice value must be reported since it is a commercial sample or gift
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Unit price of the product/service
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|YES
|
: Sequence order indicator (line number)
: Notification If it contains a value already used in the sequence attribute in another group of this file
: Notification If the numbers used in the different groups are not consecutive, starting at "1"
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Product serials (comma separator), Ex: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Manufacturer code corresponding to a sub-specification of the article
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Issuer/seller code corresponding to a sub-specification of the item
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: To classify the type of AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|YES
|
: Unit of measure code of the invoiced product/service
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|canalDeEntrega
|String
| -
|YES
|
: Electronic Document Delivery Means
: It can take the following values: 0– Email; 1– Reception; 2– Interoperability; 3- Whatsapp; 4- Telegram
: PATH: Does not apply
|-
|email
|Array <String>
| -
|C/C
|
: List of Emails to which the electronic document will be delivered if the DeliveryChannel='0'
: '''Required''' When deliveryChannel=’0’
: '''PATH''': Does not apply
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: scheduled date
: '''PATH''': Does not apply
|-
|mensajeProgramado
|String
| -
|NO
|
: Message
: '''PATH''': Does not apply
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the Recipient
: '''Required''' When deliveryChannel='1' or '2'
: '''PATH''': Does not apply
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Recipient Telephone
: '''Required''' When deliveryChannel='3' or '4'
: '''PATH''': Does not apply
|}
====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Required''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the ReferencedDocument information is going to be sent, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the transfer invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note.
: You can only report electronic invoices from the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|Description
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Ransfe date of the referenced document, in format: YYYY-MM-DD
: '''Mandatory''' When InternalCode is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Not defined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|YES
|
: Concatenation of the prefix and the referenced document number
: Rejection If codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document,
: Example: "National Sales Invoice"
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type.
: '''Required''' When InternalCode is '1'
: RejectionIf codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Note''': For remission orders, inform the code ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
|}
'''@IMPORTANT:'''
''# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentsReferenced must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; internalCode = '4', documentNumber, transfer.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Contingency Invoice''', an array of the ReferenceDocuments type must be sent, indicating the fields: internal code = '1', numberDocument, date, typeDocumentCode (corresponding to Contingency Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Carrier Data
: '''PATH''': ../cac:DeliveryParty
: (see detail in [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Dispatch Information
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Delivery information
: '''PATH''': ../cac:DeliveryAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Effective date and time of departure of the goods, in format: YYYY-MM-DD HH:MM:SS
: Rejection if the effective date of departure is before the date of issue
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Estimated date and time, in format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Real date, in Format: YYYY-MM-DD HH:MM:SS
: Rejection if the actual date is before the issue date
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Requested date, in Format: YYYY-MM-DD HH:MM:SS
: Rejection if the Requested date is before the issue date
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transportation data
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transportation Enrollment
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}
====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Label assigned for the PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|It depends on the field
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|It depends on the field
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|It depends on the field
|YES
|
: Value of the field to add
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indication to display the field in the XML
: (“0” = Don't show / “1” = Show)
: '''PATH''': Variable
|}
====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Assigned Label for PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|It depends on the field
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|It depends on the field
|YES
|
: Code of the extensible field to reference
: '''PATH''': Variable
|-
|valor
|String
|It depends on the field
|YES
|
: Value of the field to add
: '''PATH''': Variable
|}
====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tax base on which the value of the tax is calculated
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Retention type indicator
: '''PATH''': Not Defined
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|YES
|
: Tribute rate.
: In the event that the tax is a percentage of the taxable value: inform the "percentage" rate to be applied to the tax base
: Rejection If you report a different rate for one of the taxes listed in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|YES
|
: Identification of the unit of measure
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Base unit of measure for the tribute
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection If valorTributoUnidad element is informed and UnidadMedidaTributo is not informed
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tribute value. Product of the percentage applied to the tax base
: Rejection For taxes whose rate is stated in percentages, if valorTOTALImp is different from baseImponibleTOTALImp * percentageTOTALImp
: Rejection For taxes whose rate is stated in nominal values (for example, plastic bags), if valorTOTALImp is different from valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
:It is the nominal value of the tax per unit
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection if the unitMedidaTributo element is NOT informed.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}
'''@IMPORTANT''': In the case of the ICA and RETEICA in which the value of the percentage is based on a thousand, the value of said percentage must be reported based on a hundred, that is, if you want to report a percentage of 11.04% thousand for any of these taxes, it must be indicated in the TOTALImp percentage field as 1,104.
====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': To define
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Sum of all attributes valorTOTALImp
: Rejection If montoTotal is different from the sum of all occurrences ofFacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}
====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Code of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Payment channel code
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Optional not used for now
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Due date of payment of the invoice in format: YYYY-MM-DD
: '''Mandatory''' If the sale is on credit
: Rejection: If the payment method code is "2" and the expiration date is not sent
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Code corresponding to the means of payment
: Rejection:If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Payment method
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identifier or internal reference of the Payment
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Number of days for payment
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transfer number or check number
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}
====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: customer code
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Document Reference
: '''PATH''': ../cac:DocumentReference
: (see detail in [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Date of the Order, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|YES
|
: Purchase Order Number
: '''Required''' To send the Purchase Order
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Order Number
: '''Required''' To send the Order
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: CUFE type identifier
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Order type
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID of some referenced document
: '''PATH''': ../cbc:UUID
|}
'''NOTE:''' As it is a delivery order, the OrdemDeCompra class must be informed, if it is necessary to indicate more than one order, it must be informed through the DocumentReferenced class with '''codigoInterno''' ='1 ', this in order to send the information referring to them in the AdditionalDocumentReference group.

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If brings value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Information related to a charge or a discount
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Delivery Conditions Code
: '''Obligatory''' If it is an export/international invoice
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|To define
|NO
|
: Transport payment method: It is used to indicate how transport costs are paid, for example: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Information detailing the delivery address
: '''PATH''': ../cac:DeliveryLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Identification number
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of who assumes responsibility in case the merchandise is lost
: '''PATH''': ../cbc:LossRisk
|}
====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Care of
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: For the attention of
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: block name
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the street
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Additional Name to better specify the street name
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|City
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: City
: Rejection If country is "CO" and the content of this attribute does not correspond to one of the values in the 'Name' column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|YES
|
: department code
: If country is "CO", CodigoDepartamento must correspond to one of the values in the Code column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Mandatory''' for Responsible Issuers and Acquirers
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corresponding time zone correction
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: department name
: Rejection if the code of the country field is "CO" and the content of this attribute does not correspond to one of the values of the Name column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
:An addressable department of an organization
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|YES
|
: Client's address, without indicating city or department
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: District
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Bedroom
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|YES
|
: Identifier of the language used in the country name
: Notification If the content of this attribute does not correspond to one of the values of the ISO 639-1 standard
: NotificaNotificationión If this is a group with information regarding the address of the issuer of an electronic document, it must contain the literal "is"
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: address coordinates
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (see detail in [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Municipality Code
: Notification If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of a Building
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: House or building number
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Parcel Number
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|YES
|
:Customer country.
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Flat
: '''PATH''': ../cac:Address/cbc:Floor
|-
|Region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Region
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Subdivision (Name of the Neighborhood)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A specific location within a building
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Postal zone
: Notification If the content of this element does not correspond to a corresponding value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notification If the value of the CodigoDepartamento attribute is different from the first 2 digits of the postal code.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}
====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|gradosLatitud
|String
|To define
|NO
|
: latitude measure in degrees
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|To define
|NO
|
: measure of longitude in degrees
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Latitude measurement in decimal minutes in mm.mm format
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Longitude measurement in decimal minutes in mm.mm format
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of measurement of latitude in relation to the Equator
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of longitude measurement in relation to the Equator
: '''PATH''': ../cbc:LongitudeDirectionCode
|}
====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|Yes
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined (see detail in [[#Class.Extensible|Class.Extensible]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Establishment Code
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Acquirer Identifier.
: You must inform the NIT if you are responsible
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Check digit
: '''Mandatory''' If tipoIdentificacion =31, the DV of the NIT must be informed
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Billing prefix:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Customer identification type
: Rejection If the content of this element is different from “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|YES
|
: Obligations of the acquirer
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Optional, if informed, indicate “Not applicable”. Possible Values:
: 48: “Sales tax - IVA”
: 49: “Not responsible for IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}
====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
:additional quantity
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: additional code
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|codigoInterno2
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|Description
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: additional description
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Period End Date
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Beginning date of the period
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Characteristic you want to report on the item, for example: (Vehicle Use)
: Rejection For each name there must be a value
: '''PATH''': ../cbc:Name
: (For defining extensible field catalogs at the detail level)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Sequence order indicator
: '''PATH''': Not defined
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
:Value Type Indicator, example Value = ’1’
: '''PATH''': Does not apply
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Value of the characteristic to be reported, for example: (Particular)
: Rejection For each value there must be a name
: '''PATH''': ../cbc:Value
|}
====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Description
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tax Types
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Information on the Address of the Person Responsible for Delivery
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Email
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicator if it is information on “for the attention of” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Contact name
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Responsible for the Delivery
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
:Contact Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: Carrier NIT
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Check digit
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Billing Prefix
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Carrier Liability
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Telefax
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: carrier phone
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier Identification Type
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Tax address of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: carrier name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Carrier document number
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Verifier Digit of the NIT of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier document type
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Mandatory''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the information will be sent DocumentoReferenciado, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the electronic invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note. You can only report electronic invoices of the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|Description
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Issue date of the referenced document, in Format: YYYY-MM-DD
: '''Mandatory''' When internal code is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': Undefined
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Undefined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenation of the prefix and the referenced document number
: Rejection if codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document, Example: "National Sales Invoice"
: '''PATH''': Not defined
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type
: '''Required''' When InternalCode is '1'
: Rejection If codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''PATH''': Undefined
|}
'''''@IMPORTANT:'''
# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentosReferenciados must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; CodihoInterno = '4', numeroDocumento, Description.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Factura de Contingencia ''', an array of the documentosReferenciados type must be sent, indicating the fields: internal code = '1', numberDocument, date, tipoDocumentCode (corresponding to Contingenc Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Complementary data of the beneficiary of the health service for collection scenarios.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (see detail in [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|To define
|C/C
|
: To indicate the type of operation through which the collection was made in the accreditation or report scenarios
: '''PATH''': To be defined
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|For the report of the additional data fields of the Health Sector
: (see detail in [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|YES
|
: Type of Health Sector Scenario. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTE: The issuance of health sector documents is only available through version 4 of the issuance service. 

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Information detailing the address of the beneficiary of the health service.
: '''PATH''': ../cac:ResidenceAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Additional data fields of the Health Sector to report information associated with the beneficiaries of the health service
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
: (see detail in [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|nombre
|String
|N|..2
|Si
|
: Additional data field code.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Note: It must correspond to one of the codes in the column[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|depends on the field
|Yes
|
: Value of the additional data field of the health sector as appropriate.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Important''': In the case of the field '''rangoNumeracion''', this value must always have the following format (Pefijo-campoDesde), that is, said field is independent of the sequential mode configured in the portal (manual with prefix or manual without prefix).

In the case of the field '''consecutivoDocumento''', This field does depend on the sequential mode configured in the web portal.
* If the assigned modality is''“manual sin prefijo”'', the values for the fields rangoNumeracion and consecutivoDocumento’ They should be for example:
:: Invoice #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Invoice #2: rangeNumeracion= "PRUE-1", consecutiveDocument= "2"
:: ...
:: Invoice #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*If the assigned modality is ''“manual with prefix”'', the values for the fields rangoNumeracion and consecutivoDocumento must be, for example:
:: Invoice #1: rangeNumeracion= "PRUE-1", consecutiveDocument= "PRUE1"
:: Invoice #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Invoice #1000: rangeNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|ID
! style="background:#f2f2f2; text-align:center;"|Description
|-
|int
|codigo
|Indicates the status of the operation returned by the service, (to define catalog)
|-
|String
|consecutivoDocumento
|Prefix and Consecutive of the Concatenated Document without separators. For the example above it corresponds to: “PRUE980338337”
|-
|String
|cufe
|"Unique Electronic Invoice Code" corresponding to the document consulted.
|-
|Bool
|esValidoDian
|“true” if valid
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in YYYY-MM-DD HH:MM:SS format
|-
|String
|fechaRespuesta
|Day and time in which the electronic document was generated, in format AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the response code, useful for error identification
|-
|Array
|mensajesValidacion
|Validation messages in case of notification or rejection
|-
|String
|nombre
|Name defined by the DIAN
|-
|String
|qr
|QR code string concatenation (control element)
|-
|Array
|reglasNotificacionDIAN
|Validation rules in case of notification
|-
|Array
|reglasValidacionDIAN
|Validation rules in case of rejection
|-
|String
|resultado
|Method consumption result: Processed” or “Error”
|-
|String
|tipoCufe
|CUFE type algorithm. “CUFE-SHA384” or “CUDE-SHA384”
|-
|String
|xml
|XML file (type AttachedDocument) encoded in Base64
|}
Once the electronic invoice has been sent successfully (code '200' or '201' in the response), the attached files are sent (through the method'''CargarAdjuntos''') consuming the SOAP Web Attachments Service, in the scenario that the '''attachments''' parameter has been assigned to “1” or “11”, otherwise the SOAP Web Attachments Service will return an error indicating that the document does NOT support attachments.
{{clear}}

===EstadoDocumento Method===
It allows you to consult the status of the document indicated before the Acquirer, before the DIAN, the type of delivery and if it was successful, the list of associated events (ApplicationResponse) and other parameters of interest that can be useful in the software control processes billing (ERP) or for the business model of the issuing client.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Typr
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indicates if the document has physical acceptance (physically delivered): “true” or “false”
|-
|String
|acuseComentario
|Comment informed by the acquirer when making the acknowledgment
|-
|String
|acuseEstatus
|0: Acknowledgment not made ; 1: Acknowledgment made
|-
|String
|acuseResponsable
|Email of the person responsible for making the acknowledgment
|-
|String
|acuseRespuesta
|0: Response not sent; 1: Reply Sent
|-
|String
|ambiente
|Type of document generation environment:
:: “1: ProductionEnvironment”
:: “2: TestEnvironment”
|-
|String
|cadenaCodigoQR
|QR code string concatenation (control element)
|-
|String
|cadenaCufe
|Chain concatenation of the CUFE code prior to calculation by the corresponding algorithm of the service
|-
|int
|Codigo
|Indicates the status of the operation returned by the service
|-
|String
|consecutivo
|Consecutive Document TFHKA/DIAN
|-
|String
|cufe
|"Unique Code of Electronic Invoice" corresponding to the document consulted, calculated by the corresponding algorithm of the service
|-
|String
|DescriptionDocumento
|Reference document type identifier,
: Example: "National Sales Invoice"
|-
|String
|DescriptionEstatusDocumento
|Description corresponding to the statusDocument before the DIAN: "Processed Correctly"
|-
|String
|entregaMetodoDIAN
|Indicates the delivery method to the DIAN
: (Synchronous or Asynchronous), (Individual or Batch)
|-
|Bool
|esValidoDIAN
|
: “true” if valid
: "false" If not valid
|-
|String
|estatusDocumento
|Code obtained in the response corresponding to the status of the document before the DIAN (Catalogue to be defined)
|-
|Array <Evento>
|eventos
|List of Electronic Document events
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in format AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Date on which the document was generated, in format: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|History of document deliveries
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|mensajeDocumento
|Provides a description of the error of each of the initial validations. If there are no errors, no description is provided.
|-
|Bool
|poseeAdjuntos
|Indicates if the document has attachments:
: "true" or "false"
|-
|Bool
|poseeRepresentacionGrafica
|Indicates if the document has a graphic representation:
: "true" or "false"
|-
|Array <String>
|reglasValidacionDIAN
|Validation messages by the DIAN
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Reference document type identifier
: Watch [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|This element corresponds to the TrackId of the processed document
|}
Where Class.Evento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|ambienteDIAN
|Generation environment in the DIAN
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Code the document of the Application Response (event)
|-
|String
|comentario
|event commentary
|-
|String
|cufe
|CUFE of the electronic document
|-
|String
|DescriptionEvento
|Description of use/source of the event
|-
|String
|emisorNumeroDocumento
|Issuer Identification Number
|-
|String
|emisorNumeroDocumentoDV
|Issuer Document Number Check Digit
|-
|String
|emisorRazonSocial
|Company Name of the Issuer
|-
|String
|emisorTipoIdentificacion
|Issuer Identification Type
|-
|Array <ExtrasEvento>
|extras
|Extra information corresponding to the event
|-
|String
|fechaEmision
|Date of Issue of the Application Response (event)
|-
|String
|fechaRecepcion
|Application Response Reception Date (event)
|-
|String
|hash
|Application Response document hash
|-
|String
|idPerfilDIAN
|DIAN Profile
|-
|String
|mensaje
|ApplicationResponse description message
|-
|String
|nombreArchivoXML
|XML file name
|-
|String
|nota
|Content of the Note field of the Application Response
|-
|String
|numeroDelEvento
|Consecutive Application Response
|-
|String
|receptorNumeroDocumento
|Receiver Identification Number
|-
|String
|receptorNumeroDocumentoDV
|Receiver Document Number Check Digit
|-
|String
|receptorRazonSocial
|Receiver's Business Name
|-
|String
|receptorTipoIdentificacion
|Receiver Identification Type
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUDE of the event:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Event type identifier:
: (Internal/ApplicationResponse)
|-
|String
|versionUBL
|UBL version of the XML
|}
And Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|nombre
|Additional Description
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas will correspond to:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|IP address of the computer in which the acknowledgment of the notification mail was made
|-
|String
|LeidoEstatus
|Notification mail acknowledgment status
|-
|String
|LeidoFecha
|Date of acknowledgment of notification mail
|-
|String
|canalDeEntrega
|Electronic document delivery channel
|-
|Array <String>
|email
|Email of the recipient of the electronic document
|-
|String
|entregaEstatus
|Delivery status:
: '0': Mail not sent
: '200': Mail sent
|-
|String
|entregaEstatusDescription
|Delivery Status Description
|-
|String
|entregaFecha
|Document delivery date
|-
|String
|fechaProgramada
|Delivery Date
|-
|String
|mensajePersonalizado
|Personalized message to be delivered by Email, WhatsApp or Telegram
|-
|String
|nitProveedorReceptor
|NIT of the receiving Technological Provider, in case of delivery by Interoperability
|-
|String
|recepcionEmailComentario
|Customer Acknowledgment Comment
|-
|String
|recepcionEmailEstatus
|E-mail reception status
: 1: Accepted
: 2: Rejected
: 3: In verification
|-
|String
|recepcionEmailFecha
|Date of receipt of the Email
|-
|String
|recepcionEmailIPAddress
|Email receiving IP address
|-
|String
|telefono
|For delivery by Whatsapp/Telegram
|}
'''@Important:''' The structure of this Response may still be subject to change in a future update.
{{clear}}
===EnvioCorreo Method===
Allows you to forward the indicated document to one or more email addresses.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”. Allows sending multiple recipients (maximum 5) separated by a comma character ','
|-
|correo
|Email to which the document will be sent. Example name@company.com
|-
|adjuntos
|
: “0”: Resends the mail without attachments
: “1”: Forwards the mail with the attachments stored during the issuance of the document.
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|rowspan="2"|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Send''' method) the '''attachments''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform does not will generate standard graphical representation (PDF), therefore only the documents hosted on the platform (AttachedDocument) will be forwarded to the recipients. To forward the mail (with the AttachedDocument and attachments) to an email address different from the one used during the transmission, the '''CargarAtjuntos''' method of the SOAP Web Attachments Service can be used again.
{{clear}}
===DescargaPDF Method===
Allows you to download the standard graphic representation (PDF generated by TFHKA) of the document for local storage, local consultation or reprint purposes.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted.
|-
|String
|documento
|Base64 encoded PDF document
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Enviar''' method) the '''adjuntos''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform will not will generate standard graphic representation (PDF), therefore this method cannot be used since the service will throw an error indicating that there is NO associated PDF, since it is assumed that the graphic representation has been generated locally by the billing software (ERP).
{{clear}}
=== DescargaXML Method===
It allows the download of the XML document (only the electronic document Invoice, CreditNote and DebitNote), in case it is required to validate the information such as the signature or its authenticity or for the purpose of local management and storage.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted
|-
|String
|documento
|XML document (Invoice, CreditNote or DebitNote) encoded in Base64
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===FoliosRestantes Method===
Allows you to consult the stamps (transactions) available. The stamps are consumed in proportion to the transactions made.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE:Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|int
|foliosRestantes
|Number of sheets available
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===CargarCertificado Method===
For now, this method will only be used internally by The Factory HKA Colombia.
{{clear}}
===DescargarEventoXML Method===
It allows downloading an event or occurrence (ApplicationResponse) related to an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
;RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|Documento
|XML document (ApplicationResponse) encoded in Base64
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===GenerarContenedor Method===
UA container is a type of AttachedDocument document, its structure is intended to contain and transmit an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) generated to date in a single XML file.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Contenedor
|XML document (AttachedDocument) encoded in Base64
|-
|String
|Fecha
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===GenerarEvento Method===
Allows the generation of an event or occurrence (ApplicationResponse) associated with an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Object with the data of the event (ApplicationResponse) to generate
|}
Where Class.DatosEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoEvento
|Indicates the code of the event (to define catalog)
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Comentario
|Comment or description of the event
|-
|String
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Additional event information
|}
Where Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Nombre Código
|of the field
|-
|String
|valor
|Additional Information
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|consecutivoDocumentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|XML document (ApplicationResponse) encoded in Base64
|}
{{clear}}

Web Soap Broadcast Service Methods - Direct Integration Manual Index

2022-03-01T16:29:46Z

Lvargas:

<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly>
The parameters to be incorporated in the methods of this Web Service must comply with the format and the corresponding directives according to the following rules:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Format
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| A || Alphabetic character
|-
| N || Numeric character
|-
| AN || AlphaNumeric character
|-
| <nowiki> A|3 </nowiki> || 3 Alphabetic characters (fixed length)
|-
| <nowiki> N|3 </nowiki> || 3 Numeric characters (fixed length)
|-
| <nowiki> AN|3 </nowiki> || 3 alphaNumeric characters (fixed length)
|-
| <nowiki> A|..3 </nowiki> || Up to 3 Alphabetic characters (variable length)
|-
| <nowiki> N|..3 </nowiki> || Up to 3 Numeric characters (variable length)
|-
| <nowiki> AN|..3 </nowiki> || Up to 3 alphaNumeric characters (variable length)
|-
| <nowiki> N|2..6 </nowiki> || Between 2 and 6 Numeric characters (variable length)
|-
| INT32 || Whole. (Maximum Value: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Mandatory
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| YES || If it is mandatory for the DIAN
|-
| NOT || It is not mandatory for the DIAN
|-
| C/C || It is required where applicable (or under certain conditions by the client's business model)
|}
{{clear}}

===Enviar Method===
The function in charge of building and sending the electronic documents to the technology provider.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by technology provider
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|See the detail of the Invoice Object below
|-
|String
|adjuntos
|
Possible values:
: “0” Attachments are not allowed. XML and standard graphic representation is generated by The Factory HKA
: “1” Supports attachments. XML and standard graphic representation is generated by The Factory HKA
: “10” Attachments are not allowed. Only XML is generated without standard Graphic representation by The Factory HKA
: “11” Supports attachments. Only XML is generated without standard graphical representation by The Factory HKA
|}

'''@IMPORTANT:''' If the value “1” or “11” is sent in the '''attachments''' parameter, no email will be sent until the method is consumed '''CargarAdjuntos''' (ServicE Adjuntos Web SOAP). For documents that accept attachments, the field'''Destinatario.email''' of the client is required and the '''notify''' field must be set to “YES”.

<pre style="color: red">WARNING: If options '10' or '11' are used in the attachments parameter, our platform will not generate standard graphic representation (PDF), therefore PDF is not hosted on it and the graphic representation cannot be viewed from the platform. web portal, in the notification email to the acquirer (view document section), nor download through the DescargaPDF method of the SOAP Web Broadcast Service or forward the graphical representation through the EnvioCorreo method, since it is being assumed that it has been generated locally by the billing software (ERP).</pre>

Next, the diagram of the '''invoice object for the billing model with prior validation''' is exposed, where the changes in its structure can be seen with respect to the object used in the model with post validation :

* In Blue new classes/attributes that were not present in the post validation model.
* In Yellow existing classes/attributes in the post-validation model that underwent changes in pre-validation.
* In Orange existing classes/attributes in post-validation model that are deprecated (removed) in pre-validation.
 

The invoice object for the billing model with prior validation is described in greater detail below:
 

<center>'''Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagram Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Cliente]]
 
'''Diagram Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagram Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagram Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagram Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagram Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagram Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagram Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagram Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}
====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|anticipos
|Array <Anticipos>
| -
|NOT
|
: Information related to advances
: '''PATH''': /root/cac:PrepaidPayment
: (see detail in [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NOT
|
: Information of the person authorized to download documents
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver see detail in [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|YES
|
: The number of decimals to be used is sent (minimum 0, maximum 6)
: Rejection If more decimals are received in the amounts than those indicated in this field
: '''PATH''': Does not apply
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NOT
|
: Information related to a charge or a discount on an invoice scale that does not affect the tax base
: '''PATH''': /root/cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|YES
|
: Acquirer Information
: '''PATH''':/root/cac:AccountingCustomerParty
: (see detail in [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NOT
|
: Information related to the payment condition
: '''PATH''': /root/cac:PaymentTerms
: (see detail in [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..20
|YES
|
: Correlative/consecutive of the electronic document
: prefix concatenation (<nowiki>AN|..4</nowiki>) + the consecutive DIAN,
: according to the configuration in the web portal:
:: Manual with prefix: prefix required (No hyphen). Example: “PREF2147483647”
:: Manual without prefix: prefix not required. Example: “2147483647”
: Rejection Additional characters such as spaces or hyphens are not allowed
: Rejection Consecutive number must be equal to or greater than the initial value of the numbering range granted by the DIAN
: Rejection Consecutive number must be equal to or less than the final value of the numbering range granted by the DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|YES
|
: Details or product information
: '''PATH''': /root/cac:InvoiceLine
: (see detail in [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Information describing a referenced document
: '''Required''' on tipoDocumento invoices contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse and BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NOT
|
: Delivery information (Delivery) of goods
: '''PATH''': /root/cac:Delivery
: (see detail in [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|YES
|
: Date and time of issuance of the document, in format: YYYY-MM-DD HH:MM:SS
: Notification If the issue date is earlier than five (5) days from the calendar date
: Rejection If the issue date is later than ten calendar days
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Date/Time of the end of the billing period (Interval of dates to which the bill refers, for example in public services), in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Billing period start date/time, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Tax payment date, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Due date of the invoice, in format: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|YES
|
: General or global tax information
: Rejection If the taxes/withholdings reported in this arrangement do not correspond to what is reported in the details
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of general taxes/withholdings by type of impuesto/retención
: Rejection If the total value of the tax/withholding indicated is different from the sum of those reported in the impuestosGenrales arrangement
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NOT
|
: Additional information or free text related to the document
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|YES
|
: Information related to the payment of the invoice
: '''PATH''': /root/cac:PaymentMeans
: (see detail in [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|YES
|
: Currency or currency of the document
: Use ISO 4217 codes (Example Colombian Pesos “COP”)
: Rejection If the value does not correspond to one of the ISO 4217 codes
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NOT
|
: Information related to the purchase order
: '''PATH''': /root/cac:OrderReference
: (see detail in [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|YES
|
: Consecutive from which the series begins for the document to be issued, the prefix (with hyphen) must always be placed regardless of the sequential mode.
: Example: 'PREF-1123456'
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Rounding applied to arrive at totalMonto
: Rejection If rounding is greater than the greater value between 500 pesos or 0.1% of the total value of the invoice
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Information related to emissions from the Health Sector'''Required: When typeSector = '2'''' is informed
: (see detail in [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Information related to the exchange rate of foreign currency to Colombian peso (COP)
: '''Required''' If documenttype is export/international or if the base currency is different from “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (see detail in [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NOT
|
: Information used as an alternative method to report conversions to other currencies
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (see detail in [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Information related to the delivery
: '''Required''' If documenttype is export/international
: '''PATH''': /root/cac:DeliveryTerms
: (see detail in [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|YES
|
: Document type
: '''PATH''': Invoice, CreditNote, DebitNote
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|YES
|
: To issue documents from the Health Sector, indicate code '2' in this field
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|YES
|
: Operation type indicator
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Sum of all advance payments
: Rejection Si totalAnticipos does not correspond to the sum of the Anticipos.montoPagado attributes in the advances array
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Taxable Base Value: Sum of Taxable Bases for the calculation of taxes at the invoice level
: Rejection If totalBaseImponible is not equal to the sum of occurrences FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total gross value with taxes
: Rejection If totalGrossWithTax is not equal to the sum: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Charge: Sum of all charges applied at the invoice level
: Rejection If totalCargosAplicados does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Discount: Sum of all the discounts applied at the invoice level
: Rejection If totalDescuentos does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value to pay of the document: Total value of items (including charges and discounts at item level) + value of taxes + value of charges – value of discounts – value of advances
: Rejection If totalMonto is not consistent with the total value of items + value of taxes + value of charges – value of discounts – value of advances + rounding appliedno es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|YES
|
: Number or quantity of product lines (rows) present in the document
: Rejection If the value of totalProductos is different from the number of occurrences of rans in the detalleDeFactura array
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Gross Value before taxes: Sum of the gross values of the invoice lines
: Rejection If totalSinImpuestos does not correspond to the sum of the attributes precioTotalSinImpuestos in the detalleDeFactura array
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|YES
|
: Date on which the payment was received, in format: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Date on which the payment was made, in format: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NOT
|
: Time in which the payment was made, in format:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|YES
|
: Internal identification of the payment
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|YES
|
: Payment Instructions
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|YES
|
: Value of the advance payment, it cannot be higher than the total value of the invoice
: Notification If montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}
====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|direccion
|Direccion
| -
|NOT
|
: Direction
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Tradename
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Identification number
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Check digit
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Business name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Telephone
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|YES
|
: ID Type
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: See list of possible values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Code to categorize the discount
: '''Mandatory''': If it is a discount at invoice level (general)
: Rejection If it is a discount and some of the values are not reported in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|Description
|String
|<nowiki>AN|10..5000</nowiki>
|YES
|
: Free text to inform the reason for the discount
: '''PATH''': …/cbc:AllowanceChargeReason
: Notification : If a charge or discount is reported and this item is not reported
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indicator of whether it is Charge "1" or Discount "0"
: Rejection : If this item contains information other than “1” or “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the charge or discount, if it is a discount, it cannot be higher than the base value
: Rejection : If it is Discount and monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Base Value to calculate the discount or charge,
: Rejection: If the montoBase is negative, if it is a discount it cannot be greater than the total value of the invoice
: Rejection: If montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Discount percentage
: Rejection If this element > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|YES
|
: Sequence order indicator
: '''PATH''': …/cbc:ID
|}
====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NOT
|
: Corresponds to the economic activity code CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NOT
|
: Last name of the acquirer.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: It allows specifying the means and data of the electronic delivery of the document
: '''Required''': If notify field = 'YES'
: '''PATH''': Not defined
: (see detail in [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|YES
|
:Tax details of the acquirer
: Rejection If the class is not informed
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Information detailing the receiving address of the acquirer
: '''Recommended''': This ransf address is the one that is painted in the standard graphical representation
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
:Tax address of the acquirer.
: '''Mandatory''': If the purchaser is responsible
: Notification If the acquirer is responsible and this class was not informed
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: E-mail of the acquirer that will go to the fiscal XML/UBL
: (only one email is sent in this field)
: '''PATH''': Does not apply node
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Legal information of the client
: Notification : If tipoPersona = '1' is reported and the attribute is not reported
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (see detail in [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Commercial name of the acquirer
: '''Obligatory''' If the commercial name will be shown in the Graphic Rep.
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''Recommended''': If the person is natural, concatenate in this field the full name (names + surnames)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NOT
|
: Additional contact note
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|YES
|
: Activates the sending of email to the acquirer.
: Possible values: “YES” or “NO”
: '''PATH''': Does not apply
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Number of the Document or Fiscal Identification of the purchaser
: '''Mandatory''' If the acquirer is responsible, he must inform the NIT
: Rejection If tipoIdentificacion is '31' and the NIT structure is invalid
: Rejection : It is generated if the value of AdditionalAccountID = “2” and it is not mentioned.
: Note : To identify the final consumer, the following document “222222222222” is used
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: NIT verification digit of the acquirer
: '''Required''': If TipoIndentificacion = 31, it must be informed
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|YES
|
: Obligations and regime of the acquirer
: Rejection If the class is not informed
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Second name of the acquirer.
: '''PATH''': Not defined
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NOT
|
: Purchaser's phone
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Acquirer ID Type
: ReRejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Note: To identify the final consumer, the code “13” is used.
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|YES
|
: Person type identifier
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}
====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NOT
|
: Event Code
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NOT
|
: Period Length
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NOT
|
: Period length unit of measure
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|YES
|
: Due date
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Payment conditions
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Associated payment method
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|YES
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Amount of the fine
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Penalty Amount
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period from
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period until
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Discount rate
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Payment Percentage
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Advance reference number
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}
====Class.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Unit quantity of this item per package.
: For example, if the item consists of three “six packs”, the quantity to be reported in QuantityPerPackage is 6, while the quantity to be reported in QuantityActual is 3, and the total number of cans being described is 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Real amount on which the price applies
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|YES
|
: Unit of the quantity on which the price applies
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Number of units of the product/service billed
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Information on charges and discounts
: '''Mandatory''' This arrangement must be reported at the item level, if and only if the charge or discount affects the item's tax base.
: If a general individual charge to the invoice generates VAT, it must be reported as an item
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Manufacturer code corresponding to the item
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Identifier code of the country of origin of the item or service
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Vendor code corresponding to the item
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Reported price type code
: '''Required''' For commercial samples (value = 01)
: Rejection If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|Description
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[1]
|-
|Description2
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[2]
|-
|Description3
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[3]
|-
|DescriptionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Technical data associated with the product or service
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Information describing a referenced document
: '''Required''' In invoices tipoDocumento Contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Standard code (item or service identification according to a standard)
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: Notification If it is an export invoice (tipoDocumento = 02), and the tariff subheading was not reported
: Notification If the code does not exist in a closed standard.
: Example: UNSPSC
: Notification If the code does not follow the rule of formation of an open code, but with verifiable values
: Example: GTIN, Example: Tariff headings
: '''Note''': In this case the code 999 (Taxpayer adoption standard) can be used to avoid reclassifying the products
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: Rejection If standardCodigo = 010 and estandarCodigoID is different from 9
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|NO
|
: Product code according to the standard informed in estandarCodigo
: View attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: organization standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub code of the product standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|YES
|
: tax information
: Rejection If there is more than one element with the same value in the attribute FacturaImpuestos.codigoTOTALImp
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Additionally, it should NOT be informed for invoices of the simple group I regime, nor for items whose concept in AIU contracts is not part of the tax base.
: At the item level, it only applies to taxes that must be reported at the item level, for example: VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of taxes for all types
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Rejection If the value of the total value of the indicated tax is different from the sum of what is reported in FacturaImpuestos. valorTOTALImp.
: At the item level, it only applies to taxes that must be reported at the item level, for example, VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: It serves to add specific product information that may be requested by authorities or entities other than the DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (see detail in [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the agent
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Verifier Digit of the agent's NIT
: '''Required''' for mandated invoices
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Agent identification type
: '''Required''' For mandated invoices
: Notification If mandatorioNumeroIdentificacion is informed and the value of this field is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item brand.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item model.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicator of whether the item is free or not (no commercial value)
: '''Required''' For commercial samples
: Possible values: “1” (It is a free sample) or “0” (It is not a free sample)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Name of the manufacturer of the product/service
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Free text to add additional information to the article
: '''Mandatory''' Inform in the case of invoices for AIU-type service contracts. For the Administration item. In this case, the note must begin with the text: "AIU services contract for:" The taxpayer must include the object of the invoiced contract
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Value of the item or service.
: Corresponds to the value of the reference price of the item that is given as a sample or gift without commercial value
: '''Required''' For commercial samples
: Rejection If the precioReferencua attribute is reported, then the value of TotalPriceWithoutTaxes must be (0.00), since it is a commercial sample or gift
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Total price of the product or service.
: (quantityUnits*UnitSalePrice +charges-discounts +taxes)
: '''Required''' For use in graphical representations
: '''PATH''': Undefined
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the line without taxes.
: (QuantityUnits*UnitSalePrice +charges-discounts)
: Rejection If the TotalPriceWithoutTaxes attribute is reported as 0.00, then the ReferencePrice value must be reported since it is a commercial sample or gift
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Unit price of the product/service
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|YES
|
: Sequence order indicator (line number)
: Notification If it contains a value already used in the sequence attribute in another group of this file
: Notification If the numbers used in the different groups are not consecutive, starting at "1"
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Product serials (comma separator), Ex: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Manufacturer code corresponding to a sub-specification of the article
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Issuer/seller code corresponding to a sub-specification of the item
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: To classify the type of AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|YES
|
: Unit of measure code of the invoiced product/service
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|canalDeEntrega
|String
| -
|YES
|
: Electronic Document Delivery Means
: It can take the following values: 0– Email; 1– Reception; 2– Interoperability; 3- Whatsapp; 4- Telegram
: PATH: Does not apply
|-
|email
|Array <String>
| -
|C/C
|
: List of Emails to which the electronic document will be delivered if the DeliveryChannel='0'
: '''Required''' When deliveryChannel=’0’
: '''PATH''': Does not apply
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: scheduled date
: '''PATH''': Does not apply
|-
|mensajeProgramado
|String
| -
|NO
|
: Message
: '''PATH''': Does not apply
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the Recipient
: '''Required''' When deliveryChannel='1' or '2'
: '''PATH''': Does not apply
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Recipient Telephone
: '''Required''' When deliveryChannel='3' or '4'
: '''PATH''': Does not apply
|}
====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Required''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the ReferencedDocument information is going to be sent, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the transfer invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note.
: You can only report electronic invoices from the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|Description
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Ransfe date of the referenced document, in format: YYYY-MM-DD
: '''Mandatory''' When InternalCode is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Not defined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|YES
|
: Concatenation of the prefix and the referenced document number
: Rejection If codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document,
: Example: "National Sales Invoice"
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type.
: '''Required''' When InternalCode is '1'
: RejectionIf codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Note''': For remission orders, inform the code ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
|}
'''@IMPORTANT:'''
''# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentsReferenced must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; internalCode = '4', documentNumber, transfer.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Contingency Invoice''', an array of the ReferenceDocuments type must be sent, indicating the fields: internal code = '1', numberDocument, date, typeDocumentCode (corresponding to Contingency Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Carrier Data
: '''PATH''': ../cac:DeliveryParty
: (see detail in [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Dispatch Information
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Delivery information
: '''PATH''': ../cac:DeliveryAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Effective date and time of departure of the goods, in format: YYYY-MM-DD HH:MM:SS
: Rejection if the effective date of departure is before the date of issue
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Estimated date and time, in format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en Format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en Format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}
====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indication to display the field in the XML
: (“0” = Don't show / “1” = Show)
: '''PATH''': Variable
|}
====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Assigned Label for PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|YES
|
: Code of the extensible field to reference
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|}
====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tax base on which the value of the tax is calculated
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Retention type indicator
: '''PATH''': Not Defined
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|YES
|
: Tribute rate.
: In the event that the tax is a percentage of the taxable value: inform the "percentage" rate to be applied to the tax base
: Rejection If you report a different rate for one of the taxes listed in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|YES
|
: Identification of the unit of measure
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Base unit of measure for the tribute
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection If valorTributoUnidad element is informed and UnidadMedidaTributo is not informed
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tribute value. Product of the percentage applied to the tax base
: Rejection For taxes whose rate is stated in percentages, if valorTOTALImp is different from baseImponibleTOTALImp * percentageTOTALImp
: Rejection For taxes whose rate is stated in nominal values (for example, plastic bags), if valorTOTALImp is different from valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
:It is the nominal value of the tax per unit
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection if the unitMedidaTributo element is NOT informed.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}
'''@IMPORTANT''': In the case of the ICA and RETEICA in which the value of the percentage is based on a thousand, the value of said percentage must be reported based on a hundred, that is, if you want to report a percentage of 11.04% thousand for any of these taxes, it must be indicated in the TOTALImp percentage field as 1,104.
====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Sum of all attributes valorTOTALImp
: Rejection If montoTotal is different from the sum of all occurrences ofFacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}
====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Code of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Payment channel code
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Optional not used for now
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Due date of payment of the invoice in format: YYYY-MM-DD
: '''Mandatory''' If the sale is on credit
: Rejection: If the payment method code is "2" and the expiration date is not sent
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Code corresponding to the means of payment
: Rejection:If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Payment method
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identifier or internal reference of the Payment
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Number of days for payment
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transfer number or check number
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}
====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: customer code
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Document Reference
: '''PATH''': ../cac:DocumentReference
: (see detail in [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Date of the Order, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|YES
|
: Purchase Order Number
: '''Required''' To send the Purchase Order
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Order Number
: '''Required''' To send the Order
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: CUFE type identifier
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Order type
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID of some referenced document
: '''PATH''': ../cbc:UUID
|}
'''NOTE:''' As it is a delivery order, the OrdemDeCompra class must be informed, if it is necessary to indicate more than one order, it must be informed through the DocumentReferenced class with '''codigoInterno''' ='1 ', this in order to send the information referring to them in the AdditionalDocumentReference group.

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If brings value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Information related to a charge or a discount
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Delivery Conditions Code
: '''Obligatorio''' Se es factura de exportación/internacional
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Transport payment method: It is used to indicate how transport costs are paid, for example: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Information detailing the delivery address
: '''PATH''': ../cac:DeliveryLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Identification number
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of who assumes responsibility in case the merchandise is lost
: '''PATH''': ../cbc:LossRisk
|}
====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Care of
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: For the attention of
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: block name
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the street
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Additional Name to better specify the street name
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: Ciudad
: Rejection If country is "CO" and the content of this attribute does not correspond to one of the values in the 'Name' column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|YES
|
: department code
: If country is "CO", CodigoDepartamento must correspond to one of the values in the Code column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Mandatory''' for Responsible Issuers and Acquirers
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corresponding time zone correction
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: department name
: Rejection if the code of the country field is "CO" and the content of this attribute does not correspond to one of the values of the Name column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
:An addressable department of an organization
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|YES
|
: Client's address, without indicating city or department
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: District
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Bedroom
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|YES
|
: Identifier of the language used in the country name
: Notification If the content of this attribute does not correspond to one of the values of the ISO 639-1 standard
: NotificaNotificationión If this is a group with information regarding the address of the issuer of an electronic document, it must contain the literal "is"
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: address coordinates
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (see detail in [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Municipality Code
: Notification If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of a Building
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Parcel Number
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|YES
|
:Customer country.
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Flat
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Subdivision (Name of the Neighborhood)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A specific location within a building
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Postal zone
: Notification If the content of this element does not correspond to a corresponding value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notification If the value of the CodigoDepartamento attribute is different from the first 2 digits of the postal code.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}
====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: latitude measure in degrees
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: measure of longitude in degrees
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Latitude measurement in decimal minutes in mm.mm format
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Longitude measurement in decimal minutes in mm.mm format
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of measurement of latitude in relation to the Equator
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of longitude measurement in relation to the Equator
: '''PATH''': ../cbc:LongitudeDirectionCode
|}
====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined (see detail in [[#Class.Extensible|Class.Extensible]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Establishment Code
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Acquirer Identifier.
: You must inform the NIT if you are responsible
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Check digit
: '''Mandatory''' If tipoIdentificacion =31, the DV of the NIT must be informed
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Billing prefix:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Customer identification type
: Rejection If the content of this element is different from “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|YES
|
: Obligations of the acquirer
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Optional, if informed, indicate “Not applicable”. Possible Values:
: 48: “Sales tax - IVA”
: 49: “Not responsible for IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}
====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
:additional quantity
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: additional code
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|codigoInterno2
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|Description
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: additional description
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Period End Date
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Beginning date of the period
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Characteristic you want to report on the item, for example: (Vehicle Use)
: Rejection For each name there must be a value
: '''PATH''': ../cbc:Name
: (For defining extensible field catalogs at the detail level)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Sequence order indicator
: '''PATH''': Not defined
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
:Value Type Indicator, example Value = ’1’
: '''PATH''': Does not apply
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Value of the characteristic to be reported, for example: (Particular)
: Rejection For each value there must be a name
: '''PATH''': ../cbc:Value
|}
====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Description
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tax Types
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Information on the Address of the Person Responsible for Delivery
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Email
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicator if it is information on “for the attention of” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Contact name
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Responsible for the Delivery
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
:Contact Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: Carrier NIT
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Check digit
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Billing Prefix
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Carrier Liability
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Telefax
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: carrier phone
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier Identification Type
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Tax address of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: carrier name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Carrier document number
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Verifier Digit of the NIT of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier document type
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Mandatory''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the information will be sent DocumentoReferenciado, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the electronic invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note. You can only report electronic invoices of the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|Description
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en Format: YYYY-MM-DD
: '''Mandatory''' When internal code is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': Undefined
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Undefined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenation of the prefix and the referenced document number
: Rejection if codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document, Example: "National Sales Invoice"
: '''PATH''': Not defined
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type
: '''Required''' When InternalCode is '1'
: Rejection If codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''PATH''': Undefined
|}
'''''@IMPORTANT:'''
# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentosReferenciados must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; CodihoInterno = '4', numeroDocumento, Description.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Factura de Contingencia ''', an array of the documentosReferenciados type must be sent, indicating the fields: internal code = '1', numberDocument, date, tipoDocumentCode (corresponding to Contingenc Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Complementary data of the beneficiary of the health service for collection scenarios.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (see detail in [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|Por definir
|C/C
|
: To indicate the type of operation through which the collection was made in the accreditation or report scenarios
: '''PATH''': To be defined
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|For the report of the additional data fields of the Health Sector
: (see detail in [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|YES
|
: Type of Health Sector Scenario. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTE: The issuance of health sector documents is only available through version 4 of the issuance service. 

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Information detailing the address of the beneficiary of the health service.
: '''PATH''': ../cac:ResidenceAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Additional data fields of the Health Sector to report information associated with the beneficiaries of the health service
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
: (see detail in [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|nombre
|String
|N|..2
|Si
|
: Additional data field code.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Note: It must correspond to one of the codes in the column[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|depends on the field
|Yes
|
: Value of the additional data field of the health sector as appropriate.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Important''': In the case of the field '''rangoNumeracion''', this value must always have the following format (Pefijo-campoDesde), that is, said field is independent of the sequential mode configured in the portal (manual with prefix or manual without prefix).

In the case of the field '''consecutivoDocumento''', This field does depend on the sequential mode configured in the web portal.
* If the assigned modality is''“manual sin prefijo”'', the values for the fields rangoNumeracion and consecutivoDocumento’ They should be for example:
:: Invoice #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Invoice #2: rangeNumeracion= "PRUE-1", consecutiveDocument= "2"
:: ...
:: Invoice #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*If the assigned modality is ''“manual with prefix”'', the values for the fields rangoNumeracion and consecutivoDocumento must be, for example:
:: Invoice #1: rangeNumeracion= "PRUE-1", consecutiveDocument= "PRUE1"
:: Invoice #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Invoice #1000: rangeNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|ID
! style="background:#f2f2f2; text-align:center;"|Description
|-
|int
|codigo
|Indicates the status of the operation returned by the service, (to define catalog)
|-
|String
|consecutivoDocumento
|Prefix and Consecutive of the Concatenated Document without separators. For the example above it corresponds to: “PRUE980338337”
|-
|String
|cufe
|"Unique Electronic Invoice Code" corresponding to the document consulted.
|-
|Bool
|esValidoDian
|“true” if valid
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in YYYY-MM-DD HH:MM:SS format
|-
|String
|fechaRespuesta
|Day and time in which the electronic document was generated, in format AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the response code, useful for error identification
|-
|Array
|mensajesValidacion
|Validation messages in case of notification or rejection
|-
|String
|nombre
|Name defined by the DIAN
|-
|String
|qr
|QR code string concatenation (control element)
|-
|Array
|reglasNotificacionDIAN
|Validation rules in case of notification
|-
|Array
|reglasValidacionDIAN
|Validation rules in case of rejection
|-
|String
|resultado
|Method consumption result: Processed” or “Error”
|-
|String
|tipoCufe
|CUFE type algorithm. “CUFE-SHA384” or “CUDE-SHA384”
|-
|String
|xml
|XML file (type AttachedDocument) encoded in Base64
|}
Once the electronic invoice has been sent successfully (code '200' or '201' in the response), the attached files are sent (through the method'''CargarAdjuntos''') consuming the SOAP Web Attachments Service, in the scenario that the '''attachments''' parameter has been assigned to “1” or “11”, otherwise the SOAP Web Attachments Service will return an error indicating that the document does NOT support attachments.
{{clear}}

===EstadoDocumento Method===
It allows you to consult the status of the document indicated before the Acquirer, before the DIAN, the type of delivery and if it was successful, the list of associated events (ApplicationResponse) and other parameters of interest that can be useful in the software control processes billing (ERP) or for the business model of the issuing client.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Typr
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indicates if the document has physical acceptance (physically delivered): “true” or “false”
|-
|String
|acuseComentario
|Comment informed by the acquirer when making the acknowledgment
|-
|String
|acuseEstatus
|0: Acknowledgment not made ; 1: Acknowledgment made
|-
|String
|acuseResponsable
|Email of the person responsible for making the acknowledgment
|-
|String
|acuseRespuesta
|0: Response not sent; 1: Reply Sent
|-
|String
|ambiente
|Type of document generation environment:
:: “1: ProductionEnvironment”
:: “2: TestEnvironment”
|-
|String
|cadenaCodigoQR
|QR code string concatenation (control element)
|-
|String
|cadenaCufe
|Chain concatenation of the CUFE code prior to calculation by the corresponding algorithm of the service
|-
|int
|Codigo
|Indicates the status of the operation returned by the service
|-
|String
|consecutivo
|Consecutive Document TFHKA/DIAN
|-
|String
|cufe
|"Unique Code of Electronic Invoice" corresponding to the document consulted, calculated by the corresponding algorithm of the service
|-
|String
|DescriptionDocumento
|Reference document type identifier,
: Example: "National Sales Invoice"
|-
|String
|DescriptionEstatusDocumento
|Description corresponding to the statusDocument before the DIAN: "Processed Correctly"
|-
|String
|entregaMetodoDIAN
|Indicates the delivery method to the DIAN
: (Synchronous or Asynchronous), (Individual or Batch)
|-
|Bool
|esValidoDIAN
|
: “true” if valid
: "false" If not valid
|-
|String
|estatusDocumento
|Code obtained in the response corresponding to the status of the document before the DIAN (Catalogue to be defined)
|-
|Array <Evento>
|eventos
|List of Electronic Document events
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in format AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Date on which the document was generated, in format: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|History of document deliveries
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|mensajeDocumento
|Provides a description of the error of each of the initial validations. If there are no errors, no description is provided.
|-
|Bool
|poseeAdjuntos
|Indicates if the document has attachments:
: "true" or "false"
|-
|Bool
|poseeRepresentacionGrafica
|Indicates if the document has a graphic representation:
: "true" or "false"
|-
|Array <String>
|reglasValidacionDIAN
|Validation messages by the DIAN
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Reference document type identifier
: Watch [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|This element corresponds to the TrackId of the processed document
|}
Where Class.Evento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|ambienteDIAN
|Generation environment in the DIAN
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Code the document of the Application Response (event)
|-
|String
|comentario
|event commentary
|-
|String
|cufe
|CUFE of the electronic document
|-
|String
|DescriptionEvento
|Description of use/source of the event
|-
|String
|emisorNumeroDocumento
|Issuer Identification Number
|-
|String
|emisorNumeroDocumentoDV
|Issuer Document Number Check Digit
|-
|String
|emisorRazonSocial
|Company Name of the Issuer
|-
|String
|emisorTipoIdentificacion
|Issuer Identification Type
|-
|Array <ExtrasEvento>
|extras
|Extra information corresponding to the event
|-
|String
|fechaEmision
|Date of Issue of the Application Response (event)
|-
|String
|fechaRecepcion
|Application Response Reception Date (event)
|-
|String
|hash
|Application Response document hash
|-
|String
|idPerfilDIAN
|DIAN Profile
|-
|String
|mensaje
|ApplicationResponse description message
|-
|String
|nombreArchivoXML
|XML file name
|-
|String
|nota
|Content of the Note field of the Application Response
|-
|String
|numeroDelEvento
|Consecutive Application Response
|-
|String
|receptorNumeroDocumento
|Receiver Identification Number
|-
|String
|receptorNumeroDocumentoDV
|Receiver Document Number Check Digit
|-
|String
|receptorRazonSocial
|Receiver's Business Name
|-
|String
|receptorTipoIdentificacion
|Receiver Identification Type
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUDE of the event:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Event type identifier:
: (Internal/ApplicationResponse)
|-
|String
|versionUBL
|UBL version of the XML
|}
And Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|nombre
|Additional Description
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas will correspond to:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|IP address of the computer in which the acknowledgment of the notification mail was made
|-
|String
|LeidoEstatus
|Notification mail acknowledgment status
|-
|String
|LeidoFecha
|Date of acknowledgment of notification mail
|-
|String
|canalDeEntrega
|Electronic document delivery channel
|-
|Array <String>
|email
|Email of the recipient of the electronic document
|-
|String
|entregaEstatus
|Delivery status:
: '0': Mail not sent
: '200': Mail sent
|-
|String
|entregaEstatusDescription
|Delivery Status Description
|-
|String
|entregaFecha
|Document delivery date
|-
|String
|fechaProgramada
|Delivery Date
|-
|String
|mensajePersonalizado
|Personalized message to be delivered by Email, WhatsApp or Telegram
|-
|String
|nitProveedorReceptor
|NIT of the receiving Technological Provider, in case of delivery by Interoperability
|-
|String
|recepcionEmailComentario
|Customer Acknowledgment Comment
|-
|String
|recepcionEmailEstatus
|E-mail reception status
: 1: Accepted
: 2: Rejected
: 3: In verification
|-
|String
|recepcionEmailFecha
|Date of receipt of the Email
|-
|String
|recepcionEmailIPAddress
|Email receiving IP address
|-
|String
|telefono
|For delivery by Whatsapp/Telegram
|}
'''@Important:''' The structure of this Response may still be subject to change in a future update.
{{clear}}
===EnvioCorreo Method===
Allows you to forward the indicated document to one or more email addresses.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”. Allows sending multiple recipients (maximum 5) separated by a comma character ','
|-
|correo
|Email to which the document will be sent. Example name@company.com
|-
|adjuntos
|
: “0”: Resends the mail without attachments
: “1”: Forwards the mail with the attachments stored during the issuance of the document.
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|rowspan="2"|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Send''' method) the '''attachments''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform does not will generate standard graphical representation (PDF), therefore only the documents hosted on the platform (AttachedDocument) will be forwarded to the recipients. To forward the mail (with the AttachedDocument and attachments) to an email address different from the one used during the transmission, the '''CargarAtjuntos''' method of the SOAP Web Attachments Service can be used again.
{{clear}}
===DescargaPDF Method===
Allows you to download the standard graphic representation (PDF generated by TFHKA) of the document for local storage, local consultation or reprint purposes.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted.
|-
|String
|documento
|Base64 encoded PDF document
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Enviar''' method) the '''adjuntos''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform will not will generate standard graphic representation (PDF), therefore this method cannot be used since the service will throw an error indicating that there is NO associated PDF, since it is assumed that the graphic representation has been generated locally by the billing software (ERP).
{{clear}}
=== DescargaXML Method===
It allows the download of the XML document (only the electronic document Invoice, CreditNote and DebitNote), in case it is required to validate the information such as the signature or its authenticity or for the purpose of local management and storage.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted
|-
|String
|documento
|XML document (Invoice, CreditNote or DebitNote) encoded in Base64
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===FoliosRestantes Method===
Allows you to consult the stamps (transactions) available. The stamps are consumed in proportion to the transactions made.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE:Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|int
|foliosRestantes
|Number of sheets available
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===CargarCertificado Method===
For now, this method will only be used internally by The Factory HKA Colombia.
{{clear}}
===DescargarEventoXML Method===
It allows downloading an event or occurrence (ApplicationResponse) related to an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
;RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|Documento
|XML document (ApplicationResponse) encoded in Base64
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===GenerarContenedor Method===
UA container is a type of AttachedDocument document, its structure is intended to contain and transmit an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) generated to date in a single XML file.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Contenedor
|XML document (AttachedDocument) encoded in Base64
|-
|String
|Fecha
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===GenerarEvento Method===
Allows the generation of an event or occurrence (ApplicationResponse) associated with an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Object with the data of the event (ApplicationResponse) to generate
|}
Where Class.DatosEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoEvento
|Indicates the code of the event (to define catalog)
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Comentario
|Comment or description of the event
|-
|String
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Additional event information
|}
Where Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Nombre Código
|of the field
|-
|String
|valor
|Additional Information
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|consecutivoDocumentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|XML document (ApplicationResponse) encoded in Base64
|}
{{clear}}

Web Soap Broadcast Service Methods - Direct Integration Manual Index

2022-03-01T16:23:01Z

Lvargas: /* Class.Anticipos */

<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly>
The parameters to be incorporated in the methods of this Web Service must comply with the format and the corresponding directives according to the following rules:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Format
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| A || Alphabetic character
|-
| N || Numeric character
|-
| AN || AlphaNumeric character
|-
| <nowiki> A|3 </nowiki> || 3 Alphabetic characters (fixed length)
|-
| <nowiki> N|3 </nowiki> || 3 Numeric characters (fixed length)
|-
| <nowiki> AN|3 </nowiki> || 3 alphaNumeric characters (fixed length)
|-
| <nowiki> A|..3 </nowiki> || Up to 3 Alphabetic characters (variable length)
|-
| <nowiki> N|..3 </nowiki> || Up to 3 Numeric characters (variable length)
|-
| <nowiki> AN|..3 </nowiki> || Up to 3 alphaNumeric characters (variable length)
|-
| <nowiki> N|2..6 </nowiki> || Between 2 and 6 Numeric characters (variable length)
|-
| INT32 || Whole. (Maximum Value: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Mandatory
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| YES || If it is mandatory for the DIAN
|-
| NOT || It is not mandatory for the DIAN
|-
| C/C || It is required where applicable (or under certain conditions by the client's business model)
|}
{{clear}}

===Enviar Method===
The function in charge of building and sending the electronic documents to the technology provider.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by technology provider
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|See the detail of the Invoice Object below
|-
|String
|adjuntos
|
Possible values:
: “0” Attachments are not allowed. XML and standard graphic representation is generated by The Factory HKA
: “1” Supports attachments. XML and standard graphic representation is generated by The Factory HKA
: “10” Attachments are not allowed. Only XML is generated without standard Graphic representation by The Factory HKA
: “11” Supports attachments. Only XML is generated without standard graphical representation by The Factory HKA
|}

'''@IMPORTANT:''' If the value “1” or “11” is sent in the '''attachments''' parameter, no email will be sent until the method is consumed '''CargarAdjuntos''' (ServicE Adjuntos Web SOAP). For documents that accept attachments, the field'''Destinatario.email''' of the client is required and the '''notify''' field must be set to “YES”.

<pre style="color: red">WARNING: If options '10' or '11' are used in the attachments parameter, our platform will not generate standard graphic representation (PDF), therefore PDF is not hosted on it and the graphic representation cannot be viewed from the platform. web portal, in the notification email to the acquirer (view document section), nor download through the DescargaPDF method of the SOAP Web Broadcast Service or forward the graphical representation through the EnvioCorreo method, since it is being assumed that it has been generated locally by the billing software (ERP).</pre>

Next, the diagram of the '''invoice object for the billing model with prior validation''' is exposed, where the changes in its structure can be seen with respect to the object used in the model with post validation :

* In Blue new classes/attributes that were not present in the post validation model.
* In Yellow existing classes/attributes in the post-validation model that underwent changes in pre-validation.
* In Orange existing classes/attributes in post-validation model that are deprecated (removed) in pre-validation.
 

The invoice object for the billing model with prior validation is described in greater detail below:
 

<center>'''Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagram Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Cliente]]
 
'''Diagram Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagram Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagram Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagram Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagram Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagram Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagram Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagram Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}
====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|anticipos
|Array <Anticipos>
| -
|NOT
|
: Information related to advances
: '''PATH''': /root/cac:PrepaidPayment
: (see detail in [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NOT
|
: Information of the person authorized to download documents
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver see detail in [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|YES
|
: The number of decimals to be used is sent (minimum 0, maximum 6)
: Rejection If more decimals are received in the amounts than those indicated in this field
: '''PATH''': Does not apply
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NOT
|
: Information related to a charge or a discount on an invoice scale that does not affect the tax base
: '''PATH''': /root/cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|YES
|
: Acquirer Information
: '''PATH''':/root/cac:AccountingCustomerParty
: (see detail in [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NOT
|
: Information related to the payment condition
: '''PATH''': /root/cac:PaymentTerms
: (see detail in [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..20
|YES
|
: Correlative/consecutive of the electronic document
: prefix concatenation (<nowiki>AN|..4</nowiki>) + the consecutive DIAN,
: according to the configuration in the web portal:
:: Manual with prefix: prefix required (No hyphen). Example: “PREF2147483647”
:: Manual without prefix: prefix not required. Example: “2147483647”
: Rejection Additional characters such as spaces or hyphens are not allowed
: Rejection Consecutive number must be equal to or greater than the initial value of the numbering range granted by the DIAN
: Rejection Consecutive number must be equal to or less than the final value of the numbering range granted by the DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|YES
|
: Details or product information
: '''PATH''': /root/cac:InvoiceLine
: (see detail in [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Information describing a referenced document
: '''Required''' on tipoDocumento invoices contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse and BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NOT
|
: Delivery information (Delivery) of goods
: '''PATH''': /root/cac:Delivery
: (see detail in [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|YES
|
: Date and time of issuance of the document, in format: YYYY-MM-DD HH:MM:SS
: Notification If the issue date is earlier than five (5) days from the calendar date
: Rejection If the issue date is later than ten calendar days
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Date/Time of the end of the billing period (Interval of dates to which the bill refers, for example in public services), in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Billing period start date/time, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Tax payment date, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Due date of the invoice, in format: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|YES
|
: General or global tax information
: Rejection If the taxes/withholdings reported in this arrangement do not correspond to what is reported in the details
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of general taxes/withholdings by type of impuesto/retención
: Rejection If the total value of the tax/withholding indicated is different from the sum of those reported in the impuestosGenrales arrangement
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NOT
|
: Additional information or free text related to the document
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|YES
|
: Information related to the payment of the invoice
: '''PATH''': /root/cac:PaymentMeans
: (see detail in [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|YES
|
: Currency or currency of the document
: Use ISO 4217 codes (Example Colombian Pesos “COP”)
: Rejection If the value does not correspond to one of the ISO 4217 codes
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NOT
|
: Information related to the purchase order
: '''PATH''': /root/cac:OrderReference
: (see detail in [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|YES
|
: Consecutive from which the series begins for the document to be issued, the prefix (with hyphen) must always be placed regardless of the sequential mode.
: Example: 'PREF-1123456'
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Rounding applied to arrive at totalMonto
: Rejection If rounding is greater than the greater value between 500 pesos or 0.1% of the total value of the invoice
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Information related to emissions from the Health Sector'''Required: When typeSector = '2'''' is informed
: (see detail in [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Information related to the exchange rate of foreign currency to Colombian peso (COP)
: '''Required''' If documenttype is export/international or if the base currency is different from “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (see detail in [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NOT
|
: Information used as an alternative method to report conversions to other currencies
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (see detail in [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Information related to the delivery
: '''Required''' If documenttype is export/international
: '''PATH''': /root/cac:DeliveryTerms
: (see detail in [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|YES
|
: Document type
: '''PATH''': Invoice, CreditNote, DebitNote
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|YES
|
: To issue documents from the Health Sector, indicate code '2' in this field
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|YES
|
: Operation type indicator
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Sum of all advance payments
: Rejection Si totalAnticipos does not correspond to the sum of the Anticipos.montoPagado attributes in the advances array
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Taxable Base Value: Sum of Taxable Bases for the calculation of taxes at the invoice level
: Rejection If totalBaseImponible is not equal to the sum of occurrences FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total gross value with taxes
: Rejection If totalGrossWithTax is not equal to the sum: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Charge: Sum of all charges applied at the invoice level
: Rejection If totalCargosAplicados does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Discount: Sum of all the discounts applied at the invoice level
: Rejection If totalDescuentos does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value to pay of the document: Total value of items (including charges and discounts at item level) + value of taxes + value of charges – value of discounts – value of advances
: Rejection If totalMonto is not consistent with the total value of items + value of taxes + value of charges – value of discounts – value of advances + rounding appliedno es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|YES
|
: Number or quantity of product lines (rows) present in the document
: Rejection If the value of totalProductos is different from the number of occurrences of rans in the detalleDeFactura array
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Gross Value before taxes: Sum of the gross values of the invoice lines
: Rejection If totalSinImpuestos does not correspond to the sum of the attributes precioTotalSinImpuestos in the detalleDeFactura array
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|YES
|
: Date on which the payment was received, in format: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Date on which the payment was made, in format: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NOT
|
: Time in which the payment was made, in format:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|YES
|
: Internal identification of the payment
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|YES
|
: Payment Instructions
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|YES
|
: Value of the advance payment, it cannot be higher than the total value of the invoice
: Notification If montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}
====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NOT
|
: Direction
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Tradename
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Identification number
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Check digit
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Business name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Telephone
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|YES
|
: ID Type
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: See list of possible values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Code to categorize the discount
: '''Mandatory''': If it is a discount at invoice level (general)
: Rejection If it is a discount and some of the values are not reported in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|Description
|String
|<nowiki>AN|10..5000</nowiki>
|YES
|
: Free text to inform the reason for the discount
: '''PATH''': …/cbc:AllowanceChargeReason
: Notification : If a charge or discount is reported and this item is not reported
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indicator of whether it is Charge "1" or Discount "0"
: Rejection : If this item contains information other than “1” or “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the charge or discount, if it is a discount, it cannot be higher than the base value
: Rejection : If it is Discount and monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Base Value to calculate the discount or charge,
: Rejection: If the montoBase is negative, if it is a discount it cannot be greater than the total value of the invoice
: Rejection: If montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Discount percentage
: Rejection If this element > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|YES
|
: Sequence order indicator
: '''PATH''': …/cbc:ID
|}
====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NOT
|
: Corresponds to the economic activity code CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NOT
|
: Last name of the acquirer.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: It allows specifying the means and data of the electronic delivery of the document
: '''Required''': If notify field = 'YES'
: '''PATH''': Not defined
: (see detail in [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|YES
|
:Tax details of the acquirer
: Rejection If the class is not informed
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Information detailing the receiving address of the acquirer
: '''Recommended''': This ransf address is the one that is painted in the standard graphical representation
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
:Tax address of the acquirer.
: '''Mandatory''': If the purchaser is responsible
: Notification If the acquirer is responsible and this class was not informed
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: E-mail of the acquirer that will go to the fiscal XML/UBL
: (only one email is sent in this field)
: '''PATH''': Does not apply node
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Legal information of the client
: Notification : If tipoPersona = '1' is reported and the attribute is not reported
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (see detail in [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Commercial name of the acquirer
: '''Obligatory''' If the commercial name will be shown in the Graphic Rep.
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''Recommended''': If the person is natural, concatenate in this field the full name (names + surnames)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NOT
|
: Additional contact note
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|YES
|
: Activates the sending of email to the acquirer.
: Possible values: “YES” or “NO”
: '''PATH''': Does not apply
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Number of the Document or Fiscal Identification of the purchaser
: '''Mandatory''' If the acquirer is responsible, he must inform the NIT
: Rejection If tipoIdentificacion is '31' and the NIT structure is invalid
: Rejection : It is generated if the value of AdditionalAccountID = “2” and it is not mentioned.
: Note : To identify the final consumer, the following document “222222222222” is used
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: NIT verification digit of the acquirer
: '''Required''': If TipoIndentificacion = 31, it must be informed
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|YES
|
: Obligations and regime of the acquirer
: Rejection If the class is not informed
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Second name of the acquirer.
: '''PATH''': Not defined
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NOT
|
: Purchaser's phone
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Acquirer ID Type
: ReRejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Note: To identify the final consumer, the code “13” is used.
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|YES
|
: Person type identifier
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}
====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NOT
|
: Event Code
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NOT
|
: Period Length
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NOT
|
: Period length unit of measure
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|YES
|
: Due date
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Payment conditions
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Associated payment method
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|YES
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Amount of the fine
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Penalty Amount
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period from
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period until
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Discount rate
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Payment Percentage
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Advance reference number
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}
====Class.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Unit quantity of this item per package.
: For example, if the item consists of three “six packs”, the quantity to be reported in QuantityPerPackage is 6, while the quantity to be reported in QuantityActual is 3, and the total number of cans being described is 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Real amount on which the price applies
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|YES
|
: Unit of the quantity on which the price applies
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Number of units of the product/service billed
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Information on charges and discounts
: '''Mandatory''' This arrangement must be reported at the item level, if and only if the charge or discount affects the item's tax base.
: If a general individual charge to the invoice generates VAT, it must be reported as an item
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Manufacturer code corresponding to the item
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Identifier code of the country of origin of the item or service
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Vendor code corresponding to the item
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Reported price type code
: '''Required''' For commercial samples (value = 01)
: Rejection If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|Description
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[1]
|-
|Description2
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[2]
|-
|Description3
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[3]
|-
|DescriptionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Technical data associated with the product or service
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Information describing a referenced document
: '''Required''' In invoices tipoDocumento Contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Standard code (item or service identification according to a standard)
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: Notification If it is an export invoice (tipoDocumento = 02), and the tariff subheading was not reported
: Notification If the code does not exist in a closed standard.
: Example: UNSPSC
: Notification If the code does not follow the rule of formation of an open code, but with verifiable values
: Example: GTIN, Example: Tariff headings
: '''Note''': In this case the code 999 (Taxpayer adoption standard) can be used to avoid reclassifying the products
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: Rejection If standardCodigo = 010 and estandarCodigoID is different from 9
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|NO
|
: Product code according to the standard informed in estandarCodigo
: View attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: organization standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub code of the product standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|YES
|
: tax information
: Rejection If there is more than one element with the same value in the attribute FacturaImpuestos.codigoTOTALImp
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Additionally, it should NOT be informed for invoices of the simple group I regime, nor for items whose concept in AIU contracts is not part of the tax base.
: At the item level, it only applies to taxes that must be reported at the item level, for example: VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of taxes for all types
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Rejection If the value of the total value of the indicated tax is different from the sum of what is reported in FacturaImpuestos. valorTOTALImp.
: At the item level, it only applies to taxes that must be reported at the item level, for example, VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: It serves to add specific product information that may be requested by authorities or entities other than the DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (see detail in [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the agent
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Verifier Digit of the agent's NIT
: '''Required''' for mandated invoices
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Agent identification type
: '''Required''' For mandated invoices
: Notification If mandatorioNumeroIdentificacion is informed and the value of this field is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item brand.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item model.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicator of whether the item is free or not (no commercial value)
: '''Required''' For commercial samples
: Possible values: “1” (It is a free sample) or “0” (It is not a free sample)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Name of the manufacturer of the product/service
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Free text to add additional information to the article
: '''Mandatory''' Inform in the case of invoices for AIU-type service contracts. For the Administration item. In this case, the note must begin with the text: "AIU services contract for:" The taxpayer must include the object of the invoiced contract
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Value of the item or service.
: Corresponds to the value of the reference price of the item that is given as a sample or gift without commercial value
: '''Required''' For commercial samples
: Rejection If the precioReferencua attribute is reported, then the value of TotalPriceWithoutTaxes must be (0.00), since it is a commercial sample or gift
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Total price of the product or service.
: (quantityUnits*UnitSalePrice +charges-discounts +taxes)
: '''Required''' For use in graphical representations
: '''PATH''': Undefined
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the line without taxes.
: (QuantityUnits*UnitSalePrice +charges-discounts)
: Rejection If the TotalPriceWithoutTaxes attribute is reported as 0.00, then the ReferencePrice value must be reported since it is a commercial sample or gift
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Unit price of the product/service
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|YES
|
: Sequence order indicator (line number)
: Notification If it contains a value already used in the sequence attribute in another group of this file
: Notification If the numbers used in the different groups are not consecutive, starting at "1"
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Product serials (comma separator), Ex: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Manufacturer code corresponding to a sub-specification of the article
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Issuer/seller code corresponding to a sub-specification of the item
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: To classify the type of AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|YES
|
: Unit of measure code of the invoiced product/service
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|YES
|
: Electronic Document Delivery Means
: It can take the following values: 0– Email; 1– Reception; 2– Interoperability; 3- Whatsapp; 4- Telegram
: PATH: Does not apply
|-
|email
|Array <String>
| -
|C/C
|
: List of Emails to which the electronic document will be delivered if the DeliveryChannel='0'
: '''Required''' When deliveryChannel=’0’
: '''PATH''': Does not apply
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: scheduled date
: '''PATH''': Does not apply
|-
|mensajeProgramado
|String
| -
|NO
|
: Message
: '''PATH''': Does not apply
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the Recipient
: '''Required''' When deliveryChannel='1' or '2'
: '''PATH''': Does not apply
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Recipient Telephone
: '''Required''' When deliveryChannel='3' or '4'
: '''PATH''': Does not apply
|}
====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Required''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the ReferencedDocument information is going to be sent, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the transfer invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note.
: You can only report electronic invoices from the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|Description
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Ransfe date of the referenced document, in format: YYYY-MM-DD
: '''Mandatory''' When InternalCode is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Not defined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|YES
|
: Concatenation of the prefix and the referenced document number
: Rejection If codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document,
: Example: "National Sales Invoice"
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type.
: '''Required''' When InternalCode is '1'
: RejectionIf codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Note''': For remission orders, inform the code ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
|}
'''@IMPORTANT:'''
''# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentsReferenced must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; internalCode = '4', documentNumber, transfer.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Contingency Invoice''', an array of the ReferenceDocuments type must be sent, indicating the fields: internal code = '1', numberDocument, date, typeDocumentCode (corresponding to Contingency Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Carrier Data
: '''PATH''': ../cac:DeliveryParty
: (see detail in [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Dispatch Information
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Delivery information
: '''PATH''': ../cac:DeliveryAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Effective date and time of departure of the goods, in format: YYYY-MM-DD HH:MM:SS
: Rejection if the effective date of departure is before the date of issue
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Estimated date and time, in format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en Format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en Format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}
====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indication to display the field in the XML
: (“0” = Don't show / “1” = Show)
: '''PATH''': Variable
|}
====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Assigned Label for PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|YES
|
: Code of the extensible field to reference
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|}
====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tax base on which the value of the tax is calculated
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Retention type indicator
: '''PATH''': Not Defined
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|YES
|
: Tribute rate.
: In the event that the tax is a percentage of the taxable value: inform the "percentage" rate to be applied to the tax base
: Rejection If you report a different rate for one of the taxes listed in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|YES
|
: Identification of the unit of measure
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Base unit of measure for the tribute
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection If valorTributoUnidad element is informed and UnidadMedidaTributo is not informed
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tribute value. Product of the percentage applied to the tax base
: Rejection For taxes whose rate is stated in percentages, if valorTOTALImp is different from baseImponibleTOTALImp * percentageTOTALImp
: Rejection For taxes whose rate is stated in nominal values (for example, plastic bags), if valorTOTALImp is different from valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
:It is the nominal value of the tax per unit
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection if the unitMedidaTributo element is NOT informed.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}
'''@IMPORTANT''': In the case of the ICA and RETEICA in which the value of the percentage is based on a thousand, the value of said percentage must be reported based on a hundred, that is, if you want to report a percentage of 11.04% thousand for any of these taxes, it must be indicated in the TOTALImp percentage field as 1,104.
====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Sum of all attributes valorTOTALImp
: Rejection If montoTotal is different from the sum of all occurrences ofFacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}
====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Code of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Payment channel code
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Optional not used for now
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Due date of payment of the invoice in format: YYYY-MM-DD
: '''Mandatory''' If the sale is on credit
: Rejection: If the payment method code is "2" and the expiration date is not sent
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Code corresponding to the means of payment
: Rejection:If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Payment method
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identifier or internal reference of the Payment
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Number of days for payment
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transfer number or check number
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}
====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: customer code
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Document Reference
: '''PATH''': ../cac:DocumentReference
: (see detail in [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Date of the Order, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|YES
|
: Purchase Order Number
: '''Required''' To send the Purchase Order
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Order Number
: '''Required''' To send the Order
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: CUFE type identifier
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Order type
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID of some referenced document
: '''PATH''': ../cbc:UUID
|}
'''NOTE:''' As it is a delivery order, the OrdemDeCompra class must be informed, if it is necessary to indicate more than one order, it must be informed through the DocumentReferenced class with '''codigoInterno''' ='1 ', this in order to send the information referring to them in the AdditionalDocumentReference group.

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If brings value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Information related to a charge or a discount
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Delivery Conditions Code
: '''Obligatorio''' Se es factura de exportación/internacional
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Transport payment method: It is used to indicate how transport costs are paid, for example: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Information detailing the delivery address
: '''PATH''': ../cac:DeliveryLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Identification number
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of who assumes responsibility in case the merchandise is lost
: '''PATH''': ../cbc:LossRisk
|}
====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Care of
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: For the attention of
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: block name
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the street
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Additional Name to better specify the street name
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: Ciudad
: Rejection If country is "CO" and the content of this attribute does not correspond to one of the values in the 'Name' column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|YES
|
: department code
: If country is "CO", CodigoDepartamento must correspond to one of the values in the Code column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Mandatory''' for Responsible Issuers and Acquirers
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corresponding time zone correction
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: department name
: Rejection if the code of the country field is "CO" and the content of this attribute does not correspond to one of the values of the Name column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
:An addressable department of an organization
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|YES
|
: Client's address, without indicating city or department
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: District
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Bedroom
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|YES
|
: Identifier of the language used in the country name
: Notification If the content of this attribute does not correspond to one of the values of the ISO 639-1 standard
: NotificaNotificationión If this is a group with information regarding the address of the issuer of an electronic document, it must contain the literal "is"
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: address coordinates
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (see detail in [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Municipality Code
: Notification If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of a Building
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Parcel Number
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|YES
|
:Customer country.
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Flat
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Subdivision (Name of the Neighborhood)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A specific location within a building
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Postal zone
: Notification If the content of this element does not correspond to a corresponding value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notification If the value of the CodigoDepartamento attribute is different from the first 2 digits of the postal code.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}
====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: latitude measure in degrees
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: measure of longitude in degrees
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Latitude measurement in decimal minutes in mm.mm format
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Longitude measurement in decimal minutes in mm.mm format
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of measurement of latitude in relation to the Equator
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of longitude measurement in relation to the Equator
: '''PATH''': ../cbc:LongitudeDirectionCode
|}
====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined (see detail in [[#Class.Extensible|Class.Extensible]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Establishment Code
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Acquirer Identifier.
: You must inform the NIT if you are responsible
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Check digit
: '''Mandatory''' If tipoIdentificacion =31, the DV of the NIT must be informed
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Billing prefix:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Customer identification type
: Rejection If the content of this element is different from “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|YES
|
: Obligations of the acquirer
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Optional, if informed, indicate “Not applicable”. Possible Values:
: 48: “Sales tax - IVA”
: 49: “Not responsible for IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}
====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
:additional quantity
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: additional code
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|codigoInterno2
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|Description
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: additional description
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Period End Date
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Beginning date of the period
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Characteristic you want to report on the item, for example: (Vehicle Use)
: Rejection For each name there must be a value
: '''PATH''': ../cbc:Name
: (For defining extensible field catalogs at the detail level)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Sequence order indicator
: '''PATH''': Not defined
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
:Value Type Indicator, example Value = ’1’
: '''PATH''': Does not apply
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Value of the characteristic to be reported, for example: (Particular)
: Rejection For each value there must be a name
: '''PATH''': ../cbc:Value
|}
====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Description
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tax Types
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Information on the Address of the Person Responsible for Delivery
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Email
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicator if it is information on “for the attention of” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Contact name
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Responsible for the Delivery
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
:Contact Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: Carrier NIT
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Check digit
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Billing Prefix
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Carrier Liability
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Telefax
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: carrier phone
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier Identification Type
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Tax address of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: carrier name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Carrier document number
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Verifier Digit of the NIT of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier document type
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Mandatory''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the information will be sent DocumentoReferenciado, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the electronic invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note. You can only report electronic invoices of the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|Description
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en Format: YYYY-MM-DD
: '''Mandatory''' When internal code is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': Undefined
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Undefined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenation of the prefix and the referenced document number
: Rejection if codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document, Example: "National Sales Invoice"
: '''PATH''': Not defined
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type
: '''Required''' When InternalCode is '1'
: Rejection If codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''PATH''': Undefined
|}
'''''@IMPORTANT:'''
# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentosReferenciados must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; CodihoInterno = '4', numeroDocumento, Description.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Factura de Contingencia ''', an array of the documentosReferenciados type must be sent, indicating the fields: internal code = '1', numberDocument, date, tipoDocumentCode (corresponding to Contingenc Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Complementary data of the beneficiary of the health service for collection scenarios.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (see detail in [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|Por definir
|C/C
|
: To indicate the type of operation through which the collection was made in the accreditation or report scenarios
: '''PATH''': To be defined
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|For the report of the additional data fields of the Health Sector
: (see detail in [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|YES
|
: Type of Health Sector Scenario. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTE: The issuance of health sector documents is only available through version 4 of the issuance service. 

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Information detailing the address of the beneficiary of the health service.
: '''PATH''': ../cac:ResidenceAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Additional data fields of the Health Sector to report information associated with the beneficiaries of the health service
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
: (see detail in [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|nombre
|String
|N|..2
|Si
|
: Additional data field code.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Note: It must correspond to one of the codes in the column[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|depends on the field
|Yes
|
: Value of the additional data field of the health sector as appropriate.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Important''': In the case of the field '''rangoNumeracion''', this value must always have the following format (Pefijo-campoDesde), that is, said field is independent of the sequential mode configured in the portal (manual with prefix or manual without prefix).

In the case of the field '''consecutivoDocumento''', This field does depend on the sequential mode configured in the web portal.
* If the assigned modality is''“manual sin prefijo”'', the values for the fields rangoNumeracion and consecutivoDocumento’ They should be for example:
:: Invoice #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Invoice #2: rangeNumeracion= "PRUE-1", consecutiveDocument= "2"
:: ...
:: Invoice #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*If the assigned modality is ''“manual with prefix”'', the values for the fields rangoNumeracion and consecutivoDocumento must be, for example:
:: Invoice #1: rangeNumeracion= "PRUE-1", consecutiveDocument= "PRUE1"
:: Invoice #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Invoice #1000: rangeNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|ID
! style="background:#f2f2f2; text-align:center;"|Description
|-
|int
|codigo
|Indicates the status of the operation returned by the service, (to define catalog)
|-
|String
|consecutivoDocumento
|Prefix and Consecutive of the Concatenated Document without separators. For the example above it corresponds to: “PRUE980338337”
|-
|String
|cufe
|"Unique Electronic Invoice Code" corresponding to the document consulted.
|-
|Bool
|esValidoDian
|“true” if valid
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in YYYY-MM-DD HH:MM:SS format
|-
|String
|fechaRespuesta
|Day and time in which the electronic document was generated, in format AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the response code, useful for error identification
|-
|Array
|mensajesValidacion
|Validation messages in case of notification or rejection
|-
|String
|nombre
|Name defined by the DIAN
|-
|String
|qr
|QR code string concatenation (control element)
|-
|Array
|reglasNotificacionDIAN
|Validation rules in case of notification
|-
|Array
|reglasValidacionDIAN
|Validation rules in case of rejection
|-
|String
|resultado
|Method consumption result: Processed” or “Error”
|-
|String
|tipoCufe
|CUFE type algorithm. “CUFE-SHA384” or “CUDE-SHA384”
|-
|String
|xml
|XML file (type AttachedDocument) encoded in Base64
|}
Once the electronic invoice has been sent successfully (code '200' or '201' in the response), the attached files are sent (through the method'''CargarAdjuntos''') consuming the SOAP Web Attachments Service, in the scenario that the '''attachments''' parameter has been assigned to “1” or “11”, otherwise the SOAP Web Attachments Service will return an error indicating that the document does NOT support attachments.
{{clear}}

===EstadoDocumento Method===
It allows you to consult the status of the document indicated before the Acquirer, before the DIAN, the type of delivery and if it was successful, the list of associated events (ApplicationResponse) and other parameters of interest that can be useful in the software control processes billing (ERP) or for the business model of the issuing client.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Typr
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indicates if the document has physical acceptance (physically delivered): “true” or “false”
|-
|String
|acuseComentario
|Comment informed by the acquirer when making the acknowledgment
|-
|String
|acuseEstatus
|0: Acknowledgment not made ; 1: Acknowledgment made
|-
|String
|acuseResponsable
|Email of the person responsible for making the acknowledgment
|-
|String
|acuseRespuesta
|0: Response not sent; 1: Reply Sent
|-
|String
|ambiente
|Type of document generation environment:
:: “1: ProductionEnvironment”
:: “2: TestEnvironment”
|-
|String
|cadenaCodigoQR
|QR code string concatenation (control element)
|-
|String
|cadenaCufe
|Chain concatenation of the CUFE code prior to calculation by the corresponding algorithm of the service
|-
|int
|Codigo
|Indicates the status of the operation returned by the service
|-
|String
|consecutivo
|Consecutive Document TFHKA/DIAN
|-
|String
|cufe
|"Unique Code of Electronic Invoice" corresponding to the document consulted, calculated by the corresponding algorithm of the service
|-
|String
|DescriptionDocumento
|Reference document type identifier,
: Example: "National Sales Invoice"
|-
|String
|DescriptionEstatusDocumento
|Description corresponding to the statusDocument before the DIAN: "Processed Correctly"
|-
|String
|entregaMetodoDIAN
|Indicates the delivery method to the DIAN
: (Synchronous or Asynchronous), (Individual or Batch)
|-
|Bool
|esValidoDIAN
|
: “true” if valid
: "false" If not valid
|-
|String
|estatusDocumento
|Code obtained in the response corresponding to the status of the document before the DIAN (Catalogue to be defined)
|-
|Array <Evento>
|eventos
|List of Electronic Document events
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in format AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Date on which the document was generated, in format: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|History of document deliveries
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|mensajeDocumento
|Provides a description of the error of each of the initial validations. If there are no errors, no description is provided.
|-
|Bool
|poseeAdjuntos
|Indicates if the document has attachments:
: "true" or "false"
|-
|Bool
|poseeRepresentacionGrafica
|Indicates if the document has a graphic representation:
: "true" or "false"
|-
|Array <String>
|reglasValidacionDIAN
|Validation messages by the DIAN
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Reference document type identifier
: Watch [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|This element corresponds to the TrackId of the processed document
|}
Where Class.Evento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|ambienteDIAN
|Generation environment in the DIAN
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Code the document of the Application Response (event)
|-
|String
|comentario
|event commentary
|-
|String
|cufe
|CUFE of the electronic document
|-
|String
|DescriptionEvento
|Description of use/source of the event
|-
|String
|emisorNumeroDocumento
|Issuer Identification Number
|-
|String
|emisorNumeroDocumentoDV
|Issuer Document Number Check Digit
|-
|String
|emisorRazonSocial
|Company Name of the Issuer
|-
|String
|emisorTipoIdentificacion
|Issuer Identification Type
|-
|Array <ExtrasEvento>
|extras
|Extra information corresponding to the event
|-
|String
|fechaEmision
|Date of Issue of the Application Response (event)
|-
|String
|fechaRecepcion
|Application Response Reception Date (event)
|-
|String
|hash
|Application Response document hash
|-
|String
|idPerfilDIAN
|DIAN Profile
|-
|String
|mensaje
|ApplicationResponse description message
|-
|String
|nombreArchivoXML
|XML file name
|-
|String
|nota
|Content of the Note field of the Application Response
|-
|String
|numeroDelEvento
|Consecutive Application Response
|-
|String
|receptorNumeroDocumento
|Receiver Identification Number
|-
|String
|receptorNumeroDocumentoDV
|Receiver Document Number Check Digit
|-
|String
|receptorRazonSocial
|Receiver's Business Name
|-
|String
|receptorTipoIdentificacion
|Receiver Identification Type
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUDE of the event:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Event type identifier:
: (Internal/ApplicationResponse)
|-
|String
|versionUBL
|UBL version of the XML
|}
And Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|nombre
|Additional Description
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas will correspond to:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|IP address of the computer in which the acknowledgment of the notification mail was made
|-
|String
|LeidoEstatus
|Notification mail acknowledgment status
|-
|String
|LeidoFecha
|Date of acknowledgment of notification mail
|-
|String
|canalDeEntrega
|Electronic document delivery channel
|-
|Array <String>
|email
|Email of the recipient of the electronic document
|-
|String
|entregaEstatus
|Delivery status:
: '0': Mail not sent
: '200': Mail sent
|-
|String
|entregaEstatusDescription
|Delivery Status Description
|-
|String
|entregaFecha
|Document delivery date
|-
|String
|fechaProgramada
|Delivery Date
|-
|String
|mensajePersonalizado
|Personalized message to be delivered by Email, WhatsApp or Telegram
|-
|String
|nitProveedorReceptor
|NIT of the receiving Technological Provider, in case of delivery by Interoperability
|-
|String
|recepcionEmailComentario
|Customer Acknowledgment Comment
|-
|String
|recepcionEmailEstatus
|E-mail reception status
: 1: Accepted
: 2: Rejected
: 3: In verification
|-
|String
|recepcionEmailFecha
|Date of receipt of the Email
|-
|String
|recepcionEmailIPAddress
|Email receiving IP address
|-
|String
|telefono
|For delivery by Whatsapp/Telegram
|}
'''@Important:''' The structure of this Response may still be subject to change in a future update.
{{clear}}
===EnvioCorreo Method===
Allows you to forward the indicated document to one or more email addresses.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”. Allows sending multiple recipients (maximum 5) separated by a comma character ','
|-
|correo
|Email to which the document will be sent. Example name@company.com
|-
|adjuntos
|
: “0”: Resends the mail without attachments
: “1”: Forwards the mail with the attachments stored during the issuance of the document.
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|rowspan="2"|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Send''' method) the '''attachments''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform does not will generate standard graphical representation (PDF), therefore only the documents hosted on the platform (AttachedDocument) will be forwarded to the recipients. To forward the mail (with the AttachedDocument and attachments) to an email address different from the one used during the transmission, the '''CargarAtjuntos''' method of the SOAP Web Attachments Service can be used again.
{{clear}}
===DescargaPDF Method===
Allows you to download the standard graphic representation (PDF generated by TFHKA) of the document for local storage, local consultation or reprint purposes.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted.
|-
|String
|documento
|Base64 encoded PDF document
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Enviar''' method) the '''adjuntos''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform will not will generate standard graphic representation (PDF), therefore this method cannot be used since the service will throw an error indicating that there is NO associated PDF, since it is assumed that the graphic representation has been generated locally by the billing software (ERP).
{{clear}}
=== DescargaXML Method===
It allows the download of the XML document (only the electronic document Invoice, CreditNote and DebitNote), in case it is required to validate the information such as the signature or its authenticity or for the purpose of local management and storage.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted
|-
|String
|documento
|XML document (Invoice, CreditNote or DebitNote) encoded in Base64
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===FoliosRestantes Method===
Allows you to consult the stamps (transactions) available. The stamps are consumed in proportion to the transactions made.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE:Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|int
|foliosRestantes
|Number of sheets available
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===CargarCertificado Method===
For now, this method will only be used internally by The Factory HKA Colombia.
{{clear}}
===DescargarEventoXML Method===
It allows downloading an event or occurrence (ApplicationResponse) related to an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
;RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|Documento
|XML document (ApplicationResponse) encoded in Base64
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===GenerarContenedor Method===
UA container is a type of AttachedDocument document, its structure is intended to contain and transmit an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) generated to date in a single XML file.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Contenedor
|XML document (AttachedDocument) encoded in Base64
|-
|String
|Fecha
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===GenerarEvento Method===
Allows the generation of an event or occurrence (ApplicationResponse) associated with an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Object with the data of the event (ApplicationResponse) to generate
|}
Where Class.DatosEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoEvento
|Indicates the code of the event (to define catalog)
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Comentario
|Comment or description of the event
|-
|String
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Additional event information
|}
Where Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Nombre Código
|of the field
|-
|String
|valor
|Additional Information
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|consecutivoDocumentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|XML document (ApplicationResponse) encoded in Base64
|}
{{clear}}

Web Soap Broadcast Service Methods - Direct Integration Manual Index

2022-03-01T16:19:16Z

Lvargas: /* Class.Anticipos */

<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly>
The parameters to be incorporated in the methods of this Web Service must comply with the format and the corresponding directives according to the following rules:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Format
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| A || Alphabetic character
|-
| N || Numeric character
|-
| AN || AlphaNumeric character
|-
| <nowiki> A|3 </nowiki> || 3 Alphabetic characters (fixed length)
|-
| <nowiki> N|3 </nowiki> || 3 Numeric characters (fixed length)
|-
| <nowiki> AN|3 </nowiki> || 3 alphaNumeric characters (fixed length)
|-
| <nowiki> A|..3 </nowiki> || Up to 3 Alphabetic characters (variable length)
|-
| <nowiki> N|..3 </nowiki> || Up to 3 Numeric characters (variable length)
|-
| <nowiki> AN|..3 </nowiki> || Up to 3 alphaNumeric characters (variable length)
|-
| <nowiki> N|2..6 </nowiki> || Between 2 and 6 Numeric characters (variable length)
|-
| INT32 || Whole. (Maximum Value: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Mandatory
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| YES || If it is mandatory for the DIAN
|-
| NOT || It is not mandatory for the DIAN
|-
| C/C || It is required where applicable (or under certain conditions by the client's business model)
|}
{{clear}}

===Enviar Method===
The function in charge of building and sending the electronic documents to the technology provider.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by technology provider
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|See the detail of the Invoice Object below
|-
|String
|adjuntos
|
Possible values:
: “0” Attachments are not allowed. XML and standard graphic representation is generated by The Factory HKA
: “1” Supports attachments. XML and standard graphic representation is generated by The Factory HKA
: “10” Attachments are not allowed. Only XML is generated without standard Graphic representation by The Factory HKA
: “11” Supports attachments. Only XML is generated without standard graphical representation by The Factory HKA
|}

'''@IMPORTANT:''' If the value “1” or “11” is sent in the '''attachments''' parameter, no email will be sent until the method is consumed '''CargarAdjuntos''' (ServicE Adjuntos Web SOAP). For documents that accept attachments, the field '''Destinatario.email''' of the client is required and the '''notify''' field must be set to “YES”.

<pre style="color: red">WARNING: If options '10' or '11' are used in the attachments parameter, our platform will not generate standard graphic representation (PDF), therefore PDF is not hosted on it and the graphic representation cannot be viewed from the platform. web portal, in the notification email to the acquirer (view document section), nor download through the DescargaPDF method of the SOAP Web Broadcast Service or forward the graphical representation through the EnvioCorreo method, since it is being assumed that it has been generated locally by the billing software (ERP).</pre>

Next, the diagram of the '''invoice object for the billing model with prior validation''' is exposed, where the changes in its structure can be seen with respect to the object used in the model with post validation :

* In Blue new classes/attributes that were not present in the post validation model.
* In Yellow existing classes/attributes in the post-validation model that underwent changes in pre-validation.
* In Orange existing classes/attributes in post-validation model that are deprecated (removed) in pre-validation.
 

The invoice object for the billing model with prior validation is described in greater detail below:
 

<center>'''Diagram Class.FacturaGeneral with Class.Anticipos, Class.Autorizado and Class.CargosDescuentos'''
[[Archivo:Diagram Class.FacturaGeneral with Class.Anticipos, Class.Autorizado and Class.CargosDescuentos.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagram Class.FacturaGeneral with Class.Cliente'''
[[Archivo:Diagram Class.FacturaGeneral with Class.Cliente.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.Cliente]]
 
'''Diagram Class.FacturaGeneral with Class.CondicionPago'''
[[Archivo:Diagram Class.FacturaGeneral with Class.CondicionPago.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.CondicionPago]]
 
'''Diagram Class.FacturaGeneral with Class.FacturaDetalle'''
[[Archivo:Diagram Class.FacturaGeneral with Class.FacturaDetalle.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.FacturaDetalle]]
 
'''Diagram Class.FacturaGeneral with Class.DocumentoReferenciado'''
[[Archivo:Diagram Class.FacturaGeneral with Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.DocumentoReferenciado]]
 
'''Diagram Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagram Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagram Class.FacturaGeneral with Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra and Array - informacionAdicional'''
[[Archivo:Diagram Class.FacturaGeneral with Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra and Array - informacionAdicional.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra and Array - informacionAdicional]]
 
'''Diagram Class.FacturaGeneral with Class.TasaDeCambio, Class.TasaDeCambioAlternativa and Class.TerminosEntrega'''
[[Archivo:Diagram Class.FacturaGeneral with Class.TasaDeCambio, Class.TasaDeCambioAlternativa and Class.TerminosEntrega.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.TasaDeCambio, Class.TasaDeCambioAlternativa and Class.TerminosEntrega]]
</center>
{{clear}}
====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|anticipos
|Array <Anticipos>
| -
|NOT
|
: Information related to advances
: '''PATH''': /root/cac:PrepaidPayment
: (see detail in [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NOT
|
: Information of the person authorized to download documents
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver see detail in [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|YES
|
: The number of decimals to be used is sent (minimum 0, maximum 6)
: Rejection If more decimals are received in the amounts than those indicated in this field
: '''PATH''': Does not apply
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NOT
|
: Information related to a charge or a discount on an invoice scale that does not affect the tax base
: '''PATH''': /root/cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|YES
|
: Acquirer Information
: '''PATH''':/root/cac:AccountingCustomerParty
: (see detail in [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NOT
|
: Information related to the payment condition
: '''PATH''': /root/cac:PaymentTerms
: (see detail in [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..20
|YES
|
: Correlative/consecutive of the electronic document
: prefix concatenation (<nowiki>AN|..4</nowiki>) + the consecutive DIAN,
: according to the configuration in the web portal:
:: Manual with prefix: prefix required (No hyphen). Example: “PREF2147483647”
:: Manual without prefix: prefix not required. Example: “2147483647”
: Rejection Additional characters such as spaces or hyphens are not allowed
: Rejection Consecutive number must be equal to or greater than the initial value of the numbering range granted by the DIAN
: Rejection Consecutive number must be equal to or less than the final value of the numbering range granted by the DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|YES
|
: Details or product information
: '''PATH''': /root/cac:InvoiceLine
: (see detail in [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Information describing a referenced document
: '''Required''' on tipoDocumento invoices contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse and BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NOT
|
: Delivery information (Delivery) of goods
: '''PATH''': /root/cac:Delivery
: (see detail in [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|YES
|
: Date and time of issuance of the document, in format: YYYY-MM-DD HH:MM:SS
: Notification If the issue date is earlier than five (5) days from the calendar date
: Rejection If the issue date is later than ten calendar days
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Date/Time of the end of the billing period (Interval of dates to which the bill refers, for example in public services), in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Billing period start date/time, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Tax payment date, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Due date of the invoice, in format: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|YES
|
: General or global tax information
: Rejection If the taxes/withholdings reported in this arrangement do not correspond to what is reported in the details
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of general taxes/withholdings by type of impuesto/retención
: Rejection If the total value of the tax/withholding indicated is different from the sum of those reported in the impuestosGenrales arrangement
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NOT
|
: Additional information or free text related to the document
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|YES
|
: Information related to the payment of the invoice
: '''PATH''': /root/cac:PaymentMeans
: (see detail in [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|YES
|
: Currency or currency of the document
: Use ISO 4217 codes (Example Colombian Pesos “COP”)
: Rejection If the value does not correspond to one of the ISO 4217 codes
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NOT
|
: Information related to the purchase order
: '''PATH''': /root/cac:OrderReference
: (see detail in [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|YES
|
: Consecutive from which the series begins for the document to be issued, the prefix (with hyphen) must always be placed regardless of the sequential mode.
: Example: 'PREF-1123456'
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Rounding applied to arrive at totalMonto
: Rejection If rounding is greater than the greater value between 500 pesos or 0.1% of the total value of the invoice
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Information related to emissions from the Health Sector'''Required: When typeSector = '2'''' is informed
: (see detail in [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Information related to the exchange rate of foreign currency to Colombian peso (COP)
: '''Required''' If documenttype is export/international or if the base currency is different from “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (see detail in [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NOT
|
: Information used as an alternative method to report conversions to other currencies
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (see detail in [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Information related to the delivery
: '''Required''' If documenttype is export/international
: '''PATH''': /root/cac:DeliveryTerms
: (see detail in [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|YES
|
: Document type
: '''PATH''': Invoice, CreditNote, DebitNote
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|YES
|
: To issue documents from the Health Sector, indicate code '2' in this field
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|YES
|
: Operation type indicator
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Sum of all advance payments
: Rejection Si totalAnticipos does not correspond to the sum of the Anticipos.montoPagado attributes in the advances array
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Taxable Base Value: Sum of Taxable Bases for the calculation of taxes at the invoice level
: Rejection If totalBaseImponible is not equal to the sum of occurrences FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total gross value with taxes
: Rejection If totalGrossWithTax is not equal to the sum: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Charge: Sum of all charges applied at the invoice level
: Rejection If totalCargosAplicados does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Discount: Sum of all the discounts applied at the invoice level
: Rejection If totalDescuentos does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value to pay of the document: Total value of items (including charges and discounts at item level) + value of taxes + value of charges – value of discounts – value of advances
: Rejection If totalMonto is not consistent with the total value of items + value of taxes + value of charges – value of discounts – value of advances + rounding appliedno es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|YES
|
: Number or quantity of product lines (rows) present in the document
: Rejection If the value of totalProductos is different from the number of occurrences of rans in the detalleDeFactura array
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Gross Value before taxes: Sum of the gross values of the invoice lines
: Rejection If totalSinImpuestos does not correspond to the sum of the attributes precioTotalSinImpuestos in the detalleDeFactura array
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|YES
|
: Date on which the payment was received, in format: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Date on which the payment was made, in format: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NOT
|
: Time in which the payment was made, in format:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|YES
|
: Internal identification of the payment
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|YES
|
: Payment Instructions
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|YES
|
: Value of the advance payment, it cannot be higher than the total value of the invoice
: Notification If montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NOT
|
: Direction
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Tradename
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Identification number
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Check digit
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Business name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Telephone
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|YES
|
: ID Type
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: See list of possible values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Code to categorize the discount
: '''Mandatory''': If it is a discount at invoice level (general)
: Rejection If it is a discount and some of the values are not reported in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|YES
|
: Free text to inform the reason for the discount
: '''PATH''': …/cbc:AllowanceChargeReason
: Notification : If a charge or discount is reported and this item is not reported
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indicator of whether it is Charge "1" or Discount "0"
: Rejection : If this item contains information other than “1” or “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the charge or discount, if it is a discount, it cannot be higher than the base value
: Rejection : If it is Discount and monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Base Value to calculate the discount or charge,
: Rejection: If the montoBase is negative, if it is a discount it cannot be greater than the total value of the invoice
: Rejection: If montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Discount percentage
: Rejection If this element > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|YES
|
: Sequence order indicator
: '''PATH''': …/cbc:ID
|}
====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NOT
|
: Corresponds to the economic activity code CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NOT
|
: Last name of the acquirer.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: It allows specifying the means and data of the electronic delivery of the document
: '''Required''': If notify field = 'YES'
: '''PATH''': Not defined
: (see detail in [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|YES
|
:Tax details of the acquirer
: Rejection If the class is not informed
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Information detailing the receiving address of the acquirer
: '''Recommended''': This ransf address is the one that is painted in the standard graphical representation
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
:Tax address of the acquirer.
: '''Mandatory''': If the purchaser is responsible
: Notification If the acquirer is responsible and this class was not informed
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: E-mail of the acquirer that will go to the fiscal XML/UBL
: (only one email is sent in this field)
: '''PATH''': Does not apply node
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Legal information of the client
: Notification : If tipoPersona = '1' is reported and the attribute is not reported
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (see detail in [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Commercial name of the acquirer
: '''Obligatory''' If the commercial name will be shown in the Graphic Rep.
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''Recommended''': If the person is natural, concatenate in this field the full name (names + surnames)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NOT
|
: Additional contact note
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|YES
|
: Activates the sending of email to the acquirer.
: Possible values: “YES” or “NO”
: '''PATH''': Does not apply
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Number of the Document or Fiscal Identification of the purchaser
: '''Mandatory''' If the acquirer is responsible, he must inform the NIT
: Rejection If tipoIdentificacion is '31' and the NIT structure is invalid
: Rejection : It is generated if the value of AdditionalAccountID = “2” and it is not mentioned.
: Note : To identify the final consumer, the following document “222222222222” is used
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: NIT verification digit of the acquirer
: '''Required''': If TipoIndentificacion = 31, it must be informed
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|YES
|
: Obligations and regime of the acquirer
: Rejection If the class is not informed
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Second name of the acquirer.
: '''PATH''': Not defined
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NOT
|
: Purchaser's phone
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Acquirer ID Type
: ReRejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Note: To identify the final consumer, the code “13” is used.
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|YES
|
: Person type identifier
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}
====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NOT
|
: Event Code
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NOT
|
: Period Length
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NOT
|
: Period length unit of measure
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|YES
|
: Due date
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Payment conditions
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Associated payment method
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|YES
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Amount of the fine
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Penalty Amount
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period from
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period until
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Discount rate
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Payment Percentage
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Advance reference number
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}
====Class.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Unit quantity of this item per package.
: For example, if the item consists of three “six packs”, the quantity to be reported in QuantityPerPackage is 6, while the quantity to be reported in QuantityActual is 3, and the total number of cans being described is 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Real amount on which the price applies
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|YES
|
: Unit of the quantity on which the price applies
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Number of units of the product/service billed
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Information on charges and discounts
: '''Mandatory''' This arrangement must be reported at the item level, if and only if the charge or discount affects the item's tax base.
: If a general individual charge to the invoice generates VAT, it must be reported as an item
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Manufacturer code corresponding to the item
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Identifier code of the country of origin of the item or service
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Vendor code corresponding to the item
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Reported price type code
: '''Required''' For commercial samples (value = 01)
: Rejection If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Technical data associated with the product or service
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Information describing a referenced document
: '''Required''' In invoices tipoDocumento Contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Standard code (item or service identification according to a standard)
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: Notification If it is an export invoice (tipoDocumento = 02), and the tariff subheading was not reported
: Notification If the code does not exist in a closed standard.
: Example: UNSPSC
: Notification If the code does not follow the rule of formation of an open code, but with verifiable values
: Example: GTIN, Example: Tariff headings
: '''Note''': In this case the code 999 (Taxpayer adoption standard) can be used to avoid reclassifying the products
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: Rejection If standardCodigo = 010 and estandarCodigoID is different from 9
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|NO
|
: Product code according to the standard informed in estandarCodigo
: View attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: organization standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub code of the product standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|YES
|
: tax information
: Rejection If there is more than one element with the same value in the attribute FacturaImpuestos.codigoTOTALImp
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Additionally, it should NOT be informed for invoices of the simple group I regime, nor for items whose concept in AIU contracts is not part of the tax base.
: At the item level, it only applies to taxes that must be reported at the item level, for example: VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of taxes for all types
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Rejection If the value of the total value of the indicated tax is different from the sum of what is reported in FacturaImpuestos. valorTOTALImp.
: At the item level, it only applies to taxes that must be reported at the item level, for example, VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: It serves to add specific product information that may be requested by authorities or entities other than the DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (see detail in [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the agent
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Verifier Digit of the agent's NIT
: '''Required''' for mandated invoices
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Agent identification type
: '''Required''' For mandated invoices
: Notification If mandatorioNumeroIdentificacion is informed and the value of this field is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item brand.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item model.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicator of whether the item is free or not (no commercial value)
: '''Required''' For commercial samples
: Possible values: “1” (It is a free sample) or “0” (It is not a free sample)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Name of the manufacturer of the product/service
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Free text to add additional information to the article
: '''Mandatory''' Inform in the case of invoices for AIU-type service contracts. For the Administration item. In this case, the note must begin with the text: "AIU services contract for:" The taxpayer must include the object of the invoiced contract
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Value of the item or service.
: Corresponds to the value of the reference price of the item that is given as a sample or gift without commercial value
: '''Required''' For commercial samples
: Rejection If the precioReferencua attribute is reported, then the value of TotalPriceWithoutTaxes must be (0.00), since it is a commercial sample or gift
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Total price of the product or service.
: (quantityUnits*UnitSalePrice +charges-discounts +taxes)
: '''Required''' For use in graphical representations
: '''PATH''': Undefined
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the line without taxes.
: (QuantityUnits*UnitSalePrice +charges-discounts)
: Rejection If the TotalPriceWithoutTaxes attribute is reported as 0.00, then the ReferencePrice value must be reported since it is a commercial sample or gift
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Unit price of the product/service
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|YES
|
: Sequence order indicator (line number)
: Notification If it contains a value already used in the sequence attribute in another group of this file
: Notification If the numbers used in the different groups are not consecutive, starting at "1"
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Product serials (comma separator), Ex: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Manufacturer code corresponding to a sub-specification of the article
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Issuer/seller code corresponding to a sub-specification of the item
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: To classify the type of AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|YES
|
: Unit of measure code of the invoiced product/service
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|YES
|
: Electronic Document Delivery Means
: It can take the following values: 0– Email; 1– Reception; 2– Interoperability; 3- Whatsapp; 4- Telegram
: PATH: Does not apply
|-
|email
|Array <String>
| -
|C/C
|
: List of Emails to which the electronic document will be delivered if the DeliveryChannel='0'
: '''Required''' When deliveryChannel=’0’
: '''PATH''': Does not apply
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: scheduled date
: '''PATH''': Does not apply
|-
|mensajeProgramado
|String
| -
|NO
|
: Message
: '''PATH''': Does not apply
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the Recipient
: '''Required''' When deliveryChannel='1' or '2'
: '''PATH''': Does not apply
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Recipient Telephone
: '''Required''' When deliveryChannel='3' or '4'
: '''PATH''': Does not apply
|}
====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Required''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the ReferencedDocument information is going to be sent, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the transfer invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note.
: You can only report electronic invoices from the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Ransfe date of the referenced document, in format: YYYY-MM-DD
: '''Mandatory''' When InternalCode is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Not defined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|YES
|
: Concatenation of the prefix and the referenced document number
: Rejection If codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document,
: Example: "National Sales Invoice"
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type.
: '''Required''' When InternalCode is '1'
: RejectionIf codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Note''': For remission orders, inform the code ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
|}
'''@IMPORTANT:'''
''# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentsReferenced must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; internalCode = '4', documentNumber, transfer.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Contingency Invoice''', an array of the ReferenceDocuments type must be sent, indicating the fields: internal code = '1', numberDocument, date, typeDocumentCode (corresponding to Contingency Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Carrier Data
: '''PATH''': ../cac:DeliveryParty
: (see detail in [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Dispatch Information
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Delivery information
: '''PATH''': ../cac:DeliveryAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Effective date and time of departure of the goods, in format: YYYY-MM-DD HH:MM:SS
: Rejection if the effective date of departure is before the date of issue
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Estimated date and time, in format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}
====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indication to display the field in the XML
: (“0” = Don't show / “1” = Show)
: '''PATH''': Variable
|}
====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Assigned Label for PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|YES
|
: Code of the extensible field to reference
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|}
====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tax base on which the value of the tax is calculated
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Retention type indicator
: '''PATH''': Not Defined
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|YES
|
: Tribute rate.
: In the event that the tax is a percentage of the taxable value: inform the "percentage" rate to be applied to the tax base
: Rejection If you report a different rate for one of the taxes listed in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|YES
|
: Identification of the unit of measure
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Base unit of measure for the tribute
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection If valorTributoUnidad element is informed and UnidadMedidaTributo is not informed
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tribute value. Product of the percentage applied to the tax base
: Rejection For taxes whose rate is stated in percentages, if valorTOTALImp is different from baseImponibleTOTALImp * percentageTOTALImp
: Rejection For taxes whose rate is stated in nominal values (for example, plastic bags), if valorTOTALImp is different from valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
:It is the nominal value of the tax per unit
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection if the unitMedidaTributo element is NOT informed.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}
'''@IMPORTANT''': In the case of the ICA and RETEICA in which the value of the percentage is based on a thousand, the value of said percentage must be reported based on a hundred, that is, if you want to report a percentage of 11.04% thousand for any of these taxes, it must be indicated in the TOTALImp percentage field as 1,104.
====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Sum of all attributes valorTOTALImp
: Rejection If montoTotal is different from the sum of all occurrences ofFacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}
====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Code of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Payment channel code
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Optional not used for now
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Due date of payment of the invoice in format: YYYY-MM-DD
: '''Mandatory''' If the sale is on credit
: Rejection: If the payment method code is "2" and the expiration date is not sent
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Code corresponding to the means of payment
: Rejection:If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Payment method
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identifier or internal reference of the Payment
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Number of days for payment
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transfer number or check number
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}
====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: customer code
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Document Reference
: '''PATH''': ../cac:DocumentReference
: (see detail in [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Date of the Order, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|YES
|
: Purchase Order Number
: '''Required''' To send the Purchase Order
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Order Number
: '''Required''' To send the Order
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: CUFE type identifier
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Order type
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID of some referenced document
: '''PATH''': ../cbc:UUID
|}
'''NOTE:''' As it is a delivery order, the OrdemDeCompra class must be informed, if it is necessary to indicate more than one order, it must be informed through the DocumentReferenced class with '''codigoInterno''' ='1 ', this in order to send the information referring to them in the AdditionalDocumentReference group.

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If brings value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Information related to a charge or a discount
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Delivery Conditions Code
: '''Obligatorio''' Se es factura de exportación/internacional
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Transport payment method: It is used to indicate how transport costs are paid, for example: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Information detailing the delivery address
: '''PATH''': ../cac:DeliveryLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Identification number
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of who assumes responsibility in case the merchandise is lost
: '''PATH''': ../cbc:LossRisk
|}
====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Care of
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: For the attention of
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: block name
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the street
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Additional Name to better specify the street name
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: Ciudad
: Rejection If country is "CO" and the content of this attribute does not correspond to one of the values in the 'Name' column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|YES
|
: department code
: If country is "CO", CodigoDepartamento must correspond to one of the values in the Code column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Mandatory''' for Responsible Issuers and Acquirers
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corresponding time zone correction
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: department name
: Rejection if the code of the country field is "CO" and the content of this attribute does not correspond to one of the values of the Name column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
:An addressable department of an organization
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|YES
|
: Client's address, without indicating city or department
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: District
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Bedroom
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|YES
|
: Identifier of the language used in the country name
: Notification If the content of this attribute does not correspond to one of the values of the ISO 639-1 standard
: NotificaNotificationión If this is a group with information regarding the address of the issuer of an electronic document, it must contain the literal "is"
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: address coordinates
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (see detail in [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Municipality Code
: Notification If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of a Building
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Parcel Number
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|YES
|
:Customer country.
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Flat
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Subdivision (Name of the Neighborhood)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A specific location within a building
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Postal zone
: Notification If the content of this element does not correspond to a corresponding value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notification If the value of the CodigoDepartamento attribute is different from the first 2 digits of the postal code.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}
====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: latitude measure in degrees
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: measure of longitude in degrees
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Latitude measurement in decimal minutes in mm.mm format
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Longitude measurement in decimal minutes in mm.mm format
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of measurement of latitude in relation to the Equator
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of longitude measurement in relation to the Equator
: '''PATH''': ../cbc:LongitudeDirectionCode
|}
====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined (see detail in [[#Class.Extensible|Class.Extensible]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Establishment Code
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Acquirer Identifier.
: You must inform the NIT if you are responsible
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Check digit
: '''Mandatory''' If tipoIdentificacion =31, the DV of the NIT must be informed
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Billing prefix:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Customer identification type
: Rejection If the content of this element is different from “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|YES
|
: Obligations of the acquirer
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Optional, if informed, indicate “Not applicable”. Possible Values:
: 48: “Sales tax - IVA”
: 49: “Not responsible for IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}
====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
:additional quantity
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: additional code
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|codigoInterno2
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: additional description
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Period End Date
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Beginning date of the period
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Characteristic you want to report on the item, for example: (Vehicle Use)
: Rejection For each name there must be a value
: '''PATH''': ../cbc:Name
: (For defining extensible field catalogs at the detail level)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Sequence order indicator
: '''PATH''': Not defined
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
:Value Type Indicator, example Value = ’1’
: '''PATH''': Does not apply
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Value of the characteristic to be reported, for example: (Particular)
: Rejection For each value there must be a name
: '''PATH''': ../cbc:Value
|}
====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Description
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tax Types
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Information on the Address of the Person Responsible for Delivery
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Email
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicator if it is information on “for the attention of” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Contact name
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Responsible for the Delivery
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
:Contact Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: Carrier NIT
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Check digit
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Billing Prefix
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Carrier Liability
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Telefax
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: carrier phone
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier Identification Type
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Tax address of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: carrier name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Carrier document number
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Verifier Digit of the NIT of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier document type
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Mandatory''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the information will be sent DocumentoReferenciado, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the electronic invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note. You can only report electronic invoices of the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Mandatory''' When internal code is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': Undefined
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Undefined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenation of the prefix and the referenced document number
: Rejection if codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document, Example: "National Sales Invoice"
: '''PATH''': Not defined
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type
: '''Required''' When InternalCode is '1'
: Rejection If codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''PATH''': Undefined
|}
'''''@IMPORTANT:'''
# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentosReferenciados must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; CodihoInterno = '4', numeroDocumento, descripcion.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Factura de Contingencia ''', an array of the documentosReferenciados type must be sent, indicating the fields: internal code = '1', numberDocument, date, tipoDocumentCode (corresponding to Contingenc Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Complementary data of the beneficiary of the health service for collection scenarios.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (see detail in [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|Por definir
|C/C
|
: To indicate the type of operation through which the collection was made in the accreditation or report scenarios
: '''PATH''': To be defined
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|For the report of the additional data fields of the Health Sector
: (see detail in [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|YES
|
: Type of Health Sector Scenario. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTE: The issuance of health sector documents is only available through version 4 of the issuance service. 

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Information detailing the address of the beneficiary of the health service.
: '''PATH''': ../cac:ResidenceAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Additional data fields of the Health Sector to report information associated with the beneficiaries of the health service
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
: (see detail in [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|nombre
|String
|N|..2
|Si
|
: Additional data field code.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Note: It must correspond to one of the codes in the column[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|depends on the field
|Yes
|
: Value of the additional data field of the health sector as appropriate.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Important''': In the case of the field '''rangoNumeracion''', this value must always have the following format (Pefijo-campoDesde), that is, said field is independent of the sequential mode configured in the portal (manual with prefix or manual without prefix).

In the case of the field '''consecutivoDocumento''', This field does depend on the sequential mode configured in the web portal.
* If the assigned modality is''“manual sin prefijo”'', the values for the fields rangoNumeracion and consecutivoDocumento’ They should be for example:
:: Invoice #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Invoice #2: rangeNumeracion= "PRUE-1", consecutiveDocument= "2"
:: ...
:: Invoice #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*If the assigned modality is ''“manual with prefix”'', the values for the fields rangoNumeracion and consecutivoDocumento must be, for example:
:: Invoice #1: rangeNumeracion= "PRUE-1", consecutiveDocument= "PRUE1"
:: Invoice #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Invoice #1000: rangeNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|ID
! style="background:#f2f2f2; text-align:center;"|Description
|-
|int
|codigo
|Indicates the status of the operation returned by the service, (to define catalog)
|-
|String
|consecutivoDocumento
|Prefix and Consecutive of the Concatenated Document without separators. For the example above it corresponds to: “PRUE980338337”
|-
|String
|cufe
|"Unique Electronic Invoice Code" corresponding to the document consulted.
|-
|Bool
|esValidoDian
|“true” if valid
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in YYYY-MM-DD HH:MM:SS format
|-
|String
|fechaRespuesta
|Day and time in which the electronic document was generated, in format AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the response code, useful for error identification
|-
|Array
|mensajesValidacion
|Validation messages in case of notification or rejection
|-
|String
|nombre
|Name defined by the DIAN
|-
|String
|qr
|QR code string concatenation (control element)
|-
|Array
|reglasNotificacionDIAN
|Validation rules in case of notification
|-
|Array
|reglasValidacionDIAN
|Validation rules in case of rejection
|-
|String
|resultado
|Method consumption result: Processed” or “Error”
|-
|String
|tipoCufe
|CUFE type algorithm. “CUFE-SHA384” or “CUDE-SHA384”
|-
|String
|xml
|XML file (type AttachedDocument) encoded in Base64
|}
Once the electronic invoice has been sent successfully (code '200' or '201' in the response), the attached files are sent (through the method'''CargarAdjuntos''') consuming the SOAP Web Attachments Service, in the scenario that the '''attachments''' parameter has been assigned to “1” or “11”, otherwise the SOAP Web Attachments Service will return an error indicating that the document does NOT support attachments.
{{clear}}

===EstadoDocumento Method===
It allows you to consult the status of the document indicated before the Acquirer, before the DIAN, the type of delivery and if it was successful, the list of associated events (ApplicationResponse) and other parameters of interest that can be useful in the software control processes billing (ERP) or for the business model of the issuing client.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Typr
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indicates if the document has physical acceptance (physically delivered): “true” or “false”
|-
|String
|acuseComentario
|Comment informed by the acquirer when making the acknowledgment
|-
|String
|acuseEstatus
|0: Acknowledgment not made ; 1: Acknowledgment made
|-
|String
|acuseResponsable
|Email of the person responsible for making the acknowledgment
|-
|String
|acuseRespuesta
|0: Response not sent; 1: Reply Sent
|-
|String
|ambiente
|Type of document generation environment:
:: “1: ProductionEnvironment”
:: “2: TestEnvironment”
|-
|String
|cadenaCodigoQR
|QR code string concatenation (control element)
|-
|String
|cadenaCufe
|Chain concatenation of the CUFE code prior to calculation by the corresponding algorithm of the service
|-
|int
|Codigo
|Indicates the status of the operation returned by the service
|-
|String
|consecutivo
|Consecutive Document TFHKA/DIAN
|-
|String
|cufe
|"Unique Code of Electronic Invoice" corresponding to the document consulted, calculated by the corresponding algorithm of the service
|-
|String
|descripcionDocumento
|Reference document type identifier,
: Example: "National Sales Invoice"
|-
|String
|descripcionEstatusDocumento
|Description corresponding to the statusDocument before the DIAN: "Processed Correctly"
|-
|String
|entregaMetodoDIAN
|Indicates the delivery method to the DIAN
: (Synchronous or Asynchronous), (Individual or Batch)
|-
|Bool
|esValidoDIAN
|
: “true” if valid
: "false" If not valid
|-
|String
|estatusDocumento
|Code obtained in the response corresponding to the status of the document before the DIAN (Catalogue to be defined)
|-
|Array <Evento>
|eventos
|List of Electronic Document events
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in format AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Date on which the document was generated, in format: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|History of document deliveries
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|mensajeDocumento
|Provides a description of the error of each of the initial validations. If there are no errors, no description is provided.
|-
|Bool
|poseeAdjuntos
|Indicates if the document has attachments:
: "true" or "false"
|-
|Bool
|poseeRepresentacionGrafica
|Indicates if the document has a graphic representation:
: "true" or "false"
|-
|Array <String>
|reglasValidacionDIAN
|Validation messages by the DIAN
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Reference document type identifier
: Watch [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|This element corresponds to the TrackId of the processed document
|}
Where Class.Evento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|ambienteDIAN
|Generation environment in the DIAN
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Code the document of the Application Response (event)
|-
|String
|comentario
|event commentary
|-
|String
|cufe
|CUFE of the electronic document
|-
|String
|descripcionEvento
|Description of use/source of the event
|-
|String
|emisorNumeroDocumento
|Issuer Identification Number
|-
|String
|emisorNumeroDocumentoDV
|Issuer Document Number Check Digit
|-
|String
|emisorRazonSocial
|Company Name of the Issuer
|-
|String
|emisorTipoIdentificacion
|Issuer Identification Type
|-
|Array <ExtrasEvento>
|extras
|Extra information corresponding to the event
|-
|String
|fechaEmision
|Date of Issue of the Application Response (event)
|-
|String
|fechaRecepcion
|Application Response Reception Date (event)
|-
|String
|hash
|Application Response document hash
|-
|String
|idPerfilDIAN
|DIAN Profile
|-
|String
|mensaje
|ApplicationResponse description message
|-
|String
|nombreArchivoXML
|XML file name
|-
|String
|nota
|Content of the Note field of the Application Response
|-
|String
|numeroDelEvento
|Consecutive Application Response
|-
|String
|receptorNumeroDocumento
|Receiver Identification Number
|-
|String
|receptorNumeroDocumentoDV
|Receiver Document Number Check Digit
|-
|String
|receptorRazonSocial
|Receiver's Business Name
|-
|String
|receptorTipoIdentificacion
|Receiver Identification Type
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUDE of the event:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Event type identifier:
: (Internal/ApplicationResponse)
|-
|String
|versionUBL
|UBL version of the XML
|}
And Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|nombre
|Additional Description
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas will correspond to:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|IP address of the computer in which the acknowledgment of the notification mail was made
|-
|String
|LeidoEstatus
|Notification mail acknowledgment status
|-
|String
|LeidoFecha
|Date of acknowledgment of notification mail
|-
|String
|canalDeEntrega
|Electronic document delivery channel
|-
|Array <String>
|email
|Email of the recipient of the electronic document
|-
|String
|entregaEstatus
|Delivery status:
: '0': Mail not sent
: '200': Mail sent
|-
|String
|entregaEstatusDescripcion
|Delivery Status Description
|-
|String
|entregaFecha
|Document delivery date
|-
|String
|fechaProgramada
|Delivery Date
|-
|String
|mensajePersonalizado
|Personalized message to be delivered by Email, WhatsApp or Telegram
|-
|String
|nitProveedorReceptor
|NIT of the receiving Technological Provider, in case of delivery by Interoperability
|-
|String
|recepcionEmailComentario
|Customer Acknowledgment Comment
|-
|String
|recepcionEmailEstatus
|E-mail reception status
: 1: Accepted
: 2: Rejected
: 3: In verification
|-
|String
|recepcionEmailFecha
|Date of receipt of the Email
|-
|String
|recepcionEmailIPAddress
|Email receiving IP address
|-
|String
|telefono
|For delivery by Whatsapp/Telegram
|}
'''@Important:''' The structure of this Response may still be subject to change in a future update.
{{clear}}
===EnvioCorreo Method===
Allows you to forward the indicated document to one or more email addresses.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”. Allows sending multiple recipients (maximum 5) separated by a comma character ','
|-
|correo
|Email to which the document will be sent. Example name@company.com
|-
|adjuntos
|
: “0”: Resends the mail without attachments
: “1”: Forwards the mail with the attachments stored during the issuance of the document.
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|rowspan="2"|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Send''' method) the '''attachments''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform does not will generate standard graphical representation (PDF), therefore only the documents hosted on the platform (AttachedDocument) will be forwarded to the recipients. To forward the mail (with the AttachedDocument and attachments) to an email address different from the one used during the transmission, the '''CargarAtjuntos''' method of the SOAP Web Attachments Service can be used again.
{{clear}}
===DescargaPDF Method===
Allows you to download the standard graphic representation (PDF generated by TFHKA) of the document for local storage, local consultation or reprint purposes.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted.
|-
|String
|documento
|Base64 encoded PDF document
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Enviar''' method) the '''adjuntos''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform will not will generate standard graphic representation (PDF), therefore this method cannot be used since the service will throw an error indicating that there is NO associated PDF, since it is assumed that the graphic representation has been generated locally by the billing software (ERP).
{{clear}}
=== DescargaXML Method===
It allows the download of the XML document (only the electronic document Invoice, CreditNote and DebitNote), in case it is required to validate the information such as the signature or its authenticity or for the purpose of local management and storage.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted
|-
|String
|documento
|XML document (Invoice, CreditNote or DebitNote) encoded in Base64
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===FoliosRestantes Method===
Allows you to consult the stamps (transactions) available. The stamps are consumed in proportion to the transactions made.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE:Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|int
|foliosRestantes
|Number of sheets available
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===CargarCertificado Method===
For now, this method will only be used internally by The Factory HKA Colombia.
{{clear}}
===DescargarEventoXML Method===
It allows downloading an event or occurrence (ApplicationResponse) related to an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
;RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|Documento
|XML document (ApplicationResponse) encoded in Base64
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===GenerarContenedor Method===
UA container is a type of AttachedDocument document, its structure is intended to contain and transmit an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) generated to date in a single XML file.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Contenedor
|XML document (AttachedDocument) encoded in Base64
|-
|String
|Fecha
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===GenerarEvento Method===
Allows the generation of an event or occurrence (ApplicationResponse) associated with an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Object with the data of the event (ApplicationResponse) to generate
|}
Where Class.DatosEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoEvento
|Indicates the code of the event (to define catalog)
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Comentario
|Comment or description of the event
|-
|String
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Additional event information
|}
Where Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Nombre Código
|of the field
|-
|String
|valor
|Additional Information
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|consecutivoDocumentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|XML document (ApplicationResponse) encoded in Base64
|}
{{clear}}

Web Soap Broadcast Service Methods - Direct Integration Manual Index

2022-03-01T15:08:27Z

Lvargas:

<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly>
The parameters to be incorporated in the methods of this Web Service must comply with the format and the corresponding directives according to the following rules:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Format
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| A || Alphabetic character
|-
| N || Numeric character
|-
| AN || AlphaNumeric character
|-
| <nowiki> A|3 </nowiki> || 3 Alphabetic characters (fixed length)
|-
| <nowiki> N|3 </nowiki> || 3 Numeric characters (fixed length)
|-
| <nowiki> AN|3 </nowiki> || 3 alphaNumeric characters (fixed length)
|-
| <nowiki> A|..3 </nowiki> || Up to 3 Alphabetic characters (variable length)
|-
| <nowiki> N|..3 </nowiki> || Up to 3 Numeric characters (variable length)
|-
| <nowiki> AN|..3 </nowiki> || Up to 3 alphaNumeric characters (variable length)
|-
| <nowiki> N|2..6 </nowiki> || Between 2 and 6 Numeric characters (variable length)
|-
| INT32 || Whole. (Maximum Value: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Mandatory
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| YES || If it is mandatory for the DIAN
|-
| NOT || It is not mandatory for the DIAN
|-
| C/C || It is required where applicable (or under certain conditions by the client's business model)
|}
{{clear}}

===Enviar Method===
The function in charge of building and sending the electronic documents to the technology provider.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by technology provider
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|See the detail of the Invoice Object below
|-
|String
|adjuntos
|
Possible values:
: “0” Attachments are not allowed. XML and standard graphic representation is generated by The Factory HKA
: “1” Supports attachments. XML and standard graphic representation is generated by The Factory HKA
: “10” Attachments are not allowed. Only XML is generated without standard Graphic representation by The Factory HKA
: “11” Supports attachments. Only XML is generated without standard graphical representation by The Factory HKA
|}

'''@IMPORTANT:''' If the value “1” or “11” is sent in the '''attachments''' parameter, no email will be sent until the method is consumed '''CargarAdjuntos''' (ServicE Adjuntos Web SOAP). For documents that accept attachments, the field '''Destinatario.email''' of the client is required and the '''notify''' field must be set to “YES”.

<pre style="color: red">WARNING: If options '10' or '11' are used in the attachments parameter, our platform will not generate standard graphic representation (PDF), therefore PDF is not hosted on it and the graphic representation cannot be viewed from the platform. web portal, in the notification email to the acquirer (view document section), nor download through the DescargaPDF method of the SOAP Web Broadcast Service or forward the graphical representation through the EnvioCorreo method, since it is being assumed that it has been generated locally by the billing software (ERP).</pre>

Next, the diagram of the '''invoice object for the billing model with prior validation''' is exposed, where the changes in its structure can be seen with respect to the object used in the model with post validation :

* In Blue new classes/attributes that were not present in the post validation model.
* In Yellow existing classes/attributes in the post-validation model that underwent changes in pre-validation.
* In Orange existing classes/attributes in post-validation model that are deprecated (removed) in pre-validation.
 

The invoice object for the billing model with prior validation is described in greater detail below:
 

<center>'''Diagram Class.FacturaGeneral with Class.Anticipos, Class.Autorizado and Class.CargosDescuentos'''
[[Archivo:Diagram Class.FacturaGeneral with Class.Anticipos, Class.Autorizado and Class.CargosDescuentos.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagram Class.FacturaGeneral with Class.Cliente'''
[[Archivo:Diagram Class.FacturaGeneral with Class.Cliente.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.Cliente]]
 
'''Diagram Class.FacturaGeneral with Class.CondicionPago'''
[[Archivo:Diagram Class.FacturaGeneral with Class.CondicionPago.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.CondicionPago]]
 
'''Diagram Class.FacturaGeneral with Class.FacturaDetalle'''
[[Archivo:Diagram Class.FacturaGeneral with Class.FacturaDetalle.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.FacturaDetalle]]
 
'''Diagram Class.FacturaGeneral with Class.DocumentoReferenciado'''
[[Archivo:Diagram Class.FacturaGeneral with Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.DocumentoReferenciado]]
 
'''Diagram Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagram Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagram Class.FacturaGeneral with Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra and Array - informacionAdicional'''
[[Archivo:Diagram Class.FacturaGeneral with Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra and Array - informacionAdicional.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra and Array - informacionAdicional]]
 
'''Diagram Class.FacturaGeneral with Class.TasaDeCambio, Class.TasaDeCambioAlternativa and Class.TerminosEntrega'''
[[Archivo:Diagram Class.FacturaGeneral with Class.TasaDeCambio, Class.TasaDeCambioAlternativa and Class.TerminosEntrega.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral with Class.TasaDeCambio, Class.TasaDeCambioAlternativa and Class.TerminosEntrega]]
</center>
{{clear}}
====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|anticipos
|Array <Anticipos>
| -
|NOT
|
: Information related to advances
: '''PATH''': /root/cac:PrepaidPayment
: (see detail in [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NOT
|
: Information of the person authorized to download documents
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver see detail in [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|YES
|
: The number of decimals to be used is sent (minimum 0, maximum 6)
: Rejection If more decimals are received in the amounts than those indicated in this field
: '''PATH''': Does not apply
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NOT
|
: Information related to a charge or a discount on an invoice scale that does not affect the tax base
: '''PATH''': /root/cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|YES
|
: Acquirer Information
: '''PATH''':/root/cac:AccountingCustomerParty
: (see detail in [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NOT
|
: Information related to the payment condition
: '''PATH''': /root/cac:PaymentTerms
: (see detail in [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..20
|YES
|
: Correlative/consecutive of the electronic document
: prefix concatenation (<nowiki>AN|..4</nowiki>) + the consecutive DIAN,
: according to the configuration in the web portal:
:: Manual with prefix: prefix required (No hyphen). Example: “PREF2147483647”
:: Manual without prefix: prefix not required. Example: “2147483647”
: Rejection Additional characters such as spaces or hyphens are not allowed
: Rejection Consecutive number must be equal to or greater than the initial value of the numbering range granted by the DIAN
: Rejection Consecutive number must be equal to or less than the final value of the numbering range granted by the DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|YES
|
: Details or product information
: '''PATH''': /root/cac:InvoiceLine
: (see detail in [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Information describing a referenced document
: '''Required''' on tipoDocumento invoices contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse and BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NOT
|
: Delivery information (Delivery) of goods
: '''PATH''': /root/cac:Delivery
: (see detail in [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|YES
|
: Date and time of issuance of the document, in format: YYYY-MM-DD HH:MM:SS
: Notification If the issue date is earlier than five (5) days from the calendar date
: Rejection If the issue date is later than ten calendar days
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Date/Time of the end of the billing period (Interval of dates to which the bill refers, for example in public services), in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Billing period start date/time, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Tax payment date, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Due date of the invoice, in format: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|YES
|
: General or global tax information
: Rejection If the taxes/withholdings reported in this arrangement do not correspond to what is reported in the details
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of general taxes/withholdings by type of impuesto/retención
: Rejection If the total value of the tax/withholding indicated is different from the sum of those reported in the impuestosGenrales arrangement
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NOT
|
: Additional information or free text related to the document
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|YES
|
: Information related to the payment of the invoice
: '''PATH''': /root/cac:PaymentMeans
: (see detail in [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|YES
|
: Currency or currency of the document
: Use ISO 4217 codes (Example Colombian Pesos “COP”)
: Rejection If the value does not correspond to one of the ISO 4217 codes
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NOT
|
: Information related to the purchase order
: '''PATH''': /root/cac:OrderReference
: (see detail in [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|YES
|
: Consecutive from which the series begins for the document to be issued, the prefix (with hyphen) must always be placed regardless of the sequential mode.
: Example: 'PREF-1123456'
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Rounding applied to arrive at totalMonto
: Rejection If rounding is greater than the greater value between 500 pesos or 0.1% of the total value of the invoice
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Information related to emissions from the Health Sector'''Required: When typeSector = '2'''' is informed
: (see detail in [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Information related to the exchange rate of foreign currency to Colombian peso (COP)
: '''Required''' If documenttype is export/international or if the base currency is different from “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (see detail in [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NOT
|
: Information used as an alternative method to report conversions to other currencies
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (see detail in [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Information related to the delivery
: '''Required''' If documenttype is export/international
: '''PATH''': /root/cac:DeliveryTerms
: (see detail in [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|YES
|
: Document type
: '''PATH''': Invoice, CreditNote, DebitNote
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|YES
|
: To issue documents from the Health Sector, indicate code '2' in this field
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|YES
|
: Operation type indicator
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Sum of all advance payments
: Rejection Si totalAnticipos does not correspond to the sum of the Anticipos.montoPagado attributes in the advances array
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Taxable Base Value: Sum of Taxable Bases for the calculation of taxes at the invoice level
: Rejection If totalBaseImponible is not equal to the sum of occurrences FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total gross value with taxes
: Rejection If totalGrossWithTax is not equal to the sum: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Charge: Sum of all charges applied at the invoice level
: Rejection If totalCargosAplicados does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Discount: Sum of all the discounts applied at the invoice level
: Rejection If totalDescuentos does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value to pay of the document: Total value of items (including charges and discounts at item level) + value of taxes + value of charges – value of discounts – value of advances
: Rejection If totalMonto is not consistent with the total value of items + value of taxes + value of charges – value of discounts – value of advances + rounding appliedno es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|YES
|
: Number or quantity of product lines (rows) present in the document
: Rejection If the value of totalProductos is different from the number of occurrences of rans in the detalleDeFactura array
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Gross Value before taxes: Sum of the gross values of the invoice lines
: Rejection If totalSinImpuestos does not correspond to the sum of the attributes precioTotalSinImpuestos in the detalleDeFactura array
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|YES
|
: Date on which the payment was received, in format: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Date on which the payment was made, in format: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NOT
|
: Time in which the payment was made, in format:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|YES
|
: Internal identification of the payment
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|YES
|
: Payment Instructions
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|YES
|
: Value of the advance payment, it cannot be higher than the total value of the invoice
: Notification If montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}
====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NOT
|
: Direction
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Tradename
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Identification number
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Check digit
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Business name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Telephone
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|YES
|
: ID Type
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: See list of possible values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Code to categorize the discount
: '''Mandatory''': If it is a discount at invoice level (general)
: Rejection If it is a discount and some of the values are not reported in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|YES
|
: Free text to inform the reason for the discount
: '''PATH''': …/cbc:AllowanceChargeReason
: Notification : If a charge or discount is reported and this item is not reported
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indicator of whether it is Charge "1" or Discount "0"
: Rejection : If this item contains information other than “1” or “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the charge or discount, if it is a discount, it cannot be higher than the base value
: Rejection : If it is Discount and monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Base Value to calculate the discount or charge,
: Rejection: If the montoBase is negative, if it is a discount it cannot be greater than the total value of the invoice
: Rejection: If montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Discount percentage
: Rejection If this element > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|YES
|
: Sequence order indicator
: '''PATH''': …/cbc:ID
|}
====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NOT
|
: Corresponds to the economic activity code CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NOT
|
: Last name of the acquirer.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: It allows specifying the means and data of the electronic delivery of the document
: '''Required''': If notify field = 'YES'
: '''PATH''': Not defined
: (see detail in [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|YES
|
:Tax details of the acquirer
: Rejection If the class is not informed
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Information detailing the receiving address of the acquirer
: '''Recommended''': This ransf address is the one that is painted in the standard graphical representation
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
:Tax address of the acquirer.
: '''Mandatory''': If the purchaser is responsible
: Notification If the acquirer is responsible and this class was not informed
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: E-mail of the acquirer that will go to the fiscal XML/UBL
: (only one email is sent in this field)
: '''PATH''': Does not apply node
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Legal information of the client
: Notification : If tipoPersona = '1' is reported and the attribute is not reported
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (see detail in [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Commercial name of the acquirer
: '''Obligatory''' If the commercial name will be shown in the Graphic Rep.
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''Recommended''': If the person is natural, concatenate in this field the full name (names + surnames)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NOT
|
: Additional contact note
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|YES
|
: Activates the sending of email to the acquirer.
: Possible values: “YES” or “NO”
: '''PATH''': Does not apply
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Number of the Document or Fiscal Identification of the purchaser
: '''Mandatory''' If the acquirer is responsible, he must inform the NIT
: Rejection If tipoIdentificacion is '31' and the NIT structure is invalid
: Rejection : It is generated if the value of AdditionalAccountID = “2” and it is not mentioned.
: Note : To identify the final consumer, the following document “222222222222” is used
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: NIT verification digit of the acquirer
: '''Required''': If TipoIndentificacion = 31, it must be informed
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|YES
|
: Obligations and regime of the acquirer
: Rejection If the class is not informed
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Second name of the acquirer.
: '''PATH''': Not defined
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NOT
|
: Purchaser's phone
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Acquirer ID Type
: ReRejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Note: To identify the final consumer, the code “13” is used.
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|YES
|
: Person type identifier
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}
====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NOT
|
: Event Code
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NOT
|
: Period Length
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NOT
|
: Period length unit of measure
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|YES
|
: Due date
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Payment conditions
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Associated payment method
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|YES
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Amount of the fine
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Penalty Amount
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period from
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period until
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Discount rate
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Payment Percentage
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Advance reference number
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}
====Class.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Unit quantity of this item per package.
: For example, if the item consists of three “six packs”, the quantity to be reported in QuantityPerPackage is 6, while the quantity to be reported in QuantityActual is 3, and the total number of cans being described is 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Real amount on which the price applies
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|YES
|
: Unit of the quantity on which the price applies
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Number of units of the product/service billed
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Information on charges and discounts
: '''Mandatory''' This arrangement must be reported at the item level, if and only if the charge or discount affects the item's tax base.
: If a general individual charge to the invoice generates VAT, it must be reported as an item
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Manufacturer code corresponding to the item
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Identifier code of the country of origin of the item or service
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Vendor code corresponding to the item
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Reported price type code
: '''Required''' For commercial samples (value = 01)
: Rejection If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Technical data associated with the product or service
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Information describing a referenced document
: '''Required''' In invoices tipoDocumento Contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Standard code (item or service identification according to a standard)
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: Notification If it is an export invoice (tipoDocumento = 02), and the tariff subheading was not reported
: Notification If the code does not exist in a closed standard.
: Example: UNSPSC
: Notification If the code does not follow the rule of formation of an open code, but with verifiable values
: Example: GTIN, Example: Tariff headings
: '''Note''': In this case the code 999 (Taxpayer adoption standard) can be used to avoid reclassifying the products
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: Rejection If standardCodigo = 010 and estandarCodigoID is different from 9
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|NO
|
: Product code according to the standard informed in estandarCodigo
: View attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: organization standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub code of the product standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|YES
|
: tax information
: Rejection If there is more than one element with the same value in the attribute FacturaImpuestos.codigoTOTALImp
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Additionally, it should NOT be informed for invoices of the simple group I regime, nor for items whose concept in AIU contracts is not part of the tax base.
: At the item level, it only applies to taxes that must be reported at the item level, for example: VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of taxes for all types
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Rejection If the value of the total value of the indicated tax is different from the sum of what is reported in FacturaImpuestos. valorTOTALImp.
: At the item level, it only applies to taxes that must be reported at the item level, for example, VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: It serves to add specific product information that may be requested by authorities or entities other than the DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (see detail in [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the agent
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Verifier Digit of the agent's NIT
: '''Required''' for mandated invoices
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Agent identification type
: '''Required''' For mandated invoices
: Notification If mandatorioNumeroIdentificacion is informed and the value of this field is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item brand.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item model.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicator of whether the item is free or not (no commercial value)
: '''Required''' For commercial samples
: Possible values: “1” (It is a free sample) or “0” (It is not a free sample)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Name of the manufacturer of the product/service
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Free text to add additional information to the article
: '''Mandatory''' Inform in the case of invoices for AIU-type service contracts. For the Administration item. In this case, the note must begin with the text: "AIU services contract for:" The taxpayer must include the object of the invoiced contract
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Value of the item or service.
: Corresponds to the value of the reference price of the item that is given as a sample or gift without commercial value
: '''Required''' For commercial samples
: Rejection If the precioReferencua attribute is reported, then the value of TotalPriceWithoutTaxes must be (0.00), since it is a commercial sample or gift
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Total price of the product or service.
: (quantityUnits*UnitSalePrice +charges-discounts +taxes)
: '''Required''' For use in graphical representations
: '''PATH''': Undefined
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the line without taxes.
: (QuantityUnits*UnitSalePrice +charges-discounts)
: Rejection If the TotalPriceWithoutTaxes attribute is reported as 0.00, then the ReferencePrice value must be reported since it is a commercial sample or gift
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Unit price of the product/service
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|YES
|
: Sequence order indicator (line number)
: Notification If it contains a value already used in the sequence attribute in another group of this file
: Notification If the numbers used in the different groups are not consecutive, starting at "1"
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Product serials (comma separator), Ex: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Manufacturer code corresponding to a sub-specification of the article
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Issuer/seller code corresponding to a sub-specification of the item
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: To classify the type of AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|YES
|
: Unit of measure code of the invoiced product/service
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|YES
|
: Electronic Document Delivery Means
: It can take the following values: 0– Email; 1– Reception; 2– Interoperability; 3- Whatsapp; 4- Telegram
: PATH: Does not apply
|-
|email
|Array <String>
| -
|C/C
|
: List of Emails to which the electronic document will be delivered if the DeliveryChannel='0'
: '''Required''' When deliveryChannel=’0’
: '''PATH''': Does not apply
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: scheduled date
: '''PATH''': Does not apply
|-
|mensajeProgramado
|String
| -
|NO
|
: Message
: '''PATH''': Does not apply
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the Recipient
: '''Required''' When deliveryChannel='1' or '2'
: '''PATH''': Does not apply
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Recipient Telephone
: '''Required''' When deliveryChannel='3' or '4'
: '''PATH''': Does not apply
|}
====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Required''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the ReferencedDocument information is going to be sent, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the transfer invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note.
: You can only report electronic invoices from the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Ransfe date of the referenced document, in format: YYYY-MM-DD
: '''Mandatory''' When InternalCode is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Not defined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|YES
|
: Concatenation of the prefix and the referenced document number
: Rejection If codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document,
: Example: "National Sales Invoice"
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type.
: '''Required''' When InternalCode is '1'
: RejectionIf codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Note''': For remission orders, inform the code ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
|}
'''@IMPORTANT:'''
''# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentsReferenced must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; internalCode = '4', documentNumber, transfer.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Contingency Invoice''', an array of the ReferenceDocuments type must be sent, indicating the fields: internal code = '1', numberDocument, date, typeDocumentCode (corresponding to Contingency Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Carrier Data
: '''PATH''': ../cac:DeliveryParty
: (see detail in [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Dispatch Information
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Delivery information
: '''PATH''': ../cac:DeliveryAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Effective date and time of departure of the goods, in format: YYYY-MM-DD HH:MM:SS
: Rejection if the effective date of departure is before the date of issue
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Estimated date and time, in format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}
====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indication to display the field in the XML
: (“0” = Don't show / “1” = Show)
: '''PATH''': Variable
|}
====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Assigned Label for PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|YES
|
: Code of the extensible field to reference
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|}
====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tax base on which the value of the tax is calculated
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Retention type indicator
: '''PATH''': Not Defined
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|YES
|
: Tribute rate.
: In the event that the tax is a percentage of the taxable value: inform the "percentage" rate to be applied to the tax base
: Rejection If you report a different rate for one of the taxes listed in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|YES
|
: Identification of the unit of measure
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Base unit of measure for the tribute
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection If valorTributoUnidad element is informed and UnidadMedidaTributo is not informed
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tribute value. Product of the percentage applied to the tax base
: Rejection For taxes whose rate is stated in percentages, if valorTOTALImp is different from baseImponibleTOTALImp * percentageTOTALImp
: Rejection For taxes whose rate is stated in nominal values (for example, plastic bags), if valorTOTALImp is different from valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
:It is the nominal value of the tax per unit
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection if the unitMedidaTributo element is NOT informed.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}
'''@IMPORTANT''': In the case of the ICA and RETEICA in which the value of the percentage is based on a thousand, the value of said percentage must be reported based on a hundred, that is, if you want to report a percentage of 11.04% thousand for any of these taxes, it must be indicated in the TOTALImp percentage field as 1,104.
====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Sum of all attributes valorTOTALImp
: Rejection If montoTotal is different from the sum of all occurrences ofFacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}
====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Code of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Payment channel code
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Optional not used for now
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Due date of payment of the invoice in format: YYYY-MM-DD
: '''Mandatory''' If the sale is on credit
: Rejection: If the payment method code is "2" and the expiration date is not sent
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Code corresponding to the means of payment
: Rejection:If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Payment method
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identifier or internal reference of the Payment
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Number of days for payment
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transfer number or check number
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}
====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: customer code
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Document Reference
: '''PATH''': ../cac:DocumentReference
: (see detail in [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Date of the Order, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|YES
|
: Purchase Order Number
: '''Required''' To send the Purchase Order
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Order Number
: '''Required''' To send the Order
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: CUFE type identifier
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Order type
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID of some referenced document
: '''PATH''': ../cbc:UUID
|}
'''NOTE:''' As it is a delivery order, the OrdemDeCompra class must be informed, if it is necessary to indicate more than one order, it must be informed through the DocumentReferenced class with '''codigoInterno''' ='1 ', this in order to send the information referring to them in the AdditionalDocumentReference group.

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If brings value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Information related to a charge or a discount
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Delivery Conditions Code
: '''Obligatorio''' Se es factura de exportación/internacional
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Transport payment method: It is used to indicate how transport costs are paid, for example: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Information detailing the delivery address
: '''PATH''': ../cac:DeliveryLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Identification number
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of who assumes responsibility in case the merchandise is lost
: '''PATH''': ../cbc:LossRisk
|}
====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Care of
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: For the attention of
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: block name
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the street
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Additional Name to better specify the street name
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: Ciudad
: Rejection If country is "CO" and the content of this attribute does not correspond to one of the values in the 'Name' column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|YES
|
: department code
: If country is "CO", CodigoDepartamento must correspond to one of the values in the Code column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Mandatory''' for Responsible Issuers and Acquirers
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corresponding time zone correction
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: department name
: Rejection if the code of the country field is "CO" and the content of this attribute does not correspond to one of the values of the Name column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
:An addressable department of an organization
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|YES
|
: Client's address, without indicating city or department
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: District
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Bedroom
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|YES
|
: Identifier of the language used in the country name
: Notification If the content of this attribute does not correspond to one of the values of the ISO 639-1 standard
: NotificaNotificationión If this is a group with information regarding the address of the issuer of an electronic document, it must contain the literal "is"
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: address coordinates
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (see detail in [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Municipality Code
: Notification If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of a Building
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Parcel Number
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|YES
|
:Customer country.
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Flat
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Subdivision (Name of the Neighborhood)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A specific location within a building
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Postal zone
: Notification If the content of this element does not correspond to a corresponding value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notification If the value of the CodigoDepartamento attribute is different from the first 2 digits of the postal code.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}
====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: latitude measure in degrees
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: measure of longitude in degrees
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Latitude measurement in decimal minutes in mm.mm format
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Longitude measurement in decimal minutes in mm.mm format
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of measurement of latitude in relation to the Equator
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of longitude measurement in relation to the Equator
: '''PATH''': ../cbc:LongitudeDirectionCode
|}
====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined (see detail in [[#Class.Extensible|Class.Extensible]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Establishment Code
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Acquirer Identifier.
: You must inform the NIT if you are responsible
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Check digit
: '''Mandatory''' If tipoIdentificacion =31, the DV of the NIT must be informed
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Billing prefix:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Customer identification type
: Rejection If the content of this element is different from “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|YES
|
: Obligations of the acquirer
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Optional, if informed, indicate “Not applicable”. Possible Values:
: 48: “Sales tax - IVA”
: 49: “Not responsible for IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}
====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
:additional quantity
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: additional code
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|codigoInterno2
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: additional description
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Period End Date
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Beginning date of the period
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Characteristic you want to report on the item, for example: (Vehicle Use)
: Rejection For each name there must be a value
: '''PATH''': ../cbc:Name
: (For defining extensible field catalogs at the detail level)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Sequence order indicator
: '''PATH''': Not defined
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
:Value Type Indicator, example Value = ’1’
: '''PATH''': Does not apply
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Value of the characteristic to be reported, for example: (Particular)
: Rejection For each value there must be a name
: '''PATH''': ../cbc:Value
|}
====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Description
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tax Types
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Information on the Address of the Person Responsible for Delivery
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Email
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicator if it is information on “for the attention of” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Contact name
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Responsible for the Delivery
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
:Contact Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: Carrier NIT
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Check digit
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Billing Prefix
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Carrier Liability
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Telefax
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: carrier phone
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier Identification Type
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Tax address of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: carrier name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Carrier document number
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Verifier Digit of the NIT of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier document type
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Mandatory''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the information will be sent DocumentoReferenciado, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the electronic invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note. You can only report electronic invoices of the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Mandatory''' When internal code is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': Undefined
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Undefined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenation of the prefix and the referenced document number
: Rejection if codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document, Example: "National Sales Invoice"
: '''PATH''': Not defined
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type
: '''Required''' When InternalCode is '1'
: Rejection If codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''PATH''': Undefined
|}
'''''@IMPORTANT:'''
# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentosReferenciados must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; CodihoInterno = '4', numeroDocumento, descripcion.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Factura de Contingencia ''', an array of the documentosReferenciados type must be sent, indicating the fields: internal code = '1', numberDocument, date, tipoDocumentCode (corresponding to Contingenc Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Complementary data of the beneficiary of the health service for collection scenarios.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (see detail in [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|Por definir
|C/C
|
: To indicate the type of operation through which the collection was made in the accreditation or report scenarios
: '''PATH''': To be defined
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|For the report of the additional data fields of the Health Sector
: (see detail in [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|YES
|
: Type of Health Sector Scenario. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTE: The issuance of health sector documents is only available through version 4 of the issuance service. 

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Information detailing the address of the beneficiary of the health service.
: '''PATH''': ../cac:ResidenceAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Additional data fields of the Health Sector to report information associated with the beneficiaries of the health service
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
: (see detail in [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|nombre
|String
|N|..2
|Si
|
: Additional data field code.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Note: It must correspond to one of the codes in the column[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|depends on the field
|Yes
|
: Value of the additional data field of the health sector as appropriate.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Important''': In the case of the field '''rangoNumeracion''', this value must always have the following format (Pefijo-campoDesde), that is, said field is independent of the sequential mode configured in the portal (manual with prefix or manual without prefix).

In the case of the field '''consecutivoDocumento''', This field does depend on the sequential mode configured in the web portal.
* If the assigned modality is''“manual sin prefijo”'', the values for the fields rangoNumeracion and consecutivoDocumento’ They should be for example:
:: Invoice #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Invoice #2: rangeNumeracion= "PRUE-1", consecutiveDocument= "2"
:: ...
:: Invoice #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*If the assigned modality is ''“manual with prefix”'', the values for the fields rangoNumeracion and consecutivoDocumento must be, for example:
:: Invoice #1: rangeNumeracion= "PRUE-1", consecutiveDocument= "PRUE1"
:: Invoice #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Invoice #1000: rangeNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|ID
! style="background:#f2f2f2; text-align:center;"|Description
|-
|int
|codigo
|Indicates the status of the operation returned by the service, (to define catalog)
|-
|String
|consecutivoDocumento
|Prefix and Consecutive of the Concatenated Document without separators. For the example above it corresponds to: “PRUE980338337”
|-
|String
|cufe
|"Unique Electronic Invoice Code" corresponding to the document consulted.
|-
|Bool
|esValidoDian
|“true” if valid
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in YYYY-MM-DD HH:MM:SS format
|-
|String
|fechaRespuesta
|Day and time in which the electronic document was generated, in format AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the response code, useful for error identification
|-
|Array
|mensajesValidacion
|Validation messages in case of notification or rejection
|-
|String
|nombre
|Name defined by the DIAN
|-
|String
|qr
|QR code string concatenation (control element)
|-
|Array
|reglasNotificacionDIAN
|Validation rules in case of notification
|-
|Array
|reglasValidacionDIAN
|Validation rules in case of rejection
|-
|String
|resultado
|Method consumption result: Processed” or “Error”
|-
|String
|tipoCufe
|CUFE type algorithm. “CUFE-SHA384” or “CUDE-SHA384”
|-
|String
|xml
|XML file (type AttachedDocument) encoded in Base64
|}
Once the electronic invoice has been sent successfully (code '200' or '201' in the response), the attached files are sent (through the method'''CargarAdjuntos''') consuming the SOAP Web Attachments Service, in the scenario that the '''attachments''' parameter has been assigned to “1” or “11”, otherwise the SOAP Web Attachments Service will return an error indicating that the document does NOT support attachments.
{{clear}}

===EstadoDocumento Method===
It allows you to consult the status of the document indicated before the Acquirer, before the DIAN, the type of delivery and if it was successful, the list of associated events (ApplicationResponse) and other parameters of interest that can be useful in the software control processes billing (ERP) or for the business model of the issuing client.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Typr
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indicates if the document has physical acceptance (physically delivered): “true” or “false”
|-
|String
|acuseComentario
|Comment informed by the acquirer when making the acknowledgment
|-
|String
|acuseEstatus
|0: Acknowledgment not made ; 1: Acknowledgment made
|-
|String
|acuseResponsable
|Email of the person responsible for making the acknowledgment
|-
|String
|acuseRespuesta
|0: Response not sent; 1: Reply Sent
|-
|String
|ambiente
|Type of document generation environment:
:: “1: ProductionEnvironment”
:: “2: TestEnvironment”
|-
|String
|cadenaCodigoQR
|QR code string concatenation (control element)
|-
|String
|cadenaCufe
|Chain concatenation of the CUFE code prior to calculation by the corresponding algorithm of the service
|-
|int
|Codigo
|Indicates the status of the operation returned by the service
|-
|String
|consecutivo
|Consecutive Document TFHKA/DIAN
|-
|String
|cufe
|"Unique Code of Electronic Invoice" corresponding to the document consulted, calculated by the corresponding algorithm of the service
|-
|String
|descripcionDocumento
|Reference document type identifier,
: Example: "National Sales Invoice"
|-
|String
|descripcionEstatusDocumento
|Description corresponding to the statusDocument before the DIAN: "Processed Correctly"
|-
|String
|entregaMetodoDIAN
|Indicates the delivery method to the DIAN
: (Synchronous or Asynchronous), (Individual or Batch)
|-
|Bool
|esValidoDIAN
|
: “true” if valid
: "false" If not valid
|-
|String
|estatusDocumento
|Code obtained in the response corresponding to the status of the document before the DIAN (Catalogue to be defined)
|-
|Array <Evento>
|eventos
|List of Electronic Document events
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in format AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Date on which the document was generated, in format: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|History of document deliveries
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|mensajeDocumento
|Provides a description of the error of each of the initial validations. If there are no errors, no description is provided.
|-
|Bool
|poseeAdjuntos
|Indicates if the document has attachments:
: "true" or "false"
|-
|Bool
|poseeRepresentacionGrafica
|Indicates if the document has a graphic representation:
: "true" or "false"
|-
|Array <String>
|reglasValidacionDIAN
|Validation messages by the DIAN
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Reference document type identifier
: Watch [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|This element corresponds to the TrackId of the processed document
|}
Where Class.Evento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|ambienteDIAN
|Generation environment in the DIAN
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Code the document of the Application Response (event)
|-
|String
|comentario
|event commentary
|-
|String
|cufe
|CUFE of the electronic document
|-
|String
|descripcionEvento
|Description of use/source of the event
|-
|String
|emisorNumeroDocumento
|Issuer Identification Number
|-
|String
|emisorNumeroDocumentoDV
|Issuer Document Number Check Digit
|-
|String
|emisorRazonSocial
|Company Name of the Issuer
|-
|String
|emisorTipoIdentificacion
|Issuer Identification Type
|-
|Array <ExtrasEvento>
|extras
|Extra information corresponding to the event
|-
|String
|fechaEmision
|Date of Issue of the Application Response (event)
|-
|String
|fechaRecepcion
|Application Response Reception Date (event)
|-
|String
|hash
|Application Response document hash
|-
|String
|idPerfilDIAN
|DIAN Profile
|-
|String
|mensaje
|ApplicationResponse description message
|-
|String
|nombreArchivoXML
|XML file name
|-
|String
|nota
|Content of the Note field of the Application Response
|-
|String
|numeroDelEvento
|Consecutive Application Response
|-
|String
|receptorNumeroDocumento
|Receiver Identification Number
|-
|String
|receptorNumeroDocumentoDV
|Receiver Document Number Check Digit
|-
|String
|receptorRazonSocial
|Receiver's Business Name
|-
|String
|receptorTipoIdentificacion
|Receiver Identification Type
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUDE of the event:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Event type identifier:
: (Internal/ApplicationResponse)
|-
|String
|versionUBL
|UBL version of the XML
|}
And Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|nombre
|Additional Description
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas will correspond to:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|IP address of the computer in which the acknowledgment of the notification mail was made
|-
|String
|LeidoEstatus
|Notification mail acknowledgment status
|-
|String
|LeidoFecha
|Date of acknowledgment of notification mail
|-
|String
|canalDeEntrega
|Electronic document delivery channel
|-
|Array <String>
|email
|Email of the recipient of the electronic document
|-
|String
|entregaEstatus
|Delivery status:
: '0': Mail not sent
: '200': Mail sent
|-
|String
|entregaEstatusDescripcion
|Delivery Status Description
|-
|String
|entregaFecha
|Document delivery date
|-
|String
|fechaProgramada
|Delivery Date
|-
|String
|mensajePersonalizado
|Personalized message to be delivered by Email, WhatsApp or Telegram
|-
|String
|nitProveedorReceptor
|NIT of the receiving Technological Provider, in case of delivery by Interoperability
|-
|String
|recepcionEmailComentario
|Customer Acknowledgment Comment
|-
|String
|recepcionEmailEstatus
|E-mail reception status
: 1: Accepted
: 2: Rejected
: 3: In verification
|-
|String
|recepcionEmailFecha
|Date of receipt of the Email
|-
|String
|recepcionEmailIPAddress
|Email receiving IP address
|-
|String
|telefono
|For delivery by Whatsapp/Telegram
|}
'''@Important:''' The structure of this Response may still be subject to change in a future update.
{{clear}}
===EnvioCorreo Method===
Allows you to forward the indicated document to one or more email addresses.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”. Allows sending multiple recipients (maximum 5) separated by a comma character ','
|-
|correo
|Email to which the document will be sent. Example name@company.com
|-
|adjuntos
|
: “0”: Resends the mail without attachments
: “1”: Forwards the mail with the attachments stored during the issuance of the document.
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|rowspan="2"|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Send''' method) the '''attachments''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform does not will generate standard graphical representation (PDF), therefore only the documents hosted on the platform (AttachedDocument) will be forwarded to the recipients. To forward the mail (with the AttachedDocument and attachments) to an email address different from the one used during the transmission, the '''CargarAtjuntos''' method of the SOAP Web Attachments Service can be used again.
{{clear}}
===DescargaPDF Method===
Allows you to download the standard graphic representation (PDF generated by TFHKA) of the document for local storage, local consultation or reprint purposes.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted.
|-
|String
|documento
|Base64 encoded PDF document
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Enviar''' method) the '''adjuntos''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform will not will generate standard graphic representation (PDF), therefore this method cannot be used since the service will throw an error indicating that there is NO associated PDF, since it is assumed that the graphic representation has been generated locally by the billing software (ERP).
{{clear}}
=== DescargaXML Method===
It allows the download of the XML document (only the electronic document Invoice, CreditNote and DebitNote), in case it is required to validate the information such as the signature or its authenticity or for the purpose of local management and storage.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted
|-
|String
|documento
|XML document (Invoice, CreditNote or DebitNote) encoded in Base64
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===FoliosRestantes Method===
Allows you to consult the stamps (transactions) available. The stamps are consumed in proportion to the transactions made.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE:Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|int
|foliosRestantes
|Number of sheets available
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===CargarCertificado Method===
For now, this method will only be used internally by The Factory HKA Colombia.
{{clear}}
===DescargarEventoXML Method===
It allows downloading an event or occurrence (ApplicationResponse) related to an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
;RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|Documento
|XML document (ApplicationResponse) encoded in Base64
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===GenerarContenedor Method===
UA container is a type of AttachedDocument document, its structure is intended to contain and transmit an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) generated to date in a single XML file.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Contenedor
|XML document (AttachedDocument) encoded in Base64
|-
|String
|Fecha
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===GenerarEvento Method===
Allows the generation of an event or occurrence (ApplicationResponse) associated with an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Object with the data of the event (ApplicationResponse) to generate
|}
Where Class.DatosEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoEvento
|Indicates the code of the event (to define catalog)
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Comentario
|Comment or description of the event
|-
|String
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Additional event information
|}
Where Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Nombre Código
|of the field
|-
|String
|valor
|Additional Information
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|consecutivoDocumentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|XML document (ApplicationResponse) encoded in Base64
|}
{{clear}}

Web Soap Broadcast Service Methods - Direct Integration Manual Index

2022-03-01T13:53:12Z

Lvargas: Página creada con «<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly> The parameters to be incorporated in the methods of this Web Service must com…»

<includeonly>=</includeonly>==Web Soap Broadcast Service Methods==<includeonly>=</includeonly>
The parameters to be incorporated in the methods of this Web Service must comply with the format and the corresponding directives according to the following rules:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Format
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| A || Alphabetic character
|-
| N || Numeric character
|-
| AN || AlphaNumeric character
|-
| <nowiki> A|3 </nowiki> || 3 Alphabetic characters (fixed length)
|-
| <nowiki> N|3 </nowiki> || 3 Numeric characters (fixed length)
|-
| <nowiki> AN|3 </nowiki> || 3 alphaNumeric characters (fixed length)
|-
| <nowiki> A|..3 </nowiki> || Up to 3 Alphabetic characters (variable length)
|-
| <nowiki> N|..3 </nowiki> || Up to 3 Numeric characters (variable length)
|-
| <nowiki> AN|..3 </nowiki> || Up to 3 alphaNumeric characters (variable length)
|-
| <nowiki> N|2..6 </nowiki> || Between 2 and 6 Numeric characters (variable length)
|-
| INT32 || Whole. (Maximum Value: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Mandatory
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| YES || If it is mandatory for the DIAN
|-
| NOT || It is not mandatory for the DIAN
|-
| C/C || It is required where applicable (or under certain conditions by the client's business model)
|}
{{clear}}

===Enviar Method===
The function in charge of building and sending the electronic documents to the technology provider.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Guy
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Provided by technology provider
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|See the detail of the Invoice Object below
|-
|String
|adjuntos
|
Possible values:
: “0” Attachments are not allowed. XML and standard graphic representation is generated by The Factory HKA
: “1” Supports attachments. XML and standard graphic representation is generated by The Factory HKA
: “10” Attachments are not allowed. Only XML is generated without standard Graphic representation by The Factory HKA
: “11” Supports attachments. Only XML is generated without standard graphical representation by The Factory HKA
|}

'''@IMPORTANT:''' If the value “1” or “11” is sent in the '''attachments''' parameter, no email will be sent until the method is consumed '''CargarAdjuntos''' (ServicE Adjuntos Web SOAP). For documents that accept attachments, the field'''Destinatario.email''' of the client is required and the '''notify''' field must be set to “YES”.

<pre style="color: red">WARNING: If options '10' or '11' are used in the attachments parameter, our platform will not generate standard graphic representation (PDF), therefore PDF is not hosted on it and the graphic representation cannot be viewed from the platform. web portal, in the notification email to the acquirer (view document section), nor download through the DescargaPDF method of the SOAP Web Broadcast Service or forward the graphical representation through the EnvioCorreo method, since it is being assumed that it has been generated locally by the billing software (ERP).</pre>

Next, the diagram of the '''invoice object for the billing model with prior validation''' is exposed, where the changes in its structure can be seen with respect to the object used in the model with post validation :

* In Blue new classes/attributes that were not present in the post validation model.
* In Yellow existing classes/attributes in the post-validation model that underwent changes in pre-validation.
* In Orange existing classes/attributes in post-validation model that are deprecated (removed) in pre-validation.
 

The invoice object for the billing model with prior validation is described in greater detail below:
 

<center>'''Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagram Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Cliente]]
 
'''Diagram Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagram Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagram Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagram Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagram Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagram Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagram Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagram Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagram Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}
====Class.FacturaGeneral====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|anticipos
|Array <Anticipos>
| -
|NOT
|
: Information related to advances
: '''PATH''': /root/cac:PrepaidPayment
: (see detail in [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NOT
|
: Information of the person authorized to download documents
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver see detail in [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|YES
|
: The number of decimals to be used is sent (minimum 0, maximum 6)
: Rejection If more decimals are received in the amounts than those indicated in this field
: '''PATH''': Does not apply
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NOT
|
: Information related to a charge or a discount on an invoice scale that does not affect the tax base
: '''PATH''': /root/cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|cliente
|Cliente
| -
|YES
|
: Acquirer Information
: '''PATH''':/root/cac:AccountingCustomerParty
: (see detail in [[#Class.Cliente|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NOT
|
: Information related to the payment condition
: '''PATH''': /root/cac:PaymentTerms
: (see detail in [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..20
|YES
|
: Correlative/consecutive of the electronic document
: prefix concatenation (<nowiki>AN|..4</nowiki>) + the consecutive DIAN,
: according to the configuration in the web portal:
:: Manual with prefix: prefix required (No hyphen). Example: “PREF2147483647”
:: Manual without prefix: prefix not required. Example: “2147483647”
: Rejection Additional characters such as spaces or hyphens are not allowed
: Rejection Consecutive number must be equal to or greater than the initial value of the numbering range granted by the DIAN
: Rejection Consecutive number must be equal to or less than the final value of the numbering range granted by the DIAN
: '''PATH''': /root/cbc:ID
|-
|detalleDeFactura
|Array <FacturaDetalle>
| -
|YES
|
: Details or product information
: '''PATH''': /root/cac:InvoiceLine
: (see detail in [[#Class.FacturaDetalle|Class.FacturaDetalle]])
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|C/C
|
: Information describing a referenced document
: '''Required''' on tipoDocumento invoices contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse and BillingReference)
: '''PATH''': /root/cac:DiscrepancyResponse,
:: /root/cac:BillingReference,
:: /root/cac: AdditionalDocumentReference,
:: /root/cac: DespatchDocumentReference,
:: /root/cac: ReceiptDocumentReference
:(see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NOT
|
: Delivery information (Delivery) of goods
: '''PATH''': /root/cac:Delivery
: (see detail in [[#Class.Entrega|Class.Entrega]])
|-
|extras
|Array <Extras>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|YES
|
: Date and time of issuance of the document, in format: YYYY-MM-DD HH:MM:SS
: Notification If the issue date is earlier than five (5) days from the calendar date
: Rejection If the issue date is later than ten calendar days
: '''PATH''': /root/cbc:IssueDate, root/cbc:IssueTime
|-
|fechaFinPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Date/Time of the end of the billing period (Interval of dates to which the bill refers, for example in public services), in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
|-
|fechaInicioPeriodoFacturacion
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Billing period start date/time, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''':
: /root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
|-
|fechaPagoImpuestos
|String
| <nowiki>AN|19</nowiki>
|NOT
|
: Tax payment date, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Due date of the invoice, in format: YYYY-MM-DD
: '''PATH''': /root/cbc:DueDate
|-
|impuestosGenerales
|Array <FacturaImpuestos>
| -
|YES
|
: General or global tax information
: Rejection If the taxes/withholdings reported in this arrangement do not correspond to what is reported in the details
: '''PATH''': /root/cac:TaxTotal (impuestos),
: /root/cac: WithholdingTaxTotal (retenciones),
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of general taxes/withholdings by type of impuesto/retención
: Rejection If the total value of the tax/withholding indicated is different from the sum of those reported in the impuestosGenrales arrangement
: '''PATH''': /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
: /root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NOT
|
: Additional information or free text related to the document
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|YES
|
: Information related to the payment of the invoice
: '''PATH''': /root/cac:PaymentMeans
: (see detail in [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|YES
|
: Currency or currency of the document
: Use ISO 4217 codes (Example Colombian Pesos “COP”)
: Rejection If the value does not correspond to one of the ISO 4217 codes
: '''PATH''': /root/cbc:DocumentCurrencyCode
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NOT
|
: Information related to the purchase order
: '''PATH''': /root/cac:OrderReference
: (see detail in [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|YES
|
: Consecutive from which the series begins for the document to be issued, the prefix (with hyphen) must always be placed regardless of the sequential mode.
: Example: 'PREF-1123456'
: '''PATH''':
: /root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
: sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
|-
|redondeoAplicado
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Rounding applied to arrive at totalMonto
: Rejection If rounding is greater than the greater value between 500 pesos or 0.1% of the total value of the invoice
: '''PATH''': /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Information related to emissions from the Health Sector'''Required: When typeSector = '2'''' is informed
: (see detail in [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|TasaDeCambio
| -
|C/C
|
: Information related to the exchange rate of foreign currency to Colombian peso (COP)
: '''Required''' If documenttype is export/international or if the base currency is different from “COP”
: '''PATH''': /root/cac:PaymentExchangeRate
: (see detail in [[#Class.TasaDeCambio|Class.TasaDeCambio]])
|-
|tasaDeCambioAlternativa
|TasaDeCambioAlternativa
| -
|NOT
|
: Information used as an alternative method to report conversions to other currencies
: '''PATH''': /root/cac:PaymentAlternativeExchangeRate
: (see detail in [[#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]])
|-
|terminosEntrega
|TerminosEntrega
| -
|C/C
|
: Information related to the delivery
: '''Required''' If documenttype is export/international
: '''PATH''': /root/cac:DeliveryTerms
: (see detail in [[#Class.TerminosEntrega|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|YES
|
: Document type
: '''PATH''': Invoice, CreditNote, DebitNote
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|YES
|
: To issue documents from the Health Sector, indicate code '2' in this field
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|YES
|
: Operation type indicator
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Sum of all advance payments
: Rejection Si totalAnticipos does not correspond to the sum of the Anticipos.montoPagado attributes in the advances array
: '''PATH''': /root/LegalMonetaryTotal/cbc:PrepaidAmount
|-
|totalBaseImponible
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Taxable Base Value: Sum of Taxable Bases for the calculation of taxes at the invoice level
: Rejection If totalBaseImponible is not equal to the sum of occurrences FacturaImpuestos.baseImponibleTOTALImp
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
|-
|totalBrutoConImpuesto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total gross value with taxes
: Rejection If totalGrossWithTax is not equal to the sum: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
: '''PATH''': /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
|-
|totalCargosAplicados
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Charge: Sum of all charges applied at the invoice level
: Rejection If totalCargosAplicados does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “true”
: '''PATH''': /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
|-
|totalDescuentos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NOT
|
: Total Discount: Sum of all the discounts applied at the invoice level
: Rejection If totalDescuentos does not correspond to the sum of occurrences CargosDescuentos.monto when CargosDescuentos.indicador is “false”
: '''PATH''': /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
|-
|totalMonto
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value to pay of the document: Total value of items (including charges and discounts at item level) + value of taxes + value of charges – value of discounts – value of advances
: Rejection If totalMonto is not consistent with the total value of items + value of taxes + value of charges – value of discounts – value of advances + rounding appliedno es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
: '''PATH''': /root/LegalMonetaryTotal/cbc:PayableAmount
|-
|totalProductos
|String
| <nowiki>AN|..5</nowiki>
|YES
|
: Number or quantity of product lines (rows) present in the document
: Rejection If the value of totalProductos is different from the number of occurrences of rans in the detalleDeFactura array
: '''PATH''': /root/cbc:LineCountNumeric
|-
|totalSinImpuestos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total Gross Value before taxes: Sum of the gross values of the invoice lines
: Rejection If totalSinImpuestos does not correspond to the sum of the attributes precioTotalSinImpuestos in the detalleDeFactura array
: '''PATH''': /root/LegalMonetaryTotal/cbc:LineExtensionAmount
|}

====Class.Anticipos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|YES
|
: Date on which the payment was received, in format: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NOT
|
: Date on which the payment was made, in format: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NOT
|
: Time in which the payment was made, in format:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|YES
|
: Internal identification of the payment
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|YES
|
: Payment Instructions
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|YES
|
: Value of the advance payment, it cannot be higher than the total value of the invoice
: Notification If montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}
====Class.Autorizado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|direccion
|Direccion
| -
|NOT
|
: Direction
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Correo Electrónico
: '''PATH''': ../cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Tradename
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Identification number
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Check digit
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Business name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Telephone
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|YES
|
: ID Type
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: See list of possible values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Code to categorize the discount
: '''Mandatory''': If it is a discount at invoice level (general)
: Rejection If it is a discount and some of the values are not reported in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
: '''PATH''': …/cbc:AllowanceChargeReasonCode
|-
|descripcion
|String
|<nowiki>AN|10..5000</nowiki>
|YES
|
: Free text to inform the reason for the discount
: '''PATH''': …/cbc:AllowanceChargeReason
: Notification : If a charge or discount is reported and this item is not reported
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indicator of whether it is Charge "1" or Discount "0"
: Rejection : If this item contains information other than “1” or “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the charge or discount, if it is a discount, it cannot be higher than the base value
: Rejection : If it is Discount and monto > montoBase
: '''PATH''': …/cbc:Amount
|-
|montoBase
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Base Value to calculate the discount or charge,
: Rejection: If the montoBase is negative, if it is a discount it cannot be greater than the total value of the invoice
: Rejection: If montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Discount percentage
: Rejection If this element > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|YES
|
: Sequence order indicator
: '''PATH''': …/cbc:ID
|}
====Class.Cliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|actividadEconomicaCIIU
|String
|<nowiki>AN|…4</nowiki>
|NOT
|
: Corresponds to the economic activity code CIIU
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
|-
|apellido
|String
|<nowiki>AN|…50</nowiki>
|NOT
|
: Last name of the acquirer.
: '''PATH''': No definido
|-
|destinatario
|Array <Destinatario>
| -
|C/C
|
: It allows specifying the means and data of the electronic delivery of the document
: '''Required''': If notify field = 'YES'
: '''PATH''': Not defined
: (see detail in [[#Class.Destinatario|Class.Destinatario]])
|-
|detallesTributarios
|Array <Tributos>
| -
|YES
|
:Tax details of the acquirer
: Rejection If the class is not informed
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|Direccion
| -
|C/C
|
: Information detailing the receiving address of the acquirer
: '''Recommended''': This ransf address is the one that is painted in the standard graphical representation
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionFiscal
|Direccion
| -
|C/C
|
:Tax address of the acquirer.
: '''Mandatory''': If the purchaser is responsible
: Notification If the acquirer is responsible and this class was not informed
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|C/C
|
: E-mail of the acquirer that will go to the fiscal XML/UBL
: (only one email is sent in this field)
: '''PATH''': Does not apply node
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|informacionLegalCliente
|InformacionLegalCliente
| -
|C/C
|
: Legal information of the client
: Notification : If tipoPersona = '1' is reported and the attribute is not reported
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
: (see detail in [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
|-
|nombreComercial
|String
|<nowiki>AN|5..450</nowiki>
|C/C
|
: Commercial name of the acquirer
: '''Obligatory''' If the commercial name will be shown in the Graphic Rep.
: '''PATH''': /cac:Party/cac:PartyName
|-
|nombreContacto
|String
|<nowiki>AN|5..450</nowiki>
|NOT
|
: Contact name
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
|-
|nombreRazonSocial
|String
|<nowiki>AN|5..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''Recommended''': If the person is natural, concatenate in this field the full name (names + surnames)
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
|-
|nota
|String
|<nowiki>AN|..450</nowiki>
|NOT
|
: Additional contact note
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
|-
|notificar
|String
|<nowiki>AN|2</nowiki>
|YES
|
: Activates the sending of email to the acquirer.
: Possible values: “YES” or “NO”
: '''PATH''': Does not apply
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Number of the Document or Fiscal Identification of the purchaser
: '''Mandatory''' If the acquirer is responsible, he must inform the NIT
: Rejection If tipoIdentificacion is '31' and the NIT structure is invalid
: Rejection : It is generated if the value of AdditionalAccountID = “2” and it is not mentioned.
: Note : To identify the final consumer, the following document “222222222222” is used
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>AN|..2</nowiki>
|C/C
|
: NIT verification digit of the acquirer
: '''Required''': If TipoIndentificacion = 31, it must be informed
: '''PATH''':
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|YES
|
: Obligations and regime of the acquirer
: Rejection If the class is not informed
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|segundoNombre
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Second name of the acquirer.
: '''PATH''': Not defined
|-
|telefax
|String
|<nowiki>N|..20</nowiki>
|NOT
|
: Facsimile
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NOT
|
: Purchaser's phone
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Acquirer ID Type
: ReRejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: Note: To identify the final consumer, the code “13” is used.
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|tipoPersona
|String
|<nowiki>N|1</nowiki>
|YES
|
: Person type identifier
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
: '''PATH''': …/cbc:AdditionalAccountID
|}
====Class.CondicionPago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEvento
|String
| <nowiki>AN|..3</nowiki>
|NOT
|
: Event Code
: '''PATH''': ../cbc:ReferenceEventCode
|-
|comentario
|String
|<nowiki>AN|..50</nowiki>
|NOT
|
: Note
: '''PATH''': ../cbc:Note
|-
|duracionPeriodo
|String
|<nowiki>AN|..2</nowiki>
|NOT
|
: Period Length
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
|-
|duracionPeriodoMedida
|String
|<nowiki>AN|..10</nowiki>
|NOT
|
: Period length unit of measure
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
|-
|extras
|Array <Extensible>
| -
|NOT
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
|-
|fechaVencimiento
|String
|<nowiki>AN|..10</nowiki>
|YES
|
: Due date
: '''PATH''': ../cbc:PaymentDueDate
|-
|identificador
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Payment conditions
: '''PATH''': ../cbc:ID
|-
|medioPagoAsociado
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Associated payment method
: '''PATH''': ../cbc:PaymentMeansID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
|YES
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|montoMulta
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Amount of the fine
: '''PATH''': ../cbc:PenaltySurchargePercent
|-
|montoPenalidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Penalty Amount
: '''PATH''': ../cbc:PenaltyAmount
|-
|periodoDesde
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period from
: '''PATH''': ../cbc:StartDate
|-
|periodoHasta
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: period until
: '''PATH''': ../cbc:EndDate
|-
|porcentajeDescuento
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|NO
|
: Discount rate
: '''PATH''': ../cbc:SettlementDiscountPercent
|-
|porcentajePago
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|YES
|
: Payment Percentage
: '''PATH''': . /cbc:PaymentPercent
|-
|referenciaAnticipo
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Advance reference number
: '''PATH''': ../cac:PrepaidPaymentReferenceID
|}
====Class.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Unit quantity of this item per package.
: For example, if the item consists of three “six packs”, the quantity to be reported in QuantityPerPackage is 6, while the quantity to be reported in QuantityActual is 3, and the total number of cans being described is 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Real amount on which the price applies
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|YES
|
: Unit of the quantity on which the price applies
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': .. /cac:Price/cbc:BaseQuantity/@unitCode
|-
|cantidadUnidades
|String
|<nowiki>N|..6</nowiki>
|YES
|
: Number of units of the product/service billed
: '''PATH''': .. /cbc:InvoicedQuantity
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|C/C
|
: Information on charges and discounts
: '''Mandatory''' This arrangement must be reported at the item level, if and only if the charge or discount affects the item's tax base.
: If a general individual charge to the invoice generates VAT, it must be reported as an item
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoFabricante
|String
| -
|NO
|
: Manufacturer code corresponding to the item
: '''PATH''': .. /cac:Item/cac:
: ManufacturersItemIdentification/cbc:ID
|-
|codigoIdentificadorPais
|String
|<nowiki>A|2</nowiki>
|NO
|
: Identifier code of the country of origin of the item or service
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
|-
|codigoProducto
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Vendor code corresponding to the item
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
|-
|codigoTipoPrecio
|String
|<nowiki>AN|..3</nowiki>
|C/C
|
: Reported price type code
: '''Required''' For commercial samples (value = 01)
: Rejection If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
|-
|descripcion
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|YES
|
: Description of the product or service
: '''PATH''': ../Item/cbc:Description[3]
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Technical data associated with the product or service
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Information describing a referenced document
: '''Required''' In invoices tipoDocumento Contingency (AdditionalDocumentReference), in invoices that affect a note (BillingReference), in Credit and Debit Notes (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (see detail in [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Standard code (item or service identification according to a standard)
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: Notification If it is an export invoice (tipoDocumento = 02), and the tariff subheading was not reported
: Notification If the code does not exist in a closed standard.
: Example: UNSPSC
: Notification If the code does not follow the rule of formation of an open code, but with verifiable values
: Example: GTIN, Example: Tariff headings
: '''Note''': In this case the code 999 (Taxpayer adoption standard) can be used to avoid reclassifying the products
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
|-
|estandarCodigoID
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: Rejection If standardCodigo = 010 and estandarCodigoID is different from 9
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
|-
|estandarCodigoIdentificador
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
|-
|estandarCodigoNombre
|String
|AN
|NO
|
: Associated with the standard code (item or service identification according to a standard).
: See attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
|-
|estandarCodigoProducto
|String
|AN
|NO
|
: Product code according to the standard informed in estandarCodigo
: View attribute values in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|NO
|
: organization standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub code of the product standard
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': No definido
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|YES
|
: tax information
: Rejection If there is more than one element with the same value in the attribute FacturaImpuestos.codigoTOTALImp
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Additionally, it should NOT be informed for invoices of the simple group I regime, nor for items whose concept in AIU contracts is not part of the tax base.
: At the item level, it only applies to taxes that must be reported at the item level, for example: VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal (impuestos),
: ../cac: WithholdingTaxTotal (retenciones)
: (see detail in [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
|-
|impuestosTotales
|Array <ImpuestosTotales>
| -
|YES
|
: Sum of taxes for all types
: This group should NOT be reported for excluded items according to the provisions of the Tax Statute.
: Rejection If the value of the total value of the indicated tax is different from the sum of what is reported in FacturaImpuestos. valorTOTALImp.
: At the item level, it only applies to taxes that must be reported at the item level, for example, VAT, INC, IC, National Tax on Fuels, among others.
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
: (see detail in [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <LineaInformacionAdicional>
| -
|NO
|
: It serves to add specific product information that may be requested by authorities or entities other than the DIAN
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
: (see detail in [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
|-
|mandatorioNumeroIdentificacion
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the agent
: '''Obligatorio''' para facturas por mandato
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
|-
|mandatorioNumeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Verifier Digit of the agent's NIT
: '''Required''' for mandated invoices
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
|-
|mandatorioTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|C/C
|
: Agent identification type
: '''Required''' For mandated invoices
: Notification If mandatorioNumeroIdentificacion is informed and the value of this field is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
|-
|marca
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item brand.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:BrandName
|-
|modelo
|String
|<nowiki>AN|..100</nowiki>
|C/C
|
: Item model.
: '''Required''' If it is an international invoice
: Notification If tipoDocumento = “02” and this item was not reported
: '''PATH''': ../Item/cbc:ModelName
|-
|muestraGratis
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Indicator of whether the item is free or not (no commercial value)
: '''Required''' For commercial samples
: Possible values: “1” (It is a free sample) or “0” (It is not a free sample)
: '''PATH''': ../cbc:FreeOfChargeIndicator
|-
|nombreFabricante
|String
|<nowiki>AN|..100</nowiki>
|NO
|
: Name of the manufacturer of the product/service
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|nota
|String
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Free text to add additional information to the article
: '''Mandatory''' Inform in the case of invoices for AIU-type service contracts. For the Administration item. In this case, the note must begin with the text: "AIU services contract for:" The taxpayer must include the object of the invoiced contract
: '''PATH''': ../cbc:Note
|-
|precioReferencia
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Value of the item or service.
: Corresponds to the value of the reference price of the item that is given as a sample or gift without commercial value
: '''Required''' For commercial samples
: Rejection If the precioReferencua attribute is reported, then the value of TotalPriceWithoutTaxes must be (0.00), since it is a commercial sample or gift
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
|-
|precioTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
: Total price of the product or service.
: (quantityUnits*UnitSalePrice +charges-discounts +taxes)
: '''Required''' For use in graphical representations
: '''PATH''': Undefined
|-
|precioTotalSinImpuestos
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Total value of the line without taxes.
: (QuantityUnits*UnitSalePrice +charges-discounts)
: Rejection If the TotalPriceWithoutTaxes attribute is reported as 0.00, then the ReferencePrice value must be reported since it is a commercial sample or gift
: '''PATH''': ../cbc:LineExtensionAmount
|-
|precioVentaUnitario
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Unit price of the product/service
: '''PATH''': ../Price/cbc:PriceAmount
|-
|secuencia
|String
|<nowiki>AN|..4</nowiki>
|YES
|
: Sequence order indicator (line number)
: Notification If it contains a value already used in the sequence attribute in another group of this file
: Notification If the numbers used in the different groups are not consecutive, starting at "1"
: '''PATH''': ../cbc:ID
|-
|seriales
|String
|<nowiki>AN|..500</nowiki>
|NO
|
: Product serials (comma separator), Ex: ABC123,ABC456
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
|-
|subCodigoFabricante
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Manufacturer code corresponding to a sub-specification of the article
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
|-
|subCodigoProducto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Issuer/seller code corresponding to a sub-specification of the item
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
|-
|tipoAIU
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: To classify the type of AIU
: '''PATH''': No aplica
|-
|unidadMedida
|String
|<nowiki>AN|..3</nowiki>
|YES
|
: Unit of measure code of the invoiced product/service
: Notification If the attribute value is not found in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: (You can use the standard code "WSD", unit "94" or Mutual Agreement "ZZ" to NOT reclassify the products)
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
|}

====Class.Destinatario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|canalDeEntrega
|String
| -
|YES
|
: Electronic Document Delivery Means
: It can take the following values: 0– Email; 1– Reception; 2– Interoperability; 3- Whatsapp; 4- Telegram
: PATH: Does not apply
|-
|email
|Array <String>
| -
|C/C
|
: List of Emails to which the electronic document will be delivered if the DeliveryChannel='0'
: '''Required''' When deliveryChannel=’0’
: '''PATH''': Does not apply
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: scheduled date
: '''PATH''': Does not apply
|-
|mensajeProgramado
|String
| -
|NO
|
: Message
: '''PATH''': Does not apply
|-
|nitProveedorReceptor
|String
|<nowiki>N|..12</nowiki>
|C/C
|
: NIT of the Recipient
: '''Required''' When deliveryChannel='1' or '2'
: '''PATH''': Does not apply
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Recipient Telephone
: '''Required''' When deliveryChannel='3' or '4'
: '''PATH''': Does not apply
|}
====Class.DocumentoReferenciado====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Required''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the ReferencedDocument information is going to be sent, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the transfer invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note.
: You can only report electronic invoices from the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Ransfe date of the referenced document, in format: YYYY-MM-DD
: '''Mandatory''' When InternalCode is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': No definido
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Not defined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|YES
|
: Concatenation of the prefix and the referenced document number
: Rejection If codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference/cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document,
: Example: "National Sales Invoice"
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type.
: '''Required''' When InternalCode is '1'
: RejectionIf codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Note''': For remission orders, inform the code ‘AAJ’
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
|}
'''@IMPORTANT:'''
''# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentsReferenced must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; internalCode = '4', documentNumber, transfer.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Contingency Invoice''', an array of the ReferenceDocuments type must be sent, indicating the fields: internal code = '1', numberDocument, date, typeDocumentCode (corresponding to Contingency Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Carrier Data
: '''PATH''': ../cac:DeliveryParty
: (see detail in [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Dispatch Information
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Delivery information
: '''PATH''': ../cac:DeliveryAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Effective date and time of departure of the goods, in format: YYYY-MM-DD HH:MM:SS
: Rejection if the effective date of departure is before the date of issue
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
|-
|fechaEstimada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Estimated date and time, in format: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha estimada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
|-
|fechaReal
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha real es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
|-
|fechaSolicitada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
: Rejection si la fecha solicitada es anterior a la fecha de emisión
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
|-
|identificacionTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Datos del Transporte
: '''PATH''': ../cac:Despatch/cbc:ID
|-
|matriculaTransporte
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Matricula del Transporte
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
|}
====Class.Extras====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributte
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Etiqueta asignada para la Representación Impresa PDF.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|SI
|
: Código del campo extensible a referenciar
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
: '''PATH''': Variable
|-
|pdf
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicación de mostrar el campo en la representación gráfica PDF
: (“0” = No mostrar / “1” = Mostrar)
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|-
|xml
|String
|<nowiki>N|1</nowiki>
|YES
|
: Indication to display the field in the XML
: (“0” = Don't show / “1” = Show)
: '''PATH''': Variable
|}
====Class.Extensible====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|controlInterno1
|String
|<nowiki>AN|100</nowiki>
|C/C
|
: Assigned Label for PDF Printed Representation.
: '''PATH''': Variable
|-
|controlInterno2
|String
|Depende del Campo
|C/C
|
: Allows two or more fields to be associated using an index (if the fields are associable)
: '''PATH''': Variable
|-
|nombre
|String
|Depende del Campo
|YES
|
: Code of the extensible field to reference
: '''PATH''': Variable
|-
|valor
|String
|Depende del Campo
|YES
|
: Value of the field to add
: '''PATH''': Variable
|}
====Class.FacturaImpuestos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseImponibleTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tax base on which the value of the tax is calculated
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID
|-
|controlInterno
|String
|<nowiki>N|1</nowiki>
|C/C
|
: Retention type indicator
: '''PATH''': Not Defined
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|porcentajeTOTALImp
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2*</nowiki>
|YES
|
: Tribute rate.
: In the event that the tax is a percentage of the taxable value: inform the "percentage" rate to be applied to the tax base
: Rejection If you report a different rate for one of the taxes listed in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
|-
|unidadMedida
|String
|<nowiki>AN|..5</nowiki>
|YES
|
: Identification of the unit of measure
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
|-
|unidadMedidaTributo
|String
|Ent: <nowiki>N|..2</nowiki>
Dec: <nowiki>N|2</nowiki>
|C/C
|
: Base unit of measure for the tribute
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection If valorTributoUnidad element is informed and UnidadMedidaTributo is not informed
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
|-
|valorTOTALImp
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Tribute value. Product of the percentage applied to the tax base
: Rejection For taxes whose rate is stated in percentages, if valorTOTALImp is different from baseImponibleTOTALImp * percentageTOTALImp
: Rejection For taxes whose rate is stated in nominal values (for example, plastic bags), if valorTOTALImp is different from valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|valorTributoUnidad
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|C/C
|
:It is the nominal value of the tax per unit
: '''Mandatory''' In the event that the tax is a fixed value per taxed unit, for example the consumption tax on bags or fuel taxes
: Rejection if the unitMedidaTributo element is NOT informed.
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
|}
'''@IMPORTANT''': In the case of the ICA and RETEICA in which the value of the percentage is based on a thousand, the value of said percentage must be reported based on a hundred, that is, if you want to report a percentage of 11.04% thousand for any of these taxes, it must be indicated in the TOTALImp percentage field as 1,104.
====Class.ImpuestosTotales====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoTOTALImp
|String
|<nowiki>AN|2</nowiki>
|YES
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': Por Definir
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|montoTotal
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Sum of all attributes valorTOTALImp
: Rejection If montoTotal is different from the sum of all occurrences ofFacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}
====Class.MediosDePago====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoBanco
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Code of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
|-
|codigoCanalPago
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Payment channel code
: '''PATH''': ../cbc:PaymentChannelCode
|-
|codigoReferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Optional not used for now
: '''PATH''': No definido
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeVencimiento
|String
|<nowiki>AN|19</nowiki>
|C/C
|
: Due date of payment of the invoice in format: YYYY-MM-DD
: '''Mandatory''' If the sale is on credit
: Rejection: If the payment method code is "2" and the expiration date is not sent
: '''PATH''': ../cbc:PaymentDueDate
|-
|medioPago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Code corresponding to the means of payment
: Rejection:If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
: '''PATH''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|YES
|
: Payment method
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
: '''PATH''': ../cbc:ID
|-
|nombreBanco
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Bank or Financial Entity
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
|-
|numeroDeReferencia
|String
|<nowiki>AN|..200</nowiki>
|NO
|
: Identifier or internal reference of the Payment
: PATH''':''' ../cbc:PaymentID
|-
|numeroDias
|String
|<nowiki>N|..3</nowiki>
|NO
|
: Number of days for payment
: '''PATH''': ../cbc:InstructionNote
|-
|numeroTransferencia
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Transfer number or check number
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
|}
====Class.OrdenDeCompra====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoCliente
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: customer code
: '''PATH''': ../cbc:CustomerReference
|-
|documentoReferencia
|DocumentoReferencia
| -
|NO
|
: Document Reference
: '''PATH''': ../cac:DocumentReference
: (see detail in [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Date of the Order, in format: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|YES
|
: Purchase Order Number
: '''Required''' To send the Purchase Order
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Order Number
: '''Required''' To send the Order
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: CUFE type identifier
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Order type
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID of some referenced document
: '''PATH''': ../cbc:UUID
|}
'''NOTE:''' As it is a delivery order, the OrdemDeCompra class must be informed, if it is necessary to indicate more than one order, it must be informed through the DocumentReferenced class with '''codigoInterno''' ='1 ', this in order to send the information referring to them in the AdditionalDocumentReference group.

====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
'''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TasaDeCambioAlternativa====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|baseMonedaDestino
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Monetary basis for conversion.
: Must be 1.00
: Rejection If it brings a value other than 1.00
: '''PATH''': ../cbc:TargetCurrencyBaseRate
|-
|baseMonedaOrigen
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Monetary base of the foreign currency for exchange.
: Must be 1.00
: Rejection If brings value other than 1.00
: '''PATH''': ../cbc:SourceCurrencyBaseRate
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fechaDeTasaDeCambio
|String
|<nowiki>AN|10</nowiki>
|YES
|
: Date on which the exchange rate was fixed, in format: YYYY-MM-DD
: '''PATH''': ../cbc:Date
|-
|indicadorDeTasa
|String
| -
|NO
|
: Exchange Rate Indicator
: '''PATH''': ../cbc:ExchangeMarketID
|-
|monedaDestino
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Destination currency code of the document.
: Rejection If the content of this element is not 'COP'
: '''PATH''': ../cbc:TargetCurrencyCode
|-
|monedaOrigen
|String
|<nowiki>AN|3</nowiki>
|YES
|
: Document Base Currency Code
: Rejection If the content of this element does not correspond to the ISO-4217 standard
: '''PATH''': ../cbc:SourceCurrencyCode
|-
|operadorCalculo
|String
| -
|NO
|
: Calculation Operator
: '''PATH''': ../cbc: MathematicOperatorCode
|-
|tasaDeCambio
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|YES
|
: Value of the exchange rate between currencies. It must be filled out with the value of the exchange rate.
: For example, for USD-COP, it can be the value of the TRM or rate agreed between the parties (Reported value * Exchange rate value = Reported value in currency reported in destination currency)
: '''PATH''': ../cbc:CalculationRate
|}
====Class.TerminosEntrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cargosDescuentos
|Array <CargosDescuentos>
| -
|NO
|
: Information related to a charge or a discount
: '''PATH''': ../cac:AllowanceCharge
: (see detail in [[#Class.CargosDescuentos|Class.CargosDescuentos]])
|-
|codigoCondicionEntrega
|String
|<nowiki>AN|3</nowiki>
|C/C
|
: Delivery Conditions Code
: '''Obligatorio''' Se es factura de exportación/internacional
: Rejection: If the value of this attribute does not correspond to a value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
: '''PATH''': ../cbc:LossRiskResponsibilityCode
|-
|costoTransporte
|String
|Por Definir
|NO
|
: Transport payment method: It is used to indicate how transport costs are paid, for example: http://www.unece.org/
: '''PATH''': ../cbc: SpecialTerms
|-
|direccionEntrega
|Class.Direccion
| -
|NO
|
: Information detailing the delivery address
: '''PATH''': ../cac:DeliveryLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Undefined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|identificacion
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Identification number
: '''PATH''': ../cbc:ID
|-
|monto
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|NO
|
: Amount
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of who assumes responsibility in case the merchandise is lost
: '''PATH''': ../cbc:LossRisk
|}
====Class.Direccion====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|aCuidadoDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Care of
: '''PATH''': ../cac:Address/cbc:MarkCare
|-
|aLaAtenciónDe
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: For the attention of
: '''PATH''': ../cac:Address/cbc:MarkAttention
|-
|bloque
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: block name
: '''PATH''': ../cac:Address/cbc:BlockName
|-
|buzon
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Buzón postal
: '''PATH''': ../cac:Address/cbc:Postbox
|-
|calle
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the street
: '''PATH''': ../cac:Address/cbc:StreetName
|-
|calleAdicional
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Additional Name to better specify the street name
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
|-
|ciudad
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: Ciudad
: Rejection If country is "CO" and the content of this attribute does not correspond to one of the values in the 'Name' column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
: '''PATH''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|String
|<nowiki>AN|…5</nowiki>
|YES
|
: department code
: If country is "CO", CodigoDepartamento must correspond to one of the values in the Code column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''Mandatory''' for Responsible Issuers and Acquirers
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
|-
|correccionHusoHorario
|String
|<nowiki>AN|6</nowiki>
|NO
|
: Corresponding time zone correction
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
|-
|departamento
|String
|<nowiki>AN|…50</nowiki>
|YES
|
: department name
: Rejection if the code of the country field is "CO" and the content of this attribute does not correspond to one of the values of the Name column of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
: '''PATH''': ../cac:Address/cbc:CountrySubentity
|-
|departamentoOrg
|String
|<nowiki>AN|..50</nowiki>
|NO
|
:An addressable department of an organization
: '''PATH''': ../cac:Address/cbc:Department
|-
|direccion
|String
|<nowiki>AN|…100</nowiki>
|YES
|
: Client's address, without indicating city or department
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
|-
|distrito
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: District
: '''PATH''': /cac:Address/cbc:District
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Bedroom
: '''PATH''': ../cac:Address/cbc:Room
|-
|lenguaje
|String
|<nowiki>A|2</nowiki> ISO 639-1
|YES
|
: Identifier of the language used in the country name
: Notification If the content of this attribute does not correspond to one of the values of the ISO 639-1 standard
: NotificaNotificationión If this is a group with information regarding the address of the issuer of an electronic document, it must contain the literal "is"
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|localizacion
|Array <Coordenadas>
|<nowiki>AN|..50</nowiki>
|NO
|
: address coordinates
: '''PATH''': ../cac:Address/cac:LocationCoordinate
: (see detail in [[#Class.Coordenadas|Class.Coordenadas]])
|-
|municipio
|String
|<nowiki>AN|..50</nowiki>
|YES
|
: Municipality Code
: Notification If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
: '''PATH''': ../cbc:ID
|-
|nombreEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of a Building
: '''PATH''': ../cac:Address/cbc:BuildingName
|-
|numeroEdificio
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Número de una casa o edificio
: '''PATH''': ../cac:Address/cbc:BuildingNumber
|-
|numeroParcela
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Parcel Number
: '''PATH''': ../cac:Address/cbc:PlotIdentification
|-
|pais
|String
|<nowiki>A|2</nowiki>
|YES
|
:Customer country.
: Rejection If the content of this element does not correspond to a value of the ISO 3166-1 alpha-2 standard
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|piso
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Flat
: '''PATH''': ../cac:Address/cbc:Floor
|-
|region
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Región
: '''PATH''': ../cac:Address/cbc:Region
|-
|subDivision
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Subdivision (Name of the Neighborhood)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: A specific location within a building
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Postal zone
: Notification If the content of this element does not correspond to a corresponding value of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
: Notification If the value of the CodigoDepartamento attribute is different from the first 2 digits of the postal code.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}
====Class.Coordenadas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|gradosLatitud
|String
|Por Definir
|NO
|
: latitude measure in degrees
: '''PATH''': ../cbc:LatitudeDegreesMeasure
|-
|gradosLongitud
|String
|Por Definir
|NO
|
: measure of longitude in degrees
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeDegreesMeasure
|-
|minutosLatitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Latitude measurement in decimal minutes in mm.mm format
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|minutosLongitud
|String
|<nowiki>N|…5|2.2</nowiki>
|NO
|
: Longitude measurement in decimal minutes in mm.mm format
: Rejection Unit greater than 60 minutes
: '''PATH''': ../cbc:LongitudeMinutesMeasure
|-
|orientacionLatitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of measurement of latitude in relation to the Equator
: '''PATH''': ../cbc:LatitudeDirectionCode
|-
|orientacionLongitud
|String
|<nowiki>AN|1</nowiki>
|NO
|
: Sense of longitude measurement in relation to the Equator
: '''PATH''': ../cbc:LongitudeDirectionCode
|}
====Class.Tributos====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoImpuesto
|String
|<nowiki>AN|2</nowiki>
|SI
|
: tribute identifier
: Rejection If the content of this element does not correspond to one of the codes in the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
: '''PATH''': ../cbc:ID
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined (see detail in [[#Class.Extensible|Class.Extensible]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Dato Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Establishment Code
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|YES
|
: Name or company name of the acquirer
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|YES
|
: Acquirer Identifier.
: You must inform the NIT if you are responsible
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Check digit
: '''Mandatory''' If tipoIdentificacion =31, the DV of the NIT must be informed
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Billing prefix:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|YES
|
: Customer identification type
: Rejection If the content of this element is different from “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|YES
|
: Obligations of the acquirer
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
: '''PATH''': ../cbc:TaxLevelCode
|-
|regimen
|String
|<nowiki>AN|2</nowiki>
|NO
|
: Optional, if informed, indicate “Not applicable”. Possible Values:
: 48: “Sales tax - IVA”
: 49: “Not responsible for IVA”
: '''PATH''': .. /cbc:TaxLevelCode/@listName
|}
====Class.LineaInformacionAdicional====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|cantidad
|String
|<nowiki>AN|..5</nowiki>
|NO
|
:additional quantity
: '''PATH''': ../cbc:ValueQuantity
|-
|codigo
|String
|<nowiki>AN|..5</nowiki>
|NO
|
: additional code
: '''PATH''': ../cbc:NameCode
|-
|codigoInterno1
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|codigoInterno2
|String
| -
|NO
|
: Optional not used for now
: '''PATH''': Not defined
|-
|descripcion
|String
|<nowiki>AN|..450</nowiki>
|NO
|
: additional description
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
|-
|fechaFin
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Period End Date
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
|-
|fechaInicio
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Beginning date of the period
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
|-
|nombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Characteristic you want to report on the item, for example: (Vehicle Use)
: Rejection For each name there must be a value
: '''PATH''': ../cbc:Name
: (For defining extensible field catalogs at the detail level)
|-
|secuencia
|String
|<nowiki>AN|..3</nowiki>
|NO
|
: Sequence order indicator
: '''PATH''': Not defined
|-
|tipo
|String
|<nowiki>N|1</nowiki>
|NO
|
:Value Type Indicator, example Value = ’1’
: '''PATH''': Does not apply
|-
|valor
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Value of the characteristic to be reported, for example: (Particular)
: Rejection For each value there must be a name
: '''PATH''': ../cbc:Value
|}
====Class.DatosTransportistas====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Description
|-
|detallesTributarios
|Tributos
| -
|NO
|
: Tax Types
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
: (see detail in [[#Class.Tributos|Class.Tributos]])
|-
|direccionResponsableEntrega
|Direccion
| -
|NO
|
: Information on the Address of the Person Responsible for Delivery
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|email
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Email
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|indicadordeAtencion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicator if it is information on “for the attention of” (FAO)
: '''PATH''': ../cbc:MarkAttentionIndicator
|-
|indicadordeCuidado
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Indicador si es información sobre alguien responsable por los bienes
: '''PATH''': ../cbc:MarkCareIndicator
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Contact name
: '''PATH''': .. /cac:Contact/cbc:Name
|-
|nombreResponsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Name of the Responsible for the Delivery
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nota
|String
| -
|NO
|
:Contact Note
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroIdentificacion
|String
|<nowiki>AN|…12</nowiki>
|NO
|
: Carrier NIT
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|NO
|
: Check digit
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Commercial registration number
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Billing Prefix
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
|-
|responsabilidadesRut
|Array <Obligaciones>
| -
|NO
|
: Carrier Liability
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
: (see detail in [[#Class.Obligaciones|Class.Obligaciones]])
|-
|telefax
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Carrier Telefax
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|telefono
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: carrier phone
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier Identification Type
: Rejection If the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
|-
|transportadorDireccion
|Direccion
| -
|NO
|
: Tax address of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|transportadorNombre
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: carrier name
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|transportadorNumeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|NO
|
: Carrier document number
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
|-
|transportadorNumeroDocumentoDV
|String
|<nowiki>AN|..2</nowiki>
|NO
|
: Verifier Digit of the NIT of the transporter
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|transportadorTipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|NO
|
: Carrier document type
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.DocumentoReferencia====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|codigoEstatusDocumento
|String
| -
|C/C
|
: Document code or reason
: '''Mandatory''' When InternalCode is '4'
: Rejection If the content of this attribute does not correspond to any of the values of [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] and [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
: '''PATH''': ../cac:DiscrepancyResponse/cbc:ResponseCode
|-
|codigoInterno
|String
|<nowiki>N|1</nowiki>
|YES
|
: This field decides if in which XML node the information will be sent DocumentoReferenciado, possible values:
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
# DespatchDocumentReference (Doc. De despacho)
# ReceiptDocumentReference (Doc. De recepción)
# DiscrepancyResponse (N.C y N.D)
# BillingReference (Facturas por corrección, N.C y N.D)
|-
|cufeDocReferenciado
|String
|<nowiki>AN|..90</nowiki>
|C/C
|
: CUFE or CUDE of the referenced document
: '''Required''' When InternalCode is '5'
: '''Mandatory''' In invoices, it must be filled out only when the electronic invoice originates from the correction or adjustment that occurs through a NC or ND
: '''Mandatory''' In N.C and N.D, are the references to electronic invoices affected by the Note. You can only report electronic invoices of the same acquirer
: Rejection If CUFE or CUDE does not exist in the DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|descripcion
|Array <String>
|<nowiki>AN|20..5000</nowiki>
|C/C
|
: Description of the nature of the correction
: '''Required''' When InternalCode is '4'
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
|-
|extras
|Array <Extensible>
| -
|NO
|
: Optional fields or information for the issuer's business model
: '''PATH''': Not defined
: (see detail in [[#Class.Extensible|Class.Extensible]])
|-
|fecha
|String
|<nowiki>AN|10</nowiki>
|C/C
|
: Fecha de emision del documento referenciado, en formato: YYYY-MM-DD
: '''Mandatory''' When internal code is '1', '2', '3' or '5'
: Rejection If the date is later than that of the referenced document
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|fechaFinValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: End of Validity Date
: '''PATH''': Undefined
|-
|fechaInicioValidez
|String
|<nowiki>AN|10</nowiki>
|NO
|
: Validity Start Date
: '''PATH''': Undefined
|-
|numeroDocumento
|String
|<nowiki>AN..20</nowiki>
|SI
|
: Concatenation of the prefix and the referenced document number
: Rejection if codigoInterno is reported equal to '1', '2', '3', '4' or '5' and the reference document ID is not related
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|tipoCUFE
|String
|<nowiki>AN|..11</nowiki>
|C/C
|
: CUFE type algorithm.
: “CUFE-SHA384” or “CUDE-SHA384”
: '''Required''' When InternalCode is '5'
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference
: /cbc:UUID/@schemeName
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:UUID/@schemeName
: /DebitNote/cac:BillingReference/cac: InvoiceDocumentReference
: /cbc:UUID/@schemeName
|-
|tipoDocumento
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Description of the type of referenced document, Example: "National Sales Invoice"
: '''PATH''': Not defined
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identifier of the referenced document type
: '''Required''' When InternalCode is '1'
: Rejection If codigoInterno equal to '1' and the content of this attribute does not correspond to one of the values of the [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''PATH''': Undefined
|}
'''''@IMPORTANT:'''
# To reference '''sales invoices when issuing a NC or ND''', two objects of type DocumentosReferenciados must be sent indicating the following:
#* '''Object 1''': indicating the fields codigoEstatusDocumento; CodihoInterno = '4', numeroDocumento, descripcion.
#* '''Object 2''': if the '''tipoOperacion is equal to 20 (for NC) or 30 (for ND)''' and codigoInterno = '5', the fields are validated: cufeDocReferenciado, date, and DocumentNumber.
# When transmitting a '''Factura de Contingencia ''', an array of the documentosReferenciados type must be sent, indicating the fields: internal code = '1', numberDocument, date, tipoDocumentCode (corresponding to Contingenc Invoice).
# To reference '''Dispatch Documents''' (internal code = '2') or '''Reception Documents''' (internal code = '3') the fields are validated: documentnumber and date.''

====Class.sectorSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Complementary data of the beneficiary of the health service for collection scenarios.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (see detail in [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Optional fields or information for the issuer's business model.
: '''PATH''': Not defined
: (see detail in [[#Class.Extras|Class.Extras]])
|-
|IdPersonalizacion
|String
|Por definir
|C/C
|
: To indicate the type of operation through which the collection was made in the accreditation or report scenarios
: '''PATH''': To be defined
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|For the report of the additional data fields of the Health Sector
: (see detail in [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|YES
|
: Type of Health Sector Scenario. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTE: The issuance of health sector documents is only available through version 4 of the issuance service. 

====Class.Beneficiario====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Information detailing the address of the beneficiary of the health service.
: '''PATH''': ../cac:ResidenceAddress
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Additional data fields of the Health Sector to report information associated with the beneficiaries of the health service
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension
: (see detail in [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Identification type of the beneficiary user of the health service.
: '''PATH''': cbc:ID/@schemeID
: (see detail in [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Attribute
! style="background:#f2f2f2; text-align:center;"|Data Type
! style="background:#f2f2f2; text-align:center;"|Format
! style="background:#f2f2f2; text-align:center;"|Required
! style="background:#f2f2f2; text-align:center;"|Description
|-
|nombre
|String
|N|..2
|Si
|
: Additional data field code.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Note: It must correspond to one of the codes in the column[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|depends on the field
|Yes
|
: Value of the additional data field of the health sector as appropriate.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''Important''': In the case of the field '''rangoNumeracion''', this value must always have the following format (Pefijo-campoDesde), that is, said field is independent of the sequential mode configured in the portal (manual with prefix or manual without prefix).

In the case of the field '''consecutivoDocumento''', This field does depend on the sequential mode configured in the web portal.
* If the assigned modality is''“manual sin prefijo”'', the values for the fields rangoNumeracion and consecutivoDocumento’ They should be for example:
:: Invoice #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Invoice #2: rangeNumeracion= "PRUE-1", consecutiveDocument= "2"
:: ...
:: Invoice #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*If the assigned modality is ''“manual with prefix”'', the values for the fields rangoNumeracion and consecutivoDocumento must be, for example:
:: Invoice #1: rangeNumeracion= "PRUE-1", consecutiveDocument= "PRUE1"
:: Invoice #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Invoice #1000: rangeNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"

; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|ID
! style="background:#f2f2f2; text-align:center;"|Description
|-
|int
|codigo
|Indicates the status of the operation returned by the service, (to define catalog)
|-
|String
|consecutivoDocumento
|Prefix and Consecutive of the Concatenated Document without separators. For the example above it corresponds to: “PRUE980338337”
|-
|String
|cufe
|"Unique Electronic Invoice Code" corresponding to the document consulted.
|-
|Bool
|esValidoDian
|“true” if valid
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in YYYY-MM-DD HH:MM:SS format
|-
|String
|fechaRespuesta
|Day and time in which the electronic document was generated, in format AAAA-MM-DD HH:MM:SS
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the response code, useful for error identification
|-
|Array
|mensajesValidacion
|Validation messages in case of notification or rejection
|-
|String
|nombre
|Name defined by the DIAN
|-
|String
|qr
|QR code string concatenation (control element)
|-
|Array
|reglasNotificacionDIAN
|Validation rules in case of notification
|-
|Array
|reglasValidacionDIAN
|Validation rules in case of rejection
|-
|String
|resultado
|Method consumption result: Processed” or “Error”
|-
|String
|tipoCufe
|CUFE type algorithm. “CUFE-SHA384” or “CUDE-SHA384”
|-
|String
|xml
|XML file (type AttachedDocument) encoded in Base64
|}
Once the electronic invoice has been sent successfully (code '200' or '201' in the response), the attached files are sent (through the method'''CargarAdjuntos''') consuming the SOAP Web Attachments Service, in the scenario that the '''attachments''' parameter has been assigned to “1” or “11”, otherwise the SOAP Web Attachments Service will return an error indicating that the document does NOT support attachments.
{{clear}}

===EstadoDocumento Method===
It allows you to consult the status of the document indicated before the Acquirer, before the DIAN, the type of delivery and if it was successful, the list of associated events (ApplicationResponse) and other parameters of interest that can be useful in the software control processes billing (ERP) or for the business model of the issuing client.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Typr
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|Bool
|aceptacionFisica
|Indicates if the document has physical acceptance (physically delivered): “true” or “false”
|-
|String
|acuseComentario
|Comment informed by the acquirer when making the acknowledgment
|-
|String
|acuseEstatus
|0: Acknowledgment not made ; 1: Acknowledgment made
|-
|String
|acuseResponsable
|Email of the person responsible for making the acknowledgment
|-
|String
|acuseRespuesta
|0: Response not sent; 1: Reply Sent
|-
|String
|ambiente
|Type of document generation environment:
:: “1: ProductionEnvironment”
:: “2: TestEnvironment”
|-
|String
|cadenaCodigoQR
|QR code string concatenation (control element)
|-
|String
|cadenaCufe
|Chain concatenation of the CUFE code prior to calculation by the corresponding algorithm of the service
|-
|int
|Codigo
|Indicates the status of the operation returned by the service
|-
|String
|consecutivo
|Consecutive Document TFHKA/DIAN
|-
|String
|cufe
|"Unique Code of Electronic Invoice" corresponding to the document consulted, calculated by the corresponding algorithm of the service
|-
|String
|descripcionDocumento
|Reference document type identifier,
: Example: "National Sales Invoice"
|-
|String
|descripcionEstatusDocumento
|Description corresponding to the statusDocument before the DIAN: "Processed Correctly"
|-
|String
|entregaMetodoDIAN
|Indicates the delivery method to the DIAN
: (Synchronous or Asynchronous), (Individual or Batch)
|-
|Bool
|esValidoDIAN
|
: “true” if valid
: "false" If not valid
|-
|String
|estatusDocumento
|Code obtained in the response corresponding to the status of the document before the DIAN (Catalogue to be defined)
|-
|Array <Evento>
|eventos
|List of Electronic Document events
|-
|String
|fechaAceptacionDIAN
|Day and time in which the DIAN accepted the electronic document, in format AAAA-MM-DD HH:MM:SS
|-
|String
|fechaDocumento
|Date on which the document was generated, in format: AAAA-MM-DD
|-
|Array <HistorialDeEntregas>
|historialDeEntregas
|History of document deliveries
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|mensajeDocumento
|Provides a description of the error of each of the initial validations. If there are no errors, no description is provided.
|-
|Bool
|poseeAdjuntos
|Indicates if the document has attachments:
: "true" or "false"
|-
|Bool
|poseeRepresentacionGrafica
|Indicates if the document has a graphic representation:
: "true" or "false"
|-
|Array <String>
|reglasValidacionDIAN
|Validation messages by the DIAN
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoDocumento
|Reference document type identifier
: Watch [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|This element corresponds to the TrackId of the processed document
|}
Where Class.Evento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|ambienteDIAN
|Generation environment in the DIAN
: “1:ambienteDeProducción”
: “2:ambienteDePruebas”
|-
|String
|codigo
|Code the document of the Application Response (event)
|-
|String
|comentario
|event commentary
|-
|String
|cufe
|CUFE of the electronic document
|-
|String
|descripcionEvento
|Description of use/source of the event
|-
|String
|emisorNumeroDocumento
|Issuer Identification Number
|-
|String
|emisorNumeroDocumentoDV
|Issuer Document Number Check Digit
|-
|String
|emisorRazonSocial
|Company Name of the Issuer
|-
|String
|emisorTipoIdentificacion
|Issuer Identification Type
|-
|Array <ExtrasEvento>
|extras
|Extra information corresponding to the event
|-
|String
|fechaEmision
|Date of Issue of the Application Response (event)
|-
|String
|fechaRecepcion
|Application Response Reception Date (event)
|-
|String
|hash
|Application Response document hash
|-
|String
|idPerfilDIAN
|DIAN Profile
|-
|String
|mensaje
|ApplicationResponse description message
|-
|String
|nombreArchivoXML
|XML file name
|-
|String
|nota
|Content of the Note field of the Application Response
|-
|String
|numeroDelEvento
|Consecutive Application Response
|-
|String
|receptorNumeroDocumento
|Receiver Identification Number
|-
|String
|receptorNumeroDocumentoDV
|Receiver Document Number Check Digit
|-
|String
|receptorRazonSocial
|Receiver's Business Name
|-
|String
|receptorTipoIdentificacion
|Receiver Identification Type
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUDE of the event:
: SHA-256, SHA-384, SHA-512
|-
|String
|tipoEvento
|Event type identifier:
: (Internal/ApplicationResponse)
|-
|String
|versionUBL
|UBL version of the XML
|}
And Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|nombre
|Additional Description
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas will correspond to:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|LeidoEmailIPAddress
|IP address of the computer in which the acknowledgment of the notification mail was made
|-
|String
|LeidoEstatus
|Notification mail acknowledgment status
|-
|String
|LeidoFecha
|Date of acknowledgment of notification mail
|-
|String
|canalDeEntrega
|Electronic document delivery channel
|-
|Array <String>
|email
|Email of the recipient of the electronic document
|-
|String
|entregaEstatus
|Delivery status:
: '0': Mail not sent
: '200': Mail sent
|-
|String
|entregaEstatusDescripcion
|Delivery Status Description
|-
|String
|entregaFecha
|Document delivery date
|-
|String
|fechaProgramada
|Delivery Date
|-
|String
|mensajePersonalizado
|Personalized message to be delivered by Email, WhatsApp or Telegram
|-
|String
|nitProveedorReceptor
|NIT of the receiving Technological Provider, in case of delivery by Interoperability
|-
|String
|recepcionEmailComentario
|Customer Acknowledgment Comment
|-
|String
|recepcionEmailEstatus
|E-mail reception status
: 1: Accepted
: 2: Rejected
: 3: In verification
|-
|String
|recepcionEmailFecha
|Date of receipt of the Email
|-
|String
|recepcionEmailIPAddress
|Email receiving IP address
|-
|String
|telefono
|For delivery by Whatsapp/Telegram
|}
'''@Important:''' The structure of this Response may still be subject to change in a future update.
{{clear}}
===EnvioCorreo Method===
Allows you to forward the indicated document to one or more email addresses.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”. Allows sending multiple recipients (maximum 5) separated by a comma character ','
|-
|correo
|Email to which the document will be sent. Example name@company.com
|-
|adjuntos
|
: “0”: Resends the mail without attachments
: “1”: Forwards the mail with the attachments stored during the issuance of the document.
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|rowspan="2"|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Send''' method) the '''attachments''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform does not will generate standard graphical representation (PDF), therefore only the documents hosted on the platform (AttachedDocument) will be forwarded to the recipients. To forward the mail (with the AttachedDocument and attachments) to an email address different from the one used during the transmission, the '''CargarAtjuntos''' method of the SOAP Web Attachments Service can be used again.
{{clear}}
===DescargaPDF Method===
Allows you to download the standard graphic representation (PDF generated by TFHKA) of the document for local storage, local consultation or reprint purposes.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documento
|prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted.
|-
|String
|documento
|Base64 encoded PDF document
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
'''@Important:''' If during the issuance of the document ('''Enviar''' method) the '''adjuntos''' parameter was set to “10” or “11”, The Factory HKA - DFACTURE platform will not will generate standard graphic representation (PDF), therefore this method cannot be used since the service will throw an error indicating that there is NO associated PDF, since it is assumed that the graphic representation has been generated locally by the billing software (ERP).
{{clear}}
=== DescargaXML Method===
It allows the download of the XML document (only the electronic document Invoice, CreditNote and DebitNote), in case it is required to validate the information such as the signature or its authenticity or for the purpose of local management and storage.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|String
|cufe
|“Unique Electronic Invoice Code” corresponding to the document consulted
|-
|String
|documento
|XML document (Invoice, CreditNote or DebitNote) encoded in Base64
|-
|String
|hash
|Error detection code
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===FoliosRestantes Method===
Allows you to consult the stamps (transactions) available. The stamps are consumed in proportion to the transactions made.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE:Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|codigo
|Indicates the status of the operation returned by the service
|-
|int
|foliosRestantes
|Number of sheets available
|-
|String
|mensaje
|This message is associated with the code, useful for identifying errors
|-
|String
|resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===CargarCertificado Method===
For now, this method will only be used internally by The Factory HKA Colombia.
{{clear}}
===DescargarEventoXML Method===
It allows downloading an event or occurrence (ApplicationResponse) related to an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|documentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
;RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|Documento
|XML document (ApplicationResponse) encoded in Base64
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|}
{{clear}}
===GenerarContenedor Method===
UA container is a type of AttachedDocument document, its structure is intended to contain and transmit an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) generated to date in a single XML file.
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|Documento
|Prefix and Consecutive of the electronic Document concatenated without separators. Example “PRUE980338212
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|Contenedor
|XML document (AttachedDocument) encoded in Base64
|-
|String
|Fecha
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|}
{{clear}}
===GenerarEvento Method===
Allows the generation of an event or occurrence (ApplicationResponse) associated with an Electronic Document (Invoice, CreditNote or DebitNote), generated by a person or entity related to this document (DIAN, Issuer, Acquirer).
; REQUEST: Parameters to Send
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Supplied by The Factory HKA Colombia
|-
|tokenPassword
|-
|DatosEvento
|datosEvento
|Object with the data of the event (ApplicationResponse) to generate
|}
Where Class.DatosEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoEvento
|Indicates the code of the event (to define catalog)
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Comentario
|Comment or description of the event
|-
|String
|Documento
|Prefix and consecutive of the Electronic Document concatenated without separators. Example “PRUE980338212”
|-
|Array <ExtrasEvento>
|Extras
|Additional event information
|}
Where Class.ExtrasEvento contains the following information:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|String
|codigoInterno1
|Hashtag
|-
|String
|codigoInterno2
|Additional Description
|-
|String
|Nombre Código
|of the field
|-
|String
|valor
|Additional Information
|}
; RESPONSE: Parameters to Receive
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Type
! style="background:#f2f2f2; text-align:center;"|Identifier
! style="background:#f2f2f2; text-align:center;"|Description
|- valign="center"
|-
|int
|Código
|Indicates the status of the operation returned by the service
|-
|String
|consecutivoDocumentoEvento
|Consecutive of the event (ApplicationResponse)
|-
|String
|Cufe
|Event CUFE (ApplicationResponse)
|-
|String
|fechaRespuesta
|Date and Time consumption of the method, format: AAAA-MM-DD HH:MM:SS
|-
|String
|Hash
|Error detection code
|-
|String
|Mensaje
|This message is associated with the code, useful for error identification.
|-
|String
|Resultado
|Result of method consumption:
: “Processed” or “Error”
|-
|String
|tipoCufe
|Algorithm used to calculate CUFE:
: SHA-256, SHA-384, SHA-512
|-
|String
|Xml
|XML document (ApplicationResponse) encoded in Base64
|}
{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-03-01T13:47:46Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Version record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Web Soap Broadcast Service Methods - Direct Integration Manual Index|Web Soap Broadcast Service Methods]]==<includeonly>=</includeonly>
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Enviar Method|Enviar Method]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Anticipos|Class.Anticipos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Autorizado|Class.Autorizado]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Cliente|Class.Cliente]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.CondicionPago|Class.CondicionPago]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Destinatario|Class.Destinatario]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Entrega|Class.Entrega]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Extras|Class.Extras]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Extensible|Class.Extensible]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.MediosDePago|Class.MediosDePago]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Direccion|Class.Direccion]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Coordenadas|Class.Coordenadas]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Tributos|Class.Tributos]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Obligaciones|Class.Obligaciones]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.sectorSalud|Class.sectorSalud]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.Beneficiario|Class.Beneficiario]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Class.GeneralSalud|Class.GeneralSalud]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#EstadoDocumento Method|EstadoDocumento Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#Método EnvioCorreo Method|Método EnvioCorreo Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargaPDF Method|DescargaPDF Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargaXML Method|DescargaXML Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#FoliosRestantes Method|FoliosRestantes Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#CargarCertificado Method|CargarCertificado Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#DescargarEventoXML Method|DescargarEventoXML Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#GenerarContenedor Method|GenerarContenedor Method]]
# [[Web Soap Broadcast Service Methods - Direct Integration Manual Index#GenerarEvento Method|GenerarEvento Method]]

<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO|GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catalog of web service response errors - Direct Integration Manual Index - Electronic Bill|Catalog of web service response errors]]==<includeonly>=</includeonly>

{{clear}}

Generalities - Direct Integration Manual Index - Electronic Bill

2022-02-28T16:50:25Z

Lvargas:

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support?==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====Technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===What is the electronic invoice with prior validation?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}
===Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-02-28T16:44:53Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Version record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa|Métodos Servicio Emisión Web Soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Entrega|Class.Entrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO|GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-02-28T16:35:41Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill# Version record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill# How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill# General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill# Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill# Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill# Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill# Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill# Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa|Métodos Servicio Emisión Web Soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Entrega|Class.Entrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO|GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-02-28T16:32:51Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#Version record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index - The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index - Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index - Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index - What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index - Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index - Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index - Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index - Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index - Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa|Métodos Servicio Emisión Web Soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Entrega|Class.Entrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO|GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-02-28T16:28:11Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support?|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index#The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index#Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index#Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index#What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index#Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index#Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index#Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index#Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index#Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index#Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa|Métodos Servicio Emisión Web Soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Entrega|Class.Entrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO|GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

{{clear}}

Generalities - Direct Integration Manual Index - Electronic Bill

2022-02-28T16:14:59Z

Lvargas: Página creada con « <includeonly>=</includeonly>==Version record==<includeonly>=</includeonly> {| class="wikitable" style="margin: auto;" |- ! style="background:#e9e9e9; text-align:center;"|V…»

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===¿What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===¿What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===¿What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===¿What is la Facturación Electrónica con Validación Previa?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}
===¿Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Direct Integration Manual Index - Electronic Bill

2022-02-28T16:13:39Z

Lvargas:

[[Category:Manuales|I]]
__NOTOC__

[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalities - Direct Integration Manual Index - Electronic Bill|Generalities]]==<includeonly>=</includeonly>
# [[Generalities - Direct Integration Manual Index - Electronic Bill#record|Version record]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#How to get support|How to get support?]]
# [[Generalities - Direct Integration Manual Index - Electronic Bill#General description|General description]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-DFACTURE?|What is The Factory HKA-DFACTURE?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#What is The Factory HKA-Dfactura?|What is The Factory HKA-Dfactura?]]
## [[Generalities - Direct Integration Manual Index - Electronic BillWhat is Dintegración?|What is Dintegración?]]
## [[Generalities - Direct Integration Manual Index - Electronic Bill#Functionalities|Functionalities]]
## [[Generalities - Direct Integration Manual Index#The direct integration|The direct integration]]
## [[Generalities - Direct Integration Manual Index#Technical requirements for direct integration|Technical requirements for direct integration]]
# [[Generalities - Direct Integration Manual Index#Electronic invoice operation scheme with prior validation|Electronic invoice operation scheme with prior validation]]
## [[Generalities - Direct Integration Manual Index#What is the electronic invoice with prior validation?|What is the electronic invoice with prior validation?]]
## [[Generalities - Direct Integration Manual Index#Who participates in this scheme?|Who participates in this scheme?]]
## [[Generalities - Direct Integration Manual Index#Advantages of Electronic Billing|Advantages of Electronic Billing]]
## [[Generalities - Direct Integration Manual Index#Electronic Billing Process with Prior Validation|Electronic Billing Process with Prior Validation]]
# [[Generalities - Direct Integration Manual Index#Process characteristics with Prior Validation|Process characteristics with Prior Validation]]
# [[Generalities - Direct Integration Manual Index#Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems|Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems]]
# [[Generalities - Direct Integration Manual Index#Web services soap with prior validation|Web services soap with prior validation]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa|Métodos Servicio Emisión Web Soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Entrega|Class.Entrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO|GENERACIÓN DE NOTAS CON Y SIN REFERENCIA A DOCUMENTO]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

{{clear}}

Generalidades - Direct Integration Manual Index - Electronic Bill

2022-02-28T14:19:19Z

Lvargas:

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===What is the electronic invoice with prior validation?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}

===¿Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Generalidades - Direct Integration Manual Index - Electronic Bill

2022-02-28T13:52:18Z

Lvargas: /* ¿What is la Facturación Electrónica con Validación Previa? */

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===¿What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===¿What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===¿What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===¿What is the electronic invoice with prior validation?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}

===¿Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Generalidades - Direct Integration Manual Index - Electronic Bill

2022-02-28T13:50:37Z

Lvargas: /* ¿What is la Facturación Electrónica con Validación Previa? */

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===¿What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===¿What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===¿What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===¿What is ellectronic bill with previous validation?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}

===¿Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Generalidades - Direct Integration Manual Index - Electronic Bill

2022-02-28T08:11:49Z

Lvargas:

<includeonly>=</includeonly>==Version record==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Version
! style="background:#e9e9e9; text-align:center;"|Launch date
! style="background:#e9e9e9; text-align:center;"|Description
|- valign="center"
| 0
| 07/05/2019
|
* Preview version.
|-
| 1.0
| 14/06/2019
|
* Initial version.
* "Technical annex V1.4 (19-04-19)" DIAN reference.
|-
| 1.1
| 04/07/2019
|
* "Sale electronic bill Technical annex – final" DIAN Reference update.
|-
| 1.2
| 04/07/2019
|
* Minor updates
|-
| 1.3
| 19/08/19
|
* Minor updates
|-
| 1.4
| 23/08/19
|
* Answer update in view of the send method.
* List of extensible fields and bug catalog.
|-
| 1.5
| 09/2019
|
* Wildcards updates based on the September 6th- technical annex.
|-
| 1.6
| 04/2020
|
* Updates based on the technical annex 1.8.
* Acknowledgment of the purchaser.
* Mail personalization.
* Additional features.
* Settle documents at reception.
* Code tables.
* Change of the document's name.
* Among other minor changes.
|-
| 1.7
| 06/2020
|
* Updates based on the technical annex V1.7-2020.
* Ajustes de funcionalidades de la plataforma en el mes de mayo.
|-
| 2.0
| 06/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
| 2.1
| 10/2021
|
* Updates based on the technical annex V1.8 of the 000012 Resolution. Health sector fields. Code tables.
|-
|}

<includeonly>=</includeonly>==How to get support==<includeonly>=</includeonly>
*First level support:
::Phone support / e-mail / chat or teleconference in 5x8 schedule for consultation service and user failures.
*Second level support:
::Support remote resolution of incidents in the system in schedule 5X8
::::Write to [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Consultations relating to configurations and errors in the portal:
* soporte_fel_co@thefactoryhka.com

Consultations relating to configurations of ERP, software house and integration:
* integracion_fel_co@thefactoryhka.com

'''Telephone service lines:'''
* '''MASTER''' +57 (1) 746.08.12
* +57 (1) 508.8990
* +57 (1) 517.6795
* +57 (1) 517.6796
* +57 (1) 311.3063
** '''Technical support''' → Option 2
** '''Integration ''' → Option 5 Then Option 1

<includeonly>=</includeonly>===Synchronous sessions:===<includeonly>=</includeonly>

<includeonly>=</includeonly>====technical support session====<includeonly>=</includeonly>
Registration as an electronic biller, configuration of numbering ranges, fiscal data configuration, Enabling Tests, Production environment configuration, managment and use of the TFHKA electronic billing portal.

'''Addressed to:''' Comercial agencies – Ally software factories - Final clients

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[https://meet.google.com/yyg-pujr-yqv Enlace Sesiones de Soporte]

<includeonly>=</includeonly>====Integration area sessions<includeonly>=</includeonly>====
Solución integration cases

'''Addressed to:''' Clients that realice Software development to do integration with TFHKA, Ally software factories

'''Schedule:''' Tuesday and thursday from 8:30 AM to 10:00 AM

[http://meet.google.com/fzo-xmyc-duk Enlace Sesiones Integración]
{{clear}}
<includeonly>=</includeonly>== General description==<includeonly>=</includeonly>
This document describes the integration process between the electronic invoicing model with prior validation according to regulatory and technical updates from the DIAN and/or own controls in our integration model.

For the development of this document, was taken as reference the '''Technical annexes V1.7-2020 (current) and V1.8 (this last released in October 2019 by the DIAN)'''.

'''Note:''' Not all functionalities, catalogs and billing scenarios referring to the Technical Annex V1.8 are enabled by the DIAN.
{{clear}}
===¿What is The Factory HKA-DFACTURE?===
It is an electronic billing platform, designed to comply with current legislation in Colombia and offer added values through complementary services.
===¿What is The Factory HKA-Dfactura?===
It is a portal with the capacity to issue documents under the electronic invoicing scheme, managed from the web portal and Addressed to taxpayers who have the obligation to issue electronic invoices by resolution of the DIAN.
===¿What is Dintegración?===
It is a product aimed at the integrator and is made up of the following components:
*Integration manuals.
*Bag of support hours via email and/or teleconferences.
*Credentials for test environment (DEMO) and production.
*Configurable Templates for graphical representation.
{{clear}}
===Functionalities===
The Factory HKA-DFACTURE platform allows the issuance, reception, consultation, viewing and downloading of the following documents in XML format and/or their corresponding graphic representation in PDF:
*Invoice of National Sale
*Export invoice
*Contingency invoice
*Credit note
*Debit note
Additionally, the platform allows you to check the status of the Acknowledgment of Receipt by the purchaser, the status of the document by the DIAN, check the number of available stamps/folios and send receipts via email.

'''@Important:''' It is only possible to view or download graphic representations (PDF of electronic documents) generated by our platform on our web portal.
{{clear}}
===The direct integration===
Direct integration is a unique process between the embedded software and The Factory HKA-DFACTURE platform.Integration is an essential activity for the implementation of electronic invoicing in a Billing System or Administrative Software (ERP) and will be carried out only once. This activity consists of linking two platforms with different technologies in order to transmit the necessary data for the construction of the documents and the successful monitoring of the life cycle

In the case of direct integration, the communication is connected directly to the Web Service, which has the advantage of total control of the life cycle of the electronic document, from the origin of the data, through the transmission process to its delivery, acknowledgment of receipt and validation. This form of integration allows a faster and more efficient reaction to errors or inconsistencies that arise in the process.

Direct integration is an exclusive process between the embedded software and The Factory HKA-DFACTURE platform.

'''@Important:''' It is not necessary to implement additional integration with the DIAN, since it has the complete document status tracking functionality.
{{clear}}
===Technical requirements for direct integration===
The Factory HKA-DFACTURE is a SaaS (Software as a Service) type platform: The services, information, processing, inputs and results are hosted on our servers (as technology provider), and we take care of the maintenance, operation, regulatory changes and solution support.

By DIAN regulations, the technology provider has the obligation to keep the documents and guarantee the integrity and security of the data under the ISO 27001 standard. Therefore, extensive planning of processing and storage infrastructure is not necessary to implement electronic billing.

The necessary parameters for the construction of each transaction are exposed independently at the time of consuming the services, and the result is fully delivered at the end of the operation. This means that The Factory HKA does not require managing customer or product/service databases.
As a technological provider, The Factory HKA Colombia has human resources dedicated to monitoring and analyzing the regulatory changes that the DIAN progressively issues. If a significant change is generated that has an impact on the integration side, the necessary tools and instructions will be provided to apply the corrective measures in the simplest way possible.

The Factory HKA-DFACTURE platform provides integration with a Web Service as a solution for interoperation with third parties. '''The Web Service is developed in SOAP (Simple Object Access Protocol)'''. Therefore, the only requirements for integration will be the following:

*Capacity of WS SOAP consumption of the software (development environment) to use.
*Capability of capturing and validating input data.
*Optional: Ability to store a copy of the XML/PDF per transaction.
*Ability to display the status of the electronic document life cycle.
{{clear}}
<includeonly>=</includeonly>==Electronic invoice operation scheme with prior validation==<includeonly>=</includeonly>
===¿What is la Facturación Electrónica con Validación Previa?===
Electronic Invoicing (FEL) is an operation scheme that allows the issuance of supporting documents for commercial operations between taxpayers in digital format instead of paper, allows the application of fiscal control during the process, and has legal validity for the designated tax entity. by the government of the country.

As of September 2019, it is expected that an electronic invoice will only be valid when its content has been previously validated through the DIAN or through a provider authorized by the tax administration.

Prior validation is established in Law 1943 of 2018, known as the Financing Law. Article 16 of this Law modifies article 616-1 of the Tax Statute, in its first paragraph it establishes that:

“All electronic invoices for tax recognition must be validated prior to their issuance, by the DIAN or by a provider authorized by it. The electronic invoice will only be understood as issued when it is valid and delivered to the purchaser. (…)”

In the electronic invoicing model with prior validation, 5 types of documents will be used:
*Invoice
*CreditNote
*DebitNote
*ApplicationResponse (Event): Occurrence related to an Electronic Document, generated by a person or entity related to the document (DIAN, Issuer, Acquirer), this document also contains an electronic signature.
*AttachedDocument (Document container): The structure of this document is intended to contain in a single XML file an electronic document (Invoice, CreditNote or DebitNote) and all the events (ApplicationResponse) registered to date.
{{clear}}
===¿Who participates in this scheme?===
'''The Tax Entity (DIAN):''' It is a public institution appointed by the government to collect, control and regulate everything related to taxes. It is the one that has the right to accept and authorize an electronic document. In Colombia, it is the DIAN (Directorate of National Taxes and Customs).

'''The Issuer or Taxpayer:''' Is a natural or legal person who has a unique and legal tax information record before the tax entity (NIT: Tax Identification Number) and is under the obligation to issue documents to support their business transactions. The issuer acquires the Billing System or ERP administrative software to simplify and enhance its work and uses it to interact with the electronic billing platform.

'''The Technological Provider:''' It is a private entity authorized by the DIAN to provide services related to the Electronic Invoicing scheme: XML construction, sequential control, signing, regulatory change control, processing, storage and consultation. The Factory HKA Colombia is your technology provider.

'''The Purchaser:''' Is the person who gives rise to a commercial transaction through the purchase of a product or service, and who finally chooses to receive his electronic document via email.

'''The Certification Authority:''' It is a public or private entity authorized by the Tax Entity to issue electronic certificates in accordance with the law and associated regulations. In Colombia, there are several authorities accredited to issue electronic certificates for electronic invoicing, including ANDES SCD.
{{clear}}
===Advantages of Electronic Billing===
The Electronic Billing scheme is advantageous because it is:
*Full: Guarantees that the information contained is protected and cannot be altered.
*Authentic: Allows you to verify the identity of the issuer of the document.
*Legal: This scheme is implemented and accepted under the framework of the Law.
*Convenient: Eliminates infrastructure for physical media handling, shipping, and storage, and enables printing.
*Eficiente: It is 100% based on an electronic platform, which makes handling, sending, searching and storing faster and more practical.
{{clear}}
===Electronic Billing Process with Prior Validation===

#The Acquirer originates a transaction through the purchase of a product or service.
#The Issuer or Taxpayer loads the data through the UI (User Interface) of its ERP.
#The Issuer or Taxpayer displays the available stamps in the UI of their ERP.
#The ERP builds the object and exposes it directly to the DFACTURE platform through the corresponding method of the Web Service.
#The Factory HKA platform – DFACTURE.
#*Validates the Taxpayer's access credentials.
#*It validates the structure of the object that the ERP sends.
#*Validates the content of the object sent by the ERP.
#*Assigns the CUFE (Unique Code of Electronic Invoice) to the document.
#*It builds the XML of the document according to the DIAN regulations.
#*Sign the document with the Digital Certificate of the Taxpayer.
#*Optional: Generate a printed representation in PDF according to DIAN regulations.
#*Stores information in Database (Conservation).
#*It sends the XML to the DIAN for validation.
#*Wait for response from DIAN with validation result.
#*Send the XML and PDF to the email provided by the Purchaser.
#*It responds to the request from the ERP indicating that the operation was successful.
#Optionally, the ERP can send the XML and PDF to the purchaser.
#Optionally, the ERP can download the XML and PDF files for internal purposes.
#The Purchaser receives the XML and the PDF (via email).
#The Acquirer has up to 72 hours to give Acknowledgment of Receipt of the document, after which it will be considered a tacit acceptance (this process has not yet been fully defined by the DIAN).
#The Issuer or Taxpayer displays the status of the acknowledgment of receipt of the Acquirer in the UI of their ERP.

; Electronic Billing Process with Prior Validation
[[Archivo:Proceso de Facturación Electrónica con Validación PreviaDIAN.png|Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)]]

'''@Important:''' For development environments with limitations to consume SOAP Web Services directly, The Factory HKA Colombia makes APIs available, simplifying this process for the integrator.
{{clear}}

<includeonly>=</includeonly>==Process characteristics with Prior Validation==<includeonly>=</includeonly>
#In an initial stage, for a single time, the issuer must register and the platform must be configured directly from The Factory HKA-Dinvoice portal.
#The platform operates under a commercial model of stamps or folios. The stamps correspond to a package of operations that the taxpayer contracts under a commercial agreement with The Factory HKA Colombia, and entitles him to a certain number of transactions. The ERP can consult the Web Service of THE FACTORY HKA – DFACTURE for the available stamps.
#For the document to be considered an electronic invoice, DIAN validation is required for its subsequent sending to the Acquirer by Dfactura.
#In the event that the document is not successfully valid before the DIAN, it must be corrected and reissued.
#The ERP can consume the Web Service to download XML and PDF if you want an alternative backup or offer offline query functionality.
#The ERP can optionally decide whether to send the XML and PDF to the Acquirer under its structure.
#The platform's Web Service offers the functionality of querying the Acknowledgment of Receipt status by the Acquirer. It is updated asynchronously.
#The Web Service of the platform offers the function of querying the status of the document by the DIAN. It is updated asynchronously.
#The ERP reflects in its UI the results of your queries and operations with the platform. However, the Issuer or Taxpayer can monitor or review their ERP by accessing The Factory HKA-Dfactura portal, since the operations carried out in the Web Service are reflected in the portal.

; Diagram of components and dependencies of the electronic billing system
[[Archivo:DIAGRAMA COMPONENTES.png|centro|DIAGRAMA COMPONENTES]]

The figure above shows the way in which the Billing Software (ERP) integrates and makes use of the electronic billing functionalities of The Factory HKA – DFACTURE platform, interacting with external elements (the issuer, the Acquirer and the DIAN) through the available dependencies, you can see the functions that each system must perform.
{{clear}}

<includeonly>=</includeonly>==Information security: recommendations on the implementation of electronic invoicing within the issuer's network and systems==<includeonly>=</includeonly>
This section provides recommendations on the implementation and integration of Electronic Invoicing in your organization and on the configuration of your Systems and networks to mitigate the risks of improper access to data by external parties to your organization.
===In General:===
# Have antivirus in your company.
# Have frequent backup policies and procedures, carried out in a period of execution that is consistent with the criticality of the business. To do this, take the following aspects into account:
#* Restoration tests should be performed..
#* They must be in an infrastructure other than the operating one (in the event of ransomware, all the accessed infrastructure will be compromised)
# If possible, look for security consultants and specialists and carry out ISO 27001:2013 audits to assess the quality of the decisions made in the implementation of electronic invoicing in your company.
# Avoid the use of generic users and/or Administrators in the organization and apply to each user the access control, permissions and roles that correspond to them according to their function.
===Individuals with The Factory HKA Colombia SAS:===
#Only allow access to TCP/UDP ports 80 and 443 to the domains indicated below:
#**.thefactoryhka.com.co
#*emisionrest21.thefactoryhka.com.co (Integration – Production)
#*invoice21.thefactoryhka.com.co (Portal – Production)
#*demoemisionrest21.thefactoryhka.com.co (Integration –Demo)
#*demofactura.thefactoryhka.com.co (Portal – Demo)
#Open access to these TCP/UDP ports to the entire internet is not recommended.
#In the electronic invoice model with The Factory HKA Colombia SAS, the requests arise from the client only, so they can establish rules from external connection attempts. (The communication will always be initiated by the client software.)
#If The Factory HKA Colombia SAS client software tools are used, such as:
#*intTFHKAFEL21.exe
#*AutoFact.exe
#:And they are seen as a risk by the antivirus system or client protection, an exception must be generated in the firewall, antivirus, and any other protection system solely and exclusively for them.
#The Company TOKEN and production TOKEN Password for the Electronic Invoicing Platform of The Factory HKA Colombia SAS must be kept confidential and only be accessible by trusted personnel.
#In the event that the issuer contracts a graphic representation service with the software house, or developer, in charge of making the corresponding adjustments in the accounting software or ERP for the issuance of electronic documents, the following aspects must be taken into account:
#*The Factory HKA is responsible for the generation of the UBL and its transmission to the DIAN.
#*Once the correct validation and generation of the UBL is verified, the software house can proceed to generate a graphic representation that must comply with:
#::The elements of law required by the DIAN: inclusion of the QR code and the CUFE or CUDE chain in the documents, as appropriate.
#::The elements of law required by any supervisory entity from the issuer of the documents.
#::The visual and brand representation elements required by the client: logos, banking information, legends referring to the tax responsibilities of the issuer, etc.
#*The Software House, in this scenario, assumes responsibility together with the taxpayer for any incident of fraud due to evasion, misinterpretation, error or omission of relevant and mandatory information by the regulations.
#:TFHKA does not protect this representation in its systems and makes it clear that its participation as a technology provider is limited to the generation of the UBL and its validation to the DIAN.
{{clear}}

<includeonly>=</includeonly>==Web services soap with prior validation==<includeonly>=</includeonly>
To consume the methods of the Web Service, it is essential to use the access credentials, made up of a Company Token and a Password Token., To consume the methods of the Web Service, the use of access credentials, made up of a Company Token and a Password Token, is essential. It will also be necessary to know the URL's of the Web Services of the integration environment with prior validation., It will also be necessary to know the URLs of the Web Services of the integration environment with previous validation. These elements will be provided by The Factory HKA Colombia Integration team.
'''@Important:''' This document refers to the integration process with prior validation, its technical and regulatory change controls and its differences with the web service with subsequent validation.

Below are the methods that will be available in THE FACTORY HKA-DFACTURE Web Services for electronic invoicing with prior validation:

{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Service
! style="background:#e9e9e9; text-align:center;"|Method
|- valign="center"
| Issue Web SOAP
|
* Enviar
* EstadoDocumento
* EnvioCorreo
* DescargaPDF
* DescargaXML
* FoliosRestantes
* CargarCertificado (Uso interno)
* DescargarEventoXML (Nuevo)
* GenerarContenedor (Nuevo)
* GenerarEvento (Nuevo)
|-
| Attached Web SOAP
|
*CargarAdjuntos
|-
|Reports Web SOAP (New)
|
* DescargarReporte
* ProgramarReporte
* SolicitudReporteSincrono
|}
{{clear}}

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-02-08T23:22:57Z

Lvargas:

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 
==Proceso tecnológico en el Sistema de Facturación Electrónica ==
''Habilitación''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
''Sujetos obligados ''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
''Suplemento C: Inconvenientes tecnológicos''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
''Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode''
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
''Tipos de operación Procedencia de Vendedor: cbc:CustomizationID''
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
''Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description''
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
''Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
''
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
''Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre''
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
''Tipo de organización jurídica (Personas): cbc:AdditionalAccountID''
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
''Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
 
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
 
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
 
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
 
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
 
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
 
 
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
 
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente ===
'''¿Qué es el documento soporte?'''
 
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 
==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
''Inconvenientes tecnológicos por parte de la DIAN''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
''Inconvenientes tecnológicos por parte del sujeto''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
 
 
 


 
<center>'''<big>¡Muchas Gracias!</big> Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|centro|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|centro|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|centro|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Archivo:TipoDocumento.png

2022-02-08T23:05:00Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:TipoDocumento2.png

2022-02-08T23:05:00Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Brave.png

2022-02-08T21:58:28Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Facebook.png

2022-02-08T21:58:28Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Instagram.png

2022-02-08T21:58:28Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Cambios Integración - Documento Soporte No Obligados Resolución 000167

2022-02-08T21:53:56Z

Lvargas:

<includeonly>=</includeonly>== Cambios Integración - Documento Soporte No Obligados Resolución 000167 ==<includeonly>=</includeonly>
 
En este articulo encontraras información sobre los Cambios incorporados en el Anexo técnico de Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente Versión 1.1.
 
<includeonly>=</includeonly>==Cambios incorporados en la versión 1.1 del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de ''venta'' o ''documento equivalente''==<includeonly>=</includeonly>
 
*Se incorpora la '''Nota de ajuste''' para el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente, con sus respectivas reglas de validación.
*Se modifica el cálculo del elemento UUID, para el cual se eliminaron los impuestos INC e ICA para la composición de la cadena.
*Se cambia el algoritmo utilizado para el cálculo del UUID, pasando de Código Único de Documento Electrónico - CUDE a Código Único de Documento Soporte – CUDS.
*Se actualiza la tabla de referencia para el elemento CityName.

==Cambios relevantes==
===Reglas con modificaciones en las validaciones===
'''ENTRE LAS CUALES SE DESTACAN:'''
# Se determina que el tipo de identificación para el prestador de servicios debe ser NIT.
# Cambio en el algoritmo para el cálculo del UUID.
# Validaciones correspondientes a la localización física del vendedor de acuerdo a su procedencia.
# Se determina que la identificación del vendedor puede no ser NIT dependiendo su procedencia.
# Se determina que la identificación del comprador debe ser NIT.
 
==Instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a Expedir factura de venta o documento equivalente==
 
A continuación, se describen los instrumentos que se derivan del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.
 
==Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (Invoic5)==
 
Es un documento electrónico que constituye el soporte de los costos y deducciones en el Impuesto sobre la Renta y Complementarios e impuestos descontables en el Impuesto sobre las Ventas -IVA, derivado de la adquisición de bienes y/o servicios a sujetos no obligados a expedir factura de venta o documento equivalente; el cual se deberá generar por parte del adquirente de los mencionados bienes y/o servicios, para su posterior transmisión para la validación de la DIAN.
 
==Nota de Ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente (CreditNote)==
 
Las notas de ajuste del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente, en lo sucesivo notas de ajuste, son documentos electrónicos o físicos según el caso, que constituyen el medio por el cual se realizan ajustes o se anula el documento soporte, por errores aritméticos o de contenido, cumpliendo las condiciones, términos, mecanismos técnicos y tecnológicos que para el efecto señale la DIAN.
 
==Registro de Respuesta a la Validación realizada por parte de la DIAN (ApplicationResponse)==
 
Es el procedimiento que genera el documento electrónico de validación por parte de la DIAN, que contiene la verificación de las reglas de validación de los documentos electrónicos, cumpliendo con los requisitos, términos, mecanismos técnicos y tecnológicos que para el efecto establezca la DIAN, en el Anexo Técnico respectivo.
 
==Nuevas Reglas de Validación==
*'''DSAJ08a:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el tipoOperacion es igual a '10'.
*'''DASJ08b:''' La clase dirección cliente deberá estar conformado al menos por el conjunto formado por los elementos ciudad, codigoDepartamento, departamento, direccion, lenguaje, municipio y pais. cuando el CustomizationID es igual a '11'.
*'''DSAJ10a:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '10'.
*'''DSAJ10b:''' Campo ciudad Debe ser un municipio de la República de Colombia cuando el tipoOperacion es igual a '11'.
*'''DSAJ25a:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '10' el tipoIdentificacion deberá ser '31'.
*'''DSAJ25b:''' Identificador del tipo de documento de identidad:''' Cuando el tipoOperacion es igual a '11' el tipoIdentificacion deberá ser '31'.
*'''VLR02:''' Valor total de la Nota de Ajuste es superior al valor del documento referenciado
*'''DSBH01:''' Se debe indicar el campo codigoInterno = 5 en la clase documentoReferenciado. Grupo de información exclusivo para referenciar la Nota de Ajuste que dio origen al presente DS
*'''DSBH03:''' Prefijo + Número de la nota de ajuste referenciada ID de la nota de ajuste de referencia no existe. Se debe indicar obligatoriamente el campo numeroDocumento en la clase documentoReferenciado
*'''DSBH04:''' CUDS de la nota de ajuste relacionada. CUDS de la nota de ajuste referenciada no existe. Se debe indicar obligatoriamente el campo cufeDocReferenciado.

*'''DSBH05:''' Algoritmo del CUDS
*'''DSBH06:''' Fecha de la Nota de Ajuste referenciada anterior a fecha del DS. Se debe indicar obligatoriamente el campo fecha.
 
==Proceso tecnológico en el Sistema de Facturación Electrónica ==
''Habilitación''
 
Los sujetos que se encuentren previamente habilitados como facturadores electrónicos, tendrán la opción de convalidar la información que hayan registrado en el procedimiento de habilitación del artículo 22 de la Resolución 000042 del 05 de mayo de 2020 o la norma que la modifique o sustituya.
 
Sin embargo, es importante tener en cuenta que el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente no requiere pruebas mínimas para surtir el proceso de habilitación conforme a la resolución anteriormente mencionada, el sistema de Factura Electrónica con Validación Previa entregará los insumos necesarios referentes a un SET de pruebas para quienes requieran realizar la generación, transmisión y validación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y la nota de ajuste en el ambiente de habilitación antes de enviarlo al ambiente de producción.
 
 
''Sujetos obligados ''
 
Corresponde a todos los sujetos que adquieren bienes y/o servicios a un proveedor no obligado a expedir factura de venta o documento equivalente y que son facturadores electrónicos habilitados, (en adelante ABS), que requieran documentar la transacción y tener el soporte fiscal de costos, deducciones, o impuestos descontables.
 
El ABS debe estar habilitado por la DIAN como FE para generar documento soporte, y deberá usar los rangos de numeración para estas operaciones, el cual se debe gestionar en el SIE de numeración o el sistema dispuesto por la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales DIAN, para tal fin.
 
 
''Suplemento C: Inconvenientes tecnológicos''
 
No se ha contemplado la generación del Documento Soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y sus notas de ajuste cuando existan Inconvenientes Tecnológicos Tipo 03 - Por parte del Facturador Electrónico ni Tipo 04 - Por parte de la DIAN; así pues, una vez se restablezcan los servicios se deberá hacer la transmisión del citado documento.
 
 
''Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 05
| Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
| 95
| Nota de ajuste al documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente
|-
|}
 
 
''Tipos de operación Procedencia de Vendedor: cbc:CustomizationID''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Valor
|- valign="center"
|-
| 10
| Residente
|-
| 11
| No residente
|-
|}
 
'''Nota:''' Conforme a la normativa vigente, debe tenerse en cuenta lo que se indica para el concepto de residente fiscal en Colombia y NO residente fiscal en Colombia.
 
''Forma de generación y transmisión:cbc: DescriptionCode; cbc: Description''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 1
| Por operación
|-
| 2
| Acumulado semanal
|-
|}
 
'''Nota:'''Forma de generación y transmisión de conformidad con lo establecido en los Artículo 2 y 10 de la Presente Resolución.
 
 
''Códigos para identificación fiscal Documento de identificación (Tipo de Identificador Fiscal): cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado SNO
! style="color:white;background:#2F5496; text-align:center;"|Residente
! style="color:white;background:#2F5496; text-align:center;"|No residente
|- valign="center"
|-
| 21
| Tarjeta de extranjería
|
! style=";background:#f8f9fa; text-align:center;"! style=";background:#f8f9fa; text-align:center;"|X
|-
| 22
| Cédula de extranjería
|
! style=";background:#f8f9fa; text-align:center;" color: |X
|-
|31
|NIT
! style=";background:#f8f9fa; text-align:center;"|X
! style=";background:#f8f9fa; text-align:center;"|X
|-
|41
|Pasaporte
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|42
|Documento de identificación extranjero
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|47
|PEP
|
! style=";background:#f8f9fa; text-align:center;"|X
|-
|50
|NIT de otro país
|
! style=";background:#f8f9fa; text-align:center;"|X
|}
 
 
''Tributos cac:TaxScheme/ID: Columna Identificador cac:TaxScheme/Name: Columna Nombre''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
| 01
| IVA
|Impuesto sobre las ventas
|-
| 05
| RetelIVA
| Retención sobre el IVA
|-
|06
| ReteRenta
|Retención sobre Renta
|}
 
''Tipo de organización jurídica (Personas): cbc:AdditionalAccountID''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Codigo
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 1
| Persona jurídica y asimiladas
|-
| 2
| Persona Natural y asimiladas
|-
|}
 
''Códigos para identificación fiscal Detalles Tributarios:Para el grupo PartyTaxScheme''
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
| 01
| IVA
|-
| ZZ
| No aplica*
|-
|}
 
'''Nota:''' Se utiliza en los casos donde el Vendedor no cuente con los detalles tributarios informados, aplica para personas jurídicas/personas naturales.
 
 
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Atributo
! style="color:white;background:#2F5496; text-align:center;"|TipoDato
|- valign="center"
|anticipos
|Array<Class.Anticipos>
|-
|autorizado
|Class.Autorizado
|-
|cantidadDecimales
|String
|-
|cargosDescuentos
|Array<Class.CargosDescuentos>
|-
|cliente
|Class.Cliente
|-
|condicionPago
|Array<Class.CondicionPago>
|-
|consecutivoDocumento
|String
|-
|detalleDeFactura
|Array<Class.FacturaDetalle>
|-
|documentoReferenciado
|Array<DocumentoReferenciado>
|-
|entregaMercancia
|Class.Entrega
|-
|extras
|Array<Class.Extras>
|-
|fechaEmision
|String
|-
|fechaFinPeriodoFacturacion
|String
|-
|fechaInicioPeriodoFacturacion
|String
|-
|fechaPagoImpuestos
|String
|-
|fechaVencimiento
|String
|-
|impuestosGenerales
|Array<Class.FacturaImpuestos>
|-
|impuestosTotales
|Array<Class.ImpuestosTotales>
|-
|informacionAdicional
|Array<String>
|-
|mediosDePago
|Array<Class.MediosDePago>
|-
|moneda
|String
|-
|ordenDeCompra
|Array<Class.OrdenDeCompra>
|-
|rangoNumeracion
|String
|-
|redondeoAplicado
|String
|-
|sectorSalud
|Class.SectorSalud
|-
|tasaDeCambio
|Array<Class.TasaDeCambio>
|-
|tasaDeCambioAlternativa
|Array<Class.TasaDeCambioAlternativa>
|-
|terminosEntrega
|Class.TerminosEntrega
|-
|tipoDocumento
|String
|-
|tipoOperacion
|String
|-
|tipoSector
|String
|-
|totalAnticipos
|String
|-
|totalBaseImponible
|String
|-
|totalBrutoConImpuestos
|String
|-
|totalCargosAplicados
|String
|-
|totalDescuentos
|String
|-
|totalMonto
|String
|-
|totalProductos
|String
|-
|totalSinImpuestos
|String
|-
|}
 
<includeonly>=</includeonly>== Para emitir documentos soporte en adquisiciones con sujetos no obligados a facturar electrónicamente, se deben tener en cuenta los siguientes aspectos: ==<includeonly>=</includeonly>
 
*1.La estructura '''SOAP''' del objeto '''FacturaGeneral''' a ser implementado en La versión 4 del servicio de ''emisión:''
[[Archivo:warning.png|800px|sinmarco|centro|Warning]]
 
*2.Se deberá indicar tipoDocumento = '05' correspondiente al documento Soporte con sujetos no obligados a facturar:
[[Archivo:tipoDocumento.png|800px|sinmarco|centro|TipoDocumento]]
[[Archivo:tipoDocumento2.png|800px|sinmarco|centro|TipoDocumento2]]
 
*3.Se deberá indicar tipoOperacion = ‘10’ u ‘11’ correspondiente a residente o no residente.
[[Archivo:tipoOperacion.png|800px|sinmarco|centro|TipoOperacion]]
[[Archivo:tipoOperacion2.png|800px|sinmarco|centro|TipoOperacion2]]
 
*4.La información del vendedor/proveedor (persona no obligada a facturar electrónicamente) será reportada en la clase Cliente del objetoFacturaGeneral.
Los atributos mínimos de esta clase a ser reportados son: 
detallesTributarios, nombreRazonSocial, numeroDocumento, numeroIdentificacionDV, responsabilidadesRut, tipoIdentificacion y tipoPersona.
[[Archivo:detallesTributarios.png|800px|sinmarco|centro|DetallesTributarios]]
[[Archivo:detallesTributarios2.png|800px|sinmarco|centro|DetallesTributarios2]]
 
*5.La emisión de estos documentos no admite su transmisión bajo un esquema de contingencia.
[[Archivo:contingencia.png|800px|sinmarco|centro|Contingencia]]
 
<includeonly>=</includeonly>==Información Complementaria==<includeonly>=</includeonly>
 
===Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente ===
'''¿Qué es el documento soporte?'''
 
Es el documento que usas para acreditar la compra de un ''bien'' o ''servicio'', y que debe generar el comprador cuando hace transacciones con un proveedor que no está obligado a expedir factura de venta o documento equivalente.
 
 
'''¿Cuándo se usa?'''
 
Lo expides como comprador para documentar la transacción que da lugar a ''costos, deducciones'' o ''impuestos descontables'', por medio de un documento con numeración autorizada por la '''DIAN''', cuando el vendedor o prestador del servicio no está obligado a facturar.
 
 
'''¿Quiénes lo deben emitir?'''
 
Lo emites si eres comprador del bien o el servicio.
 
 
'''¿Para qué se emite?'''
 
Si como ''vendedor del bien'' o ''prestador del servicio'' no tienes obligación de expedir factura de venta, el comprador podrá generar el '''Documento soporte''' en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente para documentar la transacción, contabilizarla y si es del caso, soportar costos, deducciones, o impuestos descontables.
 
 
'''¿Quiénes están obligados a expedirlo?'''
 
Estás obligado si adquieres un bien o servicio cuando haces compras o adquieres servicios a un proveedor no obligado a expedir factura de venta, para que puedas documentar la transacción y tener el soporte de ''costos, deducciones'', o ''impuestos descontables'', para tus declaraciones tributarias.
 
 
'''¿Qué beneficios tiene?'''
 
Te permite documentar las operaciones cuando se realizan con proveedores no obligados a emitir factura o documento equivalente. Así soportas adecuadamente ''costos, deducciones,'' o ''impuestos descontables'' en estas adquisiciones.
 
 
'''¿Cuáles son los requisitos?'''
 
Según lo indicado en la '''Resolución 000167 de 2021''' los requisitos son:
 
# Estar denominado expresamente como “Documento soporte en adquisiciones efectuadas a no obligados a facturar".
# Tener la fecha de la operación que debe corresponder a la fecha de generación del documento.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria (NIT) del vendedor o de quien presta el servicio. Tratándose de contratos suscritos con los no residentes fiscales en Colombia no inscritos en el Registro Único Tributario -RUT, el requisito del Número de Identificación Tributaria NIT, se entenderá cumplido con la identificación otorgada en el país de origen del no residente.
# Contener los apellidos y nombre o razón social y Número de Identificación Tributaria -NIT del adquiriente de los bienes y/o servicios.
# Llevar el número que corresponda a un sistema de numeración consecutiva de documento soporte incluyendo el número, rango y vigencia autorizado por la DIAN.
# Tener la descripción específica del bien o del servicio prestado.
# Detallar el valor total de la operación.
# Incluir la firma del emisor del documento soporte al momento de la generación, de acuerdo con las normas vigentes y con la política de firma que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas – DIAN.
# Utilizar el formato electrónico de generación que establezca la Unidad Administrativa Especial Dirección de Impuestos y Aduanas Nacionales - DIAN.
# El Código único de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente - CUDS.
 
'''¿Desde cuándo se debe emitir y exigir el documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente?'''
 
La generación y transmisión de forma electrónica del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente y las notas de ajuste, deberán implementarse a más tardar el '''dos (2) de mayo de 2022.'''
 
 
==Transmisión para la validación ante la DIAN==
 
===Deberá transmitirse para validación de la ''Unidad Administrativa Especial Dirección de Impuestos'' y ''Aduanas Nacionales'' -DIAN, así:===
 
#En el momento en que se lleve a cabo cada una de las operaciones en las que se adquieran bienes y/o servicios a sujetos no obligados a expedir factura o documento equivalente.
#A más tardar el último día hábil de la semana en la que se llevaron a cabo las operaciones acumuladas semanalmente, que se realicen con un mismo proveedor en las que se adquieran bienes y/o servicios con sujetos no obligados a expedir factura o documento equivalente.
 
'''¿Qué hacer si se presentan inconvenientes tecnológicos?'''
 
''Inconvenientes tecnológicos por parte de la DIAN''
 
Si al momento de la transmisión de la información del documento soporte y las notas de ajuste, se presentan inconvenientes tecnológicos que impiden la transmisión de la información para la validación, el sujeto dispone de un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente al que se restablezca el servicio informático electrónico.
 
 
''Inconvenientes tecnológicos por parte del sujeto''
 
Si se presentan inconvenientes tecnológicos por parte del sujeto, que impiden la transmisión de la información, este deberá transmitir los citados documentos en un plazo máximo de cuarenta y ocho (48) horas, contadas a partir del día siguiente en que se supere el inconveniente tecnológico, dejando los soportes del inconveniente presentado, para cuando la administración tributaria los requiera.
 
==<big>HKA TIPS</big>==
 
'''¿Cómo sé si el documento electrónico fue entregado a mi adquiriente?'''
 
* A través del portal web exponemos la trazabilidad de entregas de cada documento en la sección de ''Historial de Entregas asociada'' a los Detalles de cada documento:
 
[[Archivo:adquiriente.png|800px|sinmarco|centro|Adquiriente]]
 
*Si eres una casa de software aliada o desarrollador de un sistema contable y deseas incluir dicha información como una funcionalidad dentro del sistema, la información referente al Historial de Entregas se expone en el Response del método '''EstadoDocumento''' del Servicio Web de Emisión:
 
<center>'''Método “EstadoDocumento” REQUEST: Parámetros a enviar'''</center>
 
[[Archivo:descripcion.png|800px|sinmarco|centro|Descripcion]]
 
<center>'''Método “RESPONSE: Parámetros a recibir'''</center>
 
[[Archivo:array.png|800px|sinmarco|centro|Array]]
 
<center>'''Class.HistorialDeEntregas''' corresponderá a:</center>
 
[[Archivo:entregas.png|800px|sinmarco|centro|Entregas]]
 
'''¿Cómo puedo conocer la cantidad de folios disponibles?'''
 
*Si eres una casa de software aliada o desarrollador de un sistema contable y deseas incluir dicha información como una funcionalidad dentro del sistema, a través del método '''FoliosRestantes''' puedes conocer la cantidad de folios que cada contribuyente dispone para realizar emisiones:
 
<center>'''Método “FoliosRestantes”''' Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.</center>
 
<center>'''REQUEST: Parámetros a enviar'''</center>
 
[[Archivo:string.png|800px|sinmarco|centro|String]]
 
<center>'''RESPONSE: Parámetros a recibir'''</center>
 
[[Archivo:folios.png|800px|sinmarco|centro|Folios]]
 
'''Para una emisión con adjuntos, ¿cómo puedo conocer si se culminó la sincronización de los mismos de manera satisfactoria?'''
 
*Al realizar la consulta del método EstadoDocumento del Servicio Web de Emisión, se expone en el Response el atributo '''poseeAdjuntos''' de tipo ''boolean'', el cual indica si el ciclo de sincronización de adjuntos se encuentra completo:
 
<center>'''RESPONSE: Parámetros a recibir'''</center>
 
[[Archivo:recibir.png|800px|sinmarco|centro|Recibir]]
 
<center>'''poseeAdjuntos:''' '''True:''' Cuando se sincroniza un adjunto con Enviar = ‘1’ '''False:''' Cuando se sincroniza un adjunto con Enviar = ‘0’</center>
 
[[Archivo:adjunto.png|800px|sinmarco|centro|Adjunto]]
 
'''¿Qué debo realizar al recibir un código de respuesta con error?'''
 
*Al obtener un código de error ('''código 99''') con un mensaje de rechazo asociado al mismo, se recomienda validar inicialmente las causas por las cuales se presenta dicho inconveniente. Ante estos escenarios es necesario conocer cuales son las reglas de validación que el documento no supera con el fin de solventar el inconveniente, estas validaciones pueden presentarse en los siguientes ''array'' de ''strings'' en el Response del método Enviar:
 
<center>'''RESPONSE: Parámetros a recibir'''</center>
 
[[Archivo:int.png|800px|sinmarco|centro|Int]]
 
''' ¿Qué debo realizar ante la regla de validación FAJ71?'''
 
*En Resolución 0012 de 2021 liberado por la DIAN, se ha entregado el Anexo Técnico 1.8, el cual contiene nuevas validaciones y exigencias en las validaciones de Facturación eléctrica que empezarán a regir en las próximas semanas.
 
La Regla '''FAJ71''' del Anexo 1.8 obliga a que el emisor de la factura identifique en la facturación electrónica el "Correo de Recepción" que ha configurado en el portal de la DIAN. En caso de no identificarse este correo la DIAN Rechazara la factura.
 
Por lo anterior, el cliente debe configurar el correo para recepción de facturas en el portal de la DIAN, dado que el motivo del rechazo es la regla FAJ71.
 
En el siguiente enlace se explica cómo registrarlo: [https://felcowiki.thefactoryhka.com.co/index.php/Configuración_-_Portal_DFactura_Validación_Previa#Configurar_Correo_Recepci.C3.B3n_DIAN Configurar Correo Recepción.]
 
[[Archivo:dian.png|800px|sinmarco|centro|Dian]]
 
 
<center>'''¡Muchas Gracias! Carrera 69 Q # 78-86, Bodega 20, Bogotá – Colombia, Teléfono: +57 (1) 746.08.12''' [[Archivo:facebook.png|30px|sinmarco|izquierda|Facebook]]THEFACTORYHKACO [[Archivo:instagram.png|30px|sinmarco|izquierda|Instagram]]@THEFACTORYHKACO 
[[Archivo:brave.png|30px|sinmarco|izquierda|Brave]]THE FACTORY HKA COLOMBIA [http://WWW.THEFACTORYHKA.COM/CO WWW.THEFACTORYHKA.COM/CO]</center>

Archivo:Adquiriente.png

2022-02-08T20:53:22Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Página principal

2022-02-08T17:48:04Z

Lvargas:

[[Archivo:Tfhka-co.png|sinmarco|derecha]]
Bienvenido a la FELCOWiki, acá podrá encontrar información sobre nuestros proceso, preguntas frecuentes y manuales útiles para completar sus procesos de Facturación Electrónica.

Puede hacer uso del panel izquierdo para navegar a páginas como el Pasos que debe seguir para facturar electrónicamente, el Manual de Usuario Portal DFactura, Manual de usuario del Portal de DRecepción, la Guía de Habilitación ante la DIAN y la sección de Preguntas Frecuentes, también puede hacer uso de la barra superior de búsqueda para buscar el error que está presentando.
 
<big>Articulos de Interes:</big>


* [[Pasos que debe seguir para facturar electrónicamente]]
 
[[File:HKAFactura 3.png|200px]]
 
:* [[Indice del Manual de Usuario Portal DFactura|Manual de Usuario Portal HKA Factura]]
:* [[Habilitación como facturador electrónico en el portal de la DIAN (Validación Previa)]]
:* [[Preguntas Frecuentes HKAFactura]]
:* [[Índice del Manual de Integración Directa|Manual de Integración Directa HKA Factura]]
:* [[Emisión - Generar Comprobante Sector Salud - Portal DFactura Validación Previa]]
 
[[File:HKANomina 3.png|200px]]
 
:* [[Indice del Manual de Usuario Portal HKANómina|Manual de Usuario Portal HKA Nómina]]
:* [[Habilitación Nomina Electrónica- Indice Manual Integración Nómina Electrónica|Habilitación Nomina Electrónica]]
:* [[Preguntas Frecuentes HKANómina|Preguntas Frecuentes HKA Nómina]]
:* [[Índice del Manual de Integración Nómina Electrónica|Manual de Integración Nómina Electrónica]]
 
[[File:HKARecepcion 3.png|260px]]
 
:* [[Indice del Manual de Usuario Portal DRecepción|Manual de Usuario Portal HKA Recepción]]
:* [[Preguntas Frecuentes HKARecepcion]]
 

[[File:Integracion.jpg|100px]]
:*<big> '''[[Sección para clientes de Integración]]'''</big>

Página principal

2022-02-08T17:08:16Z

Lvargas:

[[Archivo:Tfhka-co.png|sinmarco|derecha]]
Bienvenido a la FELCOWiki, acá podrá encontrar información sobre nuestros proceso, preguntas frecuentes y manuales útiles para completar sus procesos de Facturación Electrónica.

Puede hacer uso del panel izquierdo para navegar a páginas como el Pasos que debe seguir para facturar electrónicamente, el Manual de Usuario Portal DFactura, Manual de usuario del Portal de DRecepción, la Guía de Habilitación ante la DIAN y la sección de Preguntas Frecuentes, también puede hacer uso de la barra superior de búsqueda para buscar el error que está presentando.
 
<big>Articulos de Interes:</big>


* [[Pasos que debe seguir para facturar electrónicamente]]
 
[[File:HKAFactura 3.png|200px]]
 
:* [[Indice del Manual de Usuario Portal DFactura|Manual de Usuario Portal HKA Factura]]
:* [[Habilitación como facturador electrónico en el portal de la DIAN (Validación Previa)]]
:* [[Preguntas Frecuentes HKAFactura]]
:* [[Índice del Manual de Integración Directa|Manual de Integración Directa HKA Factura]]
:* [[Emisión - Generar Comprobante Sector Salud - Portal DFactura Validación Previa]]
 
[[File:HKANomina 3.png|200px]]
 
:* [[Indice del Manual de Usuario Portal HKANómina|Manual de Usuario Portal HKA Nómina]]
:* [[Habilitación Nomina Electrónica- Indice Manual Integración Nómina Electrónica|Habilitación Nomina Electrónica]]
:* [[Preguntas Frecuentes HKANómina|Preguntas Frecuentes HKA Nómina]]
:* [[Índice del Manual de Integración Nómina Electrónica|Manual de Integración Nómina Electrónica]]
 
[[File:HKARecepcion 3.png|260px]]
 
:* [[Indice del Manual de Usuario Portal DRecepción|Manual de Usuario Portal HKA Recepción]]
:* [[Preguntas Frecuentes HKARecepcion]]
 

[[File:Integracion.jpg|200px]]
:* '''[[Sección para clientes de Integración]]'''

Archivo:Integracion.jpg

2022-02-08T17:07:14Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:DetallesTributarios.png

2022-02-08T01:03:27Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:DetallesTributarios2.png

2022-02-08T01:03:27Z

Lvargas: Archivo subido con MsUpload

Archivo subido con MsUpload