Atributo
Tipo Dato
Formato
Requerido
Expandir Descripción
anticipos
Array <Anticipos>
-
NO
Informaciones relacionadas con anticipos
PATH : /root/cac:PrepaidPayment
(ver detalle en Class.Anticipos )
autorizado
Autorizado
-
NO
Informaciones de la persona autorizada para descargar documentos
PATH : /root/cac:TaxRepresentativeParty
(ver detalle en Class.Autorizado )
boletaIngreso
Array<BoletaIngreso>
-
NO
Información referente a boleta de ingreso
(ver detalle en #Class.BoletaIngreso )
bolsaValores
Array<BolsaValores>
-
NO
Información referente a bolsa de valores
(ver detalle en #Class.BolsaValores )
cajaVenta
Array<CajaVenta>
-
NO
Información referente a caja de venta
(ver detalle en #Class.CajaVenta )
cantidadDecimales
String
N|1
SI
Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
Rechazo Si se reciben más decimales en los montos a los indicados en este campo
PATH : No aplica
cargosDescuentos
Array <CargosDescuentos>
-
NO
Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
PATH : /root/cac:AllowanceCharge
(ver detalle en Class.CargosDescuentos )
cliente
Cliente
-
SI
Información del adquiriente
Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
PATH :/root/cac:AccountingCustomerParty
(ver detalle en Class.Cliente )
codigoCosto
String
-
NO
Código de para centro de costos
PATH : ../cbc:
consecutivoDocumento
String
AN..14
SI
Correlativo/consecutivo del documento electrónico
Concatenación del prefijo (AN|..4) + el consecutivo DIAN,
según la configuración en portal web:
Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
Rechazo No se permiten caracteres adicionales como espacios o guiones
Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
PATH : /root/cbc:ID
detalleDeFactura
Array <FacturaDetalle>
-
SI
Información de detalles o productos
PATH : /root/cac:InvoiceLine
(ver detalle en Class.FacturaDetalle )
documentosReferenciados
Array <DocumentoReferenciado>
-
C/C
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 y BillingReference)
PATH : /root/cac:DiscrepancyResponse,
/root/cac:BillingReference,
/root/cac: AdditionalDocumentReference,
/root/cac: DespatchDocumentReference,
/root/cac: ReceiptDocumentReference
(ver detalle en Class.DocumentoReferenciado )
entregaMercancia
Entrega
-
NO
Información de entrega (Delivery) de bienes
PATH : /root/cac:Delivery
(ver detalle en Class.Entrega )
extras
Array <Extras>
-
NO
Campos o información opcional para el modelo de negocio del emisor
PATH : No definido
(ver detalle en Class.Extras )
fabricantesoftware
Array<FabricanteSoftware>
-
SI
Código de para centro de costos
(ver detalle en #Class.fabricanteSoftware )
fechaEmision
String
AN|19
SI
Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
Rechazo Si la fecha de emisión es posterior a diez días calendario
PATH : /root/cbc:IssueDate, root/cbc:IssueTime
fechaFinPeriodoFacturacion
String
AN|19
NO
Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
PATH : /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
fechaInicioPeriodoFacturacion
String
AN|19
NO
Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
PATH :
/root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
fechaPagoImpuestos
String
AN|19
NO
Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
PATH : root/cbc:TaxPointDate
fechaVencimiento
String
AN|10
NO
Fecha vencimiento de la factura, en formato: YYYY-MM-DD
PATH : /root/cbc:DueDate
impuestosGenerales
Array <FacturaImpuestos>
-
SI
Información de impuestos generales o globales
Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
PATH : /root/cac:TaxTotal (impuestos),
/root/cac: WithholdingTaxTotal (retenciones),
(ver detalle en Class.FacturaImpuestos )
impuestosTotales
Array <ImpuestosTotales>
-
SI
Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
PATH : /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
/root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
(ver detalle en Class.ImpuestosTotales )
informacionAdicional
Array <String>
AN|...10000
NO
Información adicional o texto libre relativo al documento
PATH : root/cbc:Note
informacionBeneficiosComprador
Array <InformacionBeneficiosComprador>
-
NO
Información relacionada con beneficios del comprador
PATH : /root/cac:PaymentMeans
(ver detalle en #Class.InformacionBeneficiosComprador )
juegosLocalizados
Array<juegosLocalizados>
-
NO
Información referente a juegos localizados
(ver detalle en #Class.juegosLocalizados )
mediosDePago
Array<MediosDePago>
-
NO
PATH : /root/cac:PaymentMeans
(ver detalle en #Class.MediosDePago )
moneda
String
AN|3
SI
Moneda o divisa del documento
Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
PATH : /root/cbc:DocumentCurrencyCode
propina
string
-
NO
Información relacionada a propina
ordenDeCompra
Array <OrdenDeCompra>
-
NO
Información relacionada a la orden de compra
PATH : /root/cac:OrderReference
(ver detalle en Class.OrdenDeCompra )
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) independientemente de la modalidad de secuencial.
Ejemplo: ‘PREF-1123456’
Rechazo Si el valor del campo desde (Inicio del rango) supera el valor 2.147.483.647 .
PATH :
/root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
redondeoAplicado
String
Ent: N|..15
Dec: N|0..6
SI
Redondeo aplicado para llegar a totalMonto
Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
PATH : /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
retencionesGenerales
Array <FacturaImpuestos>
-
SI
Información de impuestos generales o globales
Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
PATH : /root/cac:TaxTotal (impuestos),
/root/cac: WithholdingTaxTotal (retenciones),
(ver detalle en Class.FacturaImpuestos )
serviciosPublicos
Array<ServiciosPublicos>
-
NO
Información referente a servicios publicos
(ver detalle en #Class.ServiciosPublicos )
tasaDeCambio
Array<TasaDeCambio>
-
C/C
Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
Obligatorio Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
PATH : /root/cac:PaymentExchangeRate
(ver detalle en Class.TasaDeCambio )
tasaDeCambioAlternativa
TasaDeCambioAlternativa
-
NO
Información utilizada como método alternativo para informar conversiones a otras divisas
PATH : /root/cac:PaymentAlternativeExchangeRate
(ver detalle en Class.TasaDeCambioAlternativa )
terminosEntrega
TerminosEntrega
-
C/C
Información relacionada con la entrega
Obligatorio Si tipoDocumento es de exportación/internacional
PATH : /root/cac:DeliveryTerms
(ver detalle en Class.TerminosEntrega )
tipoDocumento
String
AN|2
SI
Tipo de documento
PATH : Invoice, CreditNote, DebitNote
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 1
tipoOperacion
String
AN|..4
SI
Indicador del tipo de operación
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 2
PATH : /root/cbc:CustomizationID
totalAnticipos
String
Ent: N|..15
Dec: N|0..6
NO
Suma de todos los pagos anticipados
Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
PATH : /root/LegalMonetaryTotal/cbc:PrepaidAmount
totalBaseImponible
String
Ent: N|..15
Dec: N|0..6
SI
Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
PATH : /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
totalBrutoConImpuesto
String
Ent: N|..15
Dec: N|0..6
SI
Total del valor bruto con tributos
Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
PATH : /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
totalCargosAplicados
String
Ent: N|..15
Dec: N|0..6
NO
Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
PATH : /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
totalDescuentos
String
Ent: N|..15
Dec: N|0..6
NO
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
PATH : /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
totalMonto
String
Ent: N|..15
Dec: N|0..6
SI
Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
PATH : /root/LegalMonetaryTotal/cbc:PayableAmount
totalProductos
String
AN|..5
SI
Número o cantidad de líneas de productos (renglones) presentes en el documento
Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
PATH : /root/cbc:LineCountNumeric
totalSinImpuestos
String
Ent: N|..15
Dec: N|0..6
SI
Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
PATH : /root/LegalMonetaryTotal/cbc:LineExtensionAmount