| Atributo
|
Tipo Dato
|
Formato
|
Requerido
|
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
|
