La versión para imprimir ya no se admite y puede contener errores de representación. Actualiza los marcadores del navegador y utiliza en su lugar la función de impresión predeterminada del navegador.
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
El Adquiriente da origen a una transacción mediante la compra de un producto o servicio.
El Emisor o Contribuyente carga los datos mediante la UI (User Interface) de su ERP.
El Emisor o Contribuyente visualiza los timbres disponibles en la UI de su ERP.
El ERP construye el objeto y lo expone directamente a la plataforma DFACTURE mediante el método correspondiente del Web Service.
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.
Opcionalmente, el ERP puede enviar el XML y PDF al adquiriente.
Opcionalmente, el ERP puede descargar el XML y PDF para propósito interno.
El Adquiriente recibe el XML y el PDF (vía email).
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).
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
@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
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.
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.
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.
En caso de que el documento no sea válido exitosamente ante la DIAN, éste deberá ser corregido y reexpedido.
El ERP puede consumir el Web Service para descargar XML y PDF si desea un respaldo alterno u ofrecer funcionalidad de consulta offline.
El ERP opcionalmente puede decidir si enviar el XML y PDF al Adquiriente bajo su estructura.
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.
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.
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)
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”
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”
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.
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
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”
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:
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
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
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.
Entrega de Mercancía (Delivery) -> (Identificador 02F)
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”
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”
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”
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”
Obligatorio En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
Rechazo Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
PATH: ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
9
valorTributoUnidad
Ent: N|..15
Dec: N|0..6
C/C
Es el valor nominal del tributo por unidad
Obligatorio En el caso de que el tributo es un valor fijo por unidad tributada, por ejemplo el impuesto de consumo a las bolsas o los impuestos a los combustibles
Rechazo si el elemento unidadMedidaTributo NO es informado.
Identificador de línea (Repetible). Valor fijo “02K”
PATH: No Aplica
2
codigoCliente
AN|..20
NO
Código del cliente
PATH: ../cbc:CustomerReference
3
DocumentoReferenciado1.codigoEstatusDocumento
-
NO
Código o motivo del Documento
Rechazo Si el contenido de este atributo no corresponde a algún de los valores de Tabla 9 yTabla 10
PATH: ../cac:DiscrepancyResponse/cbc:ResponseCode
4
DocumentoReferenciado1.codigoInterno
N|1
SI
Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
AdditionalDocumentReference (No usado por ahora)
DespatchDocumentReference (No usado por ahora)
ReceiptDocumentReference (No usado por ahora)
DiscrepancyResponse (Aplica en N.C y N.D)
BillingReference (Aplica en Facturas, N.C y N.D)
5
DocumentoReferenciado1.cufeDocReferenciado
AN|..90
SI
CUFE o CUDE del documento referenciado
Obligatorio: En facturas, se debe diligenciar únicamente cuando la factura electronica 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
Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
PATH: ../cbc:CalculationRate
10
Extensible1.controlInterno1
AN|100
NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
11
Extensible1.controlInterno2
Depende del Campo
NO
Permite asociar dos o más campos mediante un índice (si
Valor de la tasa de cambio entre las divisas. Se debe diligenciar con el valor de la tasa de cambio.
Por ejemplo para USD-COP puede ser el valor de la TRM o tasa acordada entre las partes (Valor reportado * Valor de tasa de cambio = Valor reportado en divisa informado en monedaDestino)
PATH: ../cbc:CalculationRate
10
Extensible1.controlInterno1
AN|100
NO
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
11
Extensible1.controlInterno2
Depende del Campo
NO
Permite asociar dos o más campos mediante un índice (si
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”
Cantidad de unidades del producto/servicio facturado
PATH: ../cbc:InvoicedQuantity
5
unidadMedida
AN|..3
NO
Código de Unidad de medida del producto/servicio facturado
Notificación: Si el valor del atributo no se encuentra en la Tabla 6
PATH: ../cac:Address/cbc:Postbox
6
precioVentaUnitario
Ent: N|..15
Dec: N|2..6
SI
Precio Unitario del porducto/servicio
PATH: ../Price/cbc:PriceAmount
7
precioTotalSinImpuestos
Ent: N|..15
Dec: N|2..6
SI
Valor total de la línea sin impuestos. (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
Rechazo: Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
PATH: ../cbc:LineExtensionAmount
8
precioTotal
Ent: N|..15
Dec: N|2..6
C/C
Precio total del producto o servicio (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
Obligatorio: Para uso en las representaciones gráficas
PATH: ..No definido
9
seriales
AN|…500
NO
Seriales del producto (separador por coma), Ej: ABC123,ABC456
PATH: ../cac:Item/cac:ItemInstance/cbc:SerialID
10
cantidadPorEmpaque
N|..3
NO
Cantidad de unidad de este artículo por empaque.
Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18)
PATH: ..cac:Item/cbc:PackSizeNumeric
11
cantidadReal
N|..6
SI
Cantidad real sobre la cual el precio aplica
PATH: .. /cac:Price/cbc:BaseQuantity
12
cantidadRealUnidadMedida
AN|..6
SI
Unidad de la cantidad sobre la cual el precio aplica
Notificación Si el valor del atributo no se encuentra en la Tabla 6
(Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
PATH: .. /cac:Price/cbc:BaseQuantity/@unitCode
13
codigoFabricante
-
NO
Código del fabricante correspondiente al artículo
PATH: .. /cac:Item/cac:
ManufacturersItemIdentification/cbc:ID
14
codigoIdentificadorPais
A|2
NO
Código Identificador del país de origen del artículo o servicio
Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
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”
Notificación Si el contenido de este elemento no corresponde a un valor correspondiente de la Tabla 21
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
31
TipoIdentificacion
N|2
SI
Tipo de Identificación del usuario beneficiario del servicio de salud.
Campos De Datos Generales Del Sector Salud: -> (Identificador SSCG)
Contiene 20 campos y 19 pipes (|):
Id_Campo
Atributo
Formato
Descripción
1
Identificador
AN|4
Identificador de línea. Valor fijo: “SSCG”
PATH: No Aplica
2
CODIGO_PRESTADOR
AF|..50
Código asignado en el Sistema General de Seguridad Social en Salud (SGSSS) a los prestadores de servicios de salud que estén en el Registro Especial de Prestadores de Servicios de Salud (REPS) o el código asignado por el Ministerio de Salud y Protección Social para los laboratorios de salud pública.
3
TIPO_DOCUMENTO_IDENTIFICACION
A|2
Tipo de identificación del usuario ver valores de la Tabla 22
4
NUMERO_DOCUMENTO_IDENTIFICACION
AF|3..16
Registro del número de documento de identificaicón de acuerdo al tipo de documento del usuario
5
PRIMER_APELLIDO
AF|3..450
Primer apellido del usuario beneficiario del servicio de salud
6
SEGUNDO_APELLIDO
AF|3..450
Segundo apellido del usuario beneficiario del servicio de salud
7
PRIMER_NOMBRE
AF|3..450
Primer nombre del usuario beneficiario del servicio de salud
8
Identificador
AN|4
Identificador de línea. Valor fijo: “SSCG”
PATH: No Aplica
9
CODIGO_PRESTADOR
AF|..50
Código asignado en el Sistema General de Seguridad Social en Salud (SGSSS) a los prestadores de servicios de salud que estén en el Registro Especial de Prestadores de Servicios de Salud (REPS) o el código asignado por el Ministerio de Salud y Protección Social para los laboratorios de salud pública.
10
TIPO_DOCUMENTO_IDENTIFICACION
A|2
Tipo de identificación del usuario ver valores de la Tabla 22
11
NUMERO_DOCUMENTO_IDENTIFICACION
AF|3..16
Registro del número de documento de identificaicón de acuerdo al tipo de documento del usuario
12
PRIMER_APELLIDO
AF|3..450
Primer apellido del usuario beneficiario del servicio de salud
13
SEGUNDO_APELLIDO
AF|3..450
Segundo apellido del usuario beneficiario del servicio de salud
14
PRIMER_NOMBRE
AF|3..450
Primer nombre del usuario beneficiario del servicio de salud
15
CODIGO_PRESTADOR
AF|..50
Código asignado en el Sistema General de Seguridad Social en Salud (SGSSS) a los prestadores de servicios de salud que estén en el Registro Especial de Prestadores de Servicios de Salud (REPS) o el código asignado por el Ministerio de Salud y Protección Social para los laboratorios de salud pública.
16
TIPO_DOCUMENTO_IDENTIFICACION
A|2
Tipo de identificación del usuario ver valores de la Tabla 22
17
NUMERO_DOCUMENTO_IDENTIFICACION
AF|3..16
Registro del número de documento de identificaicón de acuerdo al tipo de documento del usuario
18
PRIMER_APELLIDO
AF|3..450
Primer apellido del usuario beneficiario del servicio de salud
19
SEGUNDO_APELLIDO
AF|3..450
Segundo apellido del usuario beneficiario del servicio de salud
20
PRIMER_NOMBRE
AF|3..450
Primer nombre del usuario beneficiario del servicio de salud
Campos Generales Del Sector Salud: -> (Identificador SSalud)
Contiene 3 campos y 2 pipes (|):
Id_Campo
Atributo
Formato
Descripción
1
Identificador
AN|4
Identificador de línea. Valor fijo: “SSalud”
PATH: No Aplica
2
IdPersonalizacion
Por Definir
Para indicar tipo de operacion a traves de la cual se realizó el recaudo en los escenarios de acreditacion o reporte.
Identificador de línea (Repetible). Valor fijo: “SSextras”
PATH: No Aplica
2
controlInterno1
AN|100
C/C
Etiqueta asignada para la Representación Impresa PDF.
PATH: Variable
3
controlInterno2
Depende del Campo
C/C
Permite asociar dos o más campos mediante un índice (si
los campos son asociables)
PATH: Variable
4
nombre
Depende del Campo
SI
Código del campo extensible a referenciar
PATH: Variable
5
pdf
N|1
SI
Indicación de mostrar el campo en la representación gráfica PDF (0= No mostrar / 1= Mostrar)
PATH: Variable
6
valor
Depende del Campo
SI
Valor del campo a agregar
PATH: Variable
7
xml
N|1
SI
Indicación de mostrar el campo en el XML (0= No mostrar / 1= Mostrar)
PATH: Variable
NOTA: Para mayor información sobre la adición de campos extras, se recomienda ver sección USO DE CAMPOS EXTRAS del Manual de Integración
TABLAS DE CÓDIGOS DE PROPIEDADES PARA EMISIÓN DE DOCUMENTOS
En la siguiente sección encontrará información referente a las diferentes tablas de códigos de propiedades definidas por la DIAN en el anexo técnico.
Tabla 1
Tipos de Documentos
Anexo 1.8-2021 - 13.1.3. Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
Código
Significado
Uso
01
Factura electrónica de Venta
Tipos de factura
02
Factura electrónica de Venta - exportación
03
Documento electrónico de transmisión - tipo 03
04
Factura electrónica de Venta - tipo 04
91
Nota Crédito
Exclusivo en referencias a documentos (elementos DocumentReference)
92
Nota Débito
Tabla 2
Tipos de Operación
Anexo 1.8-2021 - 13.1.5. Tipos de operación
Para Facturas:
Código
Valor
10
Estandar*
09
AIU
11
Mandatos
12
Transporte
13
Cambiario
Nota: (*) Valor por default
Operación Salud
Código
SS-CUFE
SS-CUDE
SS-POS
SS-SNum
SS-Recaudo
Nota: La explicación y vigencia de los tipos de operación para el sector salud se informará en http://url.minsalud.gov.co/facturacion-electronica una vez que el Ministerio de Salud informe a todos los actores regulados por ellos.
Para Notas Crédito:
Código
Valor
20
Nota Crédito que referencia una factura electrónica*
22
Nota Crédito sin referencia a facturas*.
Nota: (*) El valor por default es 20, lo anterior quiere decir que si no se informa un valor, se asume que es 20 y aplicarán el conjunto de validaciones correspondiente. (*)Preferible para uso de notas rebate o de descuentos condicionados. Notas tipo 22 no tienen validación de rechazo. Objeto de control posterior.
Para Notas Débito:
Código
Valor
30
Nota Débito que referencia una factura electrónica*
32
Nota Débito sin referencia a facturas*.
Nota: El valor por default es 30, lo anterior quiere decir que si no se informara un valor se sume 30 y aplicarán el conjunto de validaciones correspondiente. Notas tipo 32 y 33 no tienen validación de rechazo. Objeto control posterior.
@IMPORTANTE: Las notas tipo 22 y 32 no tienen validación de rechazo. (Objeto de control Posterior).
Tabla 3
Tipos de identificación
Anexo 1.8-2021 - 13.2.1. Documento de identificación (Tipo de Identificador Fiscal):
@IMPORTANTE: (*) Deberá utilizarse solamente para el adquirente, debido a que este tipo de documento no pertenece a los tipos de documento en la base de datos del RUT.
Tabla 4
Código de descuento
Anexo 1.8-2021 - 13.3.8. Códigos de descuento
Código
Significado
00
Descuento no condicionado
01
Descuento Condicionado
Tabla 5
Tipos de Persona
Anexo 1.8-2021 - 13.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
Código
Significado
1
Persona Jurídica y asimiladas
2
Persona Natural y asimiladas
Tabla 6
Unidades de Medida
Anexo 1.8-2021 - 13.3.6. Unidades de Cantidad: @unitCode
Código
Descripción
Código
Descripción
Código
Descripción
04
spray pequeño
BIL
trillón de dólares
HUR
hora
05
levantar
BJ
cangilón
HY
cien yardas
08
Lote calor
BK
cesta
IA
pulgada libra
10
grupo
BL
bala
IC
contar por pulgada
11
equipar
BLD
barril seco
IE
persona
13
ración
BLL
barril (EE.UU.)(petróleo, etc.)
IF
pulgadas de agua
14
disparo
BO
botella
II
columna pulgada
15
palo
BP
cien pies de tabla
IL
pulgada por minuto
16
tambor de ciento quince kg
BQL
becquerel
IM
impresión
17
tambor de cien libras
BR
bar
INH
pulgada
@IMPORTANTE: Esta catalogo es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.
Tabla 7
Códigos para precios de referencia
Anexo 1.8-2021 - 13.3.9. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
Código
Significado
01
Valor comercial
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo codigoTipoPrecio
Tabla 8
Códigos para productos y servicios
Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
@schemeID
@schemeName
schemeAgencyID
Utilizar
001
UNSPSC
10
Colombia Compra Eficiente: utilizar contenido de la columna "Código"
Ver 8.1
010
GTIN
9
Números Globales de Identificación de Productos - GTIN
Ver 8.2
Cuando hay menos de 14 números en una estructura de datos (por ejemplo, GTIN8), los números se deben justificar a la derecha en un campo de 14 dígitos rellenado con cerros en las posiciones ubicadas más a la izquierda.
020
Partida Arancelarias
195
Partida arancelaria
999
Estándar de adopción del contribuyente
El valor en el atributo @schemeName no será validado
El atributo @schemeAgencyID no debe ser utilizado
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo codigoTipoPrecio
@IMPORTANTE: Para mayor información del código para productos y servicios hacer referencia a la sección del Anexo correspondiente.
Tabla 9
Motivos de Nota de crédito
Anexo 1.8-2021 - 13.3.4. Concepto de Corrección para Notas crédito: cac:DiscrepancyResponse/cbc:ResponseCode
Código
Descripción
1
Devolución parcial de los bienes y/o no aceptación parcial del servicio
2
Anulación de factura electrónica
3
Rebaja o descuento parcial o total
4
Ajuste de precio
5
Otros
Tabla 10
Motivos de Nota de débito
Anexo 1.7-2020 - 6.2.6. Concepto de Corrección para Notas débito: cac:DiscrepancyResponse/cbc:ResponseCode
Se genera la representación gráfica estándar por parte de la plataforma.
Se envía el XML y la representación gráfica estándar por el canal correspondiente al Adquiriente :Si el campo notificar está en SI
adjuntos=1
Se admiten adjuntos
El campo email es requerido y el campo notificar en SI
Se genera la representación gráfica estándar por parte de la plataforma.
Se envía el XML, la representación gráfica estándar generada y los demás adjuntos por el canal correspondiente al Adquiriente.
adjunto=10
No se admiten adjuntos.
No se genera la representación gráfica estándar por parte de la plataforma.
Se envía el XML sin la representación gráfica estándar, por el canal correspondiente al Adquiriente :Si el campo notificar está en SI.
adjunto=11
Se admiten adjuntos.
El campo email es requerido y el campo notificar en SI
No se genera la representación gráfica estándar por parte de la plataforma.
Se envía el XML sin la representación gráfica estándar y los demás adjuntos por el canal correspondiente al Adquiriente. (Uno de los adjuntos puede ser la representación gráfica personalizada por el ERP)
Tabla 20
Municipios
Anexo 1.7-2020 - 6.4.3. Municipios: cbc:CityName
Código Departamento
Código Municipio
Nombre Departamento
Nombre Municipio
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Ó
@IMPORTANTE: Este catálogo municipios es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.
Tabla 21
Zona Postal
Anexo 1.7-2020 - 6.4.4. Referencia a otros documentos cbc:PostalZone
En Colombia el código postal consta de 6 dígitos (ejemplo: 578986) que señalan inicialmente la posición geográfica, seguida por la de encaminamiento y finalmente la que nos ubica dentro del área postal, así:
Departamentos Nacionales
Los dos primeros dígitos representan a los departamentos nacionales, utilizando la codificación vigente Dane. Los códigos menores de 10 deben iniciar con un cero a la izquierda.
Zonas postales departamentales de encaminamiento
La tercera y cuarta posición definen las zonas postales de encaminamiento para facilitar la clasificación a través del Código Postal: El 00 queda reservado para la capital del departamento. Del 01 al 89 permite dividir cada departamento hasta en 89 zonas de encaminamiento postal.
Distrito postales por municipio o localidad
Las dos últimas posiciones del Código Postal Nacional permiten asignar cien distritos postales a cada una de las diez zonas postales creadas en cada departamento. Es decir, se pueden asignar hasta mil distritos distintos en cada departamento, para un total de treinta y tres mil a nivel nacional.
@IMPORTANTE: Para mayor información hacer referencia a la sección del Anexo correspondiente.
Tabla 22
Referencia a Documentos no Tributarios
Anexo 1.8 - 13.1.4. Referencia a documentos no tributarios: cbc:DocumentTypeCode
Este elemento se refiere alxpath /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode. Estos documentos representan acciones comerciales y mercantiles que amparan o soportan transaccionesrelacionadas con este documento electrónico.
Los documentos electrónicos XML adoptados por la DIAN no deben incluirse en este fragmento ya que
estos documentos no contienen las identificaciones estándar como CUFE o CUDE.
Al tratarse de una orden de entrega se debe utilizar el grupo de elemento OrderReference, al informar mas de una se debe disponer del grupo AdditionalDocumentReference.
Este campo de este grupo de información es opcional para referenciar temas comerciales a voluntad del
facturador electrónico, por tanto, los códigos son asignados por esté.
TABLAS DE CÓDIGOS PARA EMISIÓN DE DOCUMENTOS DEL SECTOR SALUD
Tabla 23
Tipo Documento Identificacion- Sector Salud
Abv
Tipo Documento de Identificación
CC
Cédula de ciudadanía
CE
Cédula de extranjería
CD
Carnet Diplomático
PA
Pasaporte
SC
Salvoconducto
PE
Permiso especial de permanencia
RC
Registro civil de nacimiento
TI
Tarjeta de Identidad
CN
Certificado de nacido vivo
AS
Adulto Sin Identificar
MS
Menor sin Identificar
DE
Documento Extranjero
SI
Sin Identificación
Tabla 24
Tipo Usuario - Sector Salud
Código
Tipo de usuario
01
Contributivo cotizante
02
Contributivo beneficiario
03
Contributivo adicional
04
Subsidiado
05
Sin régimen
06
Especiales o de Excepción cotizante
07
Especiales o de Excepción beneficiario
08
Particular
09
Tomador/Amparado ARL
10
Tomador/Amparado SOAT
11
Tomador/Amparado Planes voluntarios de salud
Tabla 25
Modalidades de Contratación - Sector Salud
Código
Modalidades de Contratación
01
Paquete / Canasta / Conjunto Integral de Salud
02
Grupos Relacionados por Diagnóstico
03
Integral por grupo de riesgo
04
Pago por contacto por especialidad
05
Pago por escenario de atención
06
Pago por tipo de servicio
07
Pago global prospectivo por episodio
08
Pago global prospectivo por grupo de riesgo
09
Pago global prospectivo por especialidad
10
Pago global prospectivo por nivel de complejidad
11
Capitación
12
Por servicio
Tabla 26
Cobertura o Plan de Beneficios - Sector Salud
Código
Cobertura o plan de servicios
01
Plan de beneficios en salud financiado con UPC
02
Presupuesto máximo
03
Prima EPS / EOC, no asegurados SOAT
04
Cobertura Póliza SOAT
05
Cobertura ARL
06
Cobertura ADRES
07
Cobertura Salud Pública
08
Cobertura entidad territorial, recursos de oferta
09
Urgencias población migrante
10
Plan complementario en salud
11
Plan medicina prepagada
12
Otra pólizas en salud
13
Cobertura Régimen Especial o Excepción
14
Cobertura Fondo Nacional de Salud de las Personas Privadas de la Libertad
15
Particular
Tabla 27
Conceptos de Recaudo
Código
Descripción
16
Copago
17
Cuota Moderadora
18
Cuota de recuperación
19
Planes compartidos en planes voluntarios de salud
Tabla 28
Tipos Escenarios
Código
Descripción
1
Registro del Concepto de recaudo al paciente
2
Registro del Concepto de acreditación a la EPS
3
Registro de operaciones sin acreditación a la EPS
4
Emisión de FEL sin recaudo previo
5
Incluyendo en una FEL el valor a acreditar por el recaudo