Diferencia entre revisiones de «Métodos Servicio Emisión Nómina Electrónica - Indice Manual Integración Nómina Electrónica»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
Línea 67: Línea 67:
 
|Nit
 
|Nit
 
|Debe corresponder al NIT del Empleador que realiza el DE
 
|Debe corresponder al NIT del Empleador que realiza el DE
 +
|-
 +
|ObjetoNomina
 +
|Objeto
 +
|Ver el detalle del Objeto Nomina más abajo
 
|}
 
|}
 
====Class.Nómina Electrónica====  
 
====Class.Nómina Electrónica====  
Línea 85: Línea 89:
 
|-  
 
|-  
 
|deducciones
 
|deducciones
−
|Array
+
|Class
 
| -
 
| -
 
|NO
 
|NO
Línea 94: Línea 98:
 
|-
 
|-
 
|devengados
 
|devengados
−
|Array
+
|Class
 
|
 
|
 
|SI
 
|SI
Línea 134: Línea 138:
 
: Información adicional Texto libre, relativo al documento.
 
: Información adicional Texto libre, relativo al documento.
 
: '''PATH''': /root/Notas.
 
: '''PATH''': /root/Notas.
 +
: ( Ver detalle en [[#Class.Notas|Class.Notas]])
 
|-
 
|-
 
|novedad
 
|novedad
Línea 159: Línea 164:
 
: Utilizado para Atributos del Lugar de Generacion del Documento XML
 
: Utilizado para Atributos del Lugar de Generacion del Documento XML
 
: '''PATH''': /root/LugarGeneracionXML
 
: '''PATH''': /root/LugarGeneracionXML
 +
: ( Ver detalle en [[#Class.LugarGeneracionXM|Class.LugarGeneracionXM]])
 
|-
 
|-
 
|pagos
 
|pagos
Línea 215: Línea 221:
 
: Tipo de documento de identificación que actualmente tiene el trabajador o aprendiz
 
: Tipo de documento de identificación que actualmente tiene el trabajador o aprendiz
 
: '''PATH''': /root/InformacionGeneral/@TipoXML
 
: '''PATH''': /root/InformacionGeneral/@TipoXML
−
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica #Tabla 1|Tabla 1]]
 
|-
 
|-
 
|tipoMoneda
 
|tipoMoneda
Línea 224: Línea 230:
 
: Tipo de Moneda utilizada en el documento
 
: Tipo de Moneda utilizada en el documento
 
: '''PATH''': /root/InformacionGeneral/@tipoMoneda
 
: '''PATH''': /root/InformacionGeneral/@tipoMoneda
−
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 2|Tabla 2]]
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica #Tabla 2|Tabla 2]]
 
|-
 
|-
 
|tipoNota
 
|tipoNota
Línea 233: Línea 239:
 
: Corresponde al tipo de Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica que se desee implementar  
 
: Corresponde al tipo de Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica que se desee implementar  
 
: '''PATH''': /root/tipoNota
 
: '''PATH''': /root/tipoNota
−
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica #Tabla 3|Tabla 3]]
 
|-
 
|-
 
|totalComprobante
 
|totalComprobante
Línea 622: Línea 628:
 
: '''PATH''': /No Aplica
 
: '''PATH''': /No Aplica
 
|-
 
|-
−
|extras
+
|transporte
−
|String
+
|Array<String>
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
:Habilitado como campo opcional
+
:Utilizado para Atributos de Transporte de Devengos del Documento
−
: '''PATH''': /No Aplica
+
: '''PATH''': /Class.Transporte
 +
: (ver detalle en [[#Class.Transporte|Class.Transporte]])
 +
 
 
|-
 
|-
−
|extras
+
|vacaciones
−
|String
+
|Class
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
|-
 
−
|extras
 
−
|String
 
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
:Habilitado como campo opcional
+
:Utilizado para Todos los Elementos de Vacaciones de Devengos del Documento
−
: '''PATH''': /No Aplica
+
: '''PATH''': /Class.Devengados/vacaciones
−
|-
+
: (ver detalle en [[#Class.Vacaciones|Class.Vacaciones]])
−
|extras
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
:Habilitado como campo opcional
 
−
: '''PATH''': /No Aplica
 
−
 
 
 
|}
 
|}
  
−
====Class.CargosDescuentos====
+
====Class.documentosReferenciados====
 
{| class="mw-collapsible mw-collapsed wikitable"
 
{| class="mw-collapsible mw-collapsed wikitable"
 
! style="background:#f2f2f2; text-align:center;"|Atributo
 
! style="background:#f2f2f2; text-align:center;"|Atributo
Línea 728: Línea 656:
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
 
|-
 
|-
−
|codigo
+
|cunePred
 
|String
 
|String
−
|<nowiki>AN|2</nowiki>
+
| -
 
|C/C
 
|C/C
 
|
 
|
−
: Código para categorizar el descuento
+
: Debe corresponder al CUNE del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
−
: '''Obligatorio''': Si es descuento a nivel de factura (general)
+
: '''PATH''': /Class.documentosReferenciados/@CUNEPred
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si es descuento y no se informa algunos de los valores en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
 
−
: '''PATH''': …/cbc:AllowanceChargeReasonCode
 
−
|-
 
−
|descripcion
 
−
|String
 
−
|<nowiki>AN|10..5000</nowiki>
 
−
|SI
 
−
|
 
−
: Texto libre para informar la razón del descuento
 
−
: '''PATH''': …/cbc:AllowanceChargeReason
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> : Si se informa un cargo o descuento y no se informa este elemento
 
 
|-
 
|-
 
|extras
 
|extras
−
|Array  <Extensible>
+
|String
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Campos o información opcional para el modelo de negocio del emisor
+
:Habilitado como campo opcional
−
: '''PATH''': No definido  
+
: '''PATH''': /No definido
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|indicador
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|SI
 
−
|
 
−
: Indicador de si es Cargo”1” o Descuento “0”
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Si este elemento contiene una información diferente de “1” o “0”
 
−
: '''PATH''': …/cbc:ChargeIndicator
 
 
|-
 
|-
−
|monto
+
|fechaGenPred
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Si  es Descuento y monto > montoBase
 
−
: '''PATH''': …/cbc:Amount
 
−
|-
 
−
|montoBase
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Valor Base para calcular el descuento o el cargo,
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si montoBase > totalMonto
 
−
: '''PATH''': …/cbc:BaseAmount
 
−
|-
 
−
|porcentaje
 
−
|String
 
−
|Ent: <nowiki>N|..6</nowiki>
 
−
Dec: <nowiki>N|2</nowiki>
 
−
|SI
 
−
|
 
−
: Porcentaje del descuento
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si este elemento > 100
 
−
: '''PATH''': …/cbc:MultiplierFactorNumeric
 
−
|-
 
−
|secuencia
 
−
|String
 
−
|<nowiki>N|..3</nowiki>
 
−
|SI
 
−
|
 
−
: Indicador de orden de secuencia
 
−
: '''PATH''': …/cbc:ID
 
−
|}
 
−
====Class.Cliente====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|actividadEconomicaCIIU
 
−
|String
 
−
|<nowiki>AN|…4</nowiki>
 
−
|NO
 
−
|
 
−
: Corresponde al código de actividad económica CIIU
 
−
: '''PATH''': .. /cac:Party/cbc:IndustryClassificationCode
 
−
|-
 
−
|apellido
 
 
|String  
 
|String  
−
|<nowiki>AN|…50</nowiki>
 
−
|NO
 
−
|
 
−
: Apellido del adquiriente.
 
−
: '''PATH''': No definido
 
−
|-
 
−
|destinatario
 
−
|Array <Destinatario>
 
−
| -
 
−
|C/C
 
−
|
 
−
: Permite especifica el medio y los datos de la entrega electrónica del documento
 
−
: '''Obligatorio''': Si campo notificar = ‘SI’
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Destinatario|Class.Destinatario]])
 
−
|-
 
−
|detallesTributarios
 
−
|Array <Tributos>
 
 
| -
 
| -
 
|SI
 
|SI
 
|
 
|
−
: Detalles tributarios del adquirente
+
: Debe corresponder a la Fecha de Emision del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si la clase no es informada
+
: '''PATH''': /Class.documentosReferenciados/fechaGenPred
−
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
 
−
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
 
 
|-
 
|-
−
|direccionCliente
+
|numeroPred
−
|Direccion
 
−
| -
 
−
|C/C
 
−
|
 
−
: Información donde se detalle la dirección de recepción del adquiriente
 
−
: '''Recomendado''': Esta dirección ransf es la que se pinta en la representación gráfica estándar
 
−
: '''PATH''': ../cac:Party/cac:PhysicalLocation/cac:Address
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|direccionFiscal
 
−
|Direccion
 
−
| -
 
−
|C/C
 
−
|
 
−
: Dirección fiscal del adquiriente.
 
−
: '''Obligatorio''': Si el adquirente es responsable
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el adquirente es responsable y no fue informada esta clase
 
−
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|email
 
 
|String
 
|String
−
|<nowiki>AN|..50</nowiki>
 
−
|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
 
−
|-
 
−
|extras
 
−
|Array  <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|informacionLegalCliente
 
−
|InformacionLegalCliente
 
−
| -
 
−
|C/C
 
−
|
 
−
: Información legal del cliente
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
 
−
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
 
−
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
 
−
|-
 
−
|nombreComercial
 
−
|String
 
−
|<nowiki>AN|5..450</nowiki>
 
−
|C/C
 
−
|
 
−
: Nombre Comercial del adquiriente
 
−
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
 
−
: '''PATH''': /cac:Party/cac:PartyName
 
−
|-
 
−
|nombreContacto
 
−
|String
 
−
|<nowiki>AN|5..450</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre de Contacto
 
−
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
 
−
|-
 
−
|nombreRazonSocial
 
−
|String
 
−
|<nowiki>AN|5..450</nowiki>
 
−
|SI
 
−
|
 
−
: Nombre o Razón Social del adquirente
 
−
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
 
−
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName 
 
−
|-
 
−
|nota
 
−
|String
 
−
|<nowiki>AN|..450</nowiki>
 
−
|NO
 
−
|
 
−
: Nota adicional de contacto
 
−
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
 
−
|-
 
−
|notificar
 
−
|String
 
−
|<nowiki>AN|2</nowiki>
 
−
|SI
 
−
|
 
−
: Activa el envío de email al adquirente.
 
−
: Valores posibles: “SI” o “NO”
 
−
: '''PATH''': No aplica
 
−
|-
 
−
|numeroDocumento
 
−
|String
 
−
|<nowiki>AN|..12</nowiki>
 
−
|SI
 
−
|
 
−
: Número del Documento o Identificación Fiscal del adquirente
 
−
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Nota</b></span> : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
 
−
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
 
−
|-
 
−
|numeroIdentificacionDV
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
−
|C/C
 
−
|
 
−
: Digito de verificación NIT del adquiriente
 
−
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
 
−
: '''PATH''':
 
−
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
 
−
|-
 
−
|responsabilidadesRut
 
−
|Array <Obligaciones>
 
 
| -
 
| -
 
|SI
 
|SI
 
|
 
|
−
: Obligaciones y régimen del adquiriente
+
: Debe corresponder al Numero de Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si la clase no es informada
+
: '''PATH''': …/Class.documentosReferenciados/numeroPred
−
: '''PATH''': ../cac:Party/cac:PartyTaxScheme/cbc:TaxLevelCode
 
−
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
 
−
|-
 
−
|segundoNombre
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Segundo nombre del adquiriente.
 
−
: '''PATH''': No definido 
 
−
|-
 
−
|telefax
 
−
|String
 
−
|<nowiki>N|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Telefax
 
−
: '''PATH''': ../cac:Party/cac:Contact/cbc:Telefax
 
−
|-
 
−
|telefono
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Teléfono del adquiriente
 
−
: '''PATH''': …/cac:Party/cac:Contact/cbc:Telephone
 
−
|-
 
−
|tipoIdentificacion
 
−
|String
 
−
|<nowiki>N|2</nowiki>
 
−
|SI
 
−
|
 
−
: Tipo de Identificación del adquiriente
 
−
: <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  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Nota</b></span>: Para identificar al consumidor final se utiliza el código “13”
 
−
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
 
−
|-
 
−
|tipoPersona
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|SI
 
−
|
 
−
: Identificador de tipo de persona
 
−
: <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  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
 
−
: '''PATH''': …/cbc:AdditionalAccountID
 
 
|}
 
|}
−
====Class.CondicionPago====
+
====Class.Notas====
 
{| class="mw-collapsible mw-collapsed wikitable"
 
{| class="mw-collapsible mw-collapsed wikitable"
 
! style="background:#f2f2f2; text-align:center;"|Atributo
 
! style="background:#f2f2f2; text-align:center;"|Atributo
Línea 1022: Línea 695:
 
! style="background:#f2f2f2; text-align:center;"|Requerido
 
! style="background:#f2f2f2; text-align:center;"|Requerido
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
−
|-
 
−
|codigoEvento
 
−
|String
 
−
| <nowiki>AN|..3</nowiki>
 
−
|NO
 
−
|
 
−
: Codigo de Evento
 
−
: '''PATH''': ../cbc:ReferenceEventCode
 
−
|-
 
−
|comentario
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nota
 
−
: '''PATH''': ../cbc:Note
 
−
|-
 
−
|duracionPeriodo
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
−
|NO
 
−
|
 
−
: Duración de Periodo
 
−
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure
 
−
|-
 
−
|duracionPeriodoMedida
 
−
|String
 
−
|<nowiki>AN|..10</nowiki>
 
−
|NO
 
−
|
 
−
: Unidad de medida de la duración de periodo
 
−
: '''PATH''': ../cac:SettlementPeriod/cbc:DurationMeasure@unitCode
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
|-
 
−
|fechaVencimiento
 
−
|String
 
−
|<nowiki>AN|..10</nowiki>
 
−
|SI
 
−
|
 
−
: Fecha de Vencimiento
 
−
: '''PATH''': ../cbc:PaymentDueDate
 
−
|-
 
−
|identificador
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
−
|NO
 
−
|
 
−
: Condiciones de Pago
 
−
: '''PATH''': ../cbc:ID
 
−
|-
 
−
|medioPagoAsociado
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
−
|NO
 
−
|
 
−
: Medio Pago asociado
 
−
: '''PATH''': ../cbc:PaymentMeansID
 
−
|-
 
−
|monto
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
|SI
 
−
|
 
−
: Monto
 
−
: '''PATH''': ../cbc:Amount
 
−
|-
 
−
|montoMulta
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Monto de la multa
 
−
: '''PATH''': ../cbc:PenaltySurchargePercent
 
−
|-
 
−
|montoPenalidad
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Monto de la Penalidad
 
−
: '''PATH''': ../cbc:PenaltyAmount
 
−
|-
 
−
|periodoDesde
 
−
|String
 
−
|<nowiki>AN|..10</nowiki>
 
−
|NO
 
−
|
 
−
: Periodo desde
 
−
: '''PATH''': ../cbc:StartDate
 
−
|-
 
−
|periodoHasta
 
−
|String
 
−
|<nowiki>AN|..10</nowiki>
 
−
|NO
 
−
|
 
−
: Periodo hasta
 
−
: '''PATH''': ../cbc:EndDate
 
−
|-
 
−
|porcentajeDescuento
 
−
|String
 
−
|Ent: <nowiki>N|..6</nowiki>
 
−
Dec: <nowiki>N|2</nowiki>
 
−
|NO
 
−
|
 
−
: Porcentaje de Descuento
 
−
: '''PATH''': ../cbc:SettlementDiscountPercent
 
−
|-
 
−
|porcentajePago
 
−
|String
 
−
|Ent: <nowiki>N|..6</nowiki>
 
−
Dec: <nowiki>N|2</nowiki>
 
−
|SI
 
−
|
 
−
: Porcentaje de Pago
 
−
: '''PATH''': . /cbc:PaymentPercent
 
−
|-
 
−
|referenciaAnticipo
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Numero de referencia de Anticipo
 
−
: '''PATH''': ../cac:PrepaidPaymentReferenceID
 
−
|}
 
−
====Class.FacturaDetalle====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|cantidadPorEmpaque
 
−
|String
 
−
| <nowiki>N|..3 </nowiki>
 
−
| 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
 
−
|-
 
−
|cantidadReal
 
−
|String
 
−
|<nowiki>N|..6</nowiki>
 
−
|SI
 
−
|
 
−
: Cantidad real sobre la cual el precio aplica
 
−
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
 
−
|-
 
−
|cantidadRealUnidadMedida
 
−
|String
 
−
|<nowiki>AN|..6</nowiki>
 
−
|SI
 
−
|
 
−
: Unidad de la cantidad sobre la cual el precio aplica
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el valor del atributo no se encuentra en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|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
 
−
|-
 
−
|cantidadUnidades
 
−
|String
 
−
|<nowiki>N|..6</nowiki>
 
−
|SI
 
−
|
 
−
: Cantidad de unidades del producto/servicio facturado
 
−
: '''PATH''': .. /cbc:InvoicedQuantity
 
−
|-
 
−
|cargosDescuentos
 
−
|Array <CargosDescuentos>
 
−
| -
 
−
|C/C
 
−
|
 
−
: Información de cargos y descuentos
 
−
: '''Obligatorio''' Este arreglo se debe informar a nivel de ítem, si y solamente si el cargo o descuento afecta la base gravable del ítem.
 
−
: Si un cargo individual general a la factura genera IVA, debe reportarse como ítem
 
−
: '''PATH''': ../cac:AllowanceCharge
 
−
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
 
−
|-
 
−
|codigoFabricante
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Código del fabricante correspondiente al artículo
 
−
: '''PATH''': .. /cac:Item/cac:
 
−
: ManufacturersItemIdentification/cbc:ID
 
−
|-
 
−
|codigoIdentificadorPais
 
−
|String
 
−
|<nowiki>A|2</nowiki>
 
−
|NO
 
−
|
 
−
: Código Identificador del país de origen del artículo o servicio
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
 
−
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
 
−
|-
 
−
|codigoProducto
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|SI
 
−
|
 
−
: Código del vendedor correspondiente al artículo
 
−
: '''PATH''': .. /cac:Item/cac:SellersItemIdentification/cbc:ID
 
−
|-
 
−
|codigoTipoPrecio
 
−
|String
 
−
|<nowiki>AN|..3</nowiki>
 
−
|C/C
 
−
|
 
−
: Código del tipo de precio informado
 
−
: '''Obligatorio''' Para muestras comerciales (valor = 01)
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el valor del atributo no se encuentra en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
 
−
: '''PATH''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceTypeCode
 
 
|-
 
|-
 
|descripcion
 
|descripcion
−
|String
 
−
|<nowiki>AN|..300</nowiki>
 
−
|SI
 
−
|
 
−
: Descripción del producto o servicio
 
−
: '''PATH''': ../Item/cbc:Description
 
−
|-
 
−
|descripcionTecnica
 
−
|String
 
−
|<nowiki>AN|..300</nowiki>
 
−
|NO
 
−
|
 
−
: Datos técnicos asociados al producto o servicio
 
−
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
 
−
|-
 
−
|documentosReferenciados
 
−
|Array <DocumentoReferenciado>
 
−
| -
 
−
|NO
 
−
|
 
−
: Informaciones que describen un documento referenciado
 
−
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
 
−
: '''PATH''': /root/cac:DiscrepancyResponse,
 
−
: /root/cac:BillingReference,
 
−
: /root/cac: AdditionalDocumentReference,
 
−
: /root/cac: DespatchDocumentReference,
 
−
: /root/cac: ReceiptDocumentReference
 
−
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
 
−
|-
 
−
|estandarCodigo
 
−
|String
 
−
|AN
 
−
|NO
 
−
|
 
−
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
 
−
: Ver valores del atributo en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el código no existe en un estándar cerrado.
 
−
: Ejemplo: UNSPSC
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el código no sigue la regla de formación de un código abierto, pero con valores verificables
 
−
: Ejemplo: GTIN, Ejemplo:Partidas arancelarias
 
−
: '''Nota''': En este caso puede utilizarse el código 999 (Estándar de adopción del contribuyente) para evitar reclasificar los productos
 
−
: '''PATH''': /cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeID
 
−
|-
 
−
|estandarCodigoID
 
−
|String
 
−
|AN
 
−
|NO
 
−
|
 
−
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si estandarCodigo = 010 y estandarCodigoID es diferente a 9
 
−
: Ver valores del atributo en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
 
−
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID/@schemeAgencyID
 
−
|-
 
−
|estandarCodigoIdentificador
 
−
|String
 
−
|AN
 
−
|NO
 
−
|
 
−
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
 
−
: Ver valores del atributo en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
 
−
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeDataURI
 
−
|-
 
−
|estandarCodigoNombre
 
−
|String
 
−
|AN
 
−
|NO
 
−
|
 
−
: Asociado al código del estándar (identificación del artículo o servicio de acuerdo con un estándar).
 
−
: Ver valores del atributo en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
 
−
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID@schemeAgencyName
 
−
|-
 
−
|estandarCodigoProducto
 
−
|String
 
−
|AN
 
−
|NO
 
−
|
 
−
: Código del producto según el estándar informado en estandarCodigo
 
−
: Ver valores del atributo en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
 
−
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
 
−
|-
 
−
|estandarOrganizacion
 
 
|String
 
|String
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Estándar de la organización
+
: Campo de libre uso para Observaciones en el documento
−
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
+
: '''PATH''': .. /class.notas/descripcion
−
|-
 
−
|estandarSubCodigoProducto
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Sub código del estándar del producto
 
−
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
 
 
|-
 
|-
 
|extras
 
|extras
−
|Array  <Extensible>
+
|String
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Campos o información opcional para el modelo de negocio del emisor
+
:Habilitado como campo opcional
−
: '''PATH''': No definido
+
: '''PATH''': /No definido
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|impuestosDetalles
 
−
|Array <FacturaImpuestos >
 
−
| -
 
−
|SI
 
−
|
 
−
: Información de impuestos
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si existe más de un elemento con el mismo valor en el atributo FacturaImpuestos.codigoTOTALImp
 
−
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
 
−
: Adicionalmente, NO debe ser informado para facturas del régimen simple grupo I, ni para ítems cuyo concepto en contratos de AIU no haga parte de la base gravable.
 
−
: A nivel de ítem solo aplica para tributos que deban informarse a nivel de ítem, por ejemplo: IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
 
−
: '''PATH''': ../cac:TaxTotal (impuestos),
 
−
: ../cac: WithholdingTaxTotal (retenciones)
 
−
: (ver detalle en [[#Class.FacturaImpuestos|Class.FacturaImpuestos]])
 
−
|-
 
−
|impuestosTotales
 
−
|Array <ImpuestosTotales> 
 
−
| -
 
−
|SI
 
−
|
 
−
: Sumatoria de los impuestos por todos los tipos
 
−
: Este grupo NO debe ser informado para ítems excluidos de acuerdo a lo establecido en el Estatuto Tributario.
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el valor del valor total del impuesto indicado es diferente a la sumatoria de lo reportado en FacturaImpuestos. valorTOTALImp.
 
−
: A nivel de ítem solo aplica para tributos que deban informase a nivel de ítem, por ejemplo, IVA, INC, IC, Impuesto Nacional a los Combustibles, entre otros
 
−
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount (impuestos),
 
−
: ../cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones)
 
−
: (ver detalle en [[#Class.ImpuestosTotales|Class.ImpuestosTotales]])
 
−
|-
 
−
|informacionAdicional
 
−
|Array <LineaInformacionAdicional>
 
−
| -
 
−
|NO
 
−
|
 
−
: Sirve para adicionar información específica del producto que puede ser solicitada por autoridades o entidades diferentes a la DIAN
 
−
: '''PATH''': ../cac:Item/cac:AdditionalItemProperty
 
−
: (ver detalle en [[#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]])
 
−
|-
 
−
|mandatorioNumeroIdentificacion
 
−
|String
 
−
|<nowiki>N|..12</nowiki>
 
−
|C/C
 
−
|
 
−
: NIT del mandatario
 
−
: '''Obligatorio''' para facturas por mandato
 
−
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID
 
−
|-
 
−
|mandatorioNumeroIdentificacionDV
 
−
|String
 
−
|<nowiki>N|..2</nowiki>
 
−
|C/C
 
−
|
 
−
: Digito Verificador del NIT del mandatario
 
−
: '''Obligatorio''' para facturas por mandato
 
−
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/ @schemeID
 
−
|-
 
−
|mandatorioTipoIdentificacion
 
−
|String
 
−
|<nowiki>N|2</nowiki>
 
−
|C/C
 
−
|
 
−
: Tipo de identificación del mandatario
 
−
: '''Obligatorio''' Para facturas por mandato
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si mandatorioNumeroIdentificacion es informado y el valor del este campo no se encuentra en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
 
−
: '''PATH''': ../cac:Item/cac:InformationContentProviderParty/cac:PowerOfAttorney/cac:AgentParty/cbc:ID/@schemeName
 
−
|-
 
−
|marca
 
−
|String
 
−
|<nowiki>AN|..100</nowiki>
 
−
|C/C
 
−
|
 
−
: Marca del artículo.
 
−
: '''Obligatorio''' Si es factura internacional
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si tipoDocumento = “02” y este elemento no fue informado
 
−
: '''PATH''': ../Item/cbc:BrandName
 
−
|-
 
−
|modelo
 
−
|String
 
−
|<nowiki>AN|..100</nowiki>
 
−
|C/C
 
−
|
 
−
: Modelo del artículo.
 
−
: '''Obligatorio''' Si es factura internacional
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si tipoDocumento = “02” y este elemento no fue informado
 
−
: '''PATH''': ../Item/cbc:ModelName
 
−
|-
 
−
|muestraGratis
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|C/C
 
−
|
 
−
: Indicador de si el ítem es gratuito o no (sin valor comercial)
 
−
: '''Obligatorio''' Para muestras comerciales
 
−
: Valores posibles: “1” (Es muestra gratis) ó “0” (No es muestra gratis)
 
−
: '''PATH''': ../cbc:FreeOfChargeIndicator
 
−
|-
 
−
|nombreFabricante
 
−
|String
 
−
|<nowiki>AN|..100</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre del fabricante del producto/servicio
 
−
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
 
−
|-
 
−
|nota
 
−
|String
 
−
|<nowiki>AN|20..5000</nowiki>
 
−
|C/C
 
−
|
 
−
: Texto libre para añadir información adicional al artículo
 
−
: '''Obligatorio''' Informar para el caso de facturas por contratos de servicio tipo AIU. Para el ítem Adminsitración. En este caso la nota debe empezar por el texto: “Contrato de servicios AIU por concepto de:” El contribuyente debe incluir el objeto del contrato facturado
 
−
: '''PATH''': ../cbc:Note
 
−
|-
 
−
|precioReferencia
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|C/C
 
−
|
 
−
: Valor del artículo o servicio.
 
−
: Corresponde al valor del precio referencia del ítem que se da como muestra o regalo sin valor comercial
 
−
: '''Obligatorio''' Para muestras comerciales
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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''': ../cac:PricingReference/cac:AlternativeConditionPrice/cbc:PriceAmount
 
−
|-
 
−
|precioTotal
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|C/C
 
−
|
 
−
: Precio total del producto o servicio.
 
−
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos +impuestos)
 
−
: '''Obligatorio''' Para uso en las representaciones gráficas
 
−
: '''PATH''': No definido
 
−
|-
 
−
|precioTotalSinImpuestos
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Valor total de la línea sin impuestos.
 
−
: (cantidadUnidades*precioVentaUnitario +cargos-descuentos)
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si se informa el atributo precioTotalSinImpuestos en 0.00 entonces el valor de precioReferencia debe ser informado ya que se trata de muestra o regalo comercial   
 
−
: '''PATH''': ../cbc:LineExtensionAmount
 
−
|-
 
−
|precioVentaUnitario
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Precio Unitario del porducto/servicio
 
−
: '''PATH''': ../Price/cbc:PriceAmount 
 
−
|-
 
−
|secuencia
 
−
|String
 
−
|<nowiki>AN|..4</nowiki>
 
−
|SI
 
−
|
 
−
: Indicador de orden de secuencia (número de línea)
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si los números utilizados en los diferentes grupos no son consecutivos, empezando en “1”
 
−
: '''PATH''': ../cbc:ID
 
−
|-
 
−
|seriales
 
−
|String
 
−
|<nowiki>AN|..500</nowiki>
 
−
|NO
 
−
|
 
−
: Seriales del producto (separador por coma), Ej: ABC123,ABC456
 
−
: '''PATH''': ../cac:Item/cac:ItemInstance/cbc:SerialID
 
−
|-
 
−
|subCodigoFabricante
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Código del fabricante correspondiente a una sub-especificación del artículo
 
−
: '''PATH''': ../cac:Item/cac:ManufacturersItemIdentification/cbc:ExtendedID
 
−
|-
 
−
|subCodigoProducto
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Código del emisor/vendedor correspondiente a una sub-especificación del artículo
 
−
: '''PATH''': ../Item/cac:SellersItemIdentification/cbc:ExtendedID
 
−
|-
 
−
|tipoAIU
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Para Clasificar el tipo de AIU
 
−
: '''PATH''': No aplica
 
−
|-
 
−
|unidadMedida
 
−
|String
 
−
|<nowiki>AN|..3</nowiki>
 
−
|SI
 
−
|
 
−
: Código de Unidad de medida del producto/servicio facturado
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el valor del atributo no se encuentra en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
 
−
: (Se puede utilizar el código estandár “WSD”, unidad “94” o Acuerdo Mutuo “ZZ” para NO reclasificar los productos)
 
−
: '''PATH''': ../cbc:InvoicedQuantity@unitCode
 
 
|}
 
|}
−
====Class.Destinatario====
+
====Class.LugarGeneracionXML====
 
{| class="mw-collapsible mw-collapsed wikitable"
 
{| class="mw-collapsible mw-collapsed wikitable"
 
! style="background:#f2f2f2; text-align:center;"|Atributo
 
! style="background:#f2f2f2; text-align:center;"|Atributo
Línea 1566: Línea 720:
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
 
|-
 
|-
−
|canalDeEntrega
+
|departamentoEstado
 
|String
 
|String
 
| -
 
| -
 
|SI
 
|SI
 
|
 
|
−
: Medio de Entrega del Documento Electrónico
+
: Código del departamento donde se genera el documento
−
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
+
: '''PATH''': ../Class.LugarGeneracionXML/departamentoEstado
−
: PATH: No aplica
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica#Tabla 4|Tabla 4]]
−
|-
 
−
|email
 
−
|Array <String>
 
−
| -
 
−
|C/C
 
−
|
 
−
: Lista de Correos Electrónicos a los cuales se realizará la entrega del documento electrónico si el canalDeEntrega=’0’
 
−
: '''Obligatorio''' Cuando canalDeEntrega=’0’
 
−
: '''PATH''': No aplica
 
 
|-
 
|-
 
|extras
 
|extras
−
|Array <Extensible>
+
|String
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Campos o información opcional para el modelo de negocio del emisor
+
:Habilitado como campo opcional
−
: '''PATH''': No definido  
+
: '''PATH''': /No definido
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fechaProgramada
 
−
|String
 
−
|<nowiki>AN|19</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha programada
 
−
: '''PATH''': No aplica
 
 
|-
 
|-
−
|mensajeProgramado
+
|idioma
 
|String
 
|String
 
| -
 
| -
−
|NO
 
−
|
 
−
: Mensaje
 
−
: '''PATH''': No aplica
 
−
|-
 
−
|nitProveedorReceptor
 
−
|String
 
−
|<nowiki>N|..12</nowiki>
 
−
|C/C
 
−
|
 
−
: NIT del Destinatario
 
−
: '''Obligatorio''' Cuando canalDeEntrega=’1’ ó ‘2’
 
−
: '''PATH''': No aplica
 
−
|-
 
−
|telefono
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|C/C
 
−
|
 
−
: Teléfono del Destinatario
 
−
: '''Obligatorio''' Cuando canalDeEntrega=’3’ ó ‘4’
 
−
: '''PATH''': No aplica
 
−
|}
 
−
====Class.DocumentoReferenciado====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoEstatusDocumento
 
−
|String
 
−
| -
 
−
|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
 
−
|-
 
−
|codigoInterno
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
 
|SI
 
|SI
 
|
 
|
−
: Este campo decide si en que nodo XML se va a enviar la información de DocumentoReferenciado, posibles valores:
+
: Codigo del país donde se genera el documento
−
# AdditionalDocumentReference (FE de contingencia y para acciones comerciales y mercantiles)
+
: '''PATH''': ../Class.LugarGeneracionXML/idioma
−
# DespatchDocumentReference (Doc. De despacho)
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica#Tabla 5|Tabla 5]]
−
# ReceiptDocumentReference (Doc. De recepción)
 
−
# DiscrepancyResponse (N.C y N.D)
 
−
# BillingReference (Facturas por corrección, N.C y N.D)
 
 
|-
 
|-
−
|cufeDocReferenciado
+
|municipioCiudad
 
|String
 
|String
−
|<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
 
−
|-
 
−
|descripcion
 
−
|Array <String>
 
−
|<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
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
 
| -
 
| -
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fecha
 
−
|String
 
−
|<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
 
−
|-
 
−
|fechaFinValidez
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha de Fin de Validez
 
−
: '''PATH''': No definido
 
−
|-
 
−
|fechaInicioValidez
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha de Inicio de Validez
 
−
: '''PATH''': No definido
 
−
|-
 
−
|numeroDocumento
 
−
|String
 
−
|<nowiki>AN..20</nowiki>
 
 
|SI
 
|SI
 
|
 
|
−
: Concatenación del prefijo y el número del documento referenciado
+
: Código del municipio o ciudad donde se genera el documento
−
: <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''': ../Class.LugarGeneracionXML/municipioCiudad
−
: '''PATH''':
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica#Tabla 6|Tabla 6]]
−
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
 
−
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
 
−
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
 
−
: /cbc:ID
 
 
|-
 
|-
−
|tipoCUFE
+
|pais
 
|String
 
|String
−
|<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
 
−
|-
 
−
|tipoDocumento
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Descripción del tipo de documento referenciado,
 
−
: Ejemplo: “Factura de Venta Nacional”
 
−
: '''PATH''': No definido
 
−
|-
 
−
|tipoDocumentoCodigo
 
−
|String
 
−
|<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 21|Tabla 21]]
 
−
: '''Nota''': Para ordenes de remisión, informar el código ‘AAJ’
 
−
: '''PATH''': /Invoice/cac:AdditionalDocumentReference/cbc: DocumentTypeCode
 
−
: / CreditNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
 
−
: / DebitNote /cac:AdditionalDocumentReference/cbc: DocumentTypeCode
 
−
|}
 
−
'''@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.
 
−
# 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.''
 
−
 
−
====Class.Entrega====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|datosTransportistas
 
−
|DatoTransportistas
 
 
| -
 
| -
−
|NO
 
−
|
 
−
: Datos del Transportista
 
−
: '''PATH''': ../cac:DeliveryParty
 
−
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
 
−
|-
 
−
|direccionDespacho
 
−
|Direccion
 
−
| -
 
−
|NO
 
−
|
 
−
: Información de Despacho
 
−
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|direccionEntrega
 
−
|Direccion
 
−
| -
 
−
|NO
 
−
|
 
−
: Información de Entrega
 
−
: '''PATH''': ../cac:DeliveryAddress
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fechaEfectivaSalida
 
−
|String
 
−
|<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
 
−
|-
 
−
|fechaEstimada
 
−
|String
 
−
|<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
 
−
|-
 
−
|fechaReal
 
−
|String
 
−
|<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
 
−
|-
 
−
|fechaSolicitada
 
−
|String
 
−
|<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
 
−
|-
 
−
|identificacionTransporte
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Datos del Transporte
 
−
: '''PATH''': ../cac:Despatch/cbc:ID
 
−
|-
 
−
|matriculaTransporte
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Matricula del Transporte
 
−
: '''PATH''': ../cac:Despatch/ cbc:ID/@schemeAgencyID
 
−
|}
 
−
====Class.Extras====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|controlInterno1
 
−
|String
 
−
|<nowiki>AN|100</nowiki>
 
−
|C/C
 
−
|
 
−
: Etiqueta asignada para la Representación Impresa PDF.
 
−
: '''PATH''': Variable
 
−
|-
 
−
|controlInterno2
 
−
|String
 
−
|Depende del Campo
 
−
|C/C
 
−
|
 
−
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
 
−
: '''PATH''': Variable
 
−
|-
 
−
|nombre
 
−
|String
 
−
|Depende del Campo
 
−
|SI
 
−
|
 
−
: Código del campo extensible a referenciar
 
−
: (Ver sección [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|USO DE CAMPOS EXTRAS]])
 
−
: '''PATH''': Variable
 
−
|-
 
−
|pdf
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|SI
 
−
|
 
−
: Indicación de mostrar el campo en la representación gráfica PDF
 
−
: (“0” = No mostrar / “1” = Mostrar)
 
−
: '''PATH''': Variable
 
−
|-
 
−
|valor
 
−
|String
 
−
|Depende del Campo
 
−
|SI
 
−
|
 
−
: Valor del campo a agregar
 
−
: '''PATH''': Variable
 
−
|-
 
−
|xml
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|SI
 
−
|
 
−
: Indicación de mostrar el campo en el XML
 
−
: (“0” = No mostrar / “1” = Mostrar)
 
−
: '''PATH''': Variable
 
−
|}
 
−
====Class.Extensible====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|controlInterno1
 
−
|String
 
−
|<nowiki>AN|100</nowiki>
 
−
|C/C
 
−
|
 
−
: Etiqueta asignada para la Representación Impresa PDF.
 
−
: '''PATH''': Variable
 
−
|-
 
−
|controlInterno2
 
−
|String
 
−
|Depende del Campo
 
−
|C/C
 
−
|
 
−
: Permite asociar dos o más campos mediante un índice (si los campos son asociables)
 
−
: '''PATH''': Variable
 
−
|-
 
−
|nombre
 
−
|String
 
−
|Depende del Campo
 
−
|SI
 
−
|
 
−
: Código del campo extensible a referenciar
 
−
: '''PATH''': Variable
 
−
|-
 
−
|valor
 
−
|String
 
−
|Depende del Campo
 
 
|SI
 
|SI
 
|
 
|
−
: Valor del campo a agregar
+
: '''PATH''': ../Class.LugarGeneracionXML/municipioCiudad
−
: '''PATH''': Variable
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica#Tabla 7|Tabla 7]]
 
|}
 
|}
−
====Class.FacturaImpuestos====
+
====Class.Pagos====
 
{| class="mw-collapsible mw-collapsed wikitable"
 
{| class="mw-collapsible mw-collapsed wikitable"
 
! style="background:#f2f2f2; text-align:center;"|Atributo
 
! style="background:#f2f2f2; text-align:center;"|Atributo
Línea 1975: Línea 770:
 
! style="background:#f2f2f2; text-align:center;"|Requerido
 
! style="background:#f2f2f2; text-align:center;"|Requerido
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
 
! style="background:#f2f2f2; text-align:center;"|Descripción  
−
|-
 
−
|baseImponibleTOTALImp
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Base Imponible sobre la que se calcula el valor del tributo
 
−
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxableAmount 
 
−
|-
 
−
|codigoTOTALImp
 
−
|String
 
−
|<nowiki>AN|2</nowiki>
 
−
|SI
 
−
|
 
−
: Identificador del tributo 
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
 
−
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID   
 
−
|-
 
−
|controlInterno
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|C/C
 
−
|
 
−
: Indicador de tipo de retención
 
−
: '''PATH''': No Definido 
 
 
|-
 
|-
 
|extras
 
|extras
−
|Array <Extensible>
+
|String
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Campos o información opcional para el modelo de negocio del emisor
+
:Habilitado como campo opcional
−
: '''PATH''': No definido  
+
: '''PATH''': /No definido
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
 
|-
 
|-
−
|porcentajeTOTALImp
+
|fechasPagos
−
|String
+
|Array<FechasPagos>
−
|Ent: <nowiki>N|..2</nowiki>
 
−
Dec: <nowiki>N|2*</nowiki>
 
−
|SI
 
−
|
 
−
: Tarifa del tributo.
 
−
: En el caso de que el tributo es un porcentaje del valor tributable: informar la tarifa “porcentaje” a ser aplicada a la base imponible
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>  Si reporta una tarifa diferente para uno de los tributos enunciados en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
 
−
: '''PATH''':../cac:TaxTotal/TaxSubtotal/cac:TaxCategory/cbc:Percent
 
−
|-
 
−
|unidadMedida
 
−
|String
 
−
|<nowiki>AN|..5</nowiki>
 
−
|SI
 
−
|
 
−
: Identificación de la unidad de medida
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
 
−
: '''PATH''':../cac:TaxTotal/cac:TaxSubtotal/cbc:BaseUnitMeasure/@unitCode
 
−
|-
 
−
|unidadMedidaTributo
 
−
|String
 
−
|Ent: <nowiki>N|..2</nowiki>
 
−
Dec: <nowiki>N|2</nowiki>
 
−
|C/C
 
−
|
 
−
: Unidad de medida base para el tributo
 
−
: '''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
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si elemento valorTributoUnidad es informado y unidadMedidaTributo no es informado
 
−
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:BaseUnitMeasure
 
−
|-
 
−
|valorTOTALImp
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Valor del tributo. Producto del porcentaje aplicado sobre la base imponible
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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
 
−
|-
 
−
|valorTributoUnidad
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|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
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> si el elemento unidadMedidaTributo NO es informado.
 
−
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:PerUnitAmount
 
−
|}
 
−
'''@IMPORTANTE''': Para el caso del ICA y RETEICA en el cual el valor del porcentaje se maneja en base a mil, se debe informar el valor de dicho porcentaje en base a cien, es decir, si se desea informar un porcentaje de 11.04%mil para alguno de estos tributos, se debe indicar en el campo porcentajeTOTALImp como 1.104.
 
−
====Class.ImpuestosTotales====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoTOTALImp
 
−
|String
 
−
|<nowiki>AN|2</nowiki>
 
−
|SI
 
−
|
 
−
: Identificador del tributo 
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
 
−
: '''PATH''': Por Definir
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor.
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|montoTotal
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Suma de todos los atributos valorTOTALImp
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
 
−
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
 
−
|}
 
−
====Class.MediosDePago====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoBanco
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Código del Banco o Entidad Financiera
 
−
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:AccountTypeCode
 
−
|-
 
−
|codigoCanalPago
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Código del canal del pago
 
−
: '''PATH''': ../cbc:PaymentChannelCode
 
−
|-
 
−
|codigoReferencia
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Opcional sin uso por ahora
 
−
: '''PATH''': No definido
 
−
|-
 
−
|extras
 
−
|Array <Extensible>  
 
 
| -
 
| -
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor.
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fechaDeVencimiento
 
−
|String
 
−
|<nowiki>AN|19</nowiki>
 
−
|C/C
 
−
|
 
−
: Fecha de Vencimiento del pago de la factura en formato: YYYY-MM-DD
 
−
: '''Obligatorio''' Si la venta es a crédito
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si código del método de pago es “2” y no se envía la fecha de vencimiento
 
−
: '''PATH''': ../cbc:PaymentDueDate
 
−
|-
 
−
|medioPago
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
 
|SI
 
|SI
 
|
 
|
−
: Código correspondiente al medio de pago
+
: Utilizado para Todos los Elementos de Fechas de Pagos del Documento
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si el valor de este atributo no corresponde a un valor de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
+
: '''PATH''': .. /root/FechasPagos
−
: '''PATH''': ../cbc:PaymentMeansCode
 
−
|-
 
−
|metodoDePago
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
−
|SI
 
−
|
 
−
: Método de Pago
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si el valor de este atributo no corresponde a un valor de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
 
−
: '''PATH''': ../cbc:ID
 
−
|-
 
−
|nombreBanco
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre del Banco o Entidad Financiera
 
−
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:Name
 
−
|-
 
−
|numeroDeReferencia
 
−
|String
 
−
|<nowiki>AN|..200</nowiki>
 
−
|NO
 
−
|
 
−
: Identificador o referencia interna del Pago
 
−
: PATH''':''' ../cbc:PaymentID
 
−
|-
 
−
|numeroDias
 
−
|String
 
−
|<nowiki>N|..3</nowiki>
 
−
|NO
 
−
|
 
−
: Número de días para el pago
 
−
: '''PATH''': ../cbc:InstructionNote
 
−
|-
 
−
|numeroTransferencia
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Número de ransferência o número de cheque
 
−
: '''PATH''': ../cac:PayeeFinancialAccount/cbc:ID
 
−
|}
 
−
====Class.OrdenDeCompra====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoCliente
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Código del cliente
 
−
: '''PATH''': ../cbc:CustomerReference
 
−
|-
 
−
|documentoReferencia
 
−
|DocumentoReferencia
 
−
| -
 
−
|NO
 
−
|
 
−
: Documento Referencia
 
−
: '''PATH''': ../cac:DocumentReference
 
−
: (ver detalle en [[#Class.DocumentoReferencia|Class.DocumentoReferencia]])
 
 
|-
 
|-
 
|extras
 
|extras
−
|Array <Extensible>
+
|String
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Campos o información opcional para el modelo de negocio del emisor
+
:Habilitado como campo opcional
−
: '''PATH''': No definido  
+
: '''PATH''': /No definido
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fecha
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
 
−
: '''PATH''': ../cbc:IssueDate
 
−
|-
 
−
|numeroOrden
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|C/C
 
−
|
 
−
: Número de la Orden de Compra
 
−
: '''Obligatorio''' Para enviar la Orden de Compra
 
−
: '''PATH''': ../cbc:ID
 
−
|-
 
−
|numeroPedido
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|C/C
 
−
|
 
−
: Número del Pedido
 
−
: '''Obligatorio''' Para enviar el Pedido
 
−
: '''PATH''': ../cbc:SalesOrderID
 
−
|-
 
−
|tipoCUFE
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Identificador del tipo de CUFE
 
−
: '''PATH''': ../cbc:UUID@schemeName
 
−
|-
 
−
|tipoOrden
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Tipo de Orden
 
−
: '''PATH''': ../cbc:OrderTypeCode
 
−
|-
 
−
|uuid
 
−
|String
 
−
|<nowiki>AN|..90</nowiki>
 
−
|NO
 
−
|
 
−
: UUID de algún documento referenciado
 
−
: '''PATH''': ../cbc:UUID
 
−
|}
 
−
'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.
 
−
====Class.TasaDeCambio====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
 
|-
 
|-
−
|baseMonedaDestino
+
|fechapagonomina
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Base monetaria para la conversión.
 
−
: Debe ser 1.00
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00
 
−
: '''PATH''': ../cbc:TargetCurrencyBaseRate
 
−
|-
 
−
|baseMonedaOrigen
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Base monetaria de la divisa extranjera para el cambio.
 
−
: Debe ser 1.00
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00
 
−
: '''PATH''':  ../cbc:SourceCurrencyBaseRate
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fechaDeTasaDeCambio
 
 
|String
 
|String
 
|<nowiki>AN|10</nowiki>
 
|<nowiki>AN|10</nowiki>
 
|SI
 
|SI
−
|
 
−
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
 
−
: '''PATH''': ../cbc:Date
 
−
|-
 
−
|indicadorDeTasa
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Indicador de Tasa de Cambio
 
−
: '''PATH''': ../cbc:ExchangeMarketID
 
−
|-
 
−
|monedaDestino
 
−
|String
 
−
|<nowiki>AN|3</nowiki>
 
−
|SI
 
−
|
 
−
: Código de moneda destino del documento.
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no es ‘COP’
 
−
: '''PATH''': ../cbc:TargetCurrencyCode
 
−
|-
 
−
|monedaOrigen
 
−
|String
 
−
|<nowiki>AN|3</nowiki>
 
−
|SI
 
−
|
 
−
: Código de moneda base del documento
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde al estándar ISO-4217 
 
−
'''PATH''': ../cbc:SourceCurrencyCode
 
−
|-
 
−
|operadorCalculo
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Operador de Calculo
 
−
: '''PATH''': ../cbc: MathematicOperatorCode
 
−
|-
 
−
|tasaDeCambio
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|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
 
−
|}
 
−
====Class.TasaDeCambioAlternativa====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|baseMonedaDestino
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Base monetaria para la conversión.
 
−
: Debe ser 1.00
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00
 
−
: '''PATH''': ../cbc:TargetCurrencyBaseRate
 
−
|-
 
−
|baseMonedaOrigen
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|SI
 
−
|
 
−
: Base monetaria de la divisa extranjera para el cambio.
 
−
: Debe ser 1.00
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si trae valor diferente a 1.00
 
−
: '''PATH''':  ../cbc:SourceCurrencyBaseRate
 
−
|-
 
−
|extras
 
−
|Array  <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fechaDeTasaDeCambio
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|SI
 
−
|
 
−
: Fecha en la que se fijó la tasa de cambio, en formato: YYYY-MM-DD
 
−
: '''PATH''': ../cbc:Date
 
−
|-
 
−
|indicadorDeTasa
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Indicador de Tasa de Cambio
 
−
: '''PATH''': ../cbc:ExchangeMarketID
 
−
|-
 
−
|monedaDestino
 
−
|String
 
−
|<nowiki>AN|3</nowiki>
 
−
|SI
 
−
|
 
−
: Código de moneda destino del documento.
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no es ‘COP’
 
−
: '''PATH''': ../cbc:TargetCurrencyCode
 
−
|-
 
−
|monedaOrigen
 
−
|String
 
−
|<nowiki>AN|3</nowiki>
 
−
|SI
 
−
|
 
−
: Código de moneda base del documento
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde al estándar ISO-4217 
 
−
: '''PATH''': ../cbc:SourceCurrencyCode
 
−
|-
 
−
|operadorCalculo
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Operador de Calculo
 
−
: '''PATH''': ../cbc: MathematicOperatorCode
 
−
|-
 
−
|tasaDeCambio
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|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
 
−
|}
 
−
====Class.TerminosEntrega====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|cargosDescuentos
 
−
|Array <CargosDescuentos>
 
−
| -
 
−
|NO
 
−
|
 
−
: Informaciones relacionadas con un cargo o un descuento
 
−
: '''PATH''': ../cac:AllowanceCharge
 
−
: (ver detalle en [[#Class.CargosDescuentos|Class.CargosDescuentos]])
 
−
|-
 
−
|codigoCondicionEntrega
 
−
|String
 
−
|<nowiki>AN|3</nowiki>
 
−
|C/C
 
−
|
 
−
: Código de Condiciones de Entrega
 
−
: '''Obligatorio''' Se es factura de exportación/internacional
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si el valor de este atributo no corresponde a un valor de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
 
−
: '''PATH''': ../cbc:LossRiskResponsibilityCode
 
−
|-
 
−
|costoTransporte
 
−
|String
 
−
|Por Definir
 
−
|NO
 
−
|
 
−
: Método de pago del transporte: Se utiliza para indicar como se pagan los costes del transporte, por ejemplo: http://www.unece.org/
 
−
: '''PATH''': ../cbc: SpecialTerms
 
−
|-
 
−
|direccionEntrega
 
−
|Class.Direccion
 
−
| -
 
−
|NO
 
−
|
 
−
: Información donde se detalle la dirección de entrega
 
−
: '''PATH''': ../cac:DeliveryLocation
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor.
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|identificacion
 
−
|String
 
−
|<nowiki>AN|..12</nowiki>
 
−
|NO
 
−
|
 
−
: Numero Identificación
 
−
: '''PATH''': ../cbc:ID
 
−
|-
 
−
|monto
 
−
|String
 
−
|Ent: <nowiki>N|..15</nowiki>
 
−
Dec: <nowiki>N|0..6</nowiki>
 
−
|NO
 
 
|  
 
|  
−
: Monto
+
: Fecha de Pago de la Nómina
−
: '''PATH''': ../cbc:Amount
+
: '''PATH''': .. /Class.Fechaspagos/@FechaPago
 
|-
 
|-
−
|responsableEntrega
+
|metodoDePago
 
|String
 
|String
−
|<nowiki>AN|..50</nowiki>
+
|<nowiki>N|1</nowiki>
−
|NO
 
−
|
 
−
: Descripción de quien asume la responsabilidad en caso de  que la mercancía se pierda
 
−
: '''PATH''': ../cbc:LossRisk
 
−
|}
 
−
====Class.Direccion====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|aCuidadoDe
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Cuidado de
 
−
: '''PATH''': ../cac:Address/cbc:MarkCare
 
−
|-
 
−
|aLaAtenciónDe
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: A la atención de
 
−
: '''PATH''': ../cac:Address/cbc:MarkAttention
 
−
|-
 
−
|bloque
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre del bloque
 
−
: '''PATH''': ../cac:Address/cbc:BlockName
 
−
|-
 
−
|buzon
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Buzón postal
 
−
: '''PATH''': ../cac:Address/cbc:Postbox
 
−
|-
 
−
|calle
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre de la calle
 
−
: '''PATH''': ../cac:Address/cbc:StreetName
 
−
|-
 
−
|calleAdicional
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre Adicional para especificar mejor el nombre de la calle
 
−
: '''PATH''': ../cac:Address/cbc:AdditionalStreetName
 
−
|-
 
−
|ciudad
 
−
|String
 
−
|<nowiki>AN|…50</nowiki>
 
 
|SI
 
|SI
 
|
 
|
−
: Ciudad
+
: Metodos de Pago del Documento
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]] (columna ‘Nombre : : : : Municipio’ del numeral 6.4.3 del Anexo Técnico)
+
: '''PATH''': ../Class.Pago/@Forma
−
: '''PATH''': ../cac:Address/cbc:CityName
+
: [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Nómina Electrónica#Tabla 8|Tabla 8]]  
 
|-
 
|-
−
|codigoDepartamento
+
|medioPago
 
|String
 
|String
−
|<nowiki>AN|…5</nowiki>
 
−
|SI
 
−
|
 
−
: Código del departamento
 
−
: Si pais es “CO”, codigoDepartamento debe corresponder a uno de los valores de la columna Código de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
 
−
: '''Obligatorio''' para Emisores y Adquirentes Responsables
 
−
: '''PATH''': ../cac:Address/cbc:CountrySubentityCode
 
−
|-
 
−
|correccionHusoHorario
 
−
|String
 
−
|<nowiki>AN|6</nowiki>
 
−
|NO
 
−
|
 
−
: Corrección del uso horario correspondiente
 
−
: '''PATH''': ../cac:Address/cbc:TimezoneOffset
 
−
|-
 
−
|departamento
 
−
|String
 
−
|<nowiki>AN|…50</nowiki>
 
−
|SI
 
−
|
 
−
: Nombre del departamento
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
 
−
: '''PATH''': ../cac:Address/cbc:CountrySubentity
 
−
|-
 
−
|departamentoOrg
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Un departamento direccionable de una organización
 
−
: '''PATH''': ../cac:Address/cbc:Department
 
−
|-
 
−
|direccion
 
−
|String
 
−
|<nowiki>AN|…100</nowiki>
 
−
|SI
 
−
|
 
−
: Dirección del cliente, sin indicar ciudad ni departamento
 
−
: '''PATH''': ../cac:Address/cac:AddressLine/cbc:Line
 
−
|-
 
−
|distrito
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Distrito
 
−
: '''PATH''': /cac:Address/cbc:District
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
 
| -
 
| -
 
|NO
 
|NO
 
|
 
|
−
: Campos o información opcional para el modelo de negocio del emisor.
+
: Código del fabricante correspondiente al artículo
−
: '''PATH''': No definido
+
: '''PATH''': .. /cac:Item/cac:
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
+
: ManufacturersItemIdentification/cbc:ID
 
|-
 
|-
−
|habitacion
+
|codigoIdentificadorPais
 
|String
 
|String
−
|<nowiki>AN|..50</nowiki>
+
|<nowiki>A|2</nowiki>  
 
|NO
 
|NO
 
|
 
|
−
: Habitación
+
: Código Identificador del país de origen del artículo o servicio
−
: '''PATH''': ../cac:Address/cbc:Room
 
−
|-
 
−
|lenguaje
 
−
|String
 
−
|<nowiki>A|2</nowiki> ISO 639-1
 
−
|SI
 
−
|
 
−
: Identificador del lenguaje utilizado en el nombre del país
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> 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
 
−
|-
 
−
|localizacion
 
−
|Array <Coordenadas>
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Coordenadas de la dirección
 
−
: '''PATH''': ../cac:Address/cac:LocationCoordinate
 
−
: (ver detalle en [[#Class.Coordenadas|Class.Coordenadas]])
 
−
|-
 
−
|municipio
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|SI
 
−
|
 
−
: Código del Municipio
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si 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 19|Tabla 19]]
 
−
: '''PATH''': ../cbc:ID
 
−
|-
 
−
|nombreEdificio
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre de un Edificio
 
−
: '''PATH''': ../cac:Address/cbc:BuildingName
 
−
|-
 
−
|numeroEdificio
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Número de una casa o edificio
 
−
: '''PATH''': ../cac:Address/cbc:BuildingNumber
 
−
|-
 
−
|numeroParcela
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Número de Parcela
 
−
: '''PATH''': ../cac:Address/cbc:PlotIdentification
 
−
|-
 
−
|pais
 
−
|String
 
−
|<nowiki>A|2</nowiki>
 
−
|SI
 
−
|
 
−
: País del cliente.
 
 
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
 
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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
+
: '''PATH''': .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode  
−
|-
 
−
|piso
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Piso
 
−
: '''PATH''': ../cac:Address/cbc:Floor
 
−
|-
 
−
|region
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Región
 
−
: '''PATH''': ../cac:Address/cbc:Region
 
−
|-
 
−
|subDivision
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Subdivisión (Nombre del Barrio)
 
−
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
 
−
|-
 
−
|ubicación
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Una ubicación específica dentro de un edificio
 
−
: '''PATH''': ../cac:Address/cbc:InhouseMail
 
−
|-
 
−
|zonaPostal
 
−
|String
 
−
|<nowiki>AN|..10</nowiki>
 
−
|NO
 
−
|
 
−
: Zona Postal
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el contenido de este elemento no corresponde a un valor correspondiente de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
 
−
: '''PATH''': ../cac:Address/cbc:PostalZone
 
−
|}
 
−
====Class.Coordenadas====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|gradosLatitud
 
−
|String
 
−
|Por Definir
 
−
|NO
 
−
|
 
−
: Medida de la latitud en grados
 
−
: '''PATH''': ../cbc:LatitudeDegreesMeasure
 
−
|-
 
−
|gradosLongitud
 
−
|String
 
−
|Por Definir
 
−
|NO
 
−
|
 
−
: Medida de la longitud en grados
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Unidad superior a 60 minutos
 
−
: '''PATH''': ../cbc:LongitudeDegreesMeasure
 
−
|-
 
−
|minutosLatitud
 
−
|String
 
−
|<nowiki>N|…5|2.2</nowiki>
 
−
|NO
 
−
|
 
−
: Medida de la latitud en minutos decimales en formato mm.mm
 
−
: '''PATH''': ../cbc:MarkAttentionIndicator
 
−
|-
 
−
|minutosLongitud
 
−
|String
 
−
|<nowiki>N|…5|2.2</nowiki>
 
−
|NO
 
−
|
 
−
: Medida de la longitud en minutos decimales en formato mm.mm
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Unidad superior a 60 minutos
 
−
: '''PATH''': ../cbc:LongitudeMinutesMeasure
 
−
|-
 
−
|orientacionLatitud
 
−
|String
 
−
|<nowiki>AN|1</nowiki>
 
−
|NO
 
−
|
 
−
: Sentido de medida de la latitud con relación al Ecuador
 
−
: '''PATH''': ../cbc:LatitudeDirectionCode
 
−
|-
 
−
|orientacionLongitud
 
−
|String
 
−
|<nowiki>AN|1</nowiki>
 
−
|NO
 
−
|
 
−
: Sentido de medida de la longitud con relación al Ecuador
 
−
: '''PATH''': ../cbc:LongitudeDirectionCode
 
−
|}
 
−
====Class.Tributos====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoImpuesto
 
−
|String
 
−
|<nowiki>AN|2</nowiki>
 
−
|SI
 
−
|
 
−
: Identificador del tributo 
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento no corresponde a uno de los códigos de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
 
−
: '''PATH''': ../cbc:ID   
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor.
 
−
: '''PATH''': No definido (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|}
 
−
====Class.InformacionLegalCliente====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoEstablecimiento
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Código de Establecimiento
 
−
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
 
−
|-
 
−
|nombreRegistroRUT
 
−
|String
 
−
|<nowiki>AN|..450</nowiki>
 
−
|SI
 
−
|
 
−
: Nombre o Razón Social del adquirente
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
 
−
|-
 
−
|numeroIdentificacion
 
−
|String
 
−
|<nowiki>AN|..12</nowiki>
 
−
|SI
 
−
|
 
−
: Identificador del Adquirente.
 
−
: Debe informar el NIT si es responsable
 
−
: '''PATH''':  ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
 
−
|-
 
−
|numeroIdentificacionDV
 
−
|String
 
−
|<nowiki>N|..2</nowiki>
 
−
|C/C
 
−
|
 
−
: Digito Verificador
 
−
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
 
−
|-
 
−
|numeroMatriculaMercantil
 
−
|String
 
−
|<nowiki>N|9</nowiki>
 
−
|NO
 
−
|
 
−
: Número de matrícula mercantil
 
−
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
 
−
|-
 
−
|prefijoFacturacion
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Prefijo de facturación:
 
−
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
 
−
|-
 
−
|tipoIdentificacion
 
−
|String
 
−
|<nowiki>N|2</nowiki>
 
−
|SI
 
−
|
 
−
: Tipo de identificación del cliente
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este elemento es diferente de “31”
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
 
−
|}
 
−
====Class.Obligaciones====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|obligaciones
 
−
|String
 
−
|<nowiki>AN|7</nowiki>
 
−
|SI
 
−
|
 
−
: Obligaciones del adquiriente
 
−
: <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  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
 
−
: '''PATH''': ../cbc:TaxLevelCode 
 
−
|-
 
−
|regimen
 
−
|String
 
−
|<nowiki>AN|2</nowiki>
 
−
|NO
 
−
|
 
−
: Opcional, si informado indicar “No aplica”. Posibles Valores:
 
−
: 48: “Impuesto sobre las ventas - IVA”
 
−
: 49: “No responsable de IVA”
 
−
: '''PATH''': .. /cbc:TaxLevelCode/@listName
 
−
|}
 
−
====Class.LineaInformacionAdicional====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|cantidad
 
−
|String
 
−
|<nowiki>AN|..5</nowiki>
 
−
|NO
 
−
|
 
−
: Cantidad adicional
 
−
: '''PATH''': ../cbc:ValueQuantity
 
−
|-
 
−
|codigo
 
−
|String
 
−
|<nowiki>AN|..5</nowiki>
 
−
|NO
 
−
|
 
−
: Código adicional
 
−
: '''PATH''': ../cbc:NameCode
 
−
|-
 
−
|codigoInterno1
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Opcional sin uso por ahora
 
−
: '''PATH''': No definido
 
−
|-
 
−
|codigoInterno2
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Opcional sin uso por ahora
 
−
: '''PATH''': No definido
 
−
|-
 
−
|descripcion
 
−
|String
 
−
|<nowiki>AN|..450</nowiki>
 
−
|NO
 
−
|
 
−
: Descripción adicional
 
−
: '''PATH''': ../cac:UsabilityPeriod/cbc:Description
 
−
|-
 
−
|fechaFin
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha final del período
 
−
: '''PATH''': ../cac:UsabilityPeriod/cbc:EndDate
 
−
|-
 
−
|fechaInicio
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha inicial del período
 
−
: '''PATH''': ../cac:UsabilityPeriod/cbc:StartDate
 
−
|-
 
−
|nombre
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Característica que quiere informar del ítem, por ejemplo: (Uso Vehículo)
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Por cada nombre debe existir un valor
 
−
: '''PATH''': ../cbc:Name
 
−
: (Por definir catálogos de campos extensibles a nivel de detalle)
 
−
|-
 
−
|secuencia
 
−
|String
 
−
|<nowiki>AN|..3</nowiki>
 
−
|NO
 
−
|
 
−
: Indicador de orden de secuencia
 
−
: '''PATH''': No definido
 
−
|-
 
−
|tipo
 
−
|String
 
−
|<nowiki>N|1</nowiki>
 
−
|NO
 
−
|
 
−
: Indicador de Tipo de Valor, ejemplo Valor = ’1’
 
−
: '''PATH''': No aplica
 
−
|-
 
−
|valor
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Valor de la característica que se quiere informar, por ejemplo :(Particular)
 
−
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Por cada valor debe existir un name
 
−
: '''PATH''': ../cbc:Value
 
 
|}
 
|}
−
====Class.DatosTransportistas====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|detallesTributarios
 
−
|Tributos
 
−
| -
 
−
|NO
 
−
|
 
−
: Tipos de Impuesto
 
−
: '''PATH''': ../cac:PartyTaxScheme/cac:TaxScheme
 
−
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
 
−
|-
 
−
|direccionResponsableEntrega
 
−
|Direccion
 
−
| -
 
−
|NO
 
−
|
 
−
: Información de la Dirección del Responsable de Entrega
 
−
: '''PATH''': ../cac:Address/cbc:PhysicalLocation
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|email
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Correo Electrónico
 
−
: '''PATH''': ..cac:Contact/cbc:ElectronicMail
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor.
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|indicadordeAtencion
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Indicador si es información  sobre “para la atención de” (FAO)
 
−
: '''PATH''': ../cbc:MarkAttentionIndicator
 
−
|-
 
−
|indicadordeCuidado
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Indicador si es información sobre alguien responsable por los bienes
 
−
: '''PATH''': ../cbc:MarkCareIndicator
 
−
|-
 
−
|nombreContacto
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre de Contacto
 
−
: '''PATH''': .. /cac:Contact/cbc:Name
 
−
|-
 
−
|nombreResponsableEntrega
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre del Responsable de la Entrega
 
−
: '''PATH''': ../cac:PartyName/cbc:Name
 
−
|-
 
−
|nota
 
−
|String
 
−
| -
 
−
|NO
 
−
|
 
−
: Nota de Contacto
 
−
: '''PATH''': ../cac:Contact/cbc:Note
 
−
|-
 
−
|numeroIdentificacion
 
−
|String
 
−
|<nowiki>AN|…12</nowiki>
 
−
|NO
 
−
|
 
−
: NIT del transportista
 
−
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID
 
−
|-
 
−
|numeroIdentificacionDV
 
−
|String
 
−
|<nowiki>N|..2</nowiki>
 
−
|NO
 
−
|
 
−
: Digito Verificador
 
−
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID@schemeID
 
−
|-
 
−
|numeroMatriculaMercantil
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Número de matrícula mercantil
 
−
: '''PATH''': ../cac:PartyLegalEntity/cac:CorporateRegistrationScheme/cbc:Name
 
−
|-
 
−
|prefijoFacturacion
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Prefijo de facturación del Transportista
 
−
: '''PATH''': .. /cac:PartyLegalEntity//cac:CorporateRegistrationScheme/cbc:ID
 
−
|-
 
−
|responsabilidadesRut
 
−
|Array <Obligaciones>
 
−
| -
 
−
|NO
 
−
|
 
−
: Responsabilidad del Transportista
 
−
: '''PATH''': ../cac:PartyTaxScheme/cbc:TaxLevelCode
 
−
: (ver detalle en [[#Class.Obligaciones|Class.Obligaciones]])
 
−
|-
 
−
|telefax
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Telefax de transportista
 
−
: '''PATH''': ../cac:PartyTaxScheme/cbc:CompanyID/@schemeName
 
−
|-
 
−
|telefono
 
−
|String
 
−
|<nowiki>AN|..20</nowiki>
 
−
|NO
 
−
|
 
−
: Teléfono de transportista
 
−
: '''PATH''': ../cac:Contact/cbc:Telefax
 
−
|-
 
−
|tipoIdentificacion
 
−
|String
 
−
|<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
 
−
|-
 
−
|transportadorDireccion
 
−
|Direccion
 
−
| -
 
−
|NO
 
−
|
 
−
: Dirección fiscal del transportador
 
−
: '''PATH''': ../cac:PartyLegalEntity/cac:RegistrationAddress
 
−
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 
−
|-
 
−
|transportadorNombre
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Nombre del transportador
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
 
−
|-
 
−
|transportadorNumeroDocumento
 
−
|String
 
−
|<nowiki>AN|..12</nowiki>
 
−
|NO
 
−
|
 
−
: Numero documento del transportador
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID
 
−
|-
 
−
|transportadorNumeroDocumentoDV
 
−
|String
 
−
|<nowiki>AN|..2</nowiki>
 
−
|NO
 
−
|
 
−
: Digito Verificador del NIT del transportador
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
 
−
|-
 
−
|transportadorTipoIdentificacion
 
−
|String
 
−
|<nowiki>N|2</nowiki>
 
−
|NO
 
−
|
 
−
: Tipo documento del transportador
 
−
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
 
−
|}
 
−
====Class.DocumentoReferencia====
 
−
{| class="mw-collapsible mw-collapsed wikitable"
 
−
! style="background:#f2f2f2; text-align:center;"|Atributo
 
−
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 
−
! style="background:#f2f2f2; text-align:center;"|Formato
 
−
! style="background:#f2f2f2; text-align:center;"|Requerido
 
−
! style="background:#f2f2f2; text-align:center;"|Descripción
 
−
|-
 
−
|codigoEstatusDocumento
 
−
|String
 
−
| -
 
−
|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
 
−
|-
 
−
|codigoInterno
 
−
|String
 
−
|<nowiki>N|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)
 
−
|-
 
−
|cufeDocReferenciado
 
−
|String
 
−
|<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 electrónica 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
 
−
|-
 
−
|descripcion
 
−
|Array <String>
 
−
|<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
 
−
|-
 
−
|extras
 
−
|Array <Extensible>
 
−
| -
 
−
|NO
 
−
|
 
−
: Campos o información opcional para el modelo de negocio del emisor
 
−
: '''PATH''': No definido
 
−
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 
−
|-
 
−
|fecha
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|C/C
 
−
|
 
−
: Fecha de emision 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
 
−
|-
 
−
|fechaFinValidez
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha de Fin de Validez
 
−
: '''PATH''': No definido
 
−
|-
 
−
|fechaInicioValidez
 
−
|String
 
−
|<nowiki>AN|10</nowiki>
 
−
|NO
 
−
|
 
−
: Fecha de Inicio de Validez
 
−
: '''PATH''': No definido
 
−
|-
 
−
|numeroDocumento
 
−
|String
 
−
|<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
 
−
|-
 
−
|tipoCUFE
 
−
|String
 
−
|<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
 
−
|-
 
−
|tipoDocumento
 
−
|String
 
−
|<nowiki>AN|..50</nowiki>
 
−
|NO
 
−
|
 
−
: Descripción del tipo de documento referenciado, Ejemplo: “Factura de Venta Nacional”
 
−
: '''PATH''': No definido
 
−
|-
 
−
|tipoDocumentoCodigo
 
−
|String
 
−
|<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 21|Tabla 21]]
 
−
: '''PATH''': No definido
 
−
|}
 
−
'''''@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, descripción.
 
−
#* '''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.''
 
−
 
−
'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).
 
−
 
−
En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
 
−
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
 
−
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
 
−
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
 
−
:: ...
 
−
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"
 
−
 
−
*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
 
−
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
 
−
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
 
−
:: ...
 
−
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"
 
 
; RESPONSE: Parámetros a Recibir
 
; RESPONSE: Parámetros a Recibir
 
{| class="mw-collapsible mw-collapsed wikitable"  
 
{| class="mw-collapsible mw-collapsed wikitable"  

Revisión del 07:04 25 mar 2021

Método Servicio Nómina Electrónica Web Soap

Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:

Formato Descripción
A Carácter alfabético
N Carácter numérico
AN Carácter alfanumérico
A|3 3 caracteres alfabéticos (longitud fija)
N|3 3 caracteres numéricos (longitud fija)
AN|3 3 caracteres alfanuméricos (longitud fija)
A|..3 Hasta 3 caracteres alfabéticos (longitud variable)
N|..3 Hasta 3 caracteres numéricos (longitud variable)
AN|..3 Hasta 3 caracteres alfanuméricos (longitud variable)
N|2..6 Entre 2 y 6 caracteres numéricos (longitud variable)
INT32 Entero. (Valor Máximo: 2,147,483,647)


Obligatorio Descripción
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)

Método Enviar

La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
idSoftware iD Identificador Software: Identificador del software habilitado para la emisión de nóminas
String tokenEmpresa Suministrado por el proveedor tecnológico
tokenPassword
nitEmpleador Nit Debe corresponder al NIT del Empleador que realiza el DE
ObjetoNomina Objeto Ver el detalle del Objeto Nomina más abajo

Class.Nómina Electrónica

Atributo Tipo Dato Formato Requerido Descripción
consecutivoDocumento String AN..20 Si
Correlativo/consecutivo del documento electrónico. Concatenación del prefijo + el consecutivoInformaciones relacionadas con anticipos
PATH: /root/NumeroSecuencialXML/(@Numero + Consecutivo)
deducciones Class - NO
Clase relacionada al las deducciones reportadas en el documento
PATH: /root/deducciones
(ver detalle en Class.Dedducciones)
devengados Class SI
Hace referencia al concepto de valor devengado de nómina señalado en el numeral 18, articulo 1 de la presente resolución.
PATH: root/devengados
(ver detalle en Class.Devengados)
documentosReferenciados Array - SI
Clase destinada a la referencia de la nomina individual o nomina de ajuste a reemplazar / eliminar
PATH: /root/(tipoNota)
(ver detalle en Class.documentosReferenciado)
extras String - NO
Campo Opcional
PATH:/NoAplica
fechaEmision String<CondicionPago> AN|19 SI
Debe ir la fecha de emision del documento. Considerando zona horaria de Colombia (-5), en formato AAAA-MM-DD
PATH: /root/InformacionGeneral/@(FechaGen + HoraGen)
notas Array - NO
Información adicional Texto libre, relativo al documento.
PATH: /root/Notas.
( Ver detalle en Class.Notas)
novedad String N|1 SI
Indica si existe alguna Novedad Contractual en el Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica del Trabajador en dicho Mes.
Se debe colocar "true" o "false"
PATH: /root/Novedad
novedadCUNE String N|96 C/C
Debe corresponder al CUNE del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a realizar la Novedad
PATH: /root/Novedad/@CUNENov
lugarGeneracionXML Class - SI
Utilizado para Atributos del Lugar de Generacion del Documento XML
PATH: /root/LugarGeneracionXML
( Ver detalle en Class.LugarGeneracionXM)
pagos Array <Extras> - SI
Pagos por el reconocimiento del logro o cumplimiento por parte del trabajador en el desarrollo de sus labores, de condiciones definidas expresamente entre las partes.
PATH: /root/Pago
(ver detalle en Class.pagos)
periodoNomina String N|1 SI
Corresponde al Codigo de Periodo de Nómina
PATH: /root/InformacionGeneral/@periodoNomina
periodos Array AN|19 SI
Corresponde al periodo de generación del documento (periodo laborable del trabajador)
PATH: /root/periodo
rangoNumeracion String AN..20 SI
Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión)
PATH: /root/NumeroSecuencialXML/@Prefijo
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
redondeo String N|.. NO
Se utiliza para cuando se realice el Redondeo en el Documento
PATH: /root/redondeo
tipoDocumento String N|3 SI
Tipo de documento de identificación que actualmente tiene el trabajador o aprendiz
PATH: /root/InformacionGeneral/@TipoXML
Tabla 1
tipoMoneda String AN|3 SI
Tipo de Moneda utilizada en el documento
PATH: /root/InformacionGeneral/@tipoMoneda
Tabla 2
tipoNota String N|1 SI
Corresponde al tipo de Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica que se desee implementar
PATH: /root/tipoNota
Tabla 3
totalComprobante String N|.. SI
Debe ir el total de: Devengados - Deducciones
PATH: /root/comprobanteTotal
totalDeducciones String N|.. SI
Valor total de la Suma de todas las Deducciones del Documento
PATH: /root/deduccionesTotal
totalDevengados String N|.. SI
Valor total de la Suma de todos los Devengados del Documento
PATH: /root/devengadosTotal
trm String N|.. NO
Tasa Representativa del mercado. Corresponde a la tasa de cambio de la moneda utilizada en el documento en el Campo “TipoMoneda” a Pesos Colombianos.
PATH:/root/InformacionGeneral/@trm
trabajador Class - SI
Utilizado para Atributos del Trabajador o Receptor del Documento
PATH: /root/Trabajador

Class.Deducciones

Atributo Tipo Dato Formato Requerido Descripción
afc String N|.. NO
Corresponde a (Ahorro Fomento a la construccion)
PATH: /Class.Deducciones/afc
anticipos Array<String> NO
Utilizado para Todos los Elementos de Anticipos de Deducciones del Documento
PATH: …/Class.Deducciones/anticipos
(ver detalle en Class.Anticipos)
cooperativa String N|.. NO
Las cuotas o aportes que los empleados hagan a las cooperativas legalmente constituidas
PATH: …/Class.Deducciones/cooperativa
deuda String N|.. NO
Valor que se deba pagar por las obligaciones que el empleado tenga con su empresa, como puede ser un crédito que ésta le haya otorgado, o como compensación por algún perjuicio o detrimento económico que el empleado le haya causado a la empresa.
PATH: …/Class.Deducciones/deuda
educación String N|.. NO
Valor Pagado correspondiente a Conceptos Educativos por parte del trabajador
PATH: …/Class.Deducciones/educacion
embargoFiscal String N|.. NO
Valor Pagado correspondiente a Embargos Fiscales por parte del trabajador
PATH: …/Class.Deducciones/embargoFiscal
fondosPensiones Array<String> - SI
Utilizado para Atributos de Fondos de Pension del Documento
PATH: …/Class.Deducciones/FondoPension
(ver detalle en Class.FondosPensiones)
fondosSP Array<String> - NO
Utilizado para Atributos de Fondo de Seguridad Pensional del Documento
PATH: …/Class.Deducciones/FondoSP
(ver detalle en Class.FondosSP)
libranzas Array<String> N|.. NO
Utilizado para Todos los Elementos de Libranzas de Deducciones del Documento
PATH: …/Class.Deducciones/libranzas
(ver detalle en Class.Libranzas)
otrasDeducciones Array<String> - NO
Utilizado para Todos los Elementos de Otras Deducciones del Documento
PATH: …/Class.Deducciones/otrasDeducciones
(ver detalle en Class.OtrasDeducciones)
pagosTerceros Array<String> - NO
Utilizado para Todos los Elementos de Pagos a Tercero de Devengos del Documento
PATH: …/Class.Deducciones/pagosTerceros
(ver detalle en Class.PagosTerceros)
pensionVoluntaria String N|.. NO
Valor correspondiente al ahorro que hace el trabajador para complementar su pension obligatoria o cumplir metas especificas.
PATH: …/Class.Deducciones/pensionVoluntaria
planComplementarios String N|.. NO
Valor de planes complementarios de salud al que el trabajador se encuentran afiliado, siempre que medie autorización del empleado.
PATH: …/Class.Deducciones/planComplementarios
retencionFuente String N|.. NO
Si hubiere lugar, la empresa deberá calcular y retener al empleado el valor correspondiente a retención en la fuente por ingresos laborales. Este valor será declarado y consignado en la respectiva declaración mensual de retención en la fuente.
PATH: …/Class.Deducciones/retencionFuente
salud Array<String> - SI
Utilizado para Atributos de Salud del Documento.
PATH: …/Class.Deducciones/Salud
(ver detalle en Class.Salud)
sanciones Array<String> - NO
Utilizado para Todos los Elementos de Sanciones de Deducciones del Documento
PATH: …/Class.Deducciones/sanciones
(ver detalle en Class.Sanciones)
sindicatos Array<String> - NO
Utilizado para Todos los Elementos de Sindicatos de Deducciones del Documento.
PATH: …/Class.Deducciones/sindicatos
(ver detalle en Class.Sindicatos)

Class.Devengados

Atributo Tipo Dato Formato Requerido Descripción
anticipos Array<String> - NO
Clase relacionada a los devengos correspondientes a anticipos.
PATH: ../Class.Devengados/anticipos
auxilios Array<String> - NO
Utilizado para Todos los Elementos de Auxilios de Devengos del Documento
PATH: ../Class.Devengados/auxilios
apoyoSost String N|.. NO
Corresponde al valor no salarial que el patrocinador paga de forma mensual como ayuda o apoyo economía al aprendiz o practicante universitario durante su etapa lectiva y fase practica.
PATH: /Class.Devengados/apoyoSost
basico Array<String> - SI
Utilizado para Atributos Basicos de Devengos del Documento
PATH: ../Class.Basico
(ver detalle en Class.Basico)
bonificaciones Array<String> - NO
Utilizado para Todos los Elementos de Bonificaciones de Devengos del Documento
PATH: ../Class.Devengados/bonificaciones
(ver detalle en Class.Bonificaciones)
bonifRetiro String N|.. NO
Valor establecido por mutuo acuerdo por retiro del Trabajador.
PATH: ../Class.Devengados/bonifRetiro
bonoEPCTVs Array<String> - NO
Utilizado para Todos los Elementos de Bonos Electronicos o de Papel de Servicio, Cheques, Tarjetas, Vales, etc de Devengos del Documento
PATH: ../Class.Devengados/bonoEPCTVs
(ver detalle en Class.bonoEPCTVs)
cesantias Array<String> - NO
Utilizado para Atributos de Cesantias de Devengos del Documento
PATH: ../Class.Devengados/cesantias
(ver detalle en Class.Cesantias)
comisiones Array<String> - NO
Utilizado para Todos los Elementos de Comisiones de Devengos del Documento
PATH: ../Class.Devengados/comisiones
compensaciones Array<String> - NO
Utilizado para Todos los Elementos de Compensaciones de Devengos del Documento
PATH: ../Class.Devengados/compensaciones
dotacion String N|.. NO
De conformidad con lo previsto en el artículo 230 del Código Sustantivo del Trabajo, o la norma que lo modifique, adicione o sustituya, corresponde al valor que el empleador dispone para suministrar la dotación de sus trabajadores.
PATH: ../Class.Devengados/dotacion
extras String - NO
Habilitado como campo opcional
PATH: /No Aplica
horasExtras Array<String> - NO
Utilizado para Todos los Elementos de Horas Extras Diarias de Devengos del Documento
PATH: /Class.Devengado/horasExtras
huelgasLegales Array<String> - NO
Utilizado para Todos los Elementos de Huelgas Legales de Devengos del Documento
PATH: /Class.Devengados/huelgasLegales
(ver detalle en Class.HuelgasLegales)
indemnizacion String N|.. NO
Valor de Indemnizacion establecido por ley
PATH: /Class.Devengados/indemnizacion
incapacidades Array<String> - NO
Utilizado para Todos los Elementos de Incapacidades de Devengos del Documento
PATH: /Class.Devengados/incapacidades
(ver detalle en Class.incapacidades)
licencias Class - NO
Utilizado para Todos los Elementos de Licencias de Devengos del Documento
PATH: /Class.Devengados/licencias
(ver detalle en Class.Licencias)
otrosConceptos Array<String> - NO
Utilizado para Todos los Elementos de Otros Conceptos de Devengos del Documento
PATH: /Class.Devengados/otrosConceptos
(ver detalle en Class.otrosConceptos)
pagosTerceros Array<String> - NO
Utilizado para Todos los Elementos de Pagos a Tercero de Devengos del Documento
PATH: /Class.Devengados/pagosTerceros
(ver detalle en Class.otrosConceptos)
primas Array<String> - NO
Utilizado para Atributos de Primas de Devengos del Documento
PATH: /Class.Devengados/primas
(ver detalle en Class.Primas)
reintegro String N|.. NO
Valor que le regresa la empresa al trabajador por una deducción mal realizada en otro pago de nomina
PATH: /Class.Devengados/reintegro
teletrabajo String N|.. NO
Valor que debe ser pagado al trabajador cuyo contrato indica expresamente que puede laborar mediante teletrabajo
PATH: /No Aplica
transporte Array<String> - NO
Utilizado para Atributos de Transporte de Devengos del Documento
PATH: /Class.Transporte
(ver detalle en Class.Transporte)
vacaciones Class - NO
Utilizado para Todos los Elementos de Vacaciones de Devengos del Documento
PATH: /Class.Devengados/vacaciones
(ver detalle en Class.Vacaciones)

Class.documentosReferenciados

Atributo Tipo Dato Formato Requerido Descripción
cunePred String - C/C
Debe corresponder al CUNE del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
PATH: /Class.documentosReferenciados/@CUNEPred
extras String - NO
Habilitado como campo opcional
PATH: /No definido
fechaGenPred String - SI
Debe corresponder a la Fecha de Emision del Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
PATH: /Class.documentosReferenciados/fechaGenPred
numeroPred String - SI
Debe corresponder al Numero de Documento Soporte de Pago de Nómina Electrónica o Nota de Ajuste de Documento Soporte de Pago de Nómina Electrónica a Reemplazar
PATH: …/Class.documentosReferenciados/numeroPred

Class.Notas

Atributo Tipo Dato Formato Requerido Descripción
descripcion String - NO
Campo de libre uso para Observaciones en el documento
PATH: .. /class.notas/descripcion
extras String - NO
Habilitado como campo opcional
PATH: /No definido

Class.LugarGeneracionXML

Atributo Tipo Dato Formato Requerido Descripción
departamentoEstado String - SI
Código del departamento donde se genera el documento
PATH: ../Class.LugarGeneracionXML/departamentoEstado
Tabla 4
extras String - NO
Habilitado como campo opcional
PATH: /No definido
idioma String - SI
Codigo del país donde se genera el documento
PATH: ../Class.LugarGeneracionXML/idioma
Tabla 5
municipioCiudad String - SI
Código del municipio o ciudad donde se genera el documento
PATH: ../Class.LugarGeneracionXML/municipioCiudad
Tabla 6
pais String - SI
PATH: ../Class.LugarGeneracionXML/municipioCiudad
Tabla 7

Class.Pagos

Atributo Tipo Dato Formato Requerido Descripción
extras String - NO
Habilitado como campo opcional
PATH: /No definido
fechasPagos Array<FechasPagos> - SI
Utilizado para Todos los Elementos de Fechas de Pagos del Documento
PATH: .. /root/FechasPagos
extras String - NO
Habilitado como campo opcional
PATH: /No definido
fechapagonomina String AN|10 SI
Fecha de Pago de la Nómina
PATH: .. /Class.Fechaspagos/@FechaPago
metodoDePago String N|1 SI
Metodos de Pago del Documento
PATH: ../Class.Pago/@Forma
Tabla 8
medioPago String - NO
Código del fabricante correspondiente al artículo
PATH: .. /cac:Item/cac:
ManufacturersItemIdentification/cbc:ID
codigoIdentificadorPais String 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
PATH: .. /cac:Item/cac:OriginCountry/cbc:IdentificationCode
RESPONSE
Parámetros a Recibir
Tipo Identificación Descripción
int codigo Indica el Estado de la operación retornado por el servicio, (Por definir catálogo)
String consecutivoDocumento Prefijo y Consecutivo del Documento concatenado sin separadores. Para el ejemplo anterior corresponde a: “PRUE980338337”
String cufe “Código Único de Factura Electrónica” correspondiente al documento consultado.
Bool esValidoDian “true” Si es válido
String fechaAceptacionDIAN Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
String fechaRespuesta Día y Hora en la que se generó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
String hash Código de detección de errores
String mensaje Este mensaje está asociado al código de respuesta, útil para identificación de errores
Array mensajesValidacion Mensajes de validación en caso de notificación o rechazo
String nombre Nombre definido por la DIAN
String qr Concatenación cadena del código QR (elemento de control)
Array reglasNotificacionDIAN Reglas de validación en caso de notificación
Array reglasValidacionDIAN Reglas de validación en caso de rechazo
String resultado Resultado del consumo del método: Procesado” ó “Error”
String tipoCufe Algoritmo del tipo de CUFE. “CUFE-SHA384” ó “CUDE-SHA384”
String xml Archivo XML (tipo AttachedDocument) codificado en Base64

Una vez realizado el envío exitoso de la factura electrónica (código ‘200’ o ‘201’ en la respuesta), se procede a enviar los archivos adjuntos (a través del método CargarAdjuntos) consumiendo el Servicio Adjuntos Web SOAP, en el escenario de que el parámetro adjuntos se haya asignado en “1” u “11”, en caso contrario el Servicio Adjuntos Web SOAP retornará un error indicando que el documento NO admite adjuntos.

Método EstadoDocumento

Permite consultar el estado del documento indicado ante el Adquiriente, ante la DIAN, el tipo de entrega y si la misma fue exitosa, la lista de eventos (ApplicationResponse) asociados y otros parámetros de interés que puedes ser útil en los procesos de control del software de facturación (ERP) o para el modelo de negocio del cliente emisor.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
Documento Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
Bool aceptacionFisica Indica si el documento posee aceptación física (entregado físicamente): “true” o “false”
String acuseComentario Comentario informado por el adquiriente al realizar el acuse
String acuseEstatus 0: Acuse no realizado ; 1: Acuse realizado
String acuseResponsable Email del responsable de realizar el acuse
String acuseRespuesta 0: Respuesta no enviada ; 1: Respuesta enviada
String ambiente Tipo de ambiente de generación del documento:
“1: ambienteDeProducción”
“2: ambienteDePruebas”
String cadenaCodigoQR Concatenación cadena del código QR (elemento de control)
String cadenaCufe Concatenación cadena del código CUFE previo al cálculo por el algoritmo correspondiente del servicio
int Codigo Indica el estado de la operación retornado por el servicio
String consecutivo Consecutivo del Documento TFHKA/DIAN
String cufe “Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
String descripcionDocumento Identificador del tipo de documento de referencia,
Ejemplo: “Factura de Venta Nacional”
String descripcionEstatusDocumento Descripción correspondiente al estatusDocumento ante la DIAN: “Procesado Correctamente”
String entregaMetodoDIAN Indica el método de Entrega a la DIAN
(Síncrono ó Asyncrono), (Individual ó Lote)
Bool esValidoDIAN
“true” Si es válido
“false” Si no es válido
String estatusDocumento Código obtenido en la respuesta correspondiente al estado del documento ante la DIAN (Por definir catálogo)
Array <Evento> eventos Lista de eventos del Documento Electrónico
String fechaAceptacionDIAN Día y Hora en la que la DIAN aceptó el documento electrónico, en formato AAAA-MM-DD HH:MM:SS
String fechaDocumento Fecha en la que se generó el documento, en formato: AAAA-MM-DD
Array <HistorialDeEntregas> historialDeEntregas Histórico de las entregas del documento
String mensaje Este mensaje está asociado al codigo, útil para identificación de errores
String mensajeDocumento Entrega una descripción del error de cada una de las validaciones iniciales. Si no hay errores no entrega descripción
Bool poseeAdjuntos Indica si el documento posee adjuntos:
“true” o “false”
Bool poseeRepresentacionGrafica Indica si el documento posee representación gráfica:
“true” o “false”
Array <String> reglasValidacionDIAN Mensajes de validación por parte de la DIAN
String resultado Resultado del consumo del método:
“Procesado” ó “Error”
String tipoCufe Algoritmo utilizado para calcular CUFE:
SHA-256, SHA-384, SHA-512
String tipoDocumento Identificador del tipo de documento de referencia
Ver Tabla 1
String trackID Este elemento corresponde al TrackId del documento procesado

Donde Class.Evento contiene la siguiente información:

Tipo Identificador Descripción
String ambienteDIAN Ambiente de generación en la DIAN:
“1:ambienteDeProducción”
“2:ambienteDePruebas”
String codigo Código el documento del Application Response (evento)
String comentario Comentario del evento
String cufe CUFE del documento electronico
String descripcionEvento Descripción de uso/origen del evento
String emisorNumeroDocumento Número de Identificación del Emisor
String emisorNumeroDocumentoDV Dígito Verificador del Número de Documento del Emisor
String emisorRazonSocial Razón Social del Emisor
String emisorTipoIdentificacion Tipo de Identificación del Emisor
Array <ExtrasEvento> extras Información extra correspondiente al evento
String fechaEmision Fecha de Emisión del Application Response (evento)
String fechaRecepcion Fecha de Recepción del Application Response (evento)
String hash Hash del documento Application Response
String idPerfilDIAN Perfil de la DIAN
String mensaje Mensaje de descripción del ApplicationResponse
String nombreArchivoXML Nombre del archivo XML
String nota Contenido del campo Note del Application Response
String numeroDelEvento Consecutivo del Application Response
String receptorNumeroDocumento Número de Identificación del Receptor
String receptorNumeroDocumentoDV Dígito Verificador del Número de Documento del Receptor
String receptorRazonSocial Razón Social del Receptor
String receptorTipoIdentificacion Tipo de Identificación del Receptor
String resultado Resultado del consumo del método:
“Procesado” ó “Error”
String tipoCufe Algoritmo utilizado para calcular CUDE del evento:
SHA-256, SHA-384, SHA-512
String tipoEvento Identificador del tipo de Evento:
(Interno/ApplicationResponse)
String versionUBL Versión UBL del XML

Y Class.ExtrasEvento contiene la siguiente información:

Tipo Identificador Descripción
String codigoInterno1 Etiqueta
String codigoInterno2 Descripción Adicional
String nombre Código del campo
String valor Información Adicional

Class.HistorialDeEntregas corresponderá a:

Tipo Identificador Descripción
String LeidoEmailIPAddress Dirección IP del computador en el cual se realizó el acuse del correo de notificación
String LeidoEstatus Estatus del acuse del correo de notificación
String LeidoFecha Fecha del acuse del correo de notificación
String canalDeEntrega Canal de entrega del documento electrónico
Array <String> email Email del receptor del documento electrónico
String entregaEstatus Estatus de la entrega:
‘0’: Correo no enviado
‘200’: Correo enviado
String entregaEstatusDescripcion Descripción del Estatus de la entrega
String entregaFecha Fecha de la Entrega del documento
String fechaProgramada Fecha de la Entrega
String mensajePersonalizado Mensaje personalizado para entrerga por Email, Whatsaap o Telegram
String nitProveedorReceptor NIT del Proveedor Tecnológico receptor, en caso de entrega por Interoperabilidad
String recepcionEmailComentario Comentario de Acuse de Recibo del Cliente
String recepcionEmailEstatus Estatus de recepción del Correo Electrónico
1: Aceptado
2: Rechazado
3: En verificación
String recepcionEmailFecha Fecha de recepción del Correo Electrónico
String recepcionEmailIPAddress Dirección IP de recepción del Correo Electrónico
String telefono Para entrega por Whatsapp/Telegram

@Importante: La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.

Método EnvioCorreo

Permite reenviar a una o varias direcciones de correos el documento indicado.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
Documento Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”. Permite enviar múltiples destinatarios (máximo 5) separados por coma el carácter coma ‘,’
correo Correo electrónico al que se enviará el documento. Ejemplo nombre@empresa.com
adjuntos
“0”: Realiza el reenvio del correo sin adjuntos
“1”: Realiza el reenvio del correo con los adjuntos almacenados durante la emisión del documento.
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int codigo Indica el Estado de la operación retornado por el servicio
String mensaje Este mensaje está asociado al código, útil para identificación de errores
resultado Resultado del consumo del método:
“Procesado” ó “Error”

@Importante: Si durante la emisión del documento (método Enviar) el parámetro adjuntos se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto solo será reenviado a los destinatarios los documentos alojados en la plataforma (AttachedDocument). Para realizar un reenvío de correo (con el AttachedDocument y adjuntos) a una dirección de email diferente a la utilizada durante la emisión se puede consumir nuevamente el método CargarAdjuntos del Servicio Adjuntos Web SOAP.

Método DescargaPDF

Permite descargar la representación gráfica estándar (PDF generado por TFHKA) del documento para efectos de almacenamiento local, consulta local o reimpresión.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
documento Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int codigo Indica el Estado de la operación retornado por el servicio
String cufe “Código Único de Factura Electrónica” correspondiente al documento consultado.
String documento Documento PDF codificado en Base64
String hash Código de detección de errores
String mensaje Este mensaje está asociado al codigo, útil para identificación de errores
String resultado Resultado del consumo del método:
“Procesado” ó “Error”

@Importante: Si durante la emisión del documento (método Enviar) el parámetro adjuntos se asignó en “10” u “11”, la plataforma The Factory HKA - DFACTURE no generará representación gráfica (PDF) estándar, por lo tanto no se puede consumir éste método ya que el servicio arrojará un error indicando que NO existe PDF asociado, ya que se asume que la representación gráfica ha sido generada de manera local por el software de facturación (ERP).

Método DescargaXML

Permite la descarga del documento XML (solo el documento electrónico Invoice, CreditNote y DebitNote), en caso que se requiera validar la información como la firma o la autenticidad de la misma o para efecto de manejo y almacenamiento local.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
Documento Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int codigo Indica el Estado de la operación retornado por el servicio
String cufe “Código Único de Factura Electrónica” correspondiente al documento consultado
String documento Documento XML (Invoice, CreditNote ó DebitNote) codificado en Base64
String hash Código de detección de errores
String mensaje Este mensaje está asociado al codigo, útil para identificación de errores
String resultado Resultado del consumo del método:
“Procesado” ó “Error”

Método FoliosRestantes

Permite consultar los timbres (transacciones) disponibles. Los timbres son consumidos en proporción a las transacciones realizadas.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int codigo Indica el Estado de la operación retornado por el servicio
int foliosRestantes Cantidad de folios disponibles
String mensaje Este mensaje está asociado al codigo, útil para identificación de errores
String resultado Resultado del consumo del método:
“Procesado” ó “Error”

Método CargarCertificado

Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.

Método DescargarEventoXML

Permite descargar un evento u ocurrencia (ApplicationResponse) relacionado con un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
documentoEvento Consecutivo del evento (ApplicationResponse)
Documento Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int Código Indica el Estado de la operación retornado por el servicio
String Cufe CUFE del evento (ApplicationResponse)
String Documento Documento XML (ApplicationResponse) codificado en Base64
String fechaRespuesta Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
String Hash Código de detección de errores
String Mensaje Este mensaje está asociado al codigo, útil para identificación de errores.
String Resultado Resultado del consumo del método:
“Procesado” ó “Error”
String tipoCufe Algoritmo utilizado para calcular CUFE:
SHA-256, SHA-384, SHA-512

Método GenerarContenedor

Un contendor es un tipo de documento AttachedDocument, la estructura de éste tiene por objetivo contener y transmitir en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) generados hasta la fecha.

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
Documento Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int Código Indica el Estado de la operación retornado por el servicio
String Contenedor Documento XML (AttachedDocument) codificado en Base64
String Fecha Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
String Hash Código de detección de errores
String Mensaje Este mensaje está asociado al codigo, útil para identificación de errores.
String Resultado Resultado del consumo del método:
“Procesado” ó “Error”

Método GenerarEvento

Permite generar un evento u ocurrencia (ApplicationResponse) asociado a un Documento Electrónico (Invoice, CreditNote ó DebitNote), generado por una persona o entidad relacionada con esto documento (DIAN, Emisor, Adquiriente).

REQUEST
Parámetros a Enviar
Tipo Identificador Descripción
String tokenEmpresa Suministrado por The Factory HKA Colombia
tokenPassword
DatosEvento datosEvento Objeto con los datos del evento (ApplicationResponse) a generar

Donde Class.DatosEvento contiene la siguiente información:

Tipo Identificador Descripción
String codigoEvento Indica el código del evento (Por definir catálogo)
String codigoInterno1 Etiqueta
String codigoInterno2 Descripción Adicional
String Comentario Comentario o descripción del evento
String Documento Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
Array <ExtrasEvento> Extras Información adicional del evento

Donde Class.ExtrasEvento contiene la siguiente información:

Tipo Identificador Descripción
String codigoInterno1 Etiqueta
String codigoInterno2 Descripción Adicional
String Nombre Código del campo
String valor Información adicional
RESPONSE
Parámetros a Recibir
Tipo Identificador Descripción
int Código Indica el Estado de la operación retornado por el servicio
String consecutivoDocumentoEvento Consecutivo del evento (ApplicationResponse)
String Cufe CUFE del evento (ApplicationResponse)
String fechaRespuesta Fecha y Hora consumo del método, formato: AAAA-MM-DD HH:MM:SS
String Hash Código de detección de errores
String Mensaje Este mensaje está asociado al codigo, útil para identificación de errores.
String Resultado Resultado del consumo del método:
“Procesado” ó “Error”
String tipoCufe Algoritmo utilizado para calcular CUFE:
SHA-256, SHA-384, SHA-512
String Xml Documento XML (ApplicationResponse) codificado en Base64
Obtenido de «http://felcowiki.thefactoryhka.com.co/index.php?title=Métodos_Servicio_Emisión_Nómina_Electrónica_-_Indice_Manual_Integración_Nómina_Electrónica&oldid=1322»