Diferencia entre revisiones de «Manual de usuario LAYOUT ARCHIVO PLANO»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
Línea 2592: Línea 2592:
 
|-
 
|-
 
|20
 
|20
 +
|Extensible1.valor
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Valor del campo a agregar
 +
: '''PATH''': Variable
 +
|-
 +
|}
 +
<br>
 +
===Documentos Referenciados -> (Identificador 02E)===
 +
<br />
 +
Contiene 16 campos y 15 pipes (|):
 +
<center><pre>Identificador|codigoEstatusDocumento|codigoInterno|cufeDocReferenciado|descripcion|fecha|fechaFinValidez|fechaInicioValidez|numeroDocumento|tipoCUFE|tipoDocumento|tipoDocumentoCodigo|Extensible1.controlInterno1|Extensible1.controlInterno2| Extensible1.nombre|Extensible1.valor</pre></center>
 +
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Id_Campo
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|1
 +
|Identificador
 +
|<nowiki>AN|3</nowiki>
 +
|C/C
 +
|
 +
: Identificador de línea (Repetible). Valor fijo: “02E”
 +
:'''Obligatorio''': En facturas tipoDocumento contingencia (AdditionalDocumentReference),
 +
en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
 +
: '''PATH''': No Aplica
 +
|-
 +
|2
 +
|codigoEstatusDocumento
 +
| <nowiki> - </nowiki>
 +
|C/C
 +
|
 +
: Código o motivo del Documento
 +
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a algún de los valores de    [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]] y  [[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
 +
|-
 +
|3
 +
|codigoInterno
 +
|<nowiki>AN|1</nowiki>
 +
|SI
 +
|
 +
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
 +
# 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)
 +
|-
 +
|4
 +
|cufeDocReferenciado
 +
|<nowiki>AN|..90</nowiki>
 +
|C/C
 +
|
 +
: CUFE o CUDE del documento referenciado
 +
: '''Obligatorio''' Cuando codigoInterno sea ‘5’
 +
: '''Obligatorio''' En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
 +
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
 +
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si CUFE o CUDE no existe en la DIAN
 +
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
 +
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
 +
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
 +
|-
 +
|5
 +
|descripcion
 +
|<nowiki>AN|20..5000</nowiki>
 +
|C/C
 +
|
 +
: Descripción de la naturaleza de la corrección
 +
: '''Obligatorio''' Cuando codigoInterno sea ‘4’
 +
: '''PATH''': ../cac:DiscrepancyResponse/cbc:Description
 +
|-
 +
|6
 +
|fecha
 +
|<nowiki>AN|10</nowiki>
 +
|C/C
 +
|
 +
: Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
 +
: '''Obligatorio''' Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si fecha es posterior a la del documento referenciado
 +
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
 +
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
 +
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
 +
: /cbc:IssueDate
 +
|-
 +
|7
 +
|fechaFinValidez
 +
|<nowiki>AN|10</nowiki>
 +
|NO
 +
|
 +
: Fecha de Fin de Validez
 +
: '''PATH''': No definido
 +
|-
 +
|8
 +
|fechaInicioValidez
 +
|<nowiki>AN|10</nowiki>
 +
|NO
 +
|
 +
: Fecha de Inicio de Validez
 +
: '''PATH''': No definido
 +
|-
 +
|9
 +
|numeroDocumento
 +
|<nowiki>AN..20</nowiki>
 +
|SI
 +
|
 +
: Concatenación del prefijo y el número del documento referenciado
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
 +
: '''PATH''':
 +
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
 +
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
 +
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
 +
: /cbc:ID
 +
|-
 +
|10
 +
|tipoCUFE
 +
|<nowiki>AN|..11</nowiki>
 +
|C/C
 +
|
 +
: Algoritmo del tipo de CUFE.
 +
: “CUFE-SHA384” ó “CUDE-SHA384”
 +
: '''Obligatorio''' Cuando codigoInterno sea ‘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
 +
|-
 +
|11
 +
|tipoDocumento
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Descripción del tipo de documento referenciado,
 +
: Ejemplo: “Factura de Venta Nacional”
 +
: '''PATH''': No definido
 +
|-
 +
|12
 +
|tipoDocumentoCodigo
 +
|<nowiki>AN|2</nowiki>
 +
|C/C
 +
|
 +
: Identificador del tipo de documento referenciado.
 +
: '''Obligatorio''' Cuando codigoInterno sea ‘1’ 
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
 +
: '''PATH''': No definido
 +
|-
 +
|13
 +
|Extensible1.controlInterno1
 +
|<nowiki>AN|100</nowiki>
 +
|NO
 +
|
 +
: Etiqueta asignada para la Representación Impresa PDF.
 +
: '''PATH''': Variable
 +
|-
 +
|14
 +
|Extensible1.controlInterno2
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Permite asociar dos o más campos mediante un índice (si
 +
los campos son asociables)
 +
: '''PATH''': Variable
 +
|-
 +
|15
 +
|Extensible1.nombre
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Código del campo extensible a referenciar
 +
: '''PATH''': Variable
 +
|-
 +
|26
 +
|Extensible1.valor
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Valor del campo a agregar
 +
: '''PATH''': Variable
 +
|-
 +
|}
 +
<font color="red">'''@IMPORTANTE:'''</font>
 +
 +
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
 +
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento,  ransferênc.
 +
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
 +
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
 +
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''
 +
<br>
 +
===Entrega de Mercancía (Delivery) -> (Identificador 02F)===
 +
<br />
 +
Contiene 11 campos y 10 pipes (|): 
 +
<center><pre>Identificador|fechaEfectivaSalida|fechaEstimada|fechaReal|fechaSolicitada|identificacionTransporte|matriculaTransporte|Extensible1.controlInterno1|Extensible1.controlInterno2| Extensible1.nombre|Extensible1.valor</pre></center>
 +
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Id_Campo
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|1
 +
|Identificador
 +
|<nowiki>AN|3</nowiki>
 +
|NO
 +
|
 +
: Identificador de línea (Repetible). Valor fijo: “02F”
 +
: '''PATH''': No Aplica
 +
|-
 +
|2
 +
|fechaEfectivaSalida
 +
|<nowiki>AN|19</nowiki>
 +
|NO
 +
|
 +
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha efectiva de salida es anterior a la fecha de emisión
 +
: '''PATH''': ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
 +
|-
 +
|3
 +
|fechaEstimada
 +
|<nowiki>AN|19</nowiki>
 +
|NO
 +
|
 +
: Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha estimada es anterior a la fecha de emisión
 +
: '''PATH''': ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
 +
|-
 +
|4
 +
|fechaReal
 +
|<nowiki>AN|19</nowiki>
 +
|NO
 +
|
 +
: Fecha real, en formato: YYYY-MM-DD HH:MM:SS
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha real es anterior a la fecha de emisión
 +
: '''PATH''': ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
 +
|-
 +
|5
 +
|fechaSolicitada
 +
|<nowiki>AN|19</nowiki>
 +
|NO
 +
|
 +
: Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si la fecha solicitada es anterior a la fecha de emisión
 +
: '''PATH''': ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
 +
|-
 +
|6
 +
|identificacionTransporte
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Datos del Transporte
 +
: '''PATH''': ../cac:Despatch/cbc:ID
 +
|-
 +
|7
 +
|fechaFinValidez
 +
|<nowiki>AN|10</nowiki>
 +
|NO
 +
|
 +
: Fecha de Fin de Validez
 +
: '''PATH''': No definido
 +
|-
 +
|8
 +
|matriculaTransporte
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Matricula del Transporte
 +
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
 +
|-
 +
|9
 +
|Extensible1.controlInterno1
 +
|<nowiki>AN|100</nowiki>
 +
|NO
 +
|
 +
: Etiqueta asignada para la Representación Impresa PDF.
 +
: '''PATH''': Variable
 +
|-
 +
|10
 +
|Extensible1.controlInterno2
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Permite asociar dos o más campos mediante un índice (si
 +
los campos son asociables)
 +
: '''PATH''': Variable
 +
|-
 +
|11
 +
|Extensible1.nombre
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Código del campo extensible a referenciar
 +
: '''PATH''': Variable
 +
|-
 +
|}
 +
<br>
 +
=== Datos del Transportista (Delivery) -> (Identificador 02F1))===
 +
<br>
 +
Contiene 22 campos y 21 pipes (|): 
 +
<center><pre>Identificador|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>
 +
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Id_Campo
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|1
 +
|Identificador
 +
|<nowiki>AN|4</nowiki>
 +
|NO
 +
|
 +
: Identificador de línea. Valor fijo: “02F1”
 +
: '''PATH''': No Aplica
 +
|-
 +
|2
 +
|email
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Correo Electrónico
 +
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
 +
|-
 +
|3
 +
|indicadordeAtencion
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Indicador si es información  sobre “para la atención de” (FAO)
 +
: '''PATH''': ../cbc:MarkAttentionIndicator
 +
|-
 +
|4
 +
|indicadordeCuidado
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Indicador si es información sobre alguien responsable por los bienes
 +
: '''PATH''': ../cbc:MarkCareIndicator
 +
|-
 +
|5
 +
|nombreContacto
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Nombre de Contacto
 +
: '''PATH''': .. /cac:Contact/cbc:Name
 +
|-
 +
|6
 +
|nombreResponsableEntrega
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Nombre del Responsable de la Entrega
 +
: '''PATH''': ../cac:PartyName/cbc:Name
 +
|-
 +
|7
 +
|nota
 +
| -
 +
|NO
 +
|
 +
: Nota de Contacto
 +
: '''PATH''': ../cac:Contact/cbc:Note
 +
|-
 +
|8
 +
|numeroIdentificacion
 +
|<nowiki>AN|…12</nowiki>
 +
|NO
 +
|
 +
: NIT del transportista
 +
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
 +
|-
 +
|9
 +
|numeroIdentificacionDV
 +
|<nowiki>N|..2</nowiki>
 +
|NO
 +
|
 +
: Digito Verificador
 +
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
 +
|-
 +
|10
 +
|numeroMatriculaMercantil
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Número de matrícula mercantil
 +
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
 +
|-
 +
|11
 +
|prefijoFacturacion
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Prefijo de facturación del Transportista
 +
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
 +
|-
 +
|12
 +
|telefax
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Telefax de transportista
 +
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
 +
|-
 +
|13
 +
|telefono
 +
|<nowiki>AN|..20</nowiki>
 +
|NO
 +
|
 +
: Teléfono de transportista
 +
: '''PATH''': ../cac:Contact/cbc:Telefax
 +
|-
 +
|14
 +
|tipoIdentificacion
 +
|<nowiki>N|2</nowiki>
 +
|NO
 +
|
 +
: Tipo de Identificación del Transportista
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>  Si el contenido de este atributo no corresponde a uno de los valores de la en  [[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
 +
|-
 +
|15
 +
|transportadorNombre
 +
|<nowiki>AN|..50</nowiki>
 +
|NO
 +
|
 +
: Nombre del transportador
 +
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
 +
|-
 +
|16
 +
|transportadorNumeroDocumento
 +
|<nowiki>AN|..12</nowiki>
 +
|NO
 +
|
 +
: Numero documento del transportador
 +
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
 +
|-
 +
|17
 +
|transportadorNumeroDocumentoDV
 +
|<nowiki>AN|..2</nowiki>
 +
|NO
 +
|
 +
: Digito Verificador del NIT del transportador
 +
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
 +
|-
 +
|18
 +
|transportadorTipoIdentificacion
 +
|<nowiki>N|2</nowiki>
 +
|NO
 +
|
 +
: Tipo documento del transportador
 +
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
 +
|-
 +
|19
 +
|Extensible1.controlInterno1
 +
|<nowiki>AN|100</nowiki>
 +
|NO
 +
|
 +
: Etiqueta asignada para la Representación Impresa PDF.
 +
: '''PATH''': Variable
 +
|-
 +
|20
 +
|Extensible1.controlInterno2
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Permite asociar dos o más campos mediante un índice (si
 +
los campos son asociables)
 +
: '''PATH''': Variable
 +
|-
 +
|21
 +
|Extensible1.nombre
 +
|Depende del Campo
 +
|NO
 +
|
 +
:Código del campo extensible a referenciar
 +
: '''PATH''': Variable
 +
|22
 
|Extensible1.valor
 
|Extensible1.valor
 
|Depende del Campo
 
|Depende del Campo

Revisión del 21:42 14 ene 2022

Historial de Versiones


Versión Fecha lanzamiento Descripción
1.0 20/06/19 Versión Inicial 1.0
1.1 08/07/19 Actualización del Objeto
1.2 18/07/19 Modificación Línea 02K Orden de Compra
1.3 29/07/19 Cambio en Id Destinatario (obligatoriedad) y ajustes menores
1.4 04/2020 Actualizaciones en base al Anexo Técnico 1.8, extras, tablas de códigos, cambio del nombre del documento, entre otros.
1.5 05/2021 Actualizaciones en base al Anexo Técnico V1.8 de la Resolución 000012. Campos Sector Salud. Tablas de códigos.


Cómo obtener soporte


  • Soporte de 1er nivel:
Soporte telefónico / email / chat o tele-conferencias en horario 5x8 para atención de consultas y fallas de usuario.
  • Soporte de 2do nivel:
Soporte resolución remota de incidencias en el sistema en horario 5x8
Escriba a soporte@thefactoryhka.com.co


Para consultas referente a configuraciones y errores en el Portal:
  • soporte_fel_co@thefactoryhka.com
Para consultas referente a configuraciones de ERP, casa de software e integración:
  • integracion_fel_co@thefactoryhka.com


Lineas de atención telefónica:

  • MASTER +57 (1) 746.08.12
  • +57 (1) 508.8990
  • +57 (1) 517.6795
  • +57 (1) 517.6796
  • +57 (1) 311.3063
    • Soporte Técnico → Opción 2
    • Integración → Opción 5 Luego Opción 1


Descripción General


En éste documento está orientado a la descripción del layout del archivo de texto plano (.txt), el cual es utilizado en los modelos de integración a través de algunas de las siguientes herramientas:

  • Conector Indirecto HKA AutoFact (Versión TXT)
  • API para integración directa IntTfhkaFel

Esquema de operación de la factura electrónica con validación previa


¿Qué es la Facturación Electrónica con Validación Previa?


La Facturación Electrónica (FEL) es un esquema de operación que permite emitir documentos de respaldo de las operaciones comerciales entre contribuyentes en formato digital en lugar de papel, permite la aplicación de control fiscal durante el proceso, y tiene validez legal para el ente tributario designado por el gobierno del país.

A partir de septiembre de 2019, se tiene previsto que una factura electrónica solo será válida cuando se haya validado previamente su contenido a través de la DIAN o a través de un proveedor autorizado por la administración de impuestos.

La validación previa se encuentra establecida en la ley 1943 de 2018, conocida como Ley de Financiamiento. El artículo 16 de esta Ley modifica el artículo 616-1 del Estatuto Tributario, en su parágrafo primero consagra que:

“Todas las facturas electrónicas para su reconocimiento tributario deberán ser validadas previo a su expedición, por la DIAN o por un proveedor autorizado por esta. La factura electrónica solo se entenderá expedida cuando sea validad y entregada al adquiriente. (…)”

En el modelo de facturación electrónica con validación previa se utilizarán 5 tipos de documentos:

  • Invoice (Factura)
  • CreditNote (Nota Crédito)
  • DebitNote (Nota Débito)
  • ApplicationResponse (Evento): Ocurrencia relacionada con un Documento Electrónico, generada por una persona o entidad relacionada con el documento (DIAN, Emisor, Adquiriente), este documento también contiene una firma electrónica.
  • 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.


¿Quiénes participan en este esquema?


El Ente Tributario (DIAN): Es una institución pública, nombrada por el gobierno para recaudar, controlar y regular todo lo relacionado con los tributos. Es el que tiene el derecho de aceptar y autorizar un documento electrónico. En Colombia, es la DIAN (Dirección de Impuestos y Aduanas Nacionales).

El Emisor o Contribuyente: Es una persona natural o jurídica que posee un registro de información fiscal único y legal ante el ente tributario (NIT: Número de Identificación Tributario) y está bajo la obligación de emitir documentos para respaldar sus transacciones comerciales. El emisor adquiere el Sistema de Facturación o Software administrativo ERP para simplificar y potenciar sus labores y hace uso de él para interactuar con la plataforma de facturación electrónica.

El Proveedor Tecnológico: Es un ente privado autorizado por la DIAN para prestar servicios relacionados con el esquema de Facturación Electrónica: construcción del XML, control de secuenciales, firmado, control de cambio normativo, procesamiento, almacenamiento y consulta. The Factory HKA Colombia es su proveedor tecnológico.

El Adquiriente: Es la persona que da origen a una transacción comercial mediante la compra de un producto o servicio, y que finalmente, opta por recibir su documento electrónico vía email.

La Autoridad de Certificación: Es un ente público o privado habilitado por el Ente Tributario para expedir certificados electrónicos conforme a la ley y a las normas asociadas. En Colombia, hay varias autoridades acreditadas para expedir certificados electrónicos para facturación electrónica, entre ellas ANDES SCD.


Ventajas de la Facturación Electrónica


El esquema de Facturación Electrónica es ventajoso porque es:

  • Íntegro: Garantiza que la información contenida está protegida y no puede ser alterada.
  • Auténtico: Permite verificar la identidad del emisor del documento.
  • Legal: Este esquema está implementado y aceptado bajo el marco de la Ley.
  • Práctico: Elimina la infraestructura para el manejo, envío y almacenamiento de soportes físicos, y permite la impresión.
  • Eficiente: Se basa 100% en plataforma electrónica, lo cual hace que el manejo, envío, búsqueda y almacenamiento sea más rápido y práctico.


Proceso de la Facturación Electrónica con Validación Previa


  1. El Adquiriente da origen a una transacción mediante la compra de un producto o servicio.
  2. El Emisor o Contribuyente carga los datos mediante la UI (User Interface) de su ERP.
  3. El Emisor o Contribuyente visualiza los timbres disponibles en la UI de su ERP.
  4. El ERP construye el objeto y lo expone directamente a la plataforma DFACTURE mediante el método correspondiente del Web Service.
  5. La plataforma The Factory HKA – DFACTURE:
    • Valida las credenciales de acceso del Contribuyente.
    • Valida la estructura del objeto que envía el ERP.
    • Valida el contenido del objeto que envía el ERP.
    • Asigna el CUFE (Código único de Factura Electrónica) al documento.
    • Construye el XML del documento según normativa DIAN.
    • Firma el documento con el Certificado Digital del Contribuyente.
    • Opcional: Genera una representación impresa en PDF según normativa DIAN.
    • Almacena la información en Base de Datos (Conservación).
    • Envía el XML a la DIAN para validación.
    • Espera respuesta de la DIAN con resultado de la validación.
    • Envía el XML y PDF al email proporcionado por el Adquiriente.
    • Responde a la solicitud del ERP indicando que la operación fue satisfactoria.
  6. Opcionalmente, el ERP puede enviar el XML y PDF al adquiriente.
  7. Opcionalmente, el ERP puede descargar el XML y PDF para propósito interno.
  8. El Adquiriente recibe el XML y el PDF (vía email).
  9. El Adquiriente tiene hasta 72 horas para dar Acuse de Recibo del documento, después de lo cual se considerará una aceptación tácita (este proceso aún no está definido totalmente por la DIAN).
  10. El Emisor o Contribuyente visualiza el estatus del acuse de recibo del Adquiriente en la UI de su ERP.


Proceso de Facturación Electrónica con Validación Previa
Proceso de Facturación Electrónica con Validación Previa (Fuente: DIAN)

@Importante: Para ambientes de desarrollo con limitaciones para consumir Web Services SOAP de manera directa, The Factory HKA Colombia pone a disposición API’s simplificando al integrador éste proceso.


Características del proceso con Validación Previa


  1. En una etapa inicial, por única vez, el emisor debe registrarse y la plataforma debe ser configurada directamente desde el portal The Factory HKA-Dfactura.
  2. La plataforma opera bajo un modelo comercial de timbres o folios. Los timbres corresponden a un paquete de operaciones que el contribuyente contrata bajo un acuerdo comercial con The Factory HKA Colombia, y le da derecho a un determinado número de transacciones. El ERP puede consultar al Web Service de THE FACTORY HKA – DFACTURE los timbres disponibles.
  3. Para que el documento sea considerado factura electrónica, se requiere validación de la DIAN para su posterior envío al Adquiriente por parte de Dfactura.
  4. En caso de que el documento no sea válido exitosamente ante la DIAN, éste deberá ser corregido y reexpedido.
  5. El ERP puede consumir el Web Service para descargar XML y PDF si desea un respaldo alterno u ofrecer funcionalidad de consulta offline.
  6. El ERP opcionalmente puede decidir si enviar el XML y PDF al Adquiriente bajo su estructura.
  7. El Web Service de la plataforma ofrece la funcionalidad de consulta de estado del Acuse de Recibo por parte del Adquiriente. Éste se actualiza de forma asincrónica.
  8. El Web Service de la plataforma ofrece la funcionalidad de consulta de estado del documento por parte de la DIAN. Éste se actualiza de forma asincrónica.
  9. El ERP refleja en su UI los resultados de sus consultas y operaciones con la plataforma. Sin embargo, el Emisor o Contribuyente puede hacer seguimiento o revisión a la vista de su ERP accediendo al portal The Factory HKA-Dfactura, ya que las operaciones realizadas en el Web Service se reflejan en el portal.
Diagrama de componentes y dependencias del sistema de facturación electrónica
DIAGRAMA COMPONENTES

La Figura anterior muestra la forma en la que el Software de Facturación (ERP) se integra y hace uso de las funcionalidades de facturación electrónica de la plataforma The Factory HKA – DFACTURE, interactuando con los elementos externos (el emisor, el Adquiriente y la DIAN) mediante las dependencias disponibles, pueden verse las funciones que cada sistema debe realizar.


Generación del archivo Plano (TXT)


Para construir el archivo plano (txt), se deben utilizar los campos declarados más adelante en las tablas de configuración en el orden especificado y separados por un pipe “|”. En caso de que los campos no tengan valor alguno deberá el contenido entre pipe estar vacíos (sin espacios en blanco como recomendación, Ejemplo: ||).

Los campos a incorporar en el archivo plano (txt) deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:

Formato Descripcion
A Carácter alfabético
N Carácter numérico
AN Carácter alfanumérico
3 3 caracteres alfabéticos (longitud fija)
3 3 caracteres numéricos(longitud fija)
3 3 caracteres alfanuméricos (longitud fija)
..3 Hasta 3 caracteres alfabéticos(longitud variable)
..3 Hasta 3 caracteres numéricos(longitud variable)
..3 Hasta 3 caracteres alfanuméricos (longitud variable)
..8|5.2 Hasta 8 caracteres numéricos, conformados por (hasta) 5 enteros y dos decimales separados por punto
2..6 Entre 2 y 6 caracteres numéricos (longitud variable)
INT32 Entero.(Valor Máximo: 2,147,483,647)


Requerido Descripcion
SI Si es obligatorio para la DIAN
NO No es obligatorio para la DIAN
C/C Es requerido cuando corresponda ( o bajo cierta condición por el modelo de negocio del cliente)


Estructura General del Archivo Plano (TXT)


En las siguientes tablas, se detalla el layout del archivo planto (txt) para el modelo de facturación electrónica con validación previa.

Descripción general del identificador Requerido
01 "DATOS GENERALES DEL ADQUIRIENTE" SI
01A "DESTINATARIO" (Repetible) SI
01B "DETALLES TRIBUTARIOS DEL ADQUIRIENTE" (Repetible) SI
01C "DIRECCION DEL ADQUIRIENTE" C/C
01C1 "LOCALIZACION DEL ADQUIRIENTE" (Repetible) NO
01D "DIRECCION FISCAL DEL ADQUIRIENTE" C/C
01D1 "LOCALIZACION FISCAL DEL ADQUIRIENTE" (Repetible) NO
01E "INFORMACION LEGAL DEL ADQUIRIENTE" C/C
01F "RESPONSABILIDADES RUT DEL ADQUIRIENTE" (Repetible) SI
02 "DATOS GENERALES DEL DOCUMENTO" SI
02A "ANTICIPOS" (Repetible) NO
02B "AUTORIZADO" NO
02B1 "DIRECCION DEL AUTORIZADO" NO
02B1A "LOCALIZACION DEL AUTORIZADO" (Repetible) NO
02C "CARGOS Y DESCUENTOS" (Repetible) NO
02D "CONDICION DE PAGO" (Repetible) NO
02E "DOCUMENTOS REFERENCIADOS" (Repetible) C/C
02F "ENTREGA DE MERCANCIA (DELIVERY)" NO
02F1 "DATOS DEL TRANSPORTISTA" NO
02F1A "DETALLES TRIBUTARIOS DEL TRANSPORTISTA" (Repetible) NO
02F1B "DIRECCION RESPONSABLE DE ENTREGA" NO
02F1B1 "LOCALIZACION RESPONSABLE DE ENTREGA" (Repetible) NO
02F1C "RESPONSABILIDADES RUT DEL TRANSPORTISTA" (Repetible) NO
02F1D "DIRECCION DEL TRANSPORTADOR" NO
02F1D1 "LOCALIZACION DEL TRANSPORTADOR" (Repetible) NO
02F2 "DIRECCION DE DESPACHO" NO
02F2A "LOCALIZACION DE DESPACHO" (Repetible) NO
02F3 "DIRECCION DE ENTREGA" NO
02F3A "LOCALIZACION DE ENTREGA" (Repetible) NO
02G "IMPUESTOS GENERALES" (Repetible) SI
02H "IMPUESTOS TOTALES" (Repetible) SI
02I "INFORMACION ADICIONAL" (Repetible) NO
02J "MEDIOS DE PAGO" (Repetible) SI
02K "ORDEN DE COMPRA" (Repetible) NO
02L "TASA DE CAMBIO" C/C
02M "TASA DE CAMBIO ALTERNATIVA" NO
02N "TERMINOS DE ENTREGA" C/C
02N1 "CARGOS Y DESCUENTOS TERM. DE ENTREGA" (Repetible) NO
02N2 "DIRECCION DE ENTREGA" NO
02N2A "LOCALIZACION DE ENTREGA" (Repetible) NO
03 "CONCEPTOS O DETALLES DE PRODUCTOS" (Repetible) SI
04 "EXTRAS DEL DOCUMENTO" (Repetible) NO
SSCG "CAMPOS DE DATOS ADICIONALES DEL SECTOR SALUD" C/C
SSNenef "INFORMACIÓN DEL BENEFICIARIO DEL SERVICIO DE SALUD" C/C
SSalud "CAMPOS GENERALES DE SECTOR SALUD" C/C
SSextras "EXTRAS DEL SECTOR SALUD" C/C
05 "PARAMETRO DE ADJUNTOS" (0, 1, 10 U 11) SI


Los identificadores resaltados en color azul, corresponden a la información a ser reportada al momento de emitir un documento del Sector Salud. Estos documentos sólo podrán ser emitidos a través de la Versión 4 del Servicio de Emisión.

Datos generales del adquiriente -> (Identificador 01)


Contiene 20 campos y 19 pipes (|): 

Identificador|nombreRazonSocial|tipoPersona|segundoNombre|apellido|numeroDocumento|tipoIdentificacion|email|telefono|
notificar|actividadEconomicaCIIU|nombreComercial|nombreContacto|nota|numeroIdentificacionDV|telefax|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “01”
PATH: No Aplica
2 nombreRazonSocial AN|5..450 SI
Nombre o Razón Social del adquirente
PATH: ../cac:Party/cac:PartyTaxScheme/cbc:RegistrationName
3 tipoPersona N|1 SI
Identificador de tipo de persona
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 5
PATH: …/cbc:AdditionalAccountID
4 segundoNombre AN|..50 NO
Segundo nombre del adquiriente.
PATH: No definido
5 apellido AN|…50 NO
Apellido del adquiriente.
PATH: No definido
6 numeroDocumento AN|..12 SI
Número del Documento o Identificación Fiscal del adquirente
Obligatorio Si el adquirente es responsable debe informar el NIT
Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
PATH: …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
7 tipoIdentificacion N|2 SI
Tipo de Identificación del adquiriente
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 3
Nota: Para identificar al consumidor final se utiliza el código “13”
PATH: ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
8 email AN|..50 C/C
Correo Electrónico del adquiriente que irá al XML/UBL fiscal
(solo se envía un correo en este campo)
PATH: No aplica nodo
9 telefono AN|..20 NO
Teléfono del adquiriente
PATH: …/cac:Party/cac:Contact/cbc:Telephone
10 notificar AN|2 SI
Activa el envío de email al adquirente.
Valores posibles: “SI” o “NO”
PATH: No aplica
11 actividadEconomicaCIIU AN|…4 NO
Corresponde al código de actividad económica CIIU
PATH: .. /cac:Party/cbc:IndustryClassificationCode
12 nombreComercial AN|…4 NO
Nombre Comercial del adquiriente
Obligatorio Si en la Rep. Gráfica se mostrará el nombre comercial
PATH: /cac:Party/cac:PartyName
13 nombreContacto AN|5..450 NO
Nombre de Contacto
PATH: ../cac:Party/cac:Contact/cbc:Name
14 nota AN|..450 NO
Nota adicional de contacto
PATH: ../cac:Party/cac:Contact/cbc:Note
15 numeroIdentificacionDV AN|..2 C/C
Digito de verificación NIT del adquiriente
Obligatorio: Si tipoIndentificacion = 31, debe ser informado
PATH:
../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
16 telefax N|..20 NO
Telefax
PATH: ../cac:Party/cac:Contact/cbc:Telefax
17 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
18 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
19 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
19 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Destinatario -> (Identificador 01A)


Contiene 11 campos y 10 pipes (|): 

Identificador|canalDeEntrega|email|fechaProgramada|mensajeProgramado|nitProveedorReceptor|telefono|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea(Repetible). Valor fijo: “01A”
PATH: No Aplica
2 canalDeEntrega - SI
Medio de Entrega del Documento Electrónico
Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
PATH: No aplica
3 email AN|..50 C/C
Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico
Permite enviar múltiples destinatarios separados por el carácter coma (‘,’ máximo 5)
PATH: No aplica
4 fechaProgramada AN|19 NO
Fecha programada
PATH: No aplica
5 mensajeProgramado - NO
Mensaje
PATH: No aplica
6 nitProveedorReceptor N|..12 C/C
NIT del Destinatario
Obligatorio Cuando canalDeEntrega=’1’ ó ‘2’
PATH: No aplica
7 telefono AN|..20 C/C
Teléfono del Destinatario
Obligatorio Cuando canalDeEntrega=’3’ ó ‘4’
PATH: No aplica
8 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
9 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
10 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
11 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Detalles Tributarios del Adquiriente -> (Identificador 01B)


Contiene 6 campos y 5 pipes (|): 

Identificador|codigoImpuesto|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea (Repetible). Valor fijo: “01B”
Obligatorio: Si adquiriente es responsable
Notificación Si el adquirente es responsable, el NIT debe estar activo en el RUT
PATH: No Aplica
2 codigoImpuesto AN|2 SI
Identificador del tributo
Rechazo Si el contenido de este elemento no corresponde a uno de los códigos de la Tabla 11
PATH: ../cbc:ID
3 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
4 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
5 Extensible1.nombre Depende del Campo

Dirección del Adquiriente -> (Identificador 01C)


 NO
Código del campo extensible a referenciar
PATH: Variable
6 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable

Contiene 30 campos y 29 pipes (|): 

Identificador|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
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “01C”
Recomendado:: Para visualización en representación gráfica
PATH: No Aplica
2 aCuidadoDe AN|..50 NO
Cuidado de
PATH: ../cac:Address/cbc:MarkCare
3 aLaAtenciónDe AN|..50 NO
A la atención de
PATH: ../cac:Address/cbc:MarkAttention
4 bloque AN|..50 NO
Nombre del bloque
PATH: ../cac:Address/cbc:BlockName
5 buzon AN|..50 NO
Buzón postal
PATH: ../cac:Address/cbc:Postbox
6 Calle AN|..50 NO
Nombre de la calle
PATH: ../cac:Address/cbc:StreetName
7 calleAdicional AN|..50 NO
Nombre Adicional para especificar mejor el nombre de la calle
PATH: ../cac:Address/cbc:AdditionalStreetName
8 ciudad AN|…50 SI
Ciudad
Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la Tabla 19 (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
PATH: ../cac:Address/cbc:CityName
9 codigoDepartamento AN|…5 SI
Código del departamento
Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la Tabla 16
Obligatorio para Emisores y Adquirentes Responsables
PATH: ../cac:Address/cbc:CountrySubentityCode
10 correccionHusoHorario AN|6 NO
Corrección del uso horario correspondiente
PATH: ../cac:Address/cbc:TimezoneOffset
11 departamento AN|…50 SI
Nombre del departamento
Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la Tabla 16
PATH: ../cac:Address/cbc:CountrySubentity
12 departamentoOrg AN|..50 NO
Un departamento direccionable de una organización
PATH: ../cac:Address/cbc:Department
13 direccion AN|…100 SI
Dirección del cliente, sin indicar ciudad ni departamento
PATH: ../cac:Address/cac:AddressLine/cbc:Line
14 distrito AN|..50 NO
Distrito
PATH: /cac:Address/cbc:District
15 habitacion AN|..50 NO
Habitación
PATH: ../cac:Address/cbc:Room
16 lenguaje A|2 ISO 639-1 SI
Identificador del lenguaje utilizado en el nombre del país
Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
PATH: /cac:Address/cac:Country/cbc:Name/@languageID
17 municipio AN|..50 SI
Código del Municipio
Notificación Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 19
PATH: ../cbc:ID
18 nombreEdificio AN|..50 NO
Nombre de un Edificio
PATH: ../cac:Address/cbc:BuildingName
19 numeroEdificio AN|..50 NO
Número de una casa o edificio
PATH: ../cac:Address/cbc:BuildingNumber
20 numeroParcela AN|..50 NO
Número de Parcela
PATH: ../cac:Address/cbc:PlotIdentification
21 pais A|2 SI
País del cliente.
Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
PATH: ../cac:Address/cac:Country/cbc:IdentificationCode
22 piso AN|..50 NO
Piso
PATH: ../cac:Address/cbc:Floor
23 region AN|..50 NO
Región
PATH: ../cac:Address/cbc:Region
24 subDivision AN|..50 NO
Subdivisión (Nombre del Barrio)
PATH: ../cac:Address/cbc:CitySubdivisionName
25 ubicación AN|..50 NO
Una ubicación específica dentro de un edificio
PATH: ../cac:Address/cbc:InhouseMail
26 zonaPostal AN|..10 NO
Zona Postal
Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la Tabla 20
Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
PATH: ../cac:Address/cbc:PostalZone
27 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
28 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
29 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
30 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Localización del Adquiriente -> (Identificador 01C1)


Contiene 7 campos y 6 pipes (|): 

Identificador|gradosLatitud|gradosLongitud|minutosLatitud|minutosLongitud|orientacionLatitud|orientacionLongitud
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea (Repetible). Valor fijo: “01C1”
Obligatorio: Si adquiriente es responsable
PATH: No Aplica
2 gradosLatitud Por Definir NO
Medida de la latitud en grados
PATH: ../cbc:LatitudeDegreesMeasure
3 gradosLongitud Por Definir NO
Medida de la longitud en grados
Rechazo Unidad superior a 60 minutos
PATH: ../cbc:LongitudeDegreesMeasure
4 minutosLatitud N|…5|2.2 NO
Medida de la latitud en minutos decimales en formato mm.mm
PATH: ../cbc:MarkAttentionIndicator
5 minutosLongitud N|…5|2.2 NO
Medida de la longitud en minutos decimales en formato mm.mm
Rechazo Unidad superior a 60 minutos
PATH: ../cbc:LongitudeMinutesMeasure
6 orientacionLatitud AN|1 NO
Sentido de medida de la latitud con relación al Ecuador
PATH: ../cbc:LatitudeDirectionCode
7 orientacionLongitud AN|1 NO
Sentido de medida de la longitud con relación al Ecuador
PATH: ../cbc:LongitudeDirectionCode


Dirección Fiscal del Adquiriente -> (Identificador 01D)


Contiene 30 campos y 29 pipes (|): 

Identificador|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
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “01C”
Recomendado:: Para visualización en representación gráfica
PATH: No Aplica
2 aCuidadoDe AN|..50 NO
Cuidado de
PATH: ../cac:Address/cbc:MarkCare
3 aLaAtenciónDe AN|..50 NO
A la atención de
PATH: ../cac:Address/cbc:MarkAttention
4 bloque AN|..50 NO
Nombre del bloque
PATH: ../cac:Address/cbc:BlockName
5 buzon AN|..50 NO
Buzón postal
PATH: ../cac:Address/cbc:Postbox
6 Calle AN|..50 NO
Nombre de la calle
PATH: ../cac:Address/cbc:StreetName
7 calleAdicional AN|..50 NO
Nombre Adicional para especificar mejor el nombre de la calle
PATH: ../cac:Address/cbc:AdditionalStreetName
8 ciudad AN|…50 SI
Ciudad
Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la Tabla 19 (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
PATH: ../cac:Address/cbc:CityName
9 codigoDepartamento AN|…5 SI
Código del departamento
Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la Tabla 16
Obligatorio para Emisores y Adquirentes Responsables
PATH: ../cac:Address/cbc:CountrySubentityCode
10 correccionHusoHorario AN|6 NO
Corrección del uso horario correspondiente
PATH: ../cac:Address/cbc:TimezoneOffset
11 departamento AN|…50 SI
Nombre del departamento
Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la Tabla 16
PATH: ../cac:Address/cbc:CountrySubentity
12 departamentoOrg AN|..50 NO
Un departamento direccionable de una organización
PATH: ../cac:Address/cbc:Department
13 direccion AN|…100 SI
Dirección del cliente, sin indicar ciudad ni departamento
PATH: ../cac:Address/cac:AddressLine/cbc:Line
14 distrito AN|..50 NO
Distrito
PATH: /cac:Address/cbc:District
15 habitacion AN|..50 NO
Habitación
PATH: ../cac:Address/cbc:Room
16 lenguaje A|2 ISO 639-1 SI
Identificador del lenguaje utilizado en el nombre del país
Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
PATH: /cac:Address/cac:Country/cbc:Name/@languageID
17 municipio AN|..50 SI
Código del Municipio
Notificación Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 19
PATH: ../cbc:ID
18 nombreEdificio AN|..50 NO
Nombre de un Edificio
PATH: ../cac:Address/cbc:BuildingName
19 numeroEdificio AN|..50 NO
Número de una casa o edificio
PATH: ../cac:Address/cbc:BuildingNumber
20 numeroParcela AN|..50 NO
Número de Parcela
PATH: ../cac:Address/cbc:PlotIdentification
21 pais A|2 SI
País del cliente.
Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
PATH: ../cac:Address/cac:Country/cbc:IdentificationCode
22 piso AN|..50 NO
Piso
PATH: ../cac:Address/cbc:Floor
23 region AN|..50 NO
Región
PATH: ../cac:Address/cbc:Region
24 subDivision AN|..50 NO
Subdivisión (Nombre del Barrio)
PATH: ../cac:Address/cbc:CitySubdivisionName
25 ubicación AN|..50 NO
Una ubicación específica dentro de un edificio
PATH: ../cac:Address/cbc:InhouseMail
26 zonaPostal AN|..10 NO
Zona Postal
Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la Tabla 20
Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
PATH: ../cac:Address/cbc:PostalZone
27 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
28 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
29 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
30 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Información Legal del Adquiriente -> (Identificador 01E)


Contiene 8 campos y 7 pipes (|): 

Identificador|codigoEstablecimiento|nombreRegistroRUT|numeroIdentificacion|numeroIdentificacionDV|
numeroMatriculaMercantil|prefijoFacturacion|tipoIdentificacion
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “01E”
Obligatorio: Si adquiriente es responsable
PATH: No Aplica
2 codigoEstablecimiento - NO
Código de Establecimiento
PATH: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
3 nombreRegistroRUT AN|..450 SI
Nombre o Razón Social del adquirente
PATH: ../cac:PartyLegalEntity/cbc:RegistrationName
4 numeroIdentificacion AN|..12 SI
Identificador del Adquirente.
Debe informar el NIT si es responsable
PATH: ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
5 numeroIdentificacionDV N|..2 C/C
Digito Verificador
Obligatorio Si tipoIdentificacion =31, el DV del NIT debe ser informado
PATH: ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
6 numeroMatriculaMercantil N|9 NO
Número de matrícula mercantil
PATH: ../cac:CorporateRegistrationScheme/cbc:Name
7 prefijoFacturacion - NO
Prefijo de facturación:
PATH: ../cac:CorporateRegistrationScheme/cbc:ID
8 tipoIdentificacion N|2 SI
Tipo de identificación del cliente
Rechazo Si el contenido de este elemento es diferente de “31”
PATH: ../cac:PartyLegalEntity/cbc:CompanyID@schemeName


Responsabilidades RUT del Adquiriente -> (Identificador 01F)


Contiene 7 campos y 6 pipes (|): 

Identificador|obligaciones|regimen|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea (Repetible). Valor fijo: “01F” .Obligaciones y régimen del adquiriente
Obligatorio: Solo en las siguientes condiciones:
  • Si el adquiriente es persona Juridica
  • En caso de persona Natural, si el valor de la factura es mayor de 100 UVT
PATH: No Aplica
2 Obligaciones AN|7 SI
Obligaciones del adquiriente
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 17
PATH: ../cbc:TaxLevelCode
3 regimen AN|2 NO
Opcional, si informado indicar “No aplica”. Posibles Valores:
48: “Impuesto sobre las ventas - IVA”
49: “No responsable de IVA”
PATH: .. /cbc:TaxLevelCode/@listName
4 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
5 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
6 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
7 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Datos generales del documento -> (Identificador 02)


Contiene 23 campos y 23 pipe (|): 

Identificador|tipoDocumento|consecutivoDocumento|rangoNumeracion|fechaEmision|fechaVencimiento|moneda|
propina|totalDescuentos|totalSinImpuestos|totalMonto|cantidadDecimales|fechaFinPeriodoFacturacion|
fechaInicioPeriodoFacturacion|fechaPagoImpuestos|redondeoAplicado|tipoOperacion|totalAnticipos|
totalBaseImponible|totalBrutoConImpuesto|totalCargosAplicados|totalProductos|tipoSector
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “02”
PATH: No Aplica
2 tipoDocumento AN|2 SI
Tipo de documento
PATH: Invoice, CreditNote, DebitNote
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 1
3 consecutivoDocumento <nomiki>AN..20</nowiki> SI
Correlativo/consecutivo del documento electrónico
Concatenación del prefijo (AN|..4) + el consecutivo DIAN,
según la configuración en portal web:
Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
Rechazo No se permiten caracteres adicionales como espacios o guiones
Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
PATH: /root/cbc:ID
4 rangoNumeracion AN|..20 SI
Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
Ejemplo: ‘PREF-1123456’
PATH:
/root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
5 fechaEmision AN|19 SI
Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
Rechazo Si la fecha de emisión es posterior a diez días calendario
PATH: /root/cbc:IssueDate, root/cbc:IssueTime
6 fechaVencimiento AN|10 NO
Fecha vencimiento de la factura, en formato: YYYY-MM-DD
PATH: /root/cbc:DueDate
7 moneda AN|3 SI
Moneda o divisa del documento
Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
PATH: /root/cbc:DocumentCurrencyCode
8 propina - -
Sin uso por ahora en validación previa
9 totalDescuentos Ent: N|..15

Dec: N|0..6

NO
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
PATH: /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
10 totalSinImpuestos Ent: N|..15

Dec: N|0..6

SI
Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
PATH: /root/LegalMonetaryTotal/cbc:LineExtensionAmount
11 totalMonto Ent: N|..15

Dec: N|0..6

SI
Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
Rechazo Si totalMonto no 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
12 cantidadDecimales N|1 SI
Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
Rechazo Si se reciben más decimales en los montos a los indicados en este campo
PATH: No aplica
13 fechaFinPeriodoFacturacion AN|19 NO
Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
PATH: /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTimee
14 fechaInicioPeriodoFacturacion AN|19 NO
Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
PATH:
/root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
15 fechaPagoImpuestos AN|19 NO
Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
PATH: root/cbc:TaxPointDate
16 redondeoAplicado Ent: N|..15

Dec: N|0..6

SI
Redondeo aplicado para llegar a totalMonto
Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
PATH: /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
17 tipoOperacion AN|..4 SI
Indicador del tipo de operación
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 2
PATH: /root/cbc:CustomizationID
18 totalAnticipos Ent: N|..15

Dec: N|0..6

NO
Suma de todos los pagos anticipados
Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
PATH: /root/LegalMonetaryTotal/cbc:PrepaidAmount
19 totalBaseImponible Ent: N|..15

Dec: N|0..6

SI
Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
PATH: /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
20 totalBrutoConImpuesto Ent: N|..15

Dec: N|0..6

SI
Total del valor bruto con tributos
Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
PATH: /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
21 totalCargosAplicados Ent: N|..15

Dec: N|0..6

NO
Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
PATH: /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
22 totalProductos AN|..5 SI
Número o cantidad de líneas de productos (renglones) presentes en el documento
Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
PATH: /root/cbc:LineCountNumeric
23 tipoSector N|1 SI
Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
PATH: Invoice, CreditNote, DebitNote


Anticipos -> (Identificador 02A)


Contiene 11 campos y 10 pipes (|): 

Identificador|fechaDeRecibido|fechadePago|horaDePago|id|instrucciones|montoPagado|
Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “02A”
PATH: No Aplica
2 fechaDeRecibido AN|10 SI
Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
PATH: …/cbc:ReceivedDate
3 fechadePago AN|10 NO
Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
PATH: …/cbc:PaidDate
4 horaDePago AN|8 NO
Hora en la cual el pago fue realizado, en formato:HH:MM:SS
PATH: …/cbc:PaidTime
5 id A|..150 SI
Identificación interno del pago
PATH: …/cbc:ID
6 instrucciones AN|15..500 SI
Instrucciones relativas al pago
PATH: …/cbc:InstructionID
7 montoPagado Ent: N|..15

Dec: N|0..6

SI
Valor del pago anticipado, no puede ser superior al valor total de la factura
Notificación Si montoPagado > totalMonto
PATH: …/cbc:PaidAmount
8 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
9 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si los campos son asociables)
PATH: Variable
10 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
11 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Autorizado -> (Identificador 02B)


Contiene 15 campos y 14 pipes (|): 

Identificador|email|nombreComercial|nombreContacto|nota|numeroDocumento|numeroDocumentoDV|razonSocial|telefax|telefono|
tipoIdentificacion|Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “02B”
PATH: No Aplica
2 email AN|..50 C/C
Correo Electrónico del adquiriente que irá al XML/UBL fiscal
(solo se envía un correo en este campo)
PATH: No aplica nodo
3 nombreComercial AN|…4 NO
Nombre Comercial del adquiriente
Obligatorio Si en la Rep. Gráfica se mostrará el nombre comercial
PATH: /cac:Party/cac:PartyName
4 nombreContacto AN|5..450 NO
Nombre de Contacto
PATH: ../cac:Party/cac:Contact/cbc:Name
5 nota AN|..450 NO
Nota adicional de contacto
PATH: ../cac:Party/cac:Contact/cbc:Note
6 numeroDocumento AN|..12 SI
Número del Documento o Identificación Fiscal del adquirente
PATH: ../cac:PartyIdentification/cbc:ID
7 numeroIdentificacionDV AN|..2 C/C
Digito de verificación NIT del adquiriente
Obligatorio: Si tipoIndentificacion = 31, debe ser informado
PATH: ../cac:PartyIdentification/cbc:ID@schemeID
8 razonSocial ..50</nowiki NO
Razón Social
PATH: ../cac:PartyLegalEntity/cbc:RegistrationName
9 telefax N|..20 NO
Telefax
PATH: ../cac:Party/cac:Contact/cbc:Telefax
10 telefono N|..50 NO
Telefono
PATH:../cac:Contact/cbc:Telephone
11 tipoIdentificacion N|..2 SI
Tipo de Identificación
Ver lista de valores en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]
PATH: ../cac:PartyIdentification/cbc:ID@schemeName
12 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
13 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
14 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
15 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Dirección del Autorizado -> (Identificador 02B1)


Contiene 30 campos y 29 pipes (|): 

Identificador|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
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|4 SI
Identificador de línea. Valor fijo: “02B1”
PATH: No Aplica
2 aCuidadoDe AN|..50 NO
Cuidado de
PATH: ../cac:Address/cbc:MarkCare
3 aLaAtenciónDe AN|..50 NO
A la atención de
PATH: ../cac:Address/cbc:MarkAttention
4 bloque AN|..50 NO
Nombre del bloque
PATH: ../cac:Address/cbc:BlockName
5 buzon AN|..50 NO
Buzón postal
PATH: ../cac:Address/cbc:Postbox
6 Calle AN|..50 NO
Nombre de la calle
PATH: ../cac:Address/cbc:StreetName
7 calleAdicional AN|..50 NO
Nombre Adicional para especificar mejor el nombre de la calle
PATH: ../cac:Address/cbc:AdditionalStreetName
8 ciudad AN|…50 SI
Ciudad
Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la Tabla 19 (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
PATH: ../cac:Address/cbc:CityName
9 codigoDepartamento AN|…5 SI
Código del departamento
Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la Tabla 16
Obligatorio para Emisores y Adquirentes Responsables
PATH: ../cac:Address/cbc:CountrySubentityCode
10 correccionHusoHorario AN|6 NO
Corrección del uso horario correspondiente
PATH: ../cac:Address/cbc:TimezoneOffset
11 departamento AN|…50 SI
Nombre del departamento
Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la Tabla 16
PATH: ../cac:Address/cbc:CountrySubentity
12 departamentoOrg AN|..50 NO
Un departamento direccionable de una organización
PATH: ../cac:Address/cbc:Department
13 direccion AN|…100 SI
Dirección del cliente, sin indicar ciudad ni departamento
PATH: ../cac:Address/cac:AddressLine/cbc:Line
14 distrito AN|..50 NO
Distrito
PATH: /cac:Address/cbc:District
15 habitacion AN|..50 NO
Habitación
PATH: ../cac:Address/cbc:Room
16 lenguaje A|2 ISO 639-1 SI
Identificador del lenguaje utilizado en el nombre del país
Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
PATH: /cac:Address/cac:Country/cbc:Name/@languageID
17 municipio AN|..50 SI
Código del Municipio
Notificación Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 19
PATH: ../cbc:ID
18 nombreEdificio AN|..50 NO
Nombre de un Edificio
PATH: ../cac:Address/cbc:BuildingName
19 numeroEdificio AN|..50 NO
Número de una casa o edificio
PATH: ../cac:Address/cbc:BuildingNumber
20 numeroParcela AN|..50 NO
Número de Parcela
PATH: ../cac:Address/cbc:PlotIdentification
21 pais A|2 SI
País del cliente.
Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
PATH: ../cac:Address/cac:Country/cbc:IdentificationCode
22 piso AN|..50 NO
Piso
PATH: ../cac:Address/cbc:Floor
23 region AN|..50 NO
Región
PATH: ../cac:Address/cbc:Region
24 subDivision AN|..50 NO
Subdivisión (Nombre del Barrio)
PATH: ../cac:Address/cbc:CitySubdivisionName
25 ubicación AN|..50 NO
Una ubicación específica dentro de un edificio
PATH: ../cac:Address/cbc:InhouseMail
26 zonaPostal AN|..10 NO
Zona Postal
Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la Tabla 20
Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
PATH: ../cac:Address/cbc:PostalZone
27 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
28 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
29 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
30 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Localización del Autorizado -> (Identificador 02B1A)


Contiene 7 campos y 6 pipes (|): 

Identificador|gradosLatitud|gradosLongitud|minutosLatitud|minutosLongitud|orientacionLatitud|orientacionLongitud
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea (Repetible). Valor fijo: “02B1A”
Obligatorio: Si adquiriente es responsable
PATH: No Aplica
2 gradosLatitud Por Definir NO
Medida de la latitud en grados
PATH: ../cbc:LatitudeDegreesMeasure
3 gradosLongitud Por Definir NO
Medida de la longitud en grados
Rechazo Unidad superior a 60 minutos
PATH: ../cbc:LongitudeDegreesMeasure
4 minutosLatitud N|…5|2.2 NO
Medida de la latitud en minutos decimales en formato mm.mm
PATH: ../cbc:MarkAttentionIndicator
5 minutosLongitud N|…5|2.2 NO
Medida de la longitud en minutos decimales en formato mm.mm
Rechazo Unidad superior a 60 minutos
PATH: ../cbc:LongitudeMinutesMeasure
6 orientacionLatitud AN|1 NO
Sentido de medida de la latitud con relación al Ecuador
PATH: ../cbc:LatitudeDirectionCode
7 orientacionLongitud AN|1 NO
Sentido de medida de la longitud con relación al Ecuador
PATH: ../cbc:LongitudeDirectionCode


Cargos y Descuentos -> (Identificador 02C)


Contiene 12 campos y 11 pipes (|): 

Identificador|codigo|descripcion|indicador|monto|montoBase|porcentaje|secuencia|Extensible1.controlInterno1|
Extensible1.controlInterno2|Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea (Repetible). Valor fijo: “02C”
PATH: No Aplica
2 codigo AN|2 C/C
Código para categorizar el descuento
Obligatorio: Si es descuento a nivel de factura (general)
Rechazo Si es descuento y no se informa algunos de los valores en la Tabla 4
PATH: …/cbc:AllowanceChargeReasonCode
3 descripcion AN|10..5000 SI
Texto libre para informar la razón del descuento
PATH: …/cbc:AllowanceChargeReason
Notificación : Si se informa un cargo o descuento y no se informa este elemento
4 indicador N|1 SI
Indicador de si es Cargo”1” o Descuento “0”
Rechazo : Si este elemento contiene una información diferente de “1” o “0”
PATH: …/cbc:ChargeIndicator
5 monto Ent: N|..15

Dec: N|0..6

SI
Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
Rechazo : Si es Descuento y monto > montoBase
PATH: …/cbc:Amount
6 montoBase Ent: N|..15

Dec: N|0..6

SI
Valor Base para calcular el descuento o el cargo,
Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
Rechazo: Si montoBase > totalMonto
PATH: …/cbc:BaseAmount
7 porcentaje Ent: N|..6

Dec: N|2

SI
Porcentaje del descuento
Rechazo Si este elemento > 100
PATH: …/cbc:MultiplierFactorNumeric
8 secuencia N|..3 SI
Indicador de orden de secuencia
PATH: …/cbc:ID


Condición de Pago -> (Identificador 02D)


Contiene 20 campos y 19 pipes (|): 

Identificador|codigoEvento|comentario|duracionPeriodo|duracionPeriodoMedida|fechaVencimiento|
identificador|medioPagoAsociado|monto|montoMulta|montoPenalidad|periodoDesde|periodoHasta|porcentajeDescuento|
porcentajePago|referenciaAnticipo| Extensible1.controlInterno1|Extensible1.controlInterno2|Extensible1.nombre|
Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 SI
Identificador de línea. Valor fijo: “02D”
PATH: No Aplica
2 codigoEvento AN|..3 NO
Codigo de Evento
PATH: ../cbc:ReferenceEventCode
3 comentario AN|..50 NO
Nota
PATH: ../cbc:Note
4 duracionPeriodo AN|..2 NO
Duración de Periodo
PATH: ../cac:SettlementPeriod/cbc:DurationMeasure
5 duracionPeriodoMedida AN|..10 NO
Unidad de medida de la duración de periodo
PATH: ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
6 fechaVencimiento AN|..10 SI
Fecha de Vencimiento
PATH: ../cbc:PaymentDueDate
7 identificador AN|..2 NO
Condiciones de Pago
PATH: ../cbc:ID
8 medioPagoAsociado AN|..2 NO
Medio Pago asociado
PATH: ../cbc:PaymentMeansID
9 monto Ent: N|..15 SI
Monto
PATH: ../cbc:Amount
10 montoMulta Ent: N|..15

Dec: N|0..6

SI
Monto de la multa
PATH: ../cbc:PenaltySurchargePercent
11 montoPenalidad Ent: N|..15

Dec: N|0..6

SI
Monto de la Penalidad
PATH: ../cbc:PenaltyAmount
12 periodoDesde AN|..10 NO
Periodo desde
PATH: ../cbc:StartDate
13 periodoHasta AN|..10 NO
Periodo hasta
PATH: ../cbc:EndDate
14 porcentajeDescuento Ent: N|..6

Dec: N|2

NO
Porcentaje de Descuento
PATH: ../cbc:SettlementDiscountPercent
15 porcentajePago Ent: N|..6

Dec: N|2

SI
Porcentaje de Pago
PATH: . /cbc:PaymentPercent
16 referenciaAnticipo AN|..20 NO
Numero de referencia de Anticipo
PATH: ../cac:PrepaidPaymentReferenceID
17 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
18 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
19 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
20 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Documentos Referenciados -> (Identificador 02E)


Contiene 16 campos y 15 pipes (|): 

Identificador|codigoEstatusDocumento|codigoInterno|cufeDocReferenciado|descripcion|fecha|fechaFinValidez|fechaInicioValidez|numeroDocumento|tipoCUFE|tipoDocumento|tipoDocumentoCodigo|Extensible1.controlInterno1|Extensible1.controlInterno2| Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 C/C
Identificador de línea (Repetible). Valor fijo: “02E”
Obligatorio: En facturas tipoDocumento contingencia (AdditionalDocumentReference),

en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)

PATH: No Aplica
2 codigoEstatusDocumento - C/C
Código o motivo del Documento
Obligatorio Cuando codigoInterno sea ‘4’
Rechazo Si el contenido de este atributo no corresponde a algún de los valores de Tabla 9 y Tabla 10
PATH: ../cac:DiscrepancyResponse/cbc:ResponseCode
3 codigoInterno AN|1 SI
Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
  1. AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
  2. DespatchDocumentReference (Doc. De despacho)
  3. ReceiptDocumentReference (Doc. De recepción)
  4. DiscrepancyResponse (N.C y N.D)
  5. BillingReference (Facturas por corrección, N.C y N.D)
4 cufeDocReferenciado AN|..90 C/C
CUFE o CUDE del documento referenciado
Obligatorio Cuando codigoInterno sea ‘5’
Obligatorio En facturas, se debe diligenciar únicamente cuando la factura ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
Obligatorio En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
Solamente puede reportar facturas electrónicas de un mismo adquiriente
Rechazo Si CUFE o CUDE no existe en la DIAN
PATH: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
/CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
/DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
5 descripcion AN|20..5000 C/C
Descripción de la naturaleza de la corrección
Obligatorio Cuando codigoInterno sea ‘4’
PATH: ../cac:DiscrepancyResponse/cbc:Description
6 fecha AN|10 C/C
Fecha de ransfe del documento referenciado, en formato: YYYY-MM-DD
Obligatorio Cuando codigoInterno sea ‘1’, ‘2’, ‘3’ ó ‘5’
Rechazo Si fecha es posterior a la del documento referenciado
PATH: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
/CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
/DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
/cbc:IssueDate
7 fechaFinValidez AN|10 NO
Fecha de Fin de Validez
PATH: No definido
8 fechaInicioValidez AN|10 NO
Fecha de Inicio de Validez
PATH: No definido
9 numeroDocumento AN..20 SI
Concatenación del prefijo y el número del documento referenciado
Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
PATH:
/Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
/CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
/DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
/cbc:ID
10 tipoCUFE AN|..11 C/C
Algoritmo del tipo de CUFE.
“CUFE-SHA384” ó “CUDE-SHA384”
Obligatorio Cuando codigoInterno sea ‘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
11 tipoDocumento AN|..50 NO
Descripción del tipo de documento referenciado,
Ejemplo: “Factura de Venta Nacional”
PATH: No definido
12 tipoDocumentoCodigo AN|2 C/C
Identificador del tipo de documento referenciado.
Obligatorio Cuando codigoInterno sea ‘1’
Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la Tabla 22
PATH: No definido
13 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
14 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
15 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
26 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable

@IMPORTANTE:

# Para referenciar facturas de venta al emitir una NC o ND, se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:

    • Objeto 1: indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
    • Objeto 2: si el tipoOperacion es igual a 20 (para NC) ó 30 (para ND) y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
  2. Al transmitir una Factura de Contingencia, se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
  3. Para referenciar Documentos de Despacho (codigoInterno = ’2’) o Documentos de Recepción (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.


Entrega de Mercancía (Delivery) -> (Identificador 02F)


Contiene 11 campos y 10 pipes (|): 

Identificador|fechaEfectivaSalida|fechaEstimada|fechaReal|fechaSolicitada|identificacionTransporte|matriculaTransporte|Extensible1.controlInterno1|Extensible1.controlInterno2| Extensible1.nombre|Extensible1.valor
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|3 NO
Identificador de línea (Repetible). Valor fijo: “02F”
PATH: No Aplica
2 fechaEfectivaSalida AN|19 NO
Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
Rechazo si la fecha efectiva de salida es anterior a la fecha de emisión
PATH: ../cbc:ActualDeliveryDate + ../cbc:ActualDeliveryTime
3 fechaEstimada AN|19 NO
Fecha y hora estimada, en formato: YYYY-MM-DD HH:MM:SS
Rechazo si la fecha estimada es anterior a la fecha de emisión
PATH: ../cac:Despatch/cbc:EstimatedDespatchDate y EstimatedDespatchTime
4 fechaReal AN|19 NO
Fecha real, en formato: YYYY-MM-DD HH:MM:SS
Rechazo si la fecha real es anterior a la fecha de emisión
PATH: ../cac:Despatch/cbc:ActualDespatchDate y ActualDespatchTime
5 fechaSolicitada AN|19 NO
Fecha Solicitada, en formato: YYYY-MM-DD HH:MM:SS
Rechazo si la fecha solicitada es anterior a la fecha de emisión
PATH: ../cac:Despatch/ cbc:RequestedDespatchDate y RequestedDespatchTime
6 identificacionTransporte AN|..20 NO
Datos del Transporte
PATH: ../cac:Despatch/cbc:ID
7 fechaFinValidez AN|10 NO
Fecha de Fin de Validez
PATH: No definido
8 matriculaTransporte AN|..20 NO
Matricula del Transporte
PATH: ../cac:Despatch/ cbc:ID/@schemeAgencyID
9 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
10 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
11 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable


Datos del Transportista (Delivery) -> (Identificador 02F1))


Contiene 22 campos y 21 pipes (|): 

Identificador|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
Id_Campo Atributo Formato Requerido Descripción
1 Identificador AN|4 NO
Identificador de línea. Valor fijo: “02F1”
PATH: No Aplica
2 email AN|..50 NO
Correo Electrónico
PATH: ..cac:Contact/cbc:ElectronicMail
3 indicadordeAtencion AN|..50 NO
Indicador si es información sobre “para la atención de” (FAO)
PATH: ../cbc:MarkAttentionIndicator
4 indicadordeCuidado AN|..50 NO
Indicador si es información sobre alguien responsable por los bienes
PATH: ../cbc:MarkCareIndicator
5 nombreContacto AN|..50 NO
Nombre de Contacto
PATH: .. /cac:Contact/cbc:Name
6 nombreResponsableEntrega AN|..50 NO
Nombre del Responsable de la Entrega
PATH: ../cac:PartyName/cbc:Name
7 nota - NO
Nota de Contacto
PATH: ../cac:Contact/cbc:Note
8 numeroIdentificacion AN|…12 NO
NIT del transportista
PATH: ../cac:PartyTaxScheme/cbc:CompanyID
9 numeroIdentificacionDV N|..2 NO
Digito Verificador
PATH: ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
10 numeroMatriculaMercantil AN|..20 NO
Número de matrícula mercantil
PATH: ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
11 prefijoFacturacion AN|..20 NO
Prefijo de facturación del Transportista
PATH: .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
12 telefax AN|..20 NO
Telefax de transportista
PATH: ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
13 telefono AN|..20 NO
Teléfono de transportista
PATH: ../cac:Contact/cbc:Telefax
14 tipoIdentificacion N|2 NO
Tipo de Identificación del Transportista
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la en Tabla 3
PATH: ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
15 transportadorNombre AN|..50 NO
Nombre del transportador
PATH: ../cac:PartyLegalEntity/cbc:RegistrationName
16 transportadorNumeroDocumento AN|..12 NO
Numero documento del transportador
PATH: ../cac:PartyLegalEntity/cbc:CompanyID
17 transportadorNumeroDocumentoDV AN|..2 NO
Digito Verificador del NIT del transportador
PATH: ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
18 transportadorTipoIdentificacion N|2 NO
Tipo documento del transportador
PATH: ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
19 Extensible1.controlInterno1 AN|100 NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
20 Extensible1.controlInterno2 Depende del Campo NO
Permite asociar dos o más campos mediante un índice (si

los campos son asociables)

PATH: Variable
21 Extensible1.nombre Depende del Campo NO
Código del campo extensible a referenciar
PATH: Variable
 22 Extensible1.valor Depende del Campo NO
Valor del campo a agregar
PATH: Variable


Obtenido de «http://felcowiki.thefactoryhka.com.co/index.php?title=Manual_de_usuario_LAYOUT_ARCHIVO_PLANO&oldid=2282»