tfhkacolwiki - Contribuciones del usuario [es]

Métodos Servicio Emisión Web TFHKA - Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos

2026-03-27T14:16:50Z

Paguirre: Se ha deshecho la revisión 9402 de Dmrodriguez2 (disc.)

===Método EnviarRequest===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a EnviarRequest
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “2” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
|}

====Class.FacturaGeneral====
{| 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
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|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
| <nowiki>N|1</nowiki>
|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|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|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 (<nowiki>AN|..4</nowiki>) + 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|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|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|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|Class.Extras]])
|-
|fabricantesoftware
|Array<FabricanteSoftware>
| -
|SI
|
: Código de para centro de costos
: (ver detalle en [[#Class.fabricanteSoftware]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|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|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|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|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
| <nowiki>AN|3</nowiki>
|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|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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|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|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|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|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo 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 1|Tabla 1]]
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo 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 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
| <nowiki>AN|..5</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
|}
====Class.AcuerdosPago====
{| 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
|-
|cargo debito
|string
| -
|NO
|
: Información referente al debito del acuerdo
|-
|cuotasAPagar
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Numero de cuotas acordadas en el acuerdo de pago
|-
|cuotasPagadas
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Cantidad de cuotas pagadas del acuerdo de pago
|-
|cuotasPactadas
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Cantidad de cuotas pacttadas en el acuerdo de pago
: (ver detalle en [[#Class.CuotasPactadas|Class.CuotasPactadas]])
|-
|descuentoCredito
|String
| -
|NO
|
: descuentos especificados dentro del acuerdo de pago
|-
|descripcionProducto
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Descripción del producto
|-
|nombreProducto
|String
| <nowiki>AN|15</nowiki>
|SI
|
: Nombre especifico del producto
|-
|numeroContrato
|String
|Ent: <nowiki>N|..15 </nowiki>
|SI
|
: Numero del contrato acordado
|-
|porcentajeInteres
|String
|Ent: <nowiki>N|..15 </nowiki>
|NO
|
: Porcentaje del interes dentro del acuerdo de pago
|-
|saldoAPagar
|String
|Ent: <nowiki>N|..15 </nowiki>
|NO
|
: Valor faltante a pagar dentro del acuerdo
|}

====Class.Anticipos====
{| 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]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| 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
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|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]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.BoletaIngreso====
{| 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
|-
|nombreProductor
|String
| -
|SI
|
: Apellidos y nombre o razón social del productor u organizador del espectáculo público
: ext:ExtensionContent/PublicShowsInformation/Producer/ProducerName
|-
|numeroIdentificacionProductor
|String
| -
|SI
|
: NIT del productor u organizador del espectáculo público
: ext:ExtensionContent/PublicShowsInformation/Producer/ProducerNIT
|-
|codigoLEP
|String
| -
|NO
|
: Código LEP de productor de espectáculos públicos de acuerdo a su categoría
: ext:ExtensionContent/PublicShowsInformation/Producer/LEPCode
|-
|nombreEvento
|String
| -
|si
|
: Nombre del evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/EventName
|-
|localidad
|String
| -
|SI
|
: Sala, escenario, puesto y/o localidad asignada
: ext:ExtensionContent/PublicShowsInformation/EventInformation/TicketLocation
|-
|codigoUnicoEvento
|String
| -
|NO
|
: Código único del evento – PULEP
: ext:ExtensionContent/PublicShowsInformation/EventInformation/PULEPCode
|-
|tipoEvento
|String
| -
|NO
|
: Tipo de venta
: ext:ExtensionContent/PublicShowsInformation/EventInformation/TicketType
|-
|etapa
|String
| -
|NO
|
: Etapa de la venta
: ext:ExtensionContent/PublicShowsInformation/EventInformation/SalePhase
|-
|categoria
|String
| -
|NO
|
: Indicar la categoría del evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/EventCategory
|-
|departamento
|String
| -
|NO
|
: Nombre del departamento donde se realizará el evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/CountrySubentity
|-
|codigoDepartamento
|String
| -
|NO
|
: Código del departamento donde se realizará el evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/CountrySubentityCode
|-
|ciudad
|String
| -
|NO
|
: Nombre de la Ciudad o Municipio donde se realizará el evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/CityName
|-
|codigoCiudad
|String
| -
|NO
|
: Código de la Ciudad o Municipio donde se realizará el evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/ID
|-
|direccion
|String
| -
|NO
|
: Nombre del sitio, dirección o ubicación donde se realizará el evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/EventLocation
|-
|fechaEvento
|String
| -
|NO
|
: Fecha del evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/DateEvent
|-
|horaEvento
|String
| -
|NO
|
: Hora del evento
: ext:ExtensionContent/PublicShowsInformation/EventInformation/TimeEvent
|}

====Class.bolsaValores====
{| 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
|-
|consecutivo
|String
| -
|SI
|
: Número del consecutivo
: ext:ExtensionContent/CustomTagGeneral/Group/AdditionalCollection/Value
|-
|fechaCumplimiento
|String
| -
|SI
|
: Fecha de cumplimiento
: ext:ExtensionContent/CustomTagGeneral/Group/AdditionalCollection/Value
|-
|cantidadNominal
|String
| -
|SI
|
: Cantidad nominal
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
|-
|precioCesionTotal
|String
| -
|SI
|
: Precio cesion total
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
|-
|PrecioRegistro
|String
| -
|SI
|
: Precio de registro
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
|-
|montoderendimientos
|String
| -
|SI
|
: Monto de Rendimientos
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
|-
|valor
|String
| -
|SI
|
: Valor
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
|-
|porcentajeComision
|String
| -
|SI
|
: Porcentaje de la comisión
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
|}

====Class.CargosDescuentos====
{| 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
|-
|Tipo
|String
|<nowiki>AN|2</nowiki>
|SI
|
: Grupo de campos para información relacionadas con un cargo o un descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Rechazo: Si cac:AllowanceCharge/cbc:ID/@schemeName =1, se deben informar los elementos: ID, ChargeIndicator, AllowanceChargeReason, Amount Rechazo: Si cac:AllowanceCharge/cbc:ID/@schemeName =2, se deben informar loselementos: ID, ChargeIndicator, AllowanceChargeReason, MultiplierFactorNumeric, Amount y BaseAmount
: '''PATH''': /Invoice/cac:AllowanceCharge
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[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
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|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]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|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
: Rechazo : 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,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo Si este elemento > 100
: '''PATH''': …/cbc:MultiplierFactorNumeric
|-
|secuencia
|String
|<nowiki>N|..3</nowiki>
|SI
|
: Indicador de orden de secuencia
: '''PATH''': …/cbc:ID
|}

====Class.CajaVenta====
{| 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
|-
|placaCaja
|String
| -
|SI
|
: Valor de la característica que se quiere informar (Placa de inventario de la Caja)
: Corresponde a la Placa de inventario de la Caja
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
|-
|-
|ubicacionCaja
|String
| -
|SI
|
: Valor de la característica que se quiere informar (Ubicación de la caja ALMACEN)
: Corresponde a la Ubicación de la caja ALMACEN
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
|-
|cajero
|String
| -
|SI
|
: Valor de la característica que se quiere informar (nombres y apellidos del cajero o vendedor)
: Corresponde a los Nombres y apellidos del cajero o vendedor
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
|-
|tipoCaja
|String
| -
|SI
|
: Valor de la característica que se quiere informar (Tipo de Caja)
: Corresponse al Tipo de Caja
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
|-
|codigoVenta
|String
| -
|SI
|
: Valor de la característica que se quiere informar (Código de la Venta)
: Corresponde al Código de la Venta
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
|}

====Class.CreditoInstrumentoJuego====
{| 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
|-
|numeroSerie
|String
| -
|SI
|
: Número del serial de la máquina o intrumento de juego con reporte diario crédito
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/GameMachineSerial
|-
|valorCredito
|String
| -
|SI
|
: Valor crédito de la máquina o instrumento de juego
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/CreditValue
|-
|moneda
|String
| -
|SI
|
: Código de modena
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/CreditValue/@currencyID
|}

====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
|<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
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|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
: Notificación 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
|<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
: Notificación : 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
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|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
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''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
: Rechazo 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]]
: Nota: 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
: Rechazo 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.Consumo====
{| 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
|-
|unidadConsumida
|String
| <nowiki>AN|10</nowiki>
|SI
|
: (ver detalle en [[#Class.Valor|Class.Valor]])
|-
|periodoDesde
|string
| -
|NO
|
: Información referente al periodo inicial
|-
|periodoHasta
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Información referente al periodo final
|-
|diasFacturados
|String
| -
|NO
|
: Información referente a los días facturados durante el periodo
|-
|diasFacturadosUnidad
|String
| -
|NO
|
: Información referente al promedio consumo dias/unidad
|-
|monto
|String
| -
|NO
|
: Información referente al monto del consumo
|}
====Class.ConsumoHistorico====
{| 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
|-
|pagoAnterior
|string
| -
|NO
|
: Información referente al ultimo pago realizado anteriormente
|-
|Consumo
|String
| <nowiki>AN|10</nowiki>
|SI
|
: (ver detalle en [[#Class.Consumo|Class.Consumo]])
|-
|promedioUnidades
|String
| <nowiki>AN|10</nowiki>
|NO
|
: (ver detalle en [[#Class.Valor|Class.Valor]])
|-
|promedioDias
|String
| <nowiki>AN|10</nowiki>
|NO
|
: (ver detalle en [[#Class.Valor|Class.Valor]])
|}
====Class.CuotasPactadas====
{| 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
|-
|numeroCuota
|string
| -
|NO
|
: Información referente al numero de cuotas pactadas
|-
|montoDebito
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Referente al monto debitado en la transacción
|-
|montoCredito
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Referente al monto credito en la transacción
|}
====Class.DatosDelTransportista====
{| 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
: Rechazo 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.Destinatario====
{| 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
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|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
|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]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|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.detalleDeFactura====
{| 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
: Notificación 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
: 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
|-
|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)
: Rechazo 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
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|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
|C/C
|
: 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]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación 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).
: Rechazo 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
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: 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
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|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]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo 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.
: Rechazo 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
: Notificación 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
: Notificación 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
: Notificación 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
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../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)
: Rechazo 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)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación 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
: Notificación 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.Direcciones====
{| 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
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[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''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|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
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[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
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''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
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|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
: Notificación 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.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|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|..40</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
: Notificación 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]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====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’
: Rechazo 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)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|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 ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|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’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|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
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|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,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: 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’
: Rechazo 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
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@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.EntregaMercancia====
{| 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
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo 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
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| 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
|-
|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
: Rechazo 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
|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]])
|-
|porcentajeTOTALImp
|String
|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
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|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
: Rechazo 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.FabricanteSoftware====
{| 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
|-
|NombreApellido
|String
| -
|SI
|
: Corresponde a los nombres y apellidos del fabricante del software
: ./ext:UBLExtension/ext:ExtensionContent/InformacionDelFabricanteDelSoftware/Value
|-
|-
|RazonSocial
|String
| -
|SI
|
: Corresponse a la Razon social del fabricante del software
: ./ext:UBLExtension/ext:ExtensionContent/InformacionDelFabricanteDelSoftware/Value
|-
|nombreSoftware
|String
| -
|SI
|
: Corresponde al Nombre del Software
: ./ext:UBLExtension/ext:ExtensionContent/InformacionDelFabricanteDelSoftware/Value
|}

====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
: Rechazo 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
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|-
|redondeoAplicado
|String
| -
|SI
|
:Redondeo agregado al total del impuesto
|}

====Class.InformacionBeneficiosComprador====
{| 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
|-
|Codigo
|String
| -
|SI
|
: Corresponde al Codigo del comprador Documento identidad
: /ext:UBLExtension/ext:ExtensionContent/InformacionBeneficiosCompra dor/Value
|-
|NombresApellidos
|String
| -
|SI
|
: Corresponse a los Nombres y apellidos del comprador
: /ext:UBLExtension/ext:ExtensionContent/InformacionBeneficiosCompra dor/Value
|-
|Puntos
|String
| -
|SI
|
: Corresponde a un valor donde se informe la Cantidad de Puntos acumulados por el comprador
: /ext:UBLExtension/ext:ExtensionContent/InformacionBeneficiosCompra dor/Value
|}

====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
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''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
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====Class.juegosLocalizados====
{| 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
|-
|direccionEstablecimiento
|String
| -
|SI
|
: Dirección de establecimiento o dirección de internet e IP cuando es virtual
: ext:ExtensionContent/InfoEstablishment/InfoPoint/EstablishmentAddress
|-
|montoDeposito
|String
| -
|SI
|
: Valor de la base o depósito de dinero
: ext:ExtensionContent/InfoEstablishment/InfoPoint/MoneyDeposit
|-
|tipoJuego
|String
| -
|SI
|
: Tipo de juego
: ext:ExtensionContent/InfoEstablishment/GameInformation/MoneyDeposit
|-
|numeroInstrumento
|String
| -
|SI
|
: Número de instrumentos de juegos
: ext:ExtensionContent/InfoEstablishment/GameInformation/GameTypeTotal
|-
|creditoInstrumentoJuego
|List<Class.CreditoInstrumentoJuego>
| -
|SI
|
: Grupo para informar valor diario crédito de un instrumento de juego
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine
: (ver detalle en [[#Class.Anticipos|Class.CreditoInstrumentoJuego]])
|}

====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)
: Rechazo 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)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====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
: Rechazo: 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
|
: Código correspondiente al medio de pago
: Rechazo: 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''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: 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.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
: Rechazo 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.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
|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>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: 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.

'''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"

====Class.serviciosPublicos====
{| 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
|-
|tipo
|String
| -
|SI
|
: Código del cliente
: ext:ExtensionContent/SERVICES_SPD o ext:ExtensionContent/OTHERCOMPANY_SPD
|-
|consecutivo
|String
| -
|SI
|
: Número de consecutive de linea
: ext:UBLExtensions/ext:UBLExtension/cbc:ID
|-
|servicio
|String
| -
|SI
|
: Servicio facturado
: ext:UBLExtensions/ext:UBLExtension/cbc:Name
|-
|nombreEmpresaEmite
|String
| -
|SI
|
: Nombre de la Empresa SPD que emite este DE
: ext:UBLExtensions/ext:UBLExtension/ext:ExtensionAgencyName
|-
|nombreEmpresaRecaudo
|String
| -
|SI
|
: Nombre de la Empresa SPD a cargo de este recaudo.
: ext:UBLExtensions/ext:UBLExtension/ext:ExtensionReason
|-
|numeroContrato
|String
| -
|NO
|
: numero del contrato SPD
: ext:ExtensionContent/SERVICES_SPD/ID
|-
|peridodoConsumo
|String
| -
|NO
|
: Periodo del consumo o Periodo o fecha de Consumo del servicio del SPD
: ext:ExtensionContent/SERVICES_SPD/IssueDate
|-
|notaServicio
|String
| -
|NO
|
: Campo utilizado para informacion adicional de texto libre
: ext:ExtensionContent/SERVICES_SPD/Note
|-
|numeroDocumento
|String
| -
|NO
|
: Campo utilizado para informacion adicional de texto libre
: ext:ExtensionContent/SERVICES_SPD/Note
|-
|tipoIdentificacion
|String
| -
|NO
|
: Tipo de Identificacion
: ext:ExtensionContent/SERVICES_SPD/SenderParty/PartyIdentification/ID/@schemeName
|-
|numeroDocumentoDV
|String
| -
| CC
|
: Digito de Verificacion
: ext:ExtensionContent/SERVICES_SPD/SenderParty/PartyIdentification/ID/@schemeID
|-
|nombreEmpresaServicio
|String
| -
|NO
|
: Nombre de la empresa prestadora del servicio
: ext:ExtensionContent/SERVICES_SPD/SenderParty/PartyName/Name
|-
|nombreSuscriptor
|String
| -
|NO
|
: Nombre del suscriptor y/o usuario
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/SenderParty/PartyName/Name
|-
|direccion
|String
| -
|NO
|
: Campo para informar Direccion de correspondencia del suscriptor
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/SubscriberParty/PostalAddress/StreetName
|-
|direccionAdicional
|String
| -
|NO
|
: Campo para informar una dirección adicional de entrega del suscriptor
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberParty/PostalAddress/AdditionalStreetName
|-
|ciudad
|String
| -
|NO
|
: Nombre de la ciudad del suscriptor
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/SubscriberParty/PostalAddress/CityName
|-
|departamento
|String
| -
|NO
|
: Nombre del Departamento del suscriptor
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/SubscriberParty/PostalAddress/CountrySubentity
|-
|estrato
|String
| -
|NO
|
: Campo para información sobre el estrato o tipo de plan
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/SubscriberParty/PostalAddress/ResidentialStratum
|-
|email
|String
| -
|NO
|
: Correo electrónico de contacto
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/SubscriberParty/ElectronicMail
|-
|cicloFacturacion
|String
| -
|NO
|
: Campo para informar el ciclo de facturación
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/DurationOfTheBillingCycle
|-
|periodicidad
|String
| -
|NO
|
: Corresponde al ciclo de faturacion de cada empresa de servicios públicos
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/DurationOfTheBillingCycle/@unitOfTime
|-
|notaDocumento
|String
| -
|NO
|
: Información adicional: Texto libre, relativo al documento
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/Note
|-
|cantidadUnidadTotal
|String
| -
|NO
|
: Cantidad medida total, elemento utlizado para informar la cantidad de unidades consumidas en el periodo.
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/ConsumptionSection/SPDDebitsForPartialConsumption/SPDDebitForPartialConsumption/TotalMeteredQuantity
|-
|unidadmedida
|String
| -
|NO
|
: Valida la Unidad de Medida de la cantidad del servicio solicitado
: ext:ExtensionContent/SERVICES_SPD/SubscriberParty/SubscriberConsumption/ConsumptionSection/SPDDebitsForPartialConsumption/SPDDebitForPartialConsumption/TotalMeteredQuantity/@unitCode
|}

====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
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo 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
: Rechazo 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.
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo 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.
: Rechazo 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
: Rechazo 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
: Rechazo: 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
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}
====Class.Valor====
{| 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
|-
|numero
|String
| -
|NO
|
: Referente al numero que indica el valor correspondiente
|-
|unidad
|string
| -
|NO
|
: Referente a la unidad que indican en la valor
|}
====Class.Residuos====
{| 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
|-
|residuosHistorico
|Array
| -
|NO
|
: (ver detalle en [[#Class.residuosHistorico|Class.residuosHistorico]])
|-
|totalNoAprovechable
|array
| -
|NO
|
: (ver detalle en [[#Class.Valor|ClassValor]])
|-
|totalLimpiezaBarrido
|array
| -
|NO
|
: (ver detalle en [[#Class.Valor|ClassValor]])
|-
|totalLimpiezaUrbana
|array
| -
|NO
|
: (ver detalle en [[#Class.Valor|ClassValor]])
|-
|totalResiduosInutiles
|array
| -
|NO
|
: (ver detalle en [[#Class.Valor|ClassValor]])
|}
====Class.ResiduosHistorico====
{| 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
|-
|valor
|Array
| -
|NO
|
: (ver detalle en [[#Class.Valor|Class.Valor]])
|-
|usable
|string
| -
|NO
|
: Referente al material aprovechable de los residuos
|-
|periodoDesde
|string
| -
|NO
|
: Referencia a el periodo inicial
|-
|periodoHasta
|string
| -
|NO
|
: Referencia a el periodo final
|}
====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
: Rechazo 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]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|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.
{{clear}}

===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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 (Documento equivalente) 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
|nombre
|Este mensaje está asociado al nombre
|-
|String
|resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|-
|String
|tipoCufe
|correspondiente al documento consultado
|}
{{clear}}

===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 (Documento equivalente) y todos los eventos (ApplicationResponse) generados hasta la fecha.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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
|Nombre
|Este mensaje está asociado al nombre.
|-
|String
|Resultado
|Resultado del consumo del método:
: “Procesado” ó “Error”
|}
{{clear}}

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}
===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|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.
{{clear}}

===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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 [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|tipocufe
|correspondiente al documento consultado.
|-
|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).
{{clear}}

Sección para clientes de Integración

2026-02-16T21:33:22Z

Paguirre:

{| style="width:100%; border:1px solid #d0d7e1; border-radius:10px; background-color:#ffffff; box-shadow:0 1px 3px rgba(0,0,0,0.08);"
|-
| style="vertical-align:top; padding:20px;" |

<div style="font-size:1.9em; font-weight:bold; color:#003366;">
Integración – The Factory HKA Colombia
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
Bienvenido a Integración de The Factory HKA Colombia, el espacio diseñado para brindar una experiencia técnica clara, eficiente y centralizada para nuestros clientes y aliados.
 
Aquí encontrará la documentación completa para la integración de los servicios de Factura Electrónica, Nómina Electrónica, Recepción Electrónica y Documentos Equivalentes, incluyendo manuales, APIs, herramientas y recomendaciones para el cumplimiento de las resoluciones DIAN vigentes.
</div>

<div style="background:linear-gradient(90deg, #0073e6 0%, #0099ff 100%); color:#fff; padding:12px 18px; border-radius:6px; font-weight:bold; font-size:1.05em;">
Acceso rápido: Consulte las secciones de pasos de integración, canales de comunicación y ejemplos de APIs según su tipo de documento electrónico.
</div>

| style="width:140px; text-align:center; vertical-align:middle; background-color:#f7f9fc; border-left:1px solid #e0e6ef; padding:15px;" |
[[Archivo:Tfhka-co.png|140px|center|sinmarco]]
|}

{| style="width:100%; border:none; background-color:#ffffff; padding:2px;"
|-
| style="vertical-align:top; padding:18px 5px;" |

<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-bottom:8px;">
¿Qué hacemos?
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
En The Factory HKA Colombia ofrecemos soluciones tecnológicas que optimizan la emisión, recepción y gestión de documentos electrónicos requeridos por la DIAN.
Nuestros servicios web (APIs) están orientados a empresas, desarrolladores y casas de software que buscan integraciones seguras, escalables y de alta disponibilidad.
</div>

<div style="background-color:#f4f9fc; border-left:6px solid #0073e6; border-radius:4px; padding:12px; color:#003366; font-size:1.05em; margin-bottom:15px;">
Servicios principales: 
• Facturación Electrónica con validación previa ante la DIAN. 
• Nómina Electrónica con soporte para documentos individuales y masivos. 
• Recepción de Documentos Electrónicos con trazabilidad y respuesta. 
• Emisión de Documentos Equivalentes conforme a la Resolución 000165 del 2023.
</div>
<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;">
¿Cómo contactarnos?
</div>

<div style="font-size:1.05em; color:#444; line-height:1.6; margin-bottom:15px;">
Si necesita soporte técnico o acompañamiento durante su proceso de integración, puede comunicarse a través de los siguientes canales:
</div>

<table style="width:100%; border-collapse:collapse; font-size:1.02em; color:#333;">
<tr style="background-color:#eef4fb; text-align:left;">
<th style="padding:8px; border:1px solid #cfd7e0; width:25%;">Canal</th>
<th style="padding:8px; border:1px solid #cfd7e0;">Información de contacto</th>
</tr>
<tr>
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-correo-electronico.png|20px]] Correo electrónico
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">integracion_fel_co@thefactoryhka.com</td>
</tr>
<tr style="background-color:#f8fafd;">
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-telefono.png|20px]] Teléfonos
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">Opción 5, luego Opción 1 
+57 317 668 7663 | +57 (601) 390 95 39 </td>
</tr>
<tr>
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-whatsapp.png|20px]] WhatsApp
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">Escríbanos al canal de soporte técnico https://wa.me/573163192251</td>
</tr>
<tr style="background-color:#f8fafd;">
<td style="padding:8px; border:1px solid #cfd7e0;">
[[File:icono-sesiones-grupales.png|20px]] Sesiones grupales de integración
</td>
<td style="padding:8px; border:1px solid #cfd7e0;">Martes y jueves de 08:30 a.m. a 10:00 a.m. (hora Colombia). https://meet.google.com/jeo-jfvj-ckd</td>
</tr>
</table>

<div style="font-size:1.7em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:10px;">
Principales métodos o APIs por producto
</div>

<div style="font-size:1.02em; color:#444; line-height:1.6; margin-bottom:10px;">
La siguiente tabla presenta los métodos principales de integración por producto.
Cada servicio dispone de endpoints para emisión, validación, consulta, descarga y gestión de documentos conforme a los estándares DIAN.
</div>

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Factura Electrónica - SOAP
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - Enviar''' 
Servicio dedicado al envío y validación de facturas electrónicas ante la DIAN, garantizando el cumplimiento normativo mediante la verificación integral de todos los requisitos técnicos y legales exigidos por la autoridad tributaria colombiana. 
'''Entornos:''' Demo / Producción
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - EstadoDocumento''' 
Consulta del estado de tramitación de documentos ante la DIAN, proporcionando información en tiempo real sobre la validación y aceptación definitiva.
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - DescargaPDF''' 
Generación automática de la representación gráfica en PDF según especificaciones DIAN, lista para distribución comercial conforme a los estándares requeridos.
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| SOAP
|
'''FacturaElectronica - EnvioCorreo''' 
Envío automatizado de facturas electrónicas a los destinatarios con PDF y XML técnico, asegurando entrega completa y trazable.
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Factura Electrónica - REST
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''Api/documentos/enviar''' 
Servicio dedicado al envío y validación de facturas electrónicas ante la DIAN, con verificación completa de los requisitos técnicos y legales. 
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''Api/documentos/EstadoDocumento''' 
Consulta en tiempo real del estado del documento y validación ante la DIAN, mostrando incidencias o aceptación definitiva.
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''Api/documentos/DescargaPDF''' 
Generación automática del PDF representativo del documento, conforme a los estándares de presentación exigidos.
| GET
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | FEL
| REST
|
'''FacturaElectronica - EnvioCorreo''' 
Distribución electrónica automatizada de facturas a clientes, incluyendo PDF y XML técnico.
| POST
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Nómina Electrónica - SOAP
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - Enviar''' 
Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN. 
'''Entornos:''' Demo / Producción
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - ConsultarDocumento''' 
Consulta del estado de tramitación y validación de nóminas electrónicas.
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - EnviarCorreo''' 
Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| SOAP
|
'''NominaElectronica - ConsultarFolios''' 
Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Nómina Electrónica - REST
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/Enviar''' 
Procesamiento de nóminas electrónicas individuales o masivas conforme a requisitos DIAN. 
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/ConsultarDocumento''' 
Consulta del estado de tramitación y validación de nóminas electrónicas.
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/EnviarCorreo''' 
Envío automatizado de nóminas electrónicas a los colaboradores con sus representaciones gráficas.
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Nomina
| REST
|
'''Api/documentos/ConsultarFolios''' 
Consulta y gestión de numeración autorizada por la DIAN para emisión de nóminas.
| GET
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Recepción Electrónica
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
|-
| style="padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - ReporteStatus''' 
Procesa documentos recibidos de proveedores, validando autenticidad e integridad para integración contable. 
'''Entornos:''' Demo / Producción
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - EstadoDocumento''' 
Consulta del estado y trazabilidad de documentos recibidos ante la DIAN.
|-
| style="padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - Respuesta''' 
Gestión formal de aceptación o rechazo de documentos recibidos, registrando eventos ante la DIAN.
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Recepcion
| SOAP
|
'''Recepcion - RepresentacionGrafica''' 
Descarga y generación de PDFs de documentos recibidos conforme a los estándares DIAN.
|}

<div style="font-size:1.5em; font-weight:bold; color:#003366; margin-top:25px; margin-bottom:15px;">
Documentos Equivalentes
</div>

{| class="wikitable" style="width:100%; border-collapse:collapse; font-size:0.95em; color:#333;"
|-
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Producto
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Servicio
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Descripción
! style="background-color:#003366; color:#fff; text-align:left; padding:8px;" | Método
|-
| style="padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - EnviarRequest''' 
Envío de documentos equivalentes electrónicos a la DIAN, cumpliendo con las validaciones oficiales. 
'''Entornos:''' Demo / Producción
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - GenerarContenedor''' 
Genera contenedores de información estructurados según los requisitos técnicos de la DIAN.
| GET
|-
| style="padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - DescargaPDF''' 
Generación de representaciones gráficas PDF para documentos equivalentes conforme a la normativa vigente.
| POST
|-
| style="background-color:#f8fafd; padding:8px; border:1px solid #b8c6db;" | Doc Equivalente
| REST
|
'''Equivalente - EstadoDocumento''' 
Consulta del estado de validación y trazabilidad de documentos equivalentes ante la DIAN.
| POST
|}

|}
 
[[File:HKAFactura 3.png|200px]]
 

* [[Índice del Manual de Integración Directa]]

* [[Direct Integration Manual Index - Electronic Invoice]]
* '''[[Facturación Electrónica bajo Resoluciones DIAN]]'''
* [[Herramientas Alternativas de Integración Facturación]]
* '''[[Servicio Gestión Contribuyentes]]'''
* [[Representaciones Gráficas en el proceso de Emisión]]
* [[Reglas de Rechazo DIAN - Integración]]
* [[Preguntas Frecuentes de Integración con servicio Web (Val. Previa)]]
* [[Tips Urls de Emisión]]

 
[[File:HKANomina 3.png|200px]]
 

* [[Índice del Manual de Integración Nómina Electrónica]]
* [[Portal Web Nómina Electrónica]]
* [[Habilitación Nómina Electrónica]]
* '''[[Herramientas Alternativas de Integración Nómina]]'''
* [[Nómina Electrónica según Concepto Unificado DIAN 0106 – 19 agosto 2022 ]]
* [[Preguntas Frecuentes de Integración Nómina Electrónica]]
* [[Tips Urls de Emisión Nómina Electrónica]]

 
[[File:HKARecepcion 3.png|260px]]
 

* [[Índice del Manual de Integración Directa HKA Recepción]]
* [[HKA Reception Direct Integration Manual Index]]
* [[Preguntas Frecuentes de Integración Recepción Electrónica]]
* [[Tips Urls de Recepción Integración]]

 
[[File:HKAEquivalente1.png|260px]]
 
* [[Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos]]
* [[Requisitos minimos de las Representaciones grafica para documento equivalente]]
* [[Preguntas Frecuentes de Integración Documento Equivalente Electrónico]]
* [[Tips Urls de documento equivalente Integración]]
 
 
 

 
[[File:ArticulosInteresIntegracion.png|260px]]
 
* [[HKA TIPS]]
* [[Consideraciones Url Versión 4]]
* [[Recomendaciones para integraciones ante escenarios de intermitencia o Timeouts DIAN]]
* [[Manejo de SoapUI para pruebas en Demo]]
* [[Manejo de Postman para pruebas en Demo]]
* [[Campo extra para informar el Fabricante de Software]]
* [[Recomendaciones en la implementación de la factura electronica]]
* [[Politicas de seguridad de la información para aliados de The Factory HKA]]
* [[Actualización de Seguridad Requerida Migración a TLS 1.2 o superior en nuestros servicios web]]
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 
{{clear}}

Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica

2026-02-11T17:12:55Z

Paguirre: Se ha deshecho la revisión 9393 de Paguirre (disc.)

<includeonly>=</includeonly>==Servicios de Manejo de Documentos Electrónicos para Receptor==<includeonly>=</includeonly>

===Método de Reporte con Estatus (ReporteStatus)===
Muestra la lista de los 500 últimos documentos de Facturación Electrónica con el respectivo estado que se
está buscando, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a
un valor suministrado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="2"|Int
|consecutivo
|Número consecutivo de los documentos a revisa
|número consecutivo del documento o en blanco
|-
|status_code
|Código de Estatus del documento
|Requerido para la búsqueda*,se puede verificar en la siguiente [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}
En la siguiente tabla se muestran los estados +(tabla 1) posibles del documento para ingresarlos y
obtener un reporte solo con los documentos con el estado proporcionado.

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:ReporteStatus>
<tem:request>
<wcf:consecutivo>500</wcf:consecutivo>
<wcf:status_code>01</wcf:status_code>
<wcf:tokenEmpresa>89………………………………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3…………………………43</wcf:tokenPassword>
</tem:request>
</tem:ReporteStatus>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ReporteStatusResponse xmlns="http://tempuri.org/">
<ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>200</a:codigo>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ReporteStatusResponse xmlns="http://tempuri.org/">
<ReporteStatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>200</a:codigo>
<a:documentoselectronicos>
<a:InfoDocumentoStatus>
<a:correlativoempresa>177</a:correlativoempresa>
<a:cufe>90931e5e4e97f8d695326b2cd49328b1fcb0bf669bf9252b02acfaaab6bebe281c6adc846165e3b00a3cf23d00dfeb99</a:cufe>
<a:estatus>1</a:estatus>
<a:estatusDIANcodigo/>
<a:estatusDIANdescripcion
<a:estatusDIANfecha/>
<a:estatusnombre>Entregado</a:estatusnombre>
<a:fechaemision>2021-09-21</a:fechaemision>
<a:fecharecepcion>2021-11-17T19:24:07</a:fecharecepcion>
<a:horaemision>23:24:46</a:horaemision>
<a:montototal>21665472.08</a:montototal>
<a:numerodocumento>SUN64</a:numerodocumento>
<a:numeroidentificacion>595454595</a:numeroidentificacion>
<a:razonsocial>Ady.SA</a:razonsocial>
<a:tipodocumento>01</a:tipodocumento>
<a:tipoemisor>1</a:tipoemisor>
<a:tipoidentidad>31</a:tipoidentidad>
</a:InfoDocumentoStatus>

…………………
</a:documentoselectronicos>
<a:mensaje>Procesado</a:mensaje>
<a:pendiente>false</a:pendiente>
<a:resultado>Procesado</a:resultado>
<a:ultimoEnviado>25</a:ultimoEnviado>
</ReporteStatusResult>
</ReporteStatusResponse>
</s:Body>
</s:Envelope>

</pre>

'''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se
muestra. Si se tienen más documentos el reporte mostrará '''true''' en la etiqueta pendientes, de caso
contrario si se tiene '''false''' indica que ya no se tienen documentos.

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|Código
|Código de retorno. Ver catálogo de respuesta del método
|-
|Int
|CorrelativoEmpresa
|Número correlativo de la empresa
|-
|String
|estatus
|Estatus del documento en el que se encuentra [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|String
|cufe
|Certificado Único de Facturación Electrónica.
|-
|Date
|fechaemision
|Fecha en el que fue emitido el documento
|-
|Date
|fecharecepcion
|Fecha en que anexado
|-
|Time
|horaemisión
|Hora de emisión
|-
|Int
|montotal
|Monto total de la factura electrónica
|-
|String
|numerodocumento
|Identificador del documento
|-
|Int
|numeroidentificacion
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
|String
|razonsocial
|Razón social del Emisor
|-
|String
|tipodocumento
|Identificador del documento
|-
|Int
|tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|
|-
|Int
|tipoentidad
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|Boolean
|pendiente
|respuesta (False/True)
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|-
|Int
|ultimoenviado
|Último número consecutivo
|}

===Método Reporte===
Muestra la lista de los 500 últimos documentos de Facturación Electrónica, que se han recibidos para un Receptor dado y que tienen asociado un consecutivo menor a un valor suministrado.

'''El reporte mostrará la información del documento, sin importar que estatus tenga.'''

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|Int
|consecutivo
|Número consecutivo de los documentos a revisa
|número consecutivo del documento o en blanco
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:Reporte>
<tem:request>
<wcf:consecutivo>800</wcf:consecutivo>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
</tem:request>
</tem:Reporte>
</soapenv:Body>
</soapenv:Envelope>

</pre>
====Ejemplo de salida====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ReporteResponse xmlns="http://tempuri.org/">
<ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>200</a:codigo>
<a:documentoselectronicos>
<a:InfoDocumento>
<a:correlativoempresa>733</a:correlativoempresa>
<a:cufe>0e12f97ef32ed6c1b104bfb...ad96f36060039e2d5f2</a:cufe>
<a:estatusDIANcodigo/>
<a:estatusDIANdescripcion/>
<a:estatusDIANfecha/>
<a:fechaemision>2021-08-31</a:fechaemision>
<a:fecharecepcion>2022-02-17T16:56:55</a:fecharecepcion>
<a:horaemision>01:01:45</a:horaemision>
<a:montototal>412423.87</a:montototal>
<a:numerodocumento>ABB12</a:numerodocumento>
<a:numeroidentificacion>45......34</a:numeroidentificacion>
<a:razonsocial>JD Proveedor 01</a:razonsocial>
<a:tipodocumento>01</a:tipodocumento>
<a:tipoemisor>1</a:tipoemisor>
<a:tipoidentidad>31</a:tipoidentidad>
</a:InfoDocumento>
<a:InfoDocumento>...</a:InfoDocumento>
</a:documentoselectronicos>
<a:mensaje>Procesado</a:mensaje>
<a:pendiente>true</a:pendiente>
<a:resultado>Procesado</a:resultado>
<a:ultimoEnviado>234</a:ultimoEnviado>
</ReporteResult>
</ReporteResponse>
</s:Body>
</s:Envelope>

</pre>

'''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se muestra. Si se tienen más documentos el reporte mostrará true en la etiqueta pendientes, de caso contrario si se tiene false indica que ya no se tienen documentos.

====Ejemplos: tomando el ultimoenviado====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:Reporte>

<tem:request>

<wcf:consecutivo>253</wcf:consecutivo>
<wcf:tokenEmpresa>89………b52</wcf:tokenEmpresa>


<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
</tem:request>
</tem:Reporte>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo Respuesta:Tomando el ultimo enviado====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ReporteResponse xmlns="http://tempuri.org/">
<ReporteResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>200</a:codigo>
<a:documentoselectronicos>
<a:InfoDocumento>
<a:correlativoempresa>252</a:correlativoempresa>
<a:cufe>cdb0097ff69b252d8c1dd27b57fa8d5637a661de7a30e0554c99babd295354506dbdb33c48ba3c6dfbd8fc474984a60c</a:cufe>
<a:estatusDIANcodigo/>
<a:estatusDIANdescripcion/>
<a:estatusDIANfecha/>
<a:fechaemision>2021-08-11</a:fechaemision>
<a:fecharecepcion>2021-11-26T12:19:30</a:fecharecepcion>
<a:horaemision>15:00:00</a:horaemision>
<a:montototal>1593558.75</a:montototal>
<a:numerodocumento>LAS40021</a:numerodocumento>
<a:numeroidentificacion>45671234</a:numeroidentificacion>
<a:razonsocial>Karmi</a:razonsocial>
<a:tipodocumento>01</a:tipodocumento>
<a:tipoemisor>1</a:tipoemisor>
<a:tipoidentidad>31</a:tipoidentidad>
</a:InfoDocumento>

..............
<a:InfoDocumento>
<a:correlativoempresa>1</a:correlativoempresa>
<a:cufe>e1307a9f41f427d2ce379a6b951b82fe3c0c2400468ed22bb3f571f50112c7c67ee551d865c50b95252f62b06043b14b</a:cufe>
<a:estatusDIANcodigo/>
<a:estatusDIANdescripcion/>
<a:estatusDIANfecha/>
<a:fechaemision>2021-08-11</a:fechaemision>
<a:fecharecepcion>2021-08-13T10:44:47</a:fecharecepcion>
<a:horaemision>15:00:00</a:horaemision>
<a:montototal>1593558.75</a:montototal>
<a:numerodocumento>LAS15143</a:numerodocumento>
<a:numeroidentificacion>45671234</a:numeroidentificacion>
<a:razonsocial>Karmi</a:razonsocial>
<a:tipodocumento>01</a:tipodocumento>
<a:tipoemisor>1</a:tipoemisor>
<a:tipoidentidad>31</a:tipoidentidad>
</a:InfoDocumento>
</a:documentoselectronicos>
<a:mensaje>Procesado</a:mensaje>
<a:pendiente>false</a:pendiente>
<a:resultado>Procesado</a:resultado>
<a:ultimoEnviado>1</a:ultimoEnviado>
</ReporteResult>
</ReporteResponse>
</s:Body>
</s:Envelope>

</pre>
'''Apartado pendientes: False es indicativo que no hay más documentos por mostrar, True indica que hay más documentos anteriores.'''

'''NOTA:''' El '''ultimoEnviado''' es el número consecutivo para ver los archivos anteriores a el último que se
muestra. Si se tienen más documentos el reporte mostrará '''true''' en la etiqueta pendientes, de caso
contrario si se tiene '''false''' indica que ya no se tienen documentos.

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|Código
|Código de retorno. Ver catálogo de respuesta del método
|-
|Int
|CorrelativoEmpresa
|Número correlativo de la empresa
|-
|String
|cufe
|Certificado Único de Facturación Electrónica.
|-
|Date
|fechaemision
|Fecha en el que fue emitido el documento
|-
|Date
|fecharecepcion
|Fecha en que anexado
|-
|Time
|horaemisión
|Hora de emisión
|-
|Int
|montotal
|Monto total de la factura electrónica
|-
|String
|numerodocumento
|Identificador del documento
|-
|Int
|numeroidentificacion
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
|String
|razonsocial
|Razón social del Emisor
|-
|String
|tipodocumento
|Identificador del documento
|-
|Int
|tipoemisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|
|-
|Int
|tipoentidad
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|Boolean
|pendiente
|respuesta (False/True)
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|-
|Int
|ultimoenviado
|Último número consecutivo
|}

===Método de Descarga XML===
Permite obtener el Archivo XML codificado en Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarXML>
<tem:request>
<wcf:TipoDocumento>?</wcf:TipoDocumento>
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
<wcf:numeroDocumento>ABB10</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarXMLResponse xmlns="http://tempuri.org/">
<DescargarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>PD94b………………….b2N1bWVudD4=</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>4ecd4e588d71e689a32bb07d92c58b4e</a:crc>
<a:cufe>0e12f97ef32ed6c1b104bfb13...f36060039e2d5f2</a:cufe>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:size>44864</a:size>
</DescargarXMLResult>
</DescargarXML
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64
|-
|Int
|Código
|Código de retorno. Ver catálogo de respuesta del método
|-
|String
|crc
|Chequeo de Redundancia Cíclica
|-
|String
|cufe
|Certificado Único de Facturación Electrónica.
|-
|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|-
|Int
|size
|Tamaño del documento
|}

===Método de Descarga RepresentacionGrafica===
Permite obtener el Archivo que contiene la Representación Gráfica codificado Base64, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es un Receptor que lo está solicitando

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="2"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarRepGrafica>
<tem:request>

<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
<wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarRepGrafica>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarRepGraficaResponse xmlns="http://tempuri.org/">
<DescargarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo i:nil="true"/>
<a:codigo>102</a:codigo>
<a:crc i:nil="true"/>
<a:cufe i:nil="true"/>
<a:mensaje>Longitud No Válida para el Tipo de Identificador del Emisor</a:mensaje>
<a:resultado>Error</a:resultado>
<a:size i:nil="true"/>
</DescargarRepGraficaResult>
</DescargarRepGraficaResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bas64
|archivo
|Archivo en Base 64
|-
|Int
|codigo
|Código de retorno. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|string
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|}

===Método de Descarga de Adjuntos/Anexos===
Permite obtener el Archivo que contiene el Anexo cuya identificación interna fue indicada, correspondiente al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando. El contenido del archivo es presentado codificado en base64.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|String
|IdentificadorinternoAnexo
|corresponde al identificador interno (NameFile) del anexo que se desea descargar.
|El FileName se obtiene con el método ListaAnexo*
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarRepGrafica>
<tem:request>

<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
<wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarRepGrafica>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarAnexoResponse xmlns="http://tempuri.org/">
<DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>JVB……………………….YK</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc>
<a:cufe>6c406410fc912ca1...8da809c1517da5</a:cufe>
<a:displayname>ad0000346585016210001271e</a:displayname>
<a:extension>pdf</a:extension>
<a:idfile>5984</a:idfile>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:sizefile>43203</a:sizefile>
<a:type>2</a:type>
</DescargarAnexoResult>
</DescargarAnexoResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo XML en Base64 que contiene el documento electrónico.
|-
|Int
|codigo
|Código de retorno. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|String
|crc
|Chequeo de Redundancia Cíclica
|-
|String
|cufe
|Certificado Único de Facturación Electrónica.
|-
|String
|displayname
|
|-
|String
|extension
|Tipo de documento que se tiene
|-
|Int
|idfile
|
|}
|string
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|-
|Int
|sizefile
|Tamaño del documento
|-
|Int
|Type
|Tipo de documento, (Ver catálogo)
|}
|}

===Método Consulta de Estado Documento===
Permite conocer el estatus, así como la lista de estados por la que ha pasado un documento de Facturación Electrónica, que originalmente fue emitida por un Proveedor, cuyo adquiriente tiene como proveedor tecnológico de Facturación Electrónica a The Factory HKA Colombia

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoDocumento>

<tem:request>

<wcf:TipoDocumento></wcf:TipoDocumento>

<wcf:identificadorEmisor>25………1</wcf:identificadorEmisor>

<wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
</tem:request>
</tem:EstadoDocumento>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoDocumentoResponse xmlns="http://tempuri.org/">
<EstadoDocumentoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ListEstatusHistory>
<a:HistorialEstatus>
<a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Aceptación expresa (DIAN)</a:Comentarios>
<a:Descripcion>Aceptación expresa (DIAN)</a:Descripcion>
<a:codigoEstatus>2</a:codigoEstatus>
<a:fecha>2022-03-07 13:37:47</a:fecha>
</a:HistorialEstatus>
<a:HistorialEstatus>
<a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Recibo del bien y/o prestación del servicio</a:Comentarios>
<a:Descripcion>Recibo del bien y/o prestación del servicio</a:Descripcion>
<a:codigoEstatus>12</a:codigoEstatus>
<a:fecha>2022-03-07 13:37:46</a:fecha>
</a:HistorialEstatus>
<a:HistorialEstatus>
<a:Comentarios>Pasa del estado Acuse de recibo (DIAN) al estado Acuse de recibo (DIAN)</a:Comentarios>
<a:Descripcion>Acuse de recibo (DIAN)</a:Descripcion>
<a:codigoEstatus>10</a:codigoEstatus>
<a:fecha>2022-03-07 13:32:19</a:fecha>
</a:HistorialEstatus>
<a:HistorialEstatus>
<a:Comentarios>Cambio de Estado a Entregado por Descarga de Documento Electrónico</a:Comentarios>
<a:Descripcion>Entregado</a:Descripcion>
<a:codigoEstatus>1</a:codigoEstatus>
<a:fecha>2022-02-11 12:38:25</a:fecha>
</a:HistorialEstatus>
<a:HistorialEstatus>
<a:Comentarios>Cargado</a:Comentarios>
<a:Descripcion>Cargado</a:Descripcion>
<a:codigoEstatus>0</a:codigoEstatus>
<a:fecha>2022-02-11 12:23:02</a:fecha>
</a:HistorialEstatus>
</a:ListEstatusHistory>
<a:codigo>200</a:codigo>
<a:estatusDIANDescripcion/>
<a:estatusDIANcodigo/>
<a:estatusDIANfecha/>
<a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
<a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento>
<a:mensaje>Se retorna los datos del estado del documento</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:tipoDocumento>01</a:tipoDocumento>
<a:uuid>0e12f97ef3...060039e2d5f2</a:uuid>
</EstadoDocumentoResult>
</EstadoDocumentoResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|comentarios
|Status del documento . [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|String
|descripcion
|Descripción del status relacionado
|-
|Int
|codigoEStatus
|Código del estatus. [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|Date
|fecha
|fecha en formato “s” ”( yyyy'-'MM'-'dd'T'HH':'mm':'ss ) del estatus actual
|-
|String
|uuid
|Identificador Universal Único
|}

===Método Cambio de Status===
Este método permite la actualización del estado (o generación de eventos) de un Documento de Facturación Electrónica previamente emitido. Solo cuando el Adquiriente (Receptor de la factura electrónica) tiene a The Factory HKA Colombia como su Proveedor Tecnológico de Facturación Electrónica.

'''NOTA:'''Si el documento está en un estado DIAN y se requiere cambiar a otro estado y se genera una regla de rechazo, puede que se encuentre en espera para recibir respuesta de la DIAN del cambio de estado inicial, por lo cual se recomienda esperar 5 minutos antes de realizar un nuevo cambio de estado.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="7"|class
|rowspan="7"|EjecutadorPor
|Apellido
|Apellido de la persona encargada de realizar el cambio de estado.
|-
|Cargo
|Cargo u ocupación que desempeña la persona que realiza el cambio de estado en la organización, organismo o empresa.(opcional).
|-
|Departamento.
|Área en la que se encuentra la persona encargada del cambio de estado (opcional).
|-
|DV
|Digito verificador del NIT de la empresa.
|-
|NumeroIdentificacion
|NIT de la empresa.
|-
|TipoIdentificacion
|Tipo de identifiación de la empresa según la [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|Nombre
|Nombre de la persona encargada de realizar el cambi de estado o envio de eventos hacia la DIAN.
|-
|rowspan="8"|String
|TipoDocumento
|
|Es el tipo de documento al cual se le aplicará el cambio de estado (01 para facturas)
|-
|codigoRechazo
|
|Código de la razón por la cual se realiza el reclamo de la factura según [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 6|Tabla 6]].
'''IMPORTANTE''': El '''codigoRechazo''' es requerido al realizar el reclamo de una factura.
|-
|identificadorEmisor
|
|NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos
|-
|numeroDocumento
|
|Consecutivo del documento hasta 20 caracteres
|-
|status
|
|Código de Estatus del documento,requerido para la búsqueda*,se puede verificar en la siguiente [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|tipoIdentificacionemisor
|
|Tipo de identificador del Emisor del documento según [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|tokenEmpresa
|
|Dato suministrado por The Factory HKA Colombia (40 caracteres).
|-
|tokenPassword
|
|Dato suministrado por The Factory HKA Colombia (40 caracteres).
|-
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:CambioEstatus>
<tem:request>
<wcf:EjecutadoPor>
<wcf:Apellido>López</wcf:Apellido>
<wcf:Cargo>Pruebas</wcf:Cargo>
<wcf:Departamento>Calidad</wcf:Departamento>
<wcf:Identificacion>
<wcf:Dv/>
<wcf:NumeroIdentificacion>148777333351</wcf:NumeroIdentificacion>
<wcf:TipoIdentificacion>13</wcf:TipoIdentificacion>
</wcf:Identificacion>
<wcf:Nombre>Adriana</wcf:Nombre>
</wcf:EjecutadoPor>
<wcf:TipoDocumento>01</wcf:TipoDocumento>
<wcf:codigoRechazo>02</wcf:codigoRechazo>
<wcf:identificadorEmisor>90………26</wcf:identificadorEmisor>
<wcf:numeroDocumento>AKLAA16</wcf:numeroDocumento>
<wcf:status>10</wcf:status>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>xxxxxxxxxx</wcf:tokenEmpresa>
<wcf:tokenPassword>xxxxxxxxxxx</wcf:tokenPassword>
</tem:request>
</tem:CambioEstatus>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<CambioEstatusResponse xmlns="http://tempuri.org/">
<CambioEstatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>103</a:codigo>
<a:mensaje>Se produjo un error en el servicio...{"Codigo":"108","Mensaje":"No se pudo cambiar el status del Documento ABB01 emitido por NIT 45......34 a NIT 12.....9. Estatus no válido. No está permitido el status Precargado cuando se está en el estatus Acuse de recibo (DIAN)","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
<a:resultado>Error</a:resultado>
</CambioEstatusResult>
</CambioEstatusResponse>
</s:Body>
</s:Envelope>
</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|Código
|Código de retorno. Ver catálogo de respuesta del método
|-
|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|}

===Método Consulta de Metadata (infodatos) (a los documentos) ConsultaDocumentosMetadata===
(Infodatos)
Permite a un Receptor consultar el o los metadato(s) (infodatos) correspondientes a un documento de Facturación Electrónica, identificado con el numero documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor[[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:CosultaDocumentoMetadata>
<tem:request>
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
<wcf:numeroDocumento>ABB09</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:CosultaDocumentoMetadata>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<CosultaDocumentoMetadataResponse xmlns="http://tempuri.org/">
<CosultaDocumentoMetadataResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ListMetadata>
<a:SPPostMetadata>
<a:createdat>2022-02-17T12:08:47</a:createdat>
<a:createdby>Customer</a:createdby>
<a:label>Nueva Categoría 2</a:label>
<a:updatedat>2022-02-17T12:08:47</a:updatedat>
<a:updatedby>Customer</a:updatedby>
<a:value>A</a:value>
</a:SPPostMetadata>
<a:SPPostMetadata>
<a:createdat>2022-02-17T12:08:47</a:createdat>
<a:createdby>Customer</a:createdby>
<a:label>Nueva Categoría</a:label>
<a:updatedat>2022-02-17T12:08:47</a:updatedat>
<a:updatedby>Customer</a:updatedby>
<a:value>Calle Carrera</a:value>
</a:SPPostMetadata>
<a:SPPostMetadata>
<a:createdat>2022-02-17T12:08:47</a:createdat>
<a:createdby>Customer</a:createdby>
<a:label>Regiones 1</a:label>
<a:updatedat>2022-02-17T12:08:47</a:updatedat>
<a:updatedby>Customer</a:updatedby>
<a:value>J&J</a:value>
</a:SPPostMetadata>
</a:ListMetadata>
<a:codigo>200</a:codigo>
<a:estatusDIANDescripcion/>
<a:estatusDIANcodigo/>
<a:estatusDIANfecha/>
<a:estatusDocumento>Aceptación expresa (DIAN)</a:estatusDocumento>
<a:fechaDocumento>2022-02-11T12:23:01</a:fechaDocumento>
<a:mensaje>Se retorna los datos sobre metadatos del documento</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:tipoDocumento>01</a:tipoDocumento>
<a:uuid>0e12f97ef32ed6...11ad96f36060039e2d5f2</a:uuid>
</CosultaDocumentoMetadataResult>
</CosultaDocumentoMetadataResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|createdat
|Creación del Infodato
|-
|String
|createdby
|Quien lo creo
|-
|String
|label
|Nombre del Infodato
|-
|Time
|updatedat
|Tiempo de relación
|-
|String
|value
|Nombre de la subcategoría o valor que está relacionado del Infodato
|}

</pre>

===Método ListaAnexo ===

Permite obtener la lista de anexos asociados al documento de Facturación Electrónica identificado por un valor dado y emitido por un emisor identificado, cuyo adquiriente es el Receptor que lo está solicitando

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:ListaAnexo>
<tem:request>
<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
<wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89………………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:ListaAnexo>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<ListaAnexoResponse xmlns="http://tempuri.org/">
<ListaAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:ListArchivoDocumento>
<a:ArchivoDocumento>
<a:CreatedAt>2022-02-01T10:14:09.223</a:CreatedAt>
<a:Format>.pdf</a:Format>
<a:InvoiceFileId>5782</a:InvoiceFileId>
<a:InvoiceId>19981</a:InvoiceId>
<a:NameDisplay>LAS40588</a:NameDisplay>
<a:NameFile>LAS40588</a:NameFile>
<a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
<a:ProviderVisible>true</a:ProviderVisible>
<a:Type>Representacion Gráfica</a:Type>
<a:TypeCode>1</a:TypeCode>
<a:UpdatedAt>2022-02-01T10:14:09.223</a:UpdatedAt>
<a:size>43282</a:size>
</a:ArchivoDocumento>
<a:ArchivoDocumento>
<a:CreatedAt>2022-03-09T12:16:47.597</a:CreatedAt>
<a:Format>.pdf</a:Format>
<a:InvoiceFileId>5984</a:InvoiceFileId>
<a:InvoiceId>19981</a:InvoiceId>
<a:NameDisplay>ad0000346585016210001271e</a:NameDisplay>
<a:NameFile>32168992-676A-44C8-862D-F5E5EBC762DB</a:NameFile>
<a:PathFile>Recepcion/542/31/45......34/2021/8/11/LAS40588/</a:PathFile>
<a:ProviderVisible>true</a:ProviderVisible>
<a:Type>Anexo</a:Type>
<a:TypeCode>2</a:TypeCode>
<a:UpdatedAt>2022-03-09T12:16:47.597</a:UpdatedAt>
<a:size>43203</a:size>
</a:ArchivoDocumento>
</a:ListArchivoDocumento>
<a:codigo>200</a:codigo>
<a:mensaje>Se retorna los datos del Archivos asociados al documento LAS40588 emitido por el NIT 45......34 al solicitante con NIT 12.....9</a:mensaje>
<a:resultado>Procesado</a:resultado>
</ListaAnexoResult>
</ListaAnexoResponse>
</s:Body>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|Int
|InvoiceFileId
|Campo de control de identificación del archivo
|-
|InvoiceId
|Campo de control de identificación del documento
|-
|TypeCode
|Entero que indica el código de tipo de anexo; a saber admite los siguientes valores [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 5|Tabla 5]]
|-
|size
|tamaño del documento
|-
|rowspan="5"|String
|Format
|Extensión del Archivo
|-
|NameDisplay
|Nombre Archivo dado por el Proveedor Tecnológico, hasta 100 caracteres
|-
|PathFile
|Campo de control de identificación del documento
|-
|Type
|Indica el tipo de adjunto; a saber : Representación Gráfica, Anexo, Acuse de Recibido, Acuse de Aceptado, Acuse de Rechazado y Acuse de Aceptación Tácita
|-
|NameFile
|Nombre interno del archivo. Este valor es usado tanto para la solicitud de recuperación, como la solicitud de eliminación del archivo
|-
|rowspan="2"|Time
|UpdatedAt
|fecha de la última actualización del archivo
|-
|CreatedAt
|Fecha en la que fue incorporado el archivo
|-
|Boolean
|ProviderVisible
|Indicador que señala si el archivo puede ser descargado por el emisor
|}

NameFile : Este es indispensable para el método DercargaAnexo este debe de coincidir Type: Anexo. Para la descarga del Anexo que es el siguiente método

</pre>

===Método DescargaAnexo===

Permite la descarga del Anexo o adjunto del documento que se encuentra vinculado al documento de factura. Que originalmente fue anexada al documento.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="2"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|rowspan="5"|String
|identificadorinternoanexo
|Identificador del Anexo el cual debe de consultarse en el '''Método de ListaAnexo'''
|
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarAnexo>
<tem:request>
<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:identificadorEmisor>45......34</wcf:identificadorEmisor>
<wcf:identificadorInternoAnexo>32168992-0000-44C8-862D-F5E5EBC762DB</wcf:identificadorInternoAnexo>
<wcf:numeroDocumento>LAS40588</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarAnexo>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarAnexoResponse xmlns="http://tempuri.org/">
<DescargarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>JVBERi0xLjQKM……</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>5e9b2925ae58b8f7c2c95ef8d748d864</a:crc>
<a:cufe>6c406410fc912ca1a937d1b...e08ad3c91fa8da809c1517da5</a:cufe>
<a:displayname>ad0000346585016210001271e</a:displayname>
<a:extension>pdf</a:extension>
<a:idfile>5984</a:idfile>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:sizefile>43203</a:sizefile>
<a:type>2</a:type>
</DescargarAnexoResult>
</DescargarAnexoResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="4"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|Id
|Id del documento.
|-
|Type
|Tipo de documento, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 3|Tabla 3]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="6"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|cufe
|Certificado Único de Facturación Electrónica.
|-
|displayname
|
|-
|extension
|Tipo de documento que se tiene
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

</pre>

===Método Envío de Representación Gráfica (EnviarRepGrafica) ===

Permite a un Receptor enviar el archivo que corresponde a la representación gráfica de un documento de Facturación Electrónica, identificado con el número documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado; el archivo está codificado en Base64.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|visible
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor
|Visible = 1, No visible = 0, 1 dígito
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|-
|rowspan="7"|String
|archivo
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
|
|-
|nombre
|Nombre del documento de la Representación Gráfica
|Hasta 100 caracteres
|-
|extension
|Indica el formato del archivo remitido; los valores admitidos son
|png|bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 9 digitos
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EnviarRepGrafica>
<tem:request>
<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:archivo>JVB……FT0YK</wcf:archivo>
<wcf:extension>ppt</wcf:extension>
<wcf:identificadorEmisor>45…34</wcf:identificadorEmisor>
<wcf:nombre>SOAP01-2</wcf:nombre>
<wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
<wcf:visible>1</wcf:visible>
</tem:request>
</tem:EnviarRepGrafica>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EnviarRepGraficaResponse xmlns="http://tempuri.org/">
<EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>102</a:codigo>
<a:mensaje>Token Password es Requerido</a:mensaje>
<a:resultado>Error</a:resultado>
</EnviarRepGraficaResult>
</EnviarRepGraficaResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|codigo
|Código de retorno, (Ver catálogo de respuesta del método)
|-
|rowspan="2"|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado, contiene información adicional (Procesado/Error)
|}

</pre>

===Método Envío de XML Método de “EnviarXML” ===

Permite enviar el archivo XML que representa Documento Fiscal Electrónico, el cual fue emitido por un proveedor* de bienes y servicios a un cliente The Factory HKA Colombia, el archivo XML está representado en Base64. Opcionalmente se puede remitir los llamados Metadatos

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|Int
|metadata
|Lista Optativa de cuarteto, que permite especificar atributos adicionales referentes al Documento Fiscal Electrónico; los cuartetos son de la forma (code, value, internal1 (optativo), internal2 (optativo)); estableciendo una asociación entre el elemento code (que representa el código de metadata ) y el resto de los “atributos” del cuarteto en cuestión.
|
|-
|rowspan="3"|String
|archivo
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
|
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EnviarXML>
<tem:request>
<wcf:archivo>PD94b…………..bnQ+</wcf:archivo>
<wcf:metadata>
<wcf:metadata>
<wcf:Metadata>
<wcf:code>01</wcf:code>
<wcf:internal1/>
<wcf:internal2/>
<wcf:value/>
</wcf:Metadata>
</wcf:metadata>
</wcf:metadata>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:EnviarXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EnviarXMLResponse xmlns="http://tempuri.org/">
<EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>203</a:codigo>
<a:documentoId>AHJ07</a:documentoId>
<a:estatusDocumento>Cargado</a:estatusDocumento>
<a:mensaje>Documento Enviado Satisfactoriamente - Problema(s) con Metadato(s) : Valor(es) suministrado(s) para Metadato(s) no corresponde(n) a la(s) lista(s) definida(s)</a:mensaje>
<a:numeroIdentificacion>45......34</a:numeroIdentificacion>
<a:resultado>Procesado</a:resultado>
<a:tipoIdentificacion>31</a:tipoIdentificacion>
</EnviarXMLResult>
</EnviarXMLResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="3"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|numeroIdentificacion
|Id del documento.
|-
|tipoIdentificacion
|Tipo de identificación del documento
|-
|rowspan="4"|String
|Identificador del documento
|-
|estatusDocumento
|Estatus del Documento
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|}

</pre>

===Método Envío de Anexo (EnvioAnexo) ===
Permite a un Receptor enviar un archivo que archivo que se “adjunta” a un documento de Facturación Electrónica , identificado con el numero documento, emitido por un proveedor de bienes y servicios también identificado; al Receptor ya mencionado; el archivo está codificado en Base64.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
| -
|archivo
|Archivo en Base64 que representa un anexo de factura identificada por número de documento
|
|-
|Byte
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor.
|Visible = 1, No visible = 0, 1 dígito
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|tipoidentificadoremisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|-
|rowspan="5"|String
|nombre
|Nombre del documento de la Representación Gráfica
|Hasta 100 caracteres
|-
|extension
|Indica el formato del archivo remitido; los valores admitidos son
|png|bmp|jpg|pdf|doc|docx|xls|xlsx|ppt|pptx|rar|zip
|-
|numeroDocumento
|Identificador del documento
|Hasta 20 caracteres
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EnviarAnexo>
<tem:request>
<wcf:archivo>JVB…….</wcf:archivo>
<wcf:extension>pdf</wcf:extension>
<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:identificadorEmisor>456…34</wcf:identificadorEmisor>
<wcf:nombre>AHJ07-7</wcf:nombre>
<wcf:numeroDocumento>AHJ07</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
<wcf:visible>1</wcf:visible>
</tem:request>
</tem:EnviarAnexo>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EnviarAnexoResponse xmlns="http://tempuri.org/">
<EnviarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>200</a:codigo>
<a:mensaje>Archivo enviado satisfactoriamente</a:mensaje>
<a:resultado>Procesado</a:resultado>
</EnviarAnexoResult>
</EnviarAnexoResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|rowspan="2"|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|}

</pre>
===Método EliminarRepGrafica===
Método que permite a un Receptor eliminar la Representación Gráfica de un documento de Facturación Electrónica que esté vinculado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EliminarRepGrafica>

<tem:request>

<wcf:TipoDocumento>91</wcf:TipoDocumento>

<wcf:identificadorEmisor>25…………08</wcf:identificadorEmisor>

<wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3……..43</wcf:tokenPassword>
</tem:request>
</tem:EliminarRepGrafica>

</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EliminarRepGraficaResponse xmlns="http://tempuri.org/">
<EliminarRepGraficaResponse xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>103</a:codigo>
<a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo ERTYBNT017 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
<a:resultado>Error</a:resultado>
</EliminarRepGraficaResult>
</EliminarRepGraficaResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Código
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| 200
| Representación Gráfica enviada satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango./ Dato que es erróneo
|-
|103
|Error Interno en el Servicio
|Código de retorno. Ver catálogo de respuesta del método
|}

===Método EliminarAnexo/font>===
Método que permite al Receptor eliminar anexos que estén vinculados a un documento de Facturación Electrónica.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="3"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EliminarAnexo>

<tem:request>

<wcf:TipoDocumento>91</wcf:TipoDocumento>

<wcf:identificadorEmisor>25……08</wcf:identificadorEmisor>

<wcf:identificadorInternoAnexo>A177CFD9-695C-4E0A-BC36-0A8DC187A4C9</wcf:identificadorInternoAnexo>

<wcf:numeroDocumento>ERTYBNT017</wcf:numeroDocumento>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3…………………43</wcf:tokenPassword>
</tem:request>
</tem:EliminarAnexo>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EliminarAnexoResponse xmlns="http://tempuri.org/">
<EliminarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>103</a:codigo>
<a:mensaje>Se produjo un error en el servicio...{"Codigo":"104","Mensaje":"No se tiene registrado como válido el anexo A177CFD9-695C-4E0A-BC36-0A8DC187A4C9 en el documento ERTYBNT017 emitido por NIT 25………08 a NIT 90………98","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
<a:resultado>Error</a:resultado>
</EliminarAnexoResult>
</EliminarAnexoResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| Identificador
| Código de retorno.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

===Método DescargarRecepcionBienServicioXML===
Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|nombreFileApplicationResponse
|Nombre del documento que se encuentra en Lista de Anexo
| -
|-
|tipoDescarga
|Tipo de Descarga del documento
|
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarRecepcionBienServicioXML>

<tem:request>

<wcf:TipoDocumento>01</wcf:TipoDocumento>

<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>

<wcf:nombreFileApplicationResponse>f2c7b462-297a-4347-8a35-f63d8a947912.xml</wcf:nombreFileApplicationResponse>

<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>

<wcf:tipoDescarga>1</wcf:tipoDescarga>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarRecepcionBienServicioXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarRecepcionBienServicioXMLResponse xmlns="http://tempuri.org/">
<DescargarRecepcionBienServicioXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>PD94bW…………………</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>dcdc43fb31588b396ccd3ff322fbeda7</a:crc>
<a:cufe>f2c7b462-297a-4347-8a35-f63d8a947912.xml</a:cufe>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:size>15096</a:size>
</DescargarRecepcionBienServicioXMLResult>
</DescargarRecepcionBienServicioXMLResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|cufe
|Certificado Único de Facturación Electrónica.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

===Método DescargarAcuseReclamo===
Método que permite a un Receptor, descargar el Response del evento de Recibo del bien y/o Prestación de servicio, el cual está asociado a un documento que se en encuentra en el sistema
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|nombreFileApplicationResponse
|Nombre del documento que se encuentra en Lista de Anexo
| -
|-
|tipoDescarga
|Tipo de Descarga del documento
|
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarAcuseReclamoXML>

<tem:request>

<wcf:TipoDocumento>01</wcf:TipoDocumento>

<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>

<wcf:nombreFileApplicationResponse></wcf:nombreFileApplicationResponse>

<wcf:numeroDocumento>SETP990441828</wcf:numeroDocumento>

<wcf:tipoDescarga>2</wcf:tipoDescarga>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarAcuseReclamoXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarAcuseReclamoXMLResponse xmlns="http://tempuri.org/">
<DescargarAcuseReclamoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>PD94bWwgdmVyc…………………</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>0e6751bef6bf2815685fc4203efa9ba1</a:crc>
<a:cufe>62229467-75a3-4d3f-97b3-923798c52431.xml</a:cufe>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:size>14792</a:size>
</DescargarAcuseReclamoXMLResult>
</DescargarAcuseReclamoXMLResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|cufe
|Certificado Único de Facturación Electrónica.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

===Método DescargarAcuseRecibido===
Método que permite a un Receptor, descargar el Response del evento del Acuse de Recibido, el cual está asociado a un documento que se en encuentra en el sistema Método
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|nombreFileApplicationResponse
|Nombre del documento que se encuentra en Lista de Anexo
| -
|-
|tipoDescarga
|Tipo de Descarga del documento
|
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarAcuseRecibidoXML>

<tem:request>

<wcf:TipoDocumento></wcf:TipoDocumento>

<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>

<wcf:nombreFileApplicationResponse>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</wcf:nombreFileApplicationResponse>

<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>

<wcf:tipoDescarga>1</wcf:tipoDescarga>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarAcuseRecibidoXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarAcuseRecibidoXMLResponse xmlns="http://tempuri.org/">
<DescargarAcuseRecibidoXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>PD94bWwgdm…………………</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>a26ecb9330992ac9ab4479f457fbdaeb</a:crc>
<a:cufe>226a6537-fdc5-4224-84cd-bd31fbe39af5.xml</a:cufe>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:size>15100</a:size>
</DescargarAcuseRecibidoXMLResult>
</DescargarAcuseRecibidoXMLResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|cufe
|Certificado Único de Facturación Electrónica.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

===Método DescargarAcuseAceptacion===
Método que permite a un Receptor, descargar el Response del evento de Aceptación, el cual está asociado a un documento que se en encuentra en el sistema
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
! style="background:#f2f2f2; text-align:center;"|Valor numérico
|- valign="center"
|-
|rowspan="6"|Int
|TipoDocumento
|Es el tipo de documento que se va a manejar.
|2 caracteres
|-
|nombreFileApplicationResponse
|Nombre del documento que se encuentra en Lista de Anexo
| -
|-
|tipoDescarga
|Tipo de Descarga del documento
|
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|De 6 a 20 dígitos
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|2 caracteres
|-
|nmeroDocumento
|Identificador del documento
|2 caracteres
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia
|rowspan="2"|40 caracteres
|-
|tokenPassword
|}

====Ejemplo de entrada====
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarAcuseAceptacionXML>

<tem:request>

<wcf:TipoDocumento></wcf:TipoDocumento>

<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>

<wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>

<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>

<wcf:tipoDescarga>1</wcf:tipoDescarga>

<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>

<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>

<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarAcuseAceptacionXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

====Ejemplo de salida====
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarAcuseAceptacionXMLResponse xmlns="http://tempuri.org/">
<DescargarAcuseAceptacionXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>PD94bWwgd…………………</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>022770951408403f9442f9d09e52be15</a:crc>
<a:cufe>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</a:cufe>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:size>14688</a:size>
</DescargarAcuseRecibidoXMLResult>
</DescargarAcuseRecibidoXMLResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
| -
|archivo
|Archivo en Base 64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|cufe
|Certificado Único de Facturación Electrónica.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

</pre>

'''Mensaje:''' String que contiene mensaje descriptivo del resultado de la operación
'''resultado:''' String que contiene información adicional (Uso futuro)

Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica

2026-01-28T15:09:30Z

Paguirre: /* Tabla 6 */

==Tabla 1==
{| class="wikitable" style="width: 100%;"
|+ Descripción del Estado del Documento
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|00
|Cargado
|-
|01
|Entregado
|-
|02
|Aceptación expresa (DIAN)
|-
|04
|Reclamo (DIAN)
|-
|10
|Acuse de recibo (DIAN
|-
|11
|Rechazado (DIAN)
|-
|12
|Recibo del bien y/o prestación del servicio
|-
|13
|Precargado
|-
|14
|Revisado
|}
|}

==Tabla 2==
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno y sin estatus
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango / Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}

==Tabla 3==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Persona
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.8-2021 - 13.2.3. Tipo de organización jurídica (Personas)
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|1
|Persona Jurídica y asimiladas
|-
|2
|Persona Natural y asimiladas
|}
|}

==Tabla 4==
{| class="wikitable" style="width: 100%;"
|+ Tipos de identificación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.8-2021 - 13.2.1. Documento de identificación (Tipo de Identificador Fiscal):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|11
|Registro civil
|-
|12
|Tarjeta de identidad
|-
|13
|Cedula de ciudadanía
|-
|21
|Tarjeta de extranjería
|-
|22
|Cédula de extranjería
|-
|31
|NIT
|-
|41
|Pasaporte
|-
|42
|Documento de identificación extranjero
|-
|47
|PEP
|-
|50
|NIT de otro país
|-
|91
|NUIP*
|}
|}

==Tabla 5==
{| class="wikitable" style="width: 100%;"
|+ Tipos de documentos
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|01
|Factura de venta
|-
|91
|Nota crédito
|-
|92
|Nota débito
|}
|}

==Tabla 6==
{| class="wikitable" style="width: 100%;"
|+ Códigos para Reclamos
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|01
|Documento con inconsistencias
|-
|02
|Mercancía no entregada totalmente
|-
|03
|Mercancía no entregada parcialmente
|-
|04
|Servicio no prestado
|}
|}

Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica

2026-01-27T17:58:20Z

Paguirre: /* Tabla 1 */

==Tabla 1==
{| class="wikitable" style="width: 100%;"
|+ Descripción del Estado del Documento
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|00
|Cargado
|-
|01
|Entregado
|-
|02
|Aceptación expresa (DIAN)
|-
|04
|Reclamo (DIAN)
|-
|10
|Acuse de recibo (DIAN
|-
|11
|Rechazado (DIAN)
|-
|12
|Recibo del bien y/o prestación del servicio
|-
|13
|Precargado
|-
|14
|Revisado
|}
|}

==Tabla 2==
{| class="wikitable" style="width: 100%;"
|+ Códigos de retorno y sin estatus
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|200
|Reporte Generado Satisfactoriamente
|-
|102
|El campo {nombre del campo} es requerido / La longitud del campo {nombre del campo} no cumple con el rango / Valor no válido para el campo {nombre del campo}
|-
|103
|Error Interno en el Servicio
|}
|}

==Tabla 3==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Persona
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.8-2021 - 13.2.3. Tipo de organización jurídica (Personas)
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|-
|1
|Persona Jurídica y asimiladas
|-
|2
|Persona Natural y asimiladas
|}
|}

==Tabla 4==
{| class="wikitable" style="width: 100%;"
|+ Tipos de identificación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.8-2021 - 13.2.1. Documento de identificación (Tipo de Identificador Fiscal):
cbc:CompanyID.@schemeName; sts:ProviderID.@schemeName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
|- valign="center"
|11
|Registro civil
|-
|12
|Tarjeta de identidad
|-
|13
|Cedula de ciudadanía
|-
|21
|Tarjeta de extranjería
|-
|22
|Cédula de extranjería
|-
|31
|NIT
|-
|41
|Pasaporte
|-
|42
|Documento de identificación extranjero
|-
|47
|PEP
|-
|50
|NIT de otro país
|-
|91
|NUIP*
|}
|}

==Tabla 5==
{| class="wikitable" style="width: 100%;"
|+ Tipos de documentos
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|01
|Factura de venta
|-
|91
|Nota crédito
|-
|92
|Nota débito
|}
|}

==Tabla 6==
{| class="wikitable" style="width: 100%;"
|+ Códigos de rechazo
|- valign="center"
|-style="text-align:center;"
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|00
|Cargado
|-
|01
|Documento con inconsistencias
|-
|02
|Mercancía no entregada totalmente
|-
|03
|Mercancía no entregada parcialmente
|-
|04
|Servicio no prestado
|}
|}

Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica

2025-12-11T20:14:40Z

Paguirre:

<includeonly>=</includeonly>==Métodos del Servicio Web HKA Recepción ==<includeonly>=</includeonly>

El Servicio de Recepción maneja un conjunto de funcionalidades que soportan la gestión de las
facturas emitidas por proveedores de bienes y servicios a clientes de The Factory HKA Colombia,
cuando estos proveedores no tienen a The Factory HKA Colombia como Proveedor Tecnológico de
Facturación Electrónica.

El servicio de HKA Recepción se encuentra dispuesto para realizar dos conjuntos de acciones:

<ul>
<li>Recepción de Documentos Electrónicos</li>
<li>Gestión de Documentos Electrónicos</li>
</ul>

===Recepción de Documentos Electrónicos===
Contempla las funcionalidades que permiten remitir los documentos que soportan el documento electrónico, entre ellas se encuentran los métodos disponibles:

====Método Envío de XML AttachedDocument “EnviarXML” ====

Permite enviar el archivo XML AttachedDocument que representa Documento Fiscal Electrónico, el cual fue emitido por un proveedor de bienes y servicios a un cliente The Factory HKA Colombia, el archivo XML se debe remitir en Base64. Opcionalmente se puede remitir los llamados Metadatos

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Class
|metadata
|Lista Optativa de cuarteto, que permite especificar atributos adicionales referentes al Documento Fiscal Electrónico; los cuartetos son de la forma (code, value, internal1 (optativo), internal2 (optativo)); estableciendo una asociación entre el elemento code (que representa el código de metadata ) y el resto de los “atributos” del cuarteto en cuestión.
|-
|rowspan="3"|String
|archivo
|Archivo XML en Base64 que contiene el documento electrónico que se desea enviar
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="7"|String
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|documentoId
|Consecutivo del documento remitido.
|-
|estatusDocumento
|Estatus final del documento del Documento.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación.
|-
|numeroIdentificacion
|Número de identificación del emisor del documento remitido.
|-
|resultado
|Contiene información adicional (Procesado/Error)
|-
|tipoIdentificacion
|Tipo de identificación del emisor del documento remitido.
|}

Ejemplo de entrada
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EnviarXML>
<tem:request>
<wcf:archivo>PD94b…………..bnQ+</wcf:archivo>
<wcf:metadata>
<wcf:metadata>
<wcf:Metadata>
<wcf:code>01</wcf:code>
<wcf:internal1/>
<wcf:internal2/>
<wcf:value/>
</wcf:Metadata>
</wcf:metadata>
</wcf:metadata>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
</tem:request>
</tem:EnviarXML>
</soapenv:Body>
</soapenv:Envelope>

</pre>

Ejemplo de salida
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EnviarXMLResponse xmlns="http://tempuri.org/">
<EnviarXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>203</a:codigo>
<a:documentoId>AHJ07</a:documentoId>
<a:estatusDocumento>Cargado</a:estatusDocumento>
<a:mensaje>Documento Enviado Satisfactoriamente - Problema(s) con Metadato(s) : Valor(es) suministrado(s) para Metadato(s) no corresponde(n) a la(s) lista(s) definida(s)</a:mensaje>
<a:numeroIdentificacion>45......34</a:numeroIdentificacion>
<a:resultado>Procesado</a:resultado>
<a:tipoIdentificacion>31</a:tipoIdentificacion>
</EnviarXMLResult>
</EnviarXMLResponse>
</s:Body>
</s:Envelope>
</pre>

====Método Envío de Representación Gráfica (EnviarRepGrafica) ====

Permite a un Receptor enviar el archivo que corresponde a la representación gráfica de una fatura electrónica, identificado con el número documento, emitido por un proveedor de bienes y servicios identificado al Receptor ya mencionado; el archivo debe remitirse codificado en Base64.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="1"|Bytes
|archivo
|Archivo PDF en Base64 que contiene la representación gráfica del documento electrónico que se desea enviar
|-
|rowspan="9"|String
|TipoDocumento
|Es el tipo de documento al cual se le va a remitir la representación gráfica.
|-
|extension
|Indica el formato del archivo remitido; los valores admitidos son: png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx, rar, zip
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
|nombre
|Nombre del archivo de la Representación Gráfica
|-
|numeroDocumento
|Consecutivo del documento al cual se le remite la representación gráfica.
|-
|tipoIdentificadoremisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|
|-
|visible
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor (Visible = 1, No visible = 0)
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|rowspan="2"|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado, contiene información adicional (Procesado/Error)
|}

Ejemplo de entrada
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EnviarRepGrafica>
<tem:request>
<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:archivo>JVB……FT0YK</wcf:archivo>
<wcf:extension>ppt</wcf:extension>
<wcf:identificadorEmisor>45…34</wcf:identificadorEmisor>
<wcf:nombre>SOAP01-2</wcf:nombre>
<wcf:numeroDocumento>SOAP019</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
<wcf:visible>1</wcf:visible>
</tem:request>
</tem:EnviarRepGrafica>
</soapenv:Body>
</soapenv:Envelope>
</pre>

Ejemplo de salida
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EnviarRepGraficaResponse xmlns="http://tempuri.org/">
<EnviarRepGraficaResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>102</a:codigo>
<a:mensaje>Token Password es Requerido</a:mensaje>
<a:resultado>Error</a:resultado>
</EnviarRepGraficaResult>
</EnviarRepGraficaResponse>
</s:Body>
</s:Envelope>
</pre>

====Método Envío de Anexo "EnvioAnexo" ====
Permite remitir un archivo adicional de una factura, diferente a la representación gráfica, identificando el numero documento al cual se encuentra asociado. El archivo a remitir debe estar codificado en Base64.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bytes
|archivo
|Archivo en Base64 que representa un anexo de factura identificada por número de documento
|-
|rowspan="9"|String
|TipoDocumento
|Es el tipo de documento al cual se le remite el anexo.
|-
|extension
|Indica el formato del archivo remitido; los valores admitidos son: png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx, rar, zip
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
|nombre
|Nombre del documento de la Representación Gráfica (Hasta 100 caracteres)
|-
|numeroDocumento
|Consecutivo del documento al cual se le remite el anexo. (Hasta 20 caracteres)
|-
|tipoidentificadoremisor
|Tipo de documento del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|visible
|Indica si el archivo posteriormente puede ser o no descargado por el Emisor. (Visible = 1, No visible = 0)
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 2|Tabla 2]]
|-
|rowspan="2"|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

Ejemplo de entrada
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:EnviarAnexo>
<tem:request>
<wcf:archivo>JVB…….</wcf:archivo>
<wcf:extension>pdf</wcf:extension>
<wcf:TipoDocumento>91</wcf:TipoDocumento>
<wcf:identificadorEmisor>456…34</wcf:identificadorEmisor>
<wcf:nombre>AHJ07-7</wcf:nombre>
<wcf:numeroDocumento>AHJ07</wcf:numeroDocumento>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89……………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3……………43</wcf:tokenPassword>
<wcf:visible>1</wcf:visible>
</tem:request>
</tem:EnviarAnexo>
</soapenv:Body>
</soapenv:Envelope>
</pre>

Ejemplo de salida
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EnviarAnexoResponse xmlns="http://tempuri.org/">
<EnviarAnexoResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>200</a:codigo>
<a:mensaje>Archivo enviado satisfactoriamente</a:mensaje>
<a:resultado>Procesado</a:resultado>
</EnviarAnexoResult>
</EnviarAnexoResponse>
</s:Body>
</s:Envelope>
</pre>

===Gestión de Documentos Electrónicos===
Engloba las funcionalidades inherentes a la gestión propia de los documentos ya radicados, para ello se cuenta con los métodos:

====Método Cambio de Estatus "CambioEstatus"====
Este método permite la actualización del estado (o generación de eventos) de un Documento de Facturación Electrónica previamente emitido. Solo cuando el Adquiriente (Receptor de la factura electrónica) tiene a The Factory HKA Colombia como su Proveedor Tecnológico de Facturación Electrónica.

'''NOTA:'''Si el documento está en un estado DIAN y se requiere cambiar a otro estado y se genera una regla de rechazo, puede que se encuentre en espera para recibir respuesta de la DIAN del cambio de estado inicial, por lo cual se recomienda esperar 5 minutos antes de realizar un nuevo cambio de estado.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="7"|class
|rowspan="7"|EjecutadorPor
|Apellido
|Apellido de la persona encargada de realizar el cambio de estado.
|-
|Cargo
|Cargo u ocupación que desempeña la persona que realiza el cambio de estado en la organización, organismo o empresa.(opcional).
|-
|Departamento.
|Área en la que se encuentra la persona encargada del cambio de estado (opcional).
|-
|DV
|Digito verificador del NIT de la empresa.
|-
|NumeroIdentificacion
|NIT de la empresa.
|-
|TipoIdentificacion
|Tipo de identifiación de la empresa según la [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|Nombre
|Nombre de la persona encargada de realizar el cambi de estado o envio de eventos hacia la DIAN.
|-
|rowspan="8"|String
|TipoDocumento
|
|Es el tipo de documento al cual se le aplicará el cambio de estado (01 para facturas)
|-
|codigoRechazo
|
|Código de la razón por la cual se realiza el reclamo de la factura según [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 6|Tabla 6]].
'''IMPORTANTE''': El '''codigoRechazo''' es requerido al realizar el reclamo de una factura.
|-
|identificadorEmisor
|
|NIT del Emisor o Identificador Tributario del Emisor de la Factura, de 6 a 20 dígitos
|-
|numeroDocumento
|
|Consecutivo del documento hasta 20 caracteres
|-
|status
|
|Código de Estatus del documento,requerido para la búsqueda*,se puede verificar en la siguiente [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 1|Tabla 1]]
|-
|tipoIdentificacionemisor
|
|Tipo de identificador del Emisor del documento según [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Int
|Código
|Código de retorno. Ver catálogo de respuesta del método
|-
|String
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|String
|resultado
|Contiene información adicional (Procesado/Error)
|}

Ejemplo de entrada
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:CambioEstatus>
<tem:request>
<wcf:EjecutadoPor>
<wcf:Apellido>López</wcf:Apellido>
<wcf:Cargo>Pruebas</wcf:Cargo>
<wcf:Departamento>Calidad</wcf:Departamento>
<wcf:Identificacion>
<wcf:Dv/>
<wcf:NumeroIdentificacion>148777333351</wcf:NumeroIdentificacion>
<wcf:TipoIdentificacion>13</wcf:TipoIdentificacion>
</wcf:Identificacion>
<wcf:Nombre>Adriana</wcf:Nombre>
</wcf:EjecutadoPor>
<wcf:TipoDocumento>01</wcf:TipoDocumento>
<wcf:codigoRechazo>02</wcf:codigoRechazo>
<wcf:identificadorEmisor>90………26</wcf:identificadorEmisor>
<wcf:numeroDocumento>AKLAA16</wcf:numeroDocumento>
<wcf:status>10</wcf:status>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>xxxxxxxxxx</wcf:tokenEmpresa>
<wcf:tokenPassword>xxxxxxxxxxx</wcf:tokenPassword>
</tem:request>
</tem:CambioEstatus>
</soapenv:Body>
</soapenv:Envelope>

</pre>

Ejemplo de salida
<pre>

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<CambioEstatusResponse xmlns="http://tempuri.org/">
<CambioEstatusResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:codigo>103</a:codigo>
<a:mensaje>Se produjo un error en el servicio...{"Codigo":"108","Mensaje":"No se pudo cambiar el status del Documento ABB01 emitido por NIT 45......34 a NIT 12.....9. Estatus no válido. No está permitido el status Precargado cuando se está en el estatus Acuse de recibo (DIAN)","Resultado":"Error"} por favor inténtelo más tarde</a:mensaje>
<a:resultado>Error</a:resultado>
</CambioEstatusResult>
</CambioEstatusResponse>
</s:Body>
</s:Envelope>
</pre>

====Método DescargarAcuseAceptacionXML====
Permite obtener el archivo XML ApplicationResponse en Base64,correspondiente al evento de aceptación de la Factura Electrónica.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="8"|String
|TipoDocumento
|Es el tipo de documento del cual se desea descrgar el XML.
|-
|identificadorEmisor
|NIT del Emisor o Identificador Tributario del Emisor de la Factura
|-
|nombreFileApplicationResponse
|Nombre del documento que se encuentra en Lista de Anexo (Opcional)
|-
|nmeroDocumento
|Consecutivo del documento del cual se desea obtener el XML.
|-
|tipoDescarga
|Igual a 1
|-
|tipoIdentificacionemisor
|Identificador del Emisor [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|tokenEmpresa
|rowspan="2"|Dato suministrado por The Factory HKA Colombia (40 caracteres)
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Bytes
|archivo
|Archivo en Base64 del documento
|-
|rowspan="2"|Int
|codigo
|Código de retorno, [[Tablas de códigos de propiedades para recepción de documentos - Índice Manual Integración Recepción Electrónica#Tabla 4|Tabla 4]]
|-
|sizeFile
|tamaño del documento
|-
|rowspan="4"|String
|crc
|Chequeo de Redundancia Cíclica
|-
|cufe
|Certificado Único de Facturación Electrónica.
|-
|mensaje
|Mensaje descriptivo del resultado de la operación
|-
|resultado
|Contiene información adicional (Procesado/Error)
|}

Ejemplo de entrada
<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:wcf="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP">
<soapenv:Header/>
<soapenv:Body>
<tem:DescargarAcuseAceptacionXML>
<tem:request>
<wcf:TipoDocumento></wcf:TipoDocumento>
<wcf:identificadorEmisor>90……26</wcf:identificadorEmisor>
<wcf:nombreFileApplicationResponse>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</wcf:nombreFileApplicationResponse>
<wcf:numeroDocumento>SETP990441830</wcf:numeroDocumento>
<wcf:tipoDescarga>1</wcf:tipoDescarga>
<wcf:tipoIdentificacionemisor>31</wcf:tipoIdentificacionemisor>
<wcf:tokenEmpresa>89…………52</wcf:tokenEmpresa>
<wcf:tokenPassword>b3…………43</wcf:tokenPassword>
</tem:request>
</tem:DescargarAcuseAceptacionXML>
</soapenv:Body>
</soapenv:Envelope>
</pre>

Ejemplo de salida
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<DescargarAcuseAceptacionXMLResponse xmlns="http://tempuri.org/">
<DescargarAcuseAceptacionXMLResult xmlns:a="http://schemas.datacontract.org/2004/07/WcfRecepcionSOAP" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:archivo>PD94bWwgd…………………</a:archivo>
<a:codigo>200</a:codigo>
<a:crc>022770951408403f9442f9d09e52be15</a:crc>
<a:cufe>d9a1a014-9587-4901-af6e-190d0d1c2b0e.xml</a:cufe>
<a:mensaje>Se retorna el archivo solicitado</a:mensaje>
<a:resultado>Procesado</a:resultado>
<a:size>14688</a:size>
</DescargarAcuseRecibidoXMLResult>
</DescargarAcuseRecibidoXMLResponse>
</s:Body>
</s:Envelope>
</pre>

Servicios de Manejo de Documentos Electrónicos para Receptor - Índice Manual Integración Recepción Electrónica

2025-12-10T15:36:52Z

Paguirre: /* Método Cambio de Status */

Índice del Manual de Integración Directa

2025-04-21T21:24:00Z

Paguirre:

[[Category:Manuales|I]]
__NOTOC__
[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalidades - Indice Manual Integración Directa|Generalidades]]==<includeonly>=</includeonly>
# [[Generalidades - Indice Manual Integración Directa#Historial|Historial de versiones]]
# [[Generalidades - Indice Manual Integración Directa#Cómo obtener soporte|Cómo obtener soporte]]
# [[Generalidades - Indice Manual Integración Directa#Descripción general|Descripción general]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es The Factory HKA Factura?|¿Qué es The Factory HKA Factura?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es HKA Integración?|¿Qué es HKA Integración?]]
## [[Generalidades - Indice Manual Integración Directa#Funcionalidades|Funcionalidades]]
## [[Generalidades - Indice Manual Integración Directa#La integración directa|La integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Requerimientos técnicos para la integración directa|Requerimientos técnicos para la integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Esquemas de integración directa para Factura Electrónica TFHKA|Esquemas de integración directa para Factura Electrónica TFHKA]]
# [[Generalidades - Indice Manual Integración Directa#Esquema de operación de la factura electrónica con validación previa|Esquema de operación de la factura electrónica con validación previa]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es la Facturación Electrónica con Validación Previa?|¿Qué es la Facturación Electrónica con Validación Previa?]]
## [[Generalidades - Indice Manual Integración Directa#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
## [[Generalidades - Indice Manual Integración Directa#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
## [[Generalidades - Indice Manual Integración Directa#Proceso de la Facturación Electrónica con Validación Previa|Proceso de la Facturación Electrónica con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor|Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor]]
# [[Generalidades - Indice Manual Integración Directa#Web services TFHKA con validación previa|Web services TFHKA con validación previa]]

<includeonly>=</includeonly>==[[Etapas para la implementación de la integración]]==<includeonly>=</includeonly>
# [[Etapas para la implementación de la integración#Etapas y actividades|Etapas y actividades]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web TFHKA- Indice Manual Integración Directa|Métodos Servicio Emisión Web TFHKA]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DetalleDeFactura|Class.DetalleDeFactura]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.EntregaMercancia|Class.EntregaMercancia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoLegalDocumentos|Método EstadoLegalDocumentos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoCertificado|Método EstadoCertificado]]

<includeonly>=</includeonly>==[[Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa|Métodos Servicio datos adquiriente web soap]]==<includeonly>=</includeonly>
#[[Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa#Método ConsultaAdquiriente|Método ConsultaAdquiriente]]

<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método CargarAdjuntos|Método CargarAdjuntos]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método servicio Eliminar Adjuntos web soap|Método servicio Eliminar Adjuntos web soap]]





<includeonly>=</includeonly>==[[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa|Generación De Notas Con Y Sin Referencia A Documento Electrónico]]==<includeonly>=</includeonly>
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras para manejo de descripción del impuesto ZZ|Uso de campos extras para manejo de descripción del impuesto ZZ]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[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 Directa#Tabla 2|Tabla 2]]
# [[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 Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-04-21T21:03:23Z

Paguirre:

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

'''<pre>PRECAUCIÓN: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvío de correo.</pre>'''

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| 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
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|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|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|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + 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|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|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|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|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|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|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|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|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
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|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|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|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|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo 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 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo 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 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
| <nowiki>AN|..5</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
|}

====Class.Anticipos====
{| 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]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| 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
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|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]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| 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
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[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
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|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]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|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
: Rechazo : 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,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo 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
|<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
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|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
: Notificación 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
|<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
: Notificación : 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
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|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
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''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
: Rechazo 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]]
: Nota: 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
: Rechazo 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="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
|-
|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.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
: Rechazo 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
: Rechazo 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.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
: Rechazo 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.Destinatario====
{| 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
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|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
|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]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|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.DetalleDeFactura====
{| 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
: Notificación 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
: 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
|-
|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)
: Rechazo 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
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|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
|C/C
|
: 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]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación 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).
: Rechazo 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
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: 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
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|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]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo 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.
: Rechazo 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
: Notificación 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
: Notificación 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
: Notificación 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
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../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)
: Rechazo 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)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación 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
: Notificación 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.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
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[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''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|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
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[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
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''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
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|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
: Notificación 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.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|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|..40</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
: Notificación 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]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====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’
: Rechazo 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)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|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
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|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’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|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
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|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”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''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.''
|}

====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’
: Rechazo 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)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|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 ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|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’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|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
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|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,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: 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’
: Rechazo 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
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@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.EntregaMercancia====
{| 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
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo 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
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| 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
|-
|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
: Rechazo 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
|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]])
|-
|porcentajeTOTALImp
|String
|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
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|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
: Rechazo 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
: Rechazo 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
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====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
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''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
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====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)
: Rechazo 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)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====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
: Rechazo: 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
|
: Código correspondiente al medio de pago
: Rechazo: 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''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: 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.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
: Rechazo 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.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
|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>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: 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.sectorSalud====
{| 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
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|idPersonalizacion
|String
| -
|SI
|
: indica el tipo de operacion para a factura de venta en sector salud.
: '''PATH''': ../cbc:CustomizationID
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| 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
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| 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
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/Interoperabilidad
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| 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
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''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"

====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
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo 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
: Rechazo 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.
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo 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.
: Rechazo 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
: Rechazo 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
: Rechazo: 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
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====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
: Rechazo 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]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|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.
{{clear}}

===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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 [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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.
{{clear}}

===Método EstadoLegalDocumentos===
Permite verificar si el documento indicado tiene validez legal frente al comprador y la autoridad tributaria (DIAN), además concede validar el historial de eventos relacionados con el documento ante la DIAN. Los clientes de ERP que cuenten con el servicio de Recepción podrán consultar el Estado Legal de un documento en particular, a través del nuevo método denominado (EstadoLegalDocumentos).
El cliente debe tener el servicio de recepción electrónica activo y contratado con The Factory HKA Colombia.

'''Nota:''' De momento este método de integración se encuentra en prueba, es importante aclarar que este método posteriormente tendrá un costo, el cual se informará desde el área comercial de The Factory HKA Colombia.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|CUFE
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|SupplierIdentification
|Nit del emisor.
|-
|DocumentoId
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212"
|}

En la siguiente tabla se muestran los estados posibles del documento, se deben pasar los siguientes parámetros de entrada: token de empresa, token password, cufe, nit y número de documento y devuelve como respuesta la siguiente información:

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoLegalDocumentos>

<tem:tokenEmpresa>2afb</tem:tokenEmpresa>

<tem:tokenPassword>a809aee92bd</tem:tokenPassword>

<tem:cufe>794847abf0edfd959b38a2246</tem:cufe>

<tem:supplierIdentification>900390126</tem:supplierIdentification>

<tem:documentId>SETP990183</tem:documentId>
</tem:EstadoLegalDocumentos>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoLegalDocumentosResponse xmlns="http://tempuri.org/">
<EstadoLegalDocumentosResult xmlns:a="http://schemas.datacontract.org/2004/07/ServiceSoap.Models.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:EstadoDocumentoDIANResult>
<a:codigoEstadoFacturaDIAN>200</a:codigoEstadoFacturaDIAN>
<a:DocumentoValidoenDIAN>Valido</a:DocumentoValidoenDIAN>
<a:numeroDocumento>SETP990054183</a:numeroDocumento>
<a:cufeCudeDocumento>794847abf0edfc5f8c432a094648e944bdfce8789e00f31662c76c7037236c52b6c2b515849327a0f082d959b38a2246</a:cufeCudeDocumento>
<a:numeroIdentificacionEmisor>900390126</a:numeroIdentificacionEmisor>
<a:tipoIdentificacionEmisor>31</a:tipoIdentificacionEmisor>
<a:numeroIdentificacionReceptor>900390126</a:numeroIdentificacionReceptor>
<a:TipoIdentificacionReceptor>31</a:TipoIdentificacionReceptor>
</a:EstadoDocumentoDIANResult>
<a:EventosResult xmlns:b="http://schemas.datacontract.org/2004/07/WebApi.Domain.Models">
<b:EventsDocumentResponse>
<b:codigoEvento>030</b:codigoEvento>
<b:descripcionEvento>Acuse de recibo de Factura Electrónica de Venta</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:39Z</b:fechaEvento>
<b:numeroEvento>240122389968251</b:numeroEvento>
<b:cudeEvento>5333a02e2a29cbed56c8989221b4e4712818c4f98dfd7347a61f2cd4619b21d6e7e2169f62f0b15e121a51d40127402e</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>DRodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>032</b:codigoEvento>
<b:descripcionEvento>Recibo del bien y/o prestación del servicio</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:40Z</b:fechaEvento>
<b:numeroEvento>240122429077715</b:numeroEvento>
<b:cudeEvento>d6015b90e7cd86ffe2273ad14095935a61cadaef963ae9bbb3eac9615a4948b03127561c56e8939004bba1699b059c68</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>033</b:codigoEvento>
<b:descripcionEvento>Aceptación expresa</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:41Z</b:fechaEvento>
<b:numeroEvento>240122276806767</b:numeroEvento>
<b:cudeEvento>2da1e89e3f4c7c039b25aaca0f241f1c115dd09556a4226b8e0bf0b7db303a4eac07481a83994ef6d8bad384499a284a</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
</a:EventosResult>
<a:CódigoRespuesta>0</a:CódigoRespuesta>
<a:MensajeRespuesta i:nil="true"/>
<a:ResumenEventosDocumento>
<a:CódigoRespuesta>201</a:CódigoRespuesta>
<a:MensajeRespuesta>Se retorna el ultimo estatus legal de la factura</a:MensajeRespuesta>
<a:CantidadEventos>3</a:CantidadEventos>
<a:EsAceptada>Si</a:EsAceptada>
<a:AceptaciónTácita>No</a:AceptaciónTácita>
<a:EsBienoServicio>Recibido</a:EsBienoServicio>
<a:EsReclamada>No</a:EsReclamada>
<a:EsRecibida>Si</a:EsRecibida>
<a:TieneEventos>Si</a:TieneEventos>
<a:EsTituloValor>No</a:EsTituloValor>
<a:EstaEndosada>No</a:EstaEndosada>
</a:ResumenEventosDocumento>
</EstadoLegalDocumentosResult>
</EstadoLegalDocumentosResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Array <EstadoDocumentoDIANResult>
|EstadoDocumentoDIANResult
|Indica el estatus actual en el que se encuentra actualmente el documento ante la DIAN con los detalles del documento.
|-
|Array <EventosResult>
|EventosResult
|Detalle del documento ante la DIAN, resultado de los eventos obtenidos.
|-
|String
|CodigoRespuesta
|
|-
|String
|MensajeRespuesta
|Mensaje de respuesta del método.
|-
|Array <ResumenEventosDocumento>
|ResumenEventosDocumento
|Resumen a nivel general de los diferentes estatus que tiene el documento.
|}

Donde Class.EstadoDocumentoDIANResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigoEstadoFacturaDIAN
|Indica el estado de la operación retornado por la DIAN.
|-
|String
|DocumentoValidoenDIAN
|Indica validación del documento ante la DIAN.
|-
|String
|numeroDocumento
|Consecutivo del Documento TFHKA/DIAN.
|-
|String
|cufeCudeDocumento
|CUFE del documento electronico
|-
|String
|numeroIdentificacionEmisor
|Número de Identificación del Emisor.
|-
|int
|tipoIdentificacionEmisor
|Indicador del Emisor
|-
|String
|numeroIdentificacionReceptor
|Número de Identificación del Receptor o adquieriente del documento.
|-
|int
|TipoIdentificacionReceptor
|Indicador del Receptor
|}

Y Class.EventosResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Etiqueta
|-
|String
|descripcionEvento
|Descripción del evento actual
|-
|String
|fechaEvento
|fecha de registro del evento
|-
|String
|cudeEvento
| Código Único de Documento Electrónico del evento.
|-
|String
|emisorEvento
|Evento ejecutado por la persona encargada.
|-
|String
|tipoIdentificacionEmisor
|Tipo indentificación del emisor
|-
|String
|numeroIdentificacionEmisor
|Indentificación del emisor
|-
|String
|receptorEvento
|Usuario que recibe los eventos(emisor)
|-
|String
|numeroIdentificacionReceptor
|Indentificación del receptor.
|-
|String
|tipoIdentificacionReceptor
|Tipo indentificación del receptor.
|}

Class.ResumenEventosDocumento corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|CódigoRespuesta
|Código correspondiente al catalogo de la tabla.
|-
|String
|MensajeRespuesta
|Mensaje de satisfacción o error de resumen de eventos del documento.
|-
|String
|CantidadEventos
|Número de eventos que se han dado al documento (1, 2 ó 3)
|-
|String
|EsAceptada
|Si el documento tiene los 3 eventos y tiene una aceptación expresa como evento.(SI/NO)
|-
|String
|AceptaciónTácita
|Si el documento tiene una aceptación tácita como evento realizada por el emisor.(SI/NO)
|-
|String
|EsBienoServicio
|Si el documento tiene un segundo evento DIAN, recibo del bien o prestación del servicio como evento.(SI/NO)
|-
|String
|EsReclamada
|Si el documento tiene un reclamo como evento por parte del receptor.(SI/NO)
|-
|String
|EsRecibida
|Si el documento tiene un acuse de recibo como evento por parte del receptor.(SI/NO)
|-
|String
|TieneEventos
|Si cumple con por lo menos un evento por parte del receptor.(SI/NO)
|-
|String
|EsTituloValor
|El documento cuenta con titulo valor despues de dar los 3 eventos por parte del receptor
|-
|String
|EstaEndosada
|
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|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.
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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).
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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”
|}
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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
|}
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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”
|}
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|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:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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
|}
{{clear}}
===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa

2025-04-21T21:02:44Z

Paguirre: Página creada con «===Método ConsultaAdquiriente=== Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida. ; REQUEST: Parámetros a Enviar {| class="mw-collapsible mw-collapsed wikitable" ! style="backgrou…»

===Método ConsultaAdquiriente===

Se trata de un servicio web que permite completar los datos del adquirente (Nombre o Razón Social y Correo Electrónico) utilizando únicamente el Tipo y Número de identificación. Esto asegura el procesamiento adecuado de la factura electrónica en un punto de venta, incluyendo la información requerida.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|tipoIdentificacion
|Tipo de Identificación del adquiriente
|-
|String
|numeroIdentificacion
|Número de Identificación del adquiriente
|-
|}
; RESPONSE: Parámetros a recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|correoReceptor
|Correo electrónico del adquiriente o comprador
|-
|String
|mensaje
|Mensaje que devuelva la api
|-
|String
|nombreReceptor
|Nombre o razón social del adquiriente o comprador
|-
|String
|resultado
|Resultado de la operación retornada por el servicio
|-
|}

{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente por las siguientes URL´s:

Ambiente DEMO

https://demoemision21v4.thefactoryhka.com.co/ws/consultaAdquiriente/Service.svc?wsdl

<div style="text-align: center;">Ejemplo consumo SOAP</div>

 
[[Archivo:consultaadquiriente.png|800px|sinmarco|center|EjemploconsultaAdquiriente]]

Índice del Manual de Integración Directa

2025-04-21T20:57:17Z

Paguirre:

[[Category:Manuales|I]]
__NOTOC__
[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalidades - Indice Manual Integración Directa|Generalidades]]==<includeonly>=</includeonly>
# [[Generalidades - Indice Manual Integración Directa#Historial|Historial de versiones]]
# [[Generalidades - Indice Manual Integración Directa#Cómo obtener soporte|Cómo obtener soporte]]
# [[Generalidades - Indice Manual Integración Directa#Descripción general|Descripción general]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es The Factory HKA Factura?|¿Qué es The Factory HKA Factura?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es HKA Integración?|¿Qué es HKA Integración?]]
## [[Generalidades - Indice Manual Integración Directa#Funcionalidades|Funcionalidades]]
## [[Generalidades - Indice Manual Integración Directa#La integración directa|La integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Requerimientos técnicos para la integración directa|Requerimientos técnicos para la integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Esquemas de integración directa para Factura Electrónica TFHKA|Esquemas de integración directa para Factura Electrónica TFHKA]]
# [[Generalidades - Indice Manual Integración Directa#Esquema de operación de la factura electrónica con validación previa|Esquema de operación de la factura electrónica con validación previa]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es la Facturación Electrónica con Validación Previa?|¿Qué es la Facturación Electrónica con Validación Previa?]]
## [[Generalidades - Indice Manual Integración Directa#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
## [[Generalidades - Indice Manual Integración Directa#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
## [[Generalidades - Indice Manual Integración Directa#Proceso de la Facturación Electrónica con Validación Previa|Proceso de la Facturación Electrónica con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor|Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor]]
# [[Generalidades - Indice Manual Integración Directa#Web services TFHKA con validación previa|Web services TFHKA con validación previa]]

<includeonly>=</includeonly>==[[Etapas para la implementación de la integración]]==<includeonly>=</includeonly>
# [[Etapas para la implementación de la integración#Etapas y actividades|Etapas y actividades]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web TFHKA- Indice Manual Integración Directa|Métodos Servicio Emisión Web TFHKA]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DetalleDeFactura|Class.DetalleDeFactura]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.EntregaMercancia|Class.EntregaMercancia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoLegalDocumentos|Método EstadoLegalDocumentos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoCertificado|Método EstadoCertificado]]

<includeonly>=</includeonly>==[[Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa|Métodos Servicio datos adquiriente web soap]]==<includeonly>=</includeonly>
#[[Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa#Método “ConsultaAdquiriente”|Método “ConsultaAdquiriente”]]

<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método servicio Eliminar Adjuntos web soap|Método servicio Eliminar Adjuntos web soap]]


# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa|Generación De Notas Con Y Sin Referencia A Documento Electrónico]]==<includeonly>=</includeonly>
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras para manejo de descripción del impuesto ZZ|Uso de campos extras para manejo de descripción del impuesto ZZ]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[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 Directa#Tabla 2|Tabla 2]]
# [[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 Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Índice del Manual de Integración Directa

2025-04-21T20:53:04Z

Paguirre:

[[Category:Manuales|I]]
__NOTOC__
[[File:HKAFactura 3.png|500px|center|HKAFactura]]

<includeonly>=</includeonly>==[[Generalidades - Indice Manual Integración Directa|Generalidades]]==<includeonly>=</includeonly>
# [[Generalidades - Indice Manual Integración Directa#Historial|Historial de versiones]]
# [[Generalidades - Indice Manual Integración Directa#Cómo obtener soporte|Cómo obtener soporte]]
# [[Generalidades - Indice Manual Integración Directa#Descripción general|Descripción general]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es The Factory HKA Factura?|¿Qué es The Factory HKA Factura?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es HKA Integración?|¿Qué es HKA Integración?]]
## [[Generalidades - Indice Manual Integración Directa#Funcionalidades|Funcionalidades]]
## [[Generalidades - Indice Manual Integración Directa#La integración directa|La integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Requerimientos técnicos para la integración directa|Requerimientos técnicos para la integración directa]]
## [[Generalidades - Indice Manual Integración Directa#Esquemas de integración directa para Factura Electrónica TFHKA|Esquemas de integración directa para Factura Electrónica TFHKA]]
# [[Generalidades - Indice Manual Integración Directa#Esquema de operación de la factura electrónica con validación previa|Esquema de operación de la factura electrónica con validación previa]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es la Facturación Electrónica con Validación Previa?|¿Qué es la Facturación Electrónica con Validación Previa?]]
## [[Generalidades - Indice Manual Integración Directa#¿Quiénes participan en este esquema?|¿Quiénes participan en este esquema?]]
## [[Generalidades - Indice Manual Integración Directa#Ventajas de la Facturación Electrónica|Ventajas de la Facturación Electrónica]]
## [[Generalidades - Indice Manual Integración Directa#Proceso de la Facturación Electrónica con Validación Previa|Proceso de la Facturación Electrónica con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Características del proceso con Validación Previa|Características del proceso con Validación Previa]]
# [[Generalidades - Indice Manual Integración Directa#Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor|Seguridad de la información: recomendaciones en la implementación de la factura electrónica dentro de la red y sistemas del emisor]]
# [[Generalidades - Indice Manual Integración Directa#Web services TFHKA con validación previa|Web services TFHKA con validación previa]]

<includeonly>=</includeonly>==[[Etapas para la implementación de la integración]]==<includeonly>=</includeonly>
# [[Etapas para la implementación de la integración#Etapas y actividades|Etapas y actividades]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web TFHKA- Indice Manual Integración Directa|Métodos Servicio Emisión Web TFHKA]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DetalleDeFactura|Class.DetalleDeFactura]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.EntregaMercancia|Class.EntregaMercancia]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.sectorSalud|Class.sectorSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Beneficiario|Class.Beneficiario]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.DatosPacientesSalud|Class.DatosPacientesSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.GeneralSalud|Class.GeneralSalud]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoLegalDocumentos|Método EstadoLegalDocumentos]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
# [[Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa#Método EstadoCertificado|Método EstadoCertificado]]

<includeonly>=</includeonly>==[[Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa|Métodos Servicio datos adquiriente web soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio datos adquiriente web soap - Indice Manual Integración Directa#Método ConsultaAdquiriente|Método ConsultaAdquiriente]]

<includeonly>=</includeonly>==[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa|Métodos servicio adjuntos web soap]]==<includeonly>=</includeonly>
#[[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método “CargarAdjuntos”|Método “CargarAdjuntos”]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA|ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)|Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica personalizada por TFHKA|Representación gráfica personalizada por TFHKA]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)|Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)]]
# [[Métodos servicio adjuntos web soap - Indice Manual Integración Directa#Método servicio Eliminar Adjuntos web soap|Método servicio Eliminar Adjuntos web soap]]


# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “DescargarReporte”|Método “DescargarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “ProgramarReporte”|Método “ProgramarReporte”]]
# [[Métodos servicio reportes web soap - Indice Manual Integración Directa#Método “SolicitudReporteSincrono”|Método “SolicitudReporteSincrono”]]
<includeonly>=</includeonly>==[[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa|Generación De Notas Con Y Sin Referencia A Documento Electrónico]]==<includeonly>=</includeonly>
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas de validación previa|Notas de crédito y débito que afecten a facturas de validación previa]]
# [[Generación De Notas Con Y Sin Referencia A Documento Electrónico - Indice Manual Integración Directa#Notas de crédito y débito que no afecten a facturas|Notas de crédito y débito que no afecten a facturas]]
<includeonly>=</includeonly>==[[Caracteristicas adicionales - Indice Manual Integración Directa|Caracteristicas adicionales]]==<includeonly>=</includeonly>
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras|Uso de campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Uso de campos extras para manejo de descripción del impuesto ZZ|Uso de campos extras para manejo de descripción del impuesto ZZ]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Tabla de códigos para campos extras|Tabla de códigos para campos extras]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Correo electrónico personalizado|Correo electrónico personalizado]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)|TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Radicar documentos electrónicos en plataformas de recepción|Radicar documentos electrónicos en plataformas de recepción]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Estándar del nombre de los documentos electrónicos XML|Estándar del nombre de los documentos electrónicos XML]]
# [[Caracteristicas adicionales - Indice Manual Integración Directa#Ambiente de habilitación|Ambiente de habilitación]]
<includeonly>=</includeonly>==[[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa|Tablas de códigos de propiedades para emisión de documentos]]==<includeonly>=</includeonly>
# [[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 Directa#Tabla 2|Tabla 2]]
# [[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 Directa#Tabla 4|Tabla 4]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 6|Tabla 6]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 7|Tabla 7]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 9|Tabla 9]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 10|Tabla 10]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 11|Tabla 11]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 12|Tabla 12]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 13|Tabla 13]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 14|Tabla 14]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 15|Tabla 15]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 16|Tabla 16]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 17|Tabla 17]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 18|Tabla 18]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 19|Tabla 19]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 20|Tabla 20]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 22|Tabla 22]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 23|Tabla 23]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 24|Tabla 24]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 25|Tabla 25]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 26|Tabla 26]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
# [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

<includeonly>=</includeonly>==[[Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa|Catálogo de errores de respuesta del servicio web]]==<includeonly>=</includeonly>

 
 
 
 

<center>'''<big>[[Archivo:Copyright.png|100px|sinmarco|centro|Copyright]]THE FACTORY HKA COLOMBIA</big>
 Copyright © 2016 The Factory HKA. Todos los derechos reservados.</center>

 

{{clear}}

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-03-21T16:25:10Z

Paguirre: /* Método Enviar */

Métodos servicio adjuntos web soap - Indice Manual Integración Directa

2025-03-21T16:24:26Z

Paguirre: /* Método “CargarAdjuntos” */

<includeonly>=</includeonly>==Métodos servicio adjuntos web soap==<includeonly>=</includeonly>
El Servicio Adjuntos Web SOAP, expone un único método que se utilizará n veces por documento electrónico generado, donde n es la cantidad de archivos adjuntos que tenga la factura electrónica que se está procesando (tener en cuenta que al ser un correo en donde se envía la factura con su representación gráfica y los adjuntos, entonces existe un límite de adjuntos basándose en el peso (en KB) de los mismos).

=== Método “CargarAdjuntos” ===
Permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método '''Enviar''' con el parámetro adjuntos en “1” o en “11”. A continuación, se presenta el flujo del método:
 
 

[[Archivo:DiagramadeEnviódeadjuntos.png|800px|center|Diagrama de Envío de adjuntos]]
 

@IMPORTANTE: El método '''CargarAdjuntos''' recibe entre sus parámetros un campo para indicar el envío del correo, es decir, si el campo o propiedad '''enviar''' recibe un “0” entonces el documento sigue a la espera por más adjuntos y si recibe “1” se realiza el envío con los adjuntos que se hayan cargado hasta ese momento.

<pre style="color: red">ADVERTENCIA: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvío de correo.</pre>

 
 
 

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Adjunto
|Adjunto
|Datos de control del documento que se desea adjuntar
|}
Donde Class.Adjunto contiene la siguiente información:
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|byte[]
|Archivo
|Arreglo de bytes del archivo que se desea adjuntar
|-
|Array <string>
|email
|Correo al cual se desea enviar el XML (AttachedDocument) con todos los adjuntos cargados hasta el momento (se activa envío cuando enviar es “1”)
|-
|String
|Enviar
|
: "0" Adjunta archivo y lo asocia al documento electrónico sin enviar el email al Adquiriente
: "1" Adjunta archivo al documento electrónico y envía email de manera inmediata al Adquiriente
|-
|String
|Formato
|Extensión del archivo adjunto, formatos permitidos:
: (png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx,rar)
|-
|String
|Nombre
|Nombre que tomará el archivo adjunto
|-
|String
|numeroDocumento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|String
|Tipo
| 1: Representación gráfica generada por el ERP 2: Tipo de documento anexo o adjuntos
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Mensaje
|Este mensaje de identificación de errores
|-
|Array <String>
|mensajesValidacion
|Mensajes de validación en caso de rechazo
|-
|String
|resultado
|Resultado
|}
{{clear}}

==='''ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA'''===

===Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)===

Bajo este escenario, el emisor de documentos electrónicos cuenta con la representación gráfica estándar generada por TFHKA, la cual será entregada al adquiriente en el correo de notificación del documento electrónico.
Durante la emisión del documento, pueden incluirse en la representación gráfica estándar campos extras reservados por TFHKA, los cuales incluirán etiquetas predeterminadas en la misma con el fin de brindarle al lector de la representación, claridad sobre los montos e información
reportada. A continuación se detallan los campos extras reservados por TFHKA en la representación gráfica estándar:

{| class="wikitable" style="width: 100%;"
|+
|- valign="center"
|-style="text-align:center;"
|colspan="2"|CAMPOS EXTENSIBLES RESERVADOS POR TFHKA
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Etiqueta PDF
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Etiqueta PDF
! style="color:white;background:#2F5496; text-align:center;"|Observaciones
|- valign="center"
|122333
|Aceptación Física
|Aceptación Física
|AN|100
|
|-
|100200
|Pie de página
|Pie de página
|AN|100
|
|-
|5170000
|Total Base Excluida
|Total Base Excluida
|Formato Libre
|Para totales el R.G
|-
|5170001
|TOTAL Descuento Detalle
|TOTAL Descuento Detalle
|Formato Libre
|Para totales el R.G
|-
|5170002
|TOTAL Retenciones
|TOTAL Retenciones
|Formato Libre
|Para totales el R.G
|-
|5170003
|TOTAL a Pagar
|TOTAL a Pagar
|Formato Libre
|Para totales el R.G
|-
|5170004
|TOTAL A PAGAR en Letras
|TOTAL A PAGAR en Letras
|Formato Libre
|Para totales el R.G
|}
|}
[[Archivo:CamposExtrasReservados.png|centro|CamposExtrasReservados]]
[[Archivo:EtiquetasRG.png|centro|EtiquetasRG]]

===Representación gráfica personalizada por TFHKA===

Para el caso en que el emisor contrate un servicio de representación gráfica con TFHKA, se debe tener en cuenta que el mismo es un proyecto de desarrollo el cual conlleva tiempos y costos asociados.
Adicional al tiempo asociado al desarrollo del template personalizado por parte TFHKA, se debe tener en cuenta la adaptación del desarrollo en el sistema contable, el cual debe ser realizado por la casa de software o desarrollador del mismo, con el fin de reportar los campos extras en los cuales se reflejará la información que se desea visualizar.

Los campos extras mencionados anteriormente son suministrados por el equipo de representaciones gráficas de TFHKA, una vez se cuente con una versión aprobada por el contribuyente para su uso.

'''@IMPORTANTE:'''Como se observa, este escenario involucra desarrollo de ambas partes (ERP y TFHKA), por lo tanto antes de contratar este servicio se deben dimensionar el alcance y costos de personalización.

===Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)===

Para el caso en que el emisor contrate un servicio de representación gráfica con la casa de software, desarrollador o encargado de realizar los ajustes correspondientes en el software contable o ERP para la emisión de documentos electrónicos, se deben tener en cuenta los siguientes aspectos:
* The Factory HKA es responsable de la generación del UBL y su transmisión a la DIAN.
* Una vez se compruebe la correcta validación y generación del UBL la casa de software puede proceder a generar una representación gráfica que debe cumplir con:
* Los elementos de ley exigidos por la DIAN: inclusión del código QR y de la cadena del CUFE ó CUDE en los documentos, según corresponda.
* Los elementos de ley exigidos por cualquier entidad supervisora al emisor de los documentos.
* Los elementos visuales y de representación de marca exigidos por el propio cliente: logos, información bancaria, leyendas referentes a las responsabilidades tributarias del emisor, etc.
* La Casa de Software, en este escenario, asume la responsabilidad junto con el propio contribuyente de cualquier incidente de fraude por evasión, malinterpretación, error u omisión de información relevante y obligatoria por parte de la normativa.
* TFHKA no resguarda esta representación en sus sistemas y deja claro que su participación como proveedor tecnológico se limita a la generación del UBL y su validación ante la DIAN.

'''Durante la sincronización de los archivos adjuntos se deben tener en cuenta los siguientes aspectos:'''

* Los archivos a sincronizar deben ser codificados en Base64.
* Se recomienda indicar como correos de destinatarios los emails reportados en el array Class.Destinatario.email[]
* Los nombres de los archivos adjuntos a sincronizar deben ser diferentes.
* Solo se admite la sincronización de un (1) archivo con el parámetro tipo = ‘1’, correspondiente a la representación gráfica del documento electrónico.
* Para los adjuntos comunes a sincronizar, los cuales no corresponden a la representación gráfica del documento, se deberá indicar el parámetro tipo del método CargarAdjuntos en ‘2’, correspondiente a Anexos o adjuntos comunes.
* Todos los adjuntos a ser sincronizados no deben superar el peso de 1.8 MB, esto con el fin de dar cumplimiento a lo establecido en el Anexo Técnico de la DIAN con respecto al peso máximo de 2MB del archivo .ZIP entregado en la notificación de correo electrónico.

<includeonly>=</includeonly>==Método servicio Eliminar Adjuntos web soap==<includeonly>=</includeonly>
Permite eliminar los archivos adjuntos(anexos) a la factura electrónica, cuando el parámetro adjuntos del método enviar se encuentra en “1” u “11. Este método se ejecuta después de consumir el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP)'''. Cada vez que se consuma este método se eliminaran los últimos adjuntos anexados a la factura enviada.
 
 
'''@IMPORTANTE:''' El consumo de este método esta contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips_Urls_de_Emisión| Tips Urls de Emisión]]'''
{{clear}}

 
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|String
|numeroDocumento
|Numero o consecutivo del documento al cual se desea eliminar los adjuntos enviados
|}
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Mensaje
|Este mensaje de identificación de errores o estado de la transaccion realizada
|-
|Array <String>
|mensajesValidacion
|Mensajes de validación en caso de rechazo o aceptacion de borrado del ultimo adjunto
|-
|String
|resultado
|Resultado
|}
{{clear}}

Métodos servicio adjuntos web soap - Indice Manual Integración Directa

2025-03-21T16:23:43Z

Paguirre: /* Método “CargarAdjuntos” */

<includeonly>=</includeonly>==Métodos servicio adjuntos web soap==<includeonly>=</includeonly>
El Servicio Adjuntos Web SOAP, expone un único método que se utilizará n veces por documento electrónico generado, donde n es la cantidad de archivos adjuntos que tenga la factura electrónica que se está procesando (tener en cuenta que al ser un correo en donde se envía la factura con su representación gráfica y los adjuntos, entonces existe un límite de adjuntos basándose en el peso (en KB) de los mismos).

=== Método “CargarAdjuntos” ===
Permite adjuntar o enviar archivos (anexos) por email durante la emisión del documento electrónico. Este método se ejecuta después de consumir el método '''Enviar''' con el parámetro adjuntos en “1” o en “11”. A continuación, se presenta el flujo del método:
 
 

[[Archivo:DiagramadeEnviódeadjuntos.png|800px|center|Diagrama de Envío de adjuntos]]
 

@IMPORTANTE: El método '''CargarAdjuntos''' recibe entre sus parámetros un campo para indicar el envío del correo, es decir, si el campo o propiedad '''enviar''' recibe un “0” entonces el documento sigue a la espera por más adjuntos y si recibe “1” se realiza el envío con los adjuntos que se hayan cargado hasta ese momento.

<pre style="color: red">ADVERTENCIA: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvió de correo.</pre>

 
 
 

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|Adjunto
|Adjunto
|Datos de control del documento que se desea adjuntar
|}
Donde Class.Adjunto contiene la siguiente información:
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|byte[]
|Archivo
|Arreglo de bytes del archivo que se desea adjuntar
|-
|Array <string>
|email
|Correo al cual se desea enviar el XML (AttachedDocument) con todos los adjuntos cargados hasta el momento (se activa envío cuando enviar es “1”)
|-
|String
|Enviar
|
: "0" Adjunta archivo y lo asocia al documento electrónico sin enviar el email al Adquiriente
: "1" Adjunta archivo al documento electrónico y envía email de manera inmediata al Adquiriente
|-
|String
|Formato
|Extensión del archivo adjunto, formatos permitidos:
: (png, bmp, jpg, pdf, doc, docx, xls, xlsx, ppt, pptx,rar)
|-
|String
|Nombre
|Nombre que tomará el archivo adjunto
|-
|String
|numeroDocumento
|Prefijo y consecutivo del Documento Electrónico concatenado sin separadores. Ejemplo “PRUE980338212”
|-
|String
|Tipo
| 1: Representación gráfica generada por el ERP 2: Tipo de documento anexo o adjuntos
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Mensaje
|Este mensaje de identificación de errores
|-
|Array <String>
|mensajesValidacion
|Mensajes de validación en caso de rechazo
|-
|String
|resultado
|Resultado
|}
{{clear}}

==='''ESCENARIOS EMISIÓN DE DOCUMENTOS CON REPRESENTACIÓN GRÁFICA'''===

===Representación gráfica estándar (Uso del parámetro adjuntos del método Enviar en ‘0’ o ‘1’)===

Bajo este escenario, el emisor de documentos electrónicos cuenta con la representación gráfica estándar generada por TFHKA, la cual será entregada al adquiriente en el correo de notificación del documento electrónico.
Durante la emisión del documento, pueden incluirse en la representación gráfica estándar campos extras reservados por TFHKA, los cuales incluirán etiquetas predeterminadas en la misma con el fin de brindarle al lector de la representación, claridad sobre los montos e información
reportada. A continuación se detallan los campos extras reservados por TFHKA en la representación gráfica estándar:

{| class="wikitable" style="width: 100%;"
|+
|- valign="center"
|-style="text-align:center;"
|colspan="2"|CAMPOS EXTENSIBLES RESERVADOS POR TFHKA
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Etiqueta PDF
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Etiqueta PDF
! style="color:white;background:#2F5496; text-align:center;"|Observaciones
|- valign="center"
|122333
|Aceptación Física
|Aceptación Física
|AN|100
|
|-
|100200
|Pie de página
|Pie de página
|AN|100
|
|-
|5170000
|Total Base Excluida
|Total Base Excluida
|Formato Libre
|Para totales el R.G
|-
|5170001
|TOTAL Descuento Detalle
|TOTAL Descuento Detalle
|Formato Libre
|Para totales el R.G
|-
|5170002
|TOTAL Retenciones
|TOTAL Retenciones
|Formato Libre
|Para totales el R.G
|-
|5170003
|TOTAL a Pagar
|TOTAL a Pagar
|Formato Libre
|Para totales el R.G
|-
|5170004
|TOTAL A PAGAR en Letras
|TOTAL A PAGAR en Letras
|Formato Libre
|Para totales el R.G
|}
|}
[[Archivo:CamposExtrasReservados.png|centro|CamposExtrasReservados]]
[[Archivo:EtiquetasRG.png|centro|EtiquetasRG]]

===Representación gráfica personalizada por TFHKA===

Para el caso en que el emisor contrate un servicio de representación gráfica con TFHKA, se debe tener en cuenta que el mismo es un proyecto de desarrollo el cual conlleva tiempos y costos asociados.
Adicional al tiempo asociado al desarrollo del template personalizado por parte TFHKA, se debe tener en cuenta la adaptación del desarrollo en el sistema contable, el cual debe ser realizado por la casa de software o desarrollador del mismo, con el fin de reportar los campos extras en los cuales se reflejará la información que se desea visualizar.

Los campos extras mencionados anteriormente son suministrados por el equipo de representaciones gráficas de TFHKA, una vez se cuente con una versión aprobada por el contribuyente para su uso.

'''@IMPORTANTE:'''Como se observa, este escenario involucra desarrollo de ambas partes (ERP y TFHKA), por lo tanto antes de contratar este servicio se deben dimensionar el alcance y costos de personalización.

===Representación gráfica enviada como adjunto desde el sistema administrativo o ERP (Uso del parámetro adjuntos del método Enviar en ‘11’)===

Para el caso en que el emisor contrate un servicio de representación gráfica con la casa de software, desarrollador o encargado de realizar los ajustes correspondientes en el software contable o ERP para la emisión de documentos electrónicos, se deben tener en cuenta los siguientes aspectos:
* The Factory HKA es responsable de la generación del UBL y su transmisión a la DIAN.
* Una vez se compruebe la correcta validación y generación del UBL la casa de software puede proceder a generar una representación gráfica que debe cumplir con:
* Los elementos de ley exigidos por la DIAN: inclusión del código QR y de la cadena del CUFE ó CUDE en los documentos, según corresponda.
* Los elementos de ley exigidos por cualquier entidad supervisora al emisor de los documentos.
* Los elementos visuales y de representación de marca exigidos por el propio cliente: logos, información bancaria, leyendas referentes a las responsabilidades tributarias del emisor, etc.
* La Casa de Software, en este escenario, asume la responsabilidad junto con el propio contribuyente de cualquier incidente de fraude por evasión, malinterpretación, error u omisión de información relevante y obligatoria por parte de la normativa.
* TFHKA no resguarda esta representación en sus sistemas y deja claro que su participación como proveedor tecnológico se limita a la generación del UBL y su validación ante la DIAN.

'''Durante la sincronización de los archivos adjuntos se deben tener en cuenta los siguientes aspectos:'''

* Los archivos a sincronizar deben ser codificados en Base64.
* Se recomienda indicar como correos de destinatarios los emails reportados en el array Class.Destinatario.email[]
* Los nombres de los archivos adjuntos a sincronizar deben ser diferentes.
* Solo se admite la sincronización de un (1) archivo con el parámetro tipo = ‘1’, correspondiente a la representación gráfica del documento electrónico.
* Para los adjuntos comunes a sincronizar, los cuales no corresponden a la representación gráfica del documento, se deberá indicar el parámetro tipo del método CargarAdjuntos en ‘2’, correspondiente a Anexos o adjuntos comunes.
* Todos los adjuntos a ser sincronizados no deben superar el peso de 1.8 MB, esto con el fin de dar cumplimiento a lo establecido en el Anexo Técnico de la DIAN con respecto al peso máximo de 2MB del archivo .ZIP entregado en la notificación de correo electrónico.

<includeonly>=</includeonly>==Método servicio Eliminar Adjuntos web soap==<includeonly>=</includeonly>
Permite eliminar los archivos adjuntos(anexos) a la factura electrónica, cuando el parámetro adjuntos del método enviar se encuentra en “1” u “11. Este método se ejecuta después de consumir el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP)'''. Cada vez que se consuma este método se eliminaran los últimos adjuntos anexados a la factura enviada.
 
 
'''@IMPORTANTE:''' El consumo de este método esta contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips_Urls_de_Emisión| Tips Urls de Emisión]]'''
{{clear}}

 
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|String
|numeroDocumento
|Numero o consecutivo del documento al cual se desea eliminar los adjuntos enviados
|}
 
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|Código
|Indica el Estado de la operación retornado por el servicio
|-
|String
|Mensaje
|Este mensaje de identificación de errores o estado de la transaccion realizada
|-
|Array <String>
|mensajesValidacion
|Mensajes de validación en caso de rechazo o aceptacion de borrado del ultimo adjunto
|-
|String
|resultado
|Resultado
|}
{{clear}}

Métodos Servicio Emisión Web TFHKA - Indice Manual Integración Directa

2025-03-21T16:20:28Z

Paguirre: /* Método Enviar */

===Método Enviar===
La función encargada de construir y enviar los documentos electrónicos al proveedor tecnológico.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por el proveedor tecnológico
|-
|tokenPassword
|-
|FacturaGeneral
|factura
|Ver el detalle del Objeto Factura más abajo
|-
|String
|adjuntos
|
Posibles valores:
: “0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
: “10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA
|}

'''@IMPORTANTE:''' En caso de enviarse en el parámetro '''adjuntos''' el valor “1” u “11”, no se enviará correo electrónico hasta que se consuma el método '''CargarAdjuntos''' (Servicio Adjuntos Web SOAP). Para documentos que admiten adjuntos el campo '''Destinatario.email''' del cliente es requerido y el campo '''notificar''' debe estar en “SI”.

'''<pre>PRECAUCIÓN: Tenga en cuenta que si no se completa la carga de adjuntos durante los próximos 5 días luego de que el documento se encuentre validado por la DIAN, al momento de gestionar la carga de adjuntos no se realizará entrega del documento, por lo que la entrega al adquiriente deberá realizarse a través de un reenvió de correo.</pre>'''

<pre style="color: red">ADVERTENCIA: Si se utiliza las opciones ‘10’ u ‘11’ en el parámetro adjuntos, nuestra plataforma no generará representación gráfica (PDF) estándar, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal web, en el correo de notificación hacia el adquiriente (sección visualizar documento), tampoco realizar la descarga a través del método DescargaPDF del Servicio Emisión Web SOAP o reenviar la representación gráfica a través del método EnvioCorreo, ya que se está asumiendo que la misma ha sido generada de manera local por el software de facturación (ERP).</pre>

A continuación, se expone el diagrama del '''objeto factura para el modelo de facturación con validación previa''', donde se pueden apreciar los cambios en la estructura del mismo con respecto al objeto utilizado en el modelo con validación posterior:

* En Azul clases/atributos nuevos que no estaban presentes en el modelo de validación posterior.
* En Amarillo clases/atributos existentes en el modelo de validación posterior que sufrieron cambios en validación previa.
* En Naranja clases/atributos existentes en el modelo de validación posterior que están en desuso (eliminados) en validación previa.
 

A continuación se describen con mayor detalle el objeto factura para el modelo de facturación con validación previa:
 

<center>'''Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Anticipos, Class.Autorizado y Class.CargosDescuentos]]
 
'''Diagrama Class.FacturaGeneral con Class.Cliente'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Cliente.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Cliente]]
 
'''Diagrama Class.FacturaGeneral con Class.CondicionPago'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.CondicionPago.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.CondicionPago]]
 
'''Diagrama Class.FacturaGeneral con Class.FacturaDetalle'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.FacturaDetalle.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.FacturaDetalle]]
 
'''Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.DocumentoReferenciado]]
 
'''Diagrama Class.FacturaGeneral Class.EntregaMercancia'''
[[Archivo:Diagrama Class.FacturaGeneral Class. EntregaMercancia.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral Class.EntregaMercancia]]
 
'''Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.Extras. Class.FacturaImpuestos, Class.ImpuestosTotales, Class.MediosDePago, Class.OrdenDeCompra y Array - informacionAdicional]]
 
'''Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega'''
[[Archivo:Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega.png|800px|sinmarco|centro|Diagrama Class.FacturaGeneral con Class.TasaDeCambio, Class.TasaDeCambioAlternativa y Class.TerminosEntrega]]
</center>
{{clear}}

====Class.FacturaGeneral====
{| 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
|-
|anticipos
|Array <Anticipos>
| -
|NO
|
: Informaciones relacionadas con anticipos
: '''PATH''': /root/cac:PrepaidPayment
: (ver detalle en [[#Class.Anticipos|Class.Anticipos]])
|-
|autorizado
|Autorizado
| -
|NO
|
: Informaciones de la persona autorizada para descargar documentos
: '''PATH''': /root/cac:TaxRepresentativeParty
: (ver detalle en [[#Class.Autorizado|Class.Autorizado]])
|-
|cantidadDecimales
|String
| <nowiki>N|1</nowiki>
|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|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|Class.Cliente]])
|-
|condicionPago
|Array <CondicionPago>
| -
|NO
|
: Información relacionada con la condición de pago
: '''PATH''': /root/cac:PaymentTerms
: (ver detalle en [[#Class.CondicionPago|Class.CondicionPago]])
|-
|consecutivoDocumento
|String
| AN..14
|SI
|
: Correlativo/consecutivo del documento electrónico
: Concatenación del prefijo (<nowiki>AN|..4</nowiki>) + 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|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|Class.DocumentoReferenciado]])
|-
|entregaMercancia
|Entrega
| -
|NO
|
: Información de entrega (Delivery) de bienes
: '''PATH''': /root/cac:Delivery
: (ver detalle en [[#Class.Entrega|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|Class.Extras]])
|-
|fechaEmision
|String
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|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
| <nowiki>AN|19</nowiki>
|NO
|
: Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': root/cbc:TaxPointDate
|-
|fechaVencimiento
|String
| <nowiki>AN|10</nowiki>
|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|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|Class.ImpuestosTotales]])
|-
|informacionAdicional
|Array <String>
| <nowiki>AN|...10000</nowiki>
|NO
|
: Información adicional o texto libre relativo al documento
: '''PATH''': root/cbc:Note
|-
|mediosDePago
|Array <MediosDePago>
| -
|SI
|
: Información relacionada con el pago de la factura
: '''PATH''': /root/cac:PaymentMeans
: (ver detalle en [[#Class.MediosDePago|Class.MediosDePago]])
|-
|moneda
|String
| <nowiki>AN|3</nowiki>
|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
|-
|ordenDeCompra
|Array <OrdenDeCompra>
| -
|NO
|
: Información relacionada a la orden de compra
: '''PATH''': /root/cac:OrderReference
: (ver detalle en [[#Class.OrdenDeCompra|Class.OrdenDeCompra]])
|-
|rangoNumeracion
|String
| <nowiki>AN|20</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
|-
|sectorSalud
|sectorSalud
| -
|C/C
|
: Información relacionada con emisiones del Sector Salud '''Obligatorio: Cuando se informa tipoSector = ‘2’'''
: (ver detalle en [[#Class.sectorSalud|Class.sectorSalud]])
|-
|tasaDeCambio
|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|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|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|Class.TerminosEntrega]])
|-
|tipoDocumento
|String
| <nowiki>AN|2</nowiki>
|SI
|
: Tipo de documento
: '''PATH''': Invoice, CreditNote, DebitNote
: Rechazo 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 1|Tabla 1]]
|-
|tipoSector
|String
| <nowiki>N||</nowiki>
|SI
|
: Para emisión de documentos del Sector Salud indicar el código ‘2’ en este campo
: '''PATH''': Invoice, CreditNote, DebitNote
|-
|tipoOperacion
|String
| <nowiki>AN|..4</nowiki>
|SI
|
: Indicador del tipo de operación
: Rechazo 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 2|Tabla 2]]
: '''PATH''': /root/cbc:CustomizationID
|-
|totalAnticipos
|String
| Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
| <nowiki>AN|..5</nowiki>
|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: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|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
|}

====Class.Anticipos====
{| 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]])
|-
|fechaDeRecibido
|String
| <nowiki>AN|10</nowiki>
|SI
|
: Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
: PATH: …/cbc:ReceivedDate
|-
|fechadePago
|String
| <nowiki>AN|10</nowiki>
|NO
|
: Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
: '''PATH''': …/cbc:PaidDate
|-
|horaDePago
|String
| <nowiki>AN|8</nowiki>
|NO
|
: Hora en la cual el pago fue realizado, en formato:HH:MM:SS
: '''PATH''': …/cbc:PaidTime
|-
|id
|String
|<nowiki>A|..150</nowiki>
|SI
|
: Identificación interno del pago
: '''PATH''': …/cbc:ID
|-
|instrucciones
|String
| <nowiki>AN|15..500</nowiki>
|SI
|
: Instrucciones relativas al pago
: '''PATH''': …/cbc:InstructionID
|-
|montoPagado
|String
|Ent: <nowiki>N|..15 </nowiki>
Dec: <nowiki>N|0..6 </nowiki>
|SI
|
: Valor del pago anticipado, no puede ser superior al valor total de la factura
: Notificación Si montoPagado > totalMonto
: '''PATH''': …/cbc:PaidAmount
|}

====Class.Autorizado====
{| 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
|-
|direccion
|Direccion
| -
|NO
|
: Dirección
: '''PATH''': ../cac:PhysicalLocation/cac:Address
|-
|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]])
|-
|nombreComercial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre Comercial
: '''PATH''': ../cac:PartyName/cbc:Name
|-
|nombreContacto
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nombre de Contacto
: '''PATH''': ../cac:Contact/cbc:Name
|-
|nota
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Nota
: '''PATH''': ../cac:Contact/cbc:Note
|-
|numeroDocumento
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Numero de Identificación
: '''PATH''': ../cac:PartyIdentification/cbc:ID
|-
|numeroDocumentoDV
|String
|<nowiki>AN|..2 </nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion es “31”
: '''PATH''': ../cac:PartyIdentification/cbc:ID@schemeID
|-
|razonSocial
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Razón Social
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|telefax
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Telefax
: '''PATH''': ../cac:Contact/cbc:Telefax
|-
|telefono
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Teléfono
: '''PATH''': ../cac:Contact/cbc:Telephone
|-
|tipoIdentificacion
|String
|<nowiki>AN|..2 </nowiki>
|SI
|
: Tipo de Identificación
: '''PATH''': /cac:PartyIdentification/cbc:ID@schemeName
: Ver lista de valores posibles en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}

====Class.CargosDescuentos====
{| 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
|-
|codigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Código para categorizar el descuento
: '''Obligatorio''': Si es descuento a nivel de factura (general)
: Rechazo Si es descuento y no se informa algunos de los valores en la [[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
: Notificación : Si se informa un cargo o descuento y no se informa este elemento
|-
|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]])
|-
|indicador
|String
|<nowiki>N|1</nowiki>
|SI
|
: Indicador de si es Cargo”1” o Descuento “0”
: Rechazo : Si este elemento contiene una información diferente de “1” o “0”
: '''PATH''': …/cbc:ChargeIndicator
|-
|monto
|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
: Rechazo : 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,
: Rechazo: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
: Rechazo: Si montoBase > totalMonto
: '''PATH''': …/cbc:BaseAmount
|-
|porcentaje
|String
|Ent: <nowiki>N|..6</nowiki>
Dec: <nowiki>N|2</nowiki>
|SI
|
: Porcentaje del descuento
: Rechazo 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
|<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
|
: Detalles tributarios del adquirente
: Rechazo Si la clase no es informada
: '''PATH''': /cac:Party/cac:PartyTaxScheme/cac:TaxScheme
: (ver detalle en [[#Class.Tributos|Class.Tributos]])
|-
|direccionCliente
|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
: Notificación 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
|<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
: Notificación : 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
: Rechazo Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
: Rechazo : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
: Nota : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|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
|
: Obligaciones y régimen del adquiriente
: Rechazo Si la clase no es informada
: '''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
: Rechazo 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]]
: Nota: 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
: Rechazo 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="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
|-
|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.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
: Rechazo 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
: Rechazo 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.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
: Rechazo 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.Destinatario====
{| 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
|-
|canalDeEntrega
|String
| -
|SI
|
: Medio de Entrega del Documento Electrónico
: Puede tomar los siguientes valores: 0– Email; 1– Recepción; 2– Interoperabilidad; 3– Whatsapp; 4– Telegram
: PATH: No aplica
|-
|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
|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]])
|-
|fechaProgramada
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha programada
: '''PATH''': No aplica
|-
|mensajeProgramado
|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.DetalleDeFactura====
{| 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
: Notificación 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
: 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
|-
|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)
: Rechazo 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
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar Reportar el Servicio recibido.'''
: '''PATH''': ../Item/cbc:Description[1]
|-
|descripcion2
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: Descripción del producto o servicio
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta la fecha de compra en un formato año-mes-día.'''
: '''PATH''': ../Item/cbc:Description[2]
|-
|descripcion3
|String
|<nowiki>AN|..300</nowiki>
|C/C
|
: '''Para Documento Soporte en adquisiciones a No Obligados a Facturar se Reporta (1) Si es por operación (2) Si es un acumulado semanal.'''
: '''PATH''': ../Item/cbc:Description[3]
|-
|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
|C/C
|
: 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]]
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: Notificación Si es factura de exportación (tipoDocumento = 02), y no se informó la sub partida arancelaria
: Notificación Si el código no existe en un estándar cerrado.
: Ejemplo: UNSPSC
: Notificación 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).
: Rechazo 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
|C/C
|
: Código del producto según el estándar informado en estandarCodigo
: '''Obligatorio''' Para documento soporte y nota de ajuste.
: 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
| -
|NO
|
: Estándar de la organización
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cac:IssuerParty/cac:PartyName/cbc:Name
|-
|estandarSubCodigoProducto
|String
| -
|NO
|
: Sub código del estándar del producto
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ExtendedID
|-
|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]])
|-
|impuestosDetalles
|Array <FacturaImpuestos >
| -
|SI
|
: Información de impuestos
: Rechazo 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.
: Rechazo 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
: Notificación 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
: Notificación 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
: Notificación 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
: Rechazo Si se informa el atributo precioReferencia entonces el valor de precioTotalSinImpuestos debe ser (0.00), ya que se trata de muestra o regalo comercial
: '''PATH''': ../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)
: Rechazo 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)
: Notificación Si contiene un valor ya utilizado en el atributo secuencia en otro grupo de este archivo
: Notificación 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
: Notificación 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.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
|
: Ciudad
: Rechazo Si país es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna ‘Nombre’ de la [[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''': ../cac:Address/cbc:CityName
|-
|codigoDepartamento
|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
: Rechazo Si el código del campo pais es “CO” y el contenido de este atributo no corresponde a uno de los valores de la columna Nombre de la [[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
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|habitacion
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Habitación
: '''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
: Notificación Si el contenido de este atributo no corresponde a uno de los valores del estándar ISO 639-1
: Notificación Si este es un grupo con informaciones con respeto a la dirección del emisor de un documento electrónico, debe contener el literal “es”
: '''PATH''': /cac:Address/cac:Country/cbc:Name/@languageID
|-
|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
: Notificación 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.
: Rechazo Si el contenido de este elemento no corresponde a un valor del estándar ISO 3166-1 alfa-2
: '''PATH''': ../cac:Address/cac:Country/cbc:IdentificationCode
|-
|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|..40</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
: Notificación 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]]
: Notificación Si el valor del atributo codigoDepartamento es diferente a los 2 primeros dígitos del código postal.
: '''PATH''': ../cac:Address/cbc:PostalZone
|}

====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’
: Rechazo 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)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|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
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|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’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|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
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|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”
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: '''PATH''': No definido
|-
|tipoDocumentoCodigo
|String
|<nowiki>AN|2</nowiki>
|C/C
|
: Identificador del tipo de documento referenciado
: '''Obligatorio''' Cuando codigoInterno sea ‘1’
: Rechazo Si codigoInterno igual a ‘1’ y el contenido de este atributo no corresponde a uno de los valores de la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 21|Tabla 21]]
: '''Para Documento soporte este campo debe ser 05.'''
: '''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.''
|}

====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’
: Rechazo 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)
:OBLIGATORIO '''Para Documento soporte este campo debe ser 5.'''
|-
|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 ransferênc se origina a partir de la corrección o ajuste que se da mediante un NC o ND
: '''Obligatorio''' En N.C y N.D, son las referencias a facturas electrónicas afectadas por la Nota.
: Solamente puede reportar facturas electrónicas de un mismo adquiriente
: Rechazo Si CUFE o CUDE no existe en la DIAN
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:UUID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:UUID
|-
|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’
: Rechazo Si fecha es posterior a la del documento referenciado
: '''PATH''': /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:IssueDate
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:IssueDate
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:IssueDate
|-
|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
: Rechazo Si se informa codigoInterno igual a ‘1’, ‘2’, ‘3’, ‘4’ ó ‘5’ y el ID de documento de referencia no está relacionado
: '''PATH''':
: /Invoice/cac:BillingReference/cac:CreditNoteDocumentReference/cbc:ID
: /CreditNote/cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
: /DebitNote/cac:BillingReference/cac:InvoiceDocumentReference
: /cbc:ID
|-
|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,
: OBLIGATORIO '''Para Documento soporte este campo debe ser 05.'''
: 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’
: Rechazo 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
: '''Para Documento soporte este campo debe ser 05.'''
|}

'''@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.EntregaMercancia====
{| 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
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo 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
|
: Valor del campo a agregar
: '''PATH''': Variable
|}

====Class.FacturaImpuestos====
{| 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
|-
|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
: Rechazo 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
|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]])
|-
|porcentajeTOTALImp
|String
|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
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo Para tributos cuya tarifa se enuncia en porcentajes, si valorTOTALImp es diferente a baseImponibleTOTALImp * porcentajeTOTALImp
: Rechazo Para tributos cuya tarifa se enuncia en valores nominales (ejempo bolsas plásticas), si valorTOTALImp es diferente a valorTributoUnidad * cantidadUnidades
: '''PATH''': ../cac:TaxTotal/TaxSubtotal/cbc:TaxAmount
|-
|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
: Rechazo 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
: Rechazo 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
: Rechazo Si montoTotal es diferente a la sumatoria de todas las ocurrencias de FacturaImpuestos.valorTOTALImp
: '''PATH''': ../cac:TaxTotal/cbc:TaxAmount
|}

====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
: '''Obligatorio''' Para Documento Soporte se debe informar Nombre o Razón Social del proveedor.
: '''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
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}

====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)
: Rechazo 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)
: Rechazo Por cada valor debe existir un name
: '''PATH''': ../cbc:Value
|}

====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
: Rechazo: 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
|
: Código correspondiente al medio de pago
: Rechazo: 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''': ../cbc:PaymentMeansCode
|-
|metodoDePago
|String
|<nowiki>AN|..2</nowiki>
|SI
|
: Método de Pago
: Rechazo: 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.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
: Rechazo 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.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
|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>
|NO
|
: Fecha de la Orden, en formato: YYYY-MM-DD HH:MM:SS
: '''PATH''': ../cbc:IssueDate
|-
|numeroOrden
|String
|<nowiki>AN|..20</nowiki>
|SI
|
: 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.sectorSalud====
{| 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
|-
|Beneficiario
|Beneficiario
| -
|C/C
|
: Datos complementarios del beneficiario del servicio de salud para escenarios de recaudo.
: '''PATH''': ../cac:AccountingCustomerParty/cac:Person
: (ver detalle en [[#Class.Beneficiario|Class.Beneficiario]])
|-
|extras
|Array <Extras>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor.
: '''PATH''': No definido
: (ver detalle en [[#Class.Extras|Class.Extras]])
|-
|idPersonalizacion
|String
| -
|SI
|
: indica el tipo de operacion para a factura de venta en sector salud.
: '''PATH''': ../cbc:CustomizationID
|-
|Pacientes
|Array <DatosPacienteSalud>
| -
|C/C
|Para el reporte de los campos de datos adicionales del Sector Salud
: (ver detalle en [[#Class.DatosPacientesSalud|Class.DatosPacientesSalud]])
|-
|TipoEscenario
|String
|<nowiki> N|1 </nowiki>
|SI
|
: Tipo de Escenario Sector Salud. [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 27|Tabla 27]]
|}
NOTA: La emisión de documentos del sector salud solo se encuentra disponible a través de la versión 4 del servicio de emisión.

====Class.Beneficiario====
{| 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
|-
|DireccionResidencia
|Direccion
| -
|C/C
|
: Información donde se detalle la dirección del beneficiario del servicio de salud.
: '''PATH''': ../cac:ResidenceAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
|}

====Class.DatosPacientesSalud====
{| 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
|-
|CamposGenerales
|Array <GeneralSalud>
| -
|C/C
|
: Campos de datos adicionales del Sector Salud para reporte de información asociada a los beneficiarios del servicio de salud
: '''PATH''': Invoice/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/Interoperabilidad
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|TipoIdentificacion
|Array <GeneralSalud>
| -
|C/C
|
: Tipo de Identificación del usuario beneficiario del servicio de salud.
: '''PATH''': cbc:ID/@schemeID
: (ver detalle en [[#Class.GeneralSalud|Class.GeneralSalud]])
|}

====Class.GeneralSalud====
{| 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
|-
|nombre
|String
|N|..2
|Si
|
: Código del campo de dato adicional.
: '''PATH''':../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Name
: @Nota: Debe corresponder a uno de los códigos de la columna [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 28|Tabla 28]]

|-
|valor
|String
|Depende del campo
|Si
|
: Valor del campo de datos adicional del sector salud según corresponda.
: '''PATH''': ../Interoperabilidad/Group schemeName="Sector Salud"/Collection schemeName="Usuario"/AdditionalInformation/Value
|}

'''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"

====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
|String
|Ent: <nowiki>N|..15</nowiki>
Dec: <nowiki>N|0..6</nowiki>
|SI
|
: Base monetaria para la conversión.
: Debe ser 1.00
: Rechazo 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
: Rechazo 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.
: Rechazo 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
: Rechazo 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
: Rechazo 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
: Rechazo 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.
: Rechazo 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
: Rechazo 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
: Rechazo: 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
: '''PATH''': ../cbc:Amount
|-
|responsableEntrega
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Descripción de quien asume la responsabilidad en caso de que la mercancía se pierda
: '''PATH''': ../cbc:LossRisk
|}

====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
: Rechazo 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]])
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificación
! style="background:#f2f2f2; text-align:center;"|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.
{{clear}}

===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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 [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|trackID
|Este elemento corresponde al TrackId del documento procesado
|}
Donde Class.Evento contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|nombre
|Código del campo
|-
|String
|valor
|Información Adicional
|}
Class.HistorialDeEntregas corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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.
{{clear}}

===Método EstadoLegalDocumentos===
Permite verificar si el documento indicado tiene validez legal frente al comprador y la autoridad tributaria (DIAN), además concede validar el historial de eventos relacionados con el documento ante la DIAN. Los clientes de ERP que cuenten con el servicio de Recepción podrán consultar el Estado Legal de un documento en particular, a través del nuevo método denominado (EstadoLegalDocumentos).
El cliente debe tener el servicio de recepción electrónica activo y contratado con The Factory HKA Colombia.

'''Nota:''' De momento este método de integración se encuentra en prueba, es importante aclarar que este método posteriormente tendrá un costo, el cual se informará desde el área comercial de The Factory HKA Colombia.

; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|-
|CUFE
|“Código Único de Factura Electrónica” correspondiente al documento consultado, calculado por el algoritmo correspondiente del servicio
|-
|SupplierIdentification
|Nit del emisor.
|-
|DocumentoId
|Prefijo y Consecutivo del Documento electrónico concatenado sin separadores. Ejemplo “PRUE980338212"
|}

En la siguiente tabla se muestran los estados posibles del documento, se deben pasar los siguientes parámetros de entrada: token de empresa, token password, cufe, nit y número de documento y devuelve como respuesta la siguiente información:

====Ejemplo de entrada====
<pre>

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
<soapenv:Header/>
<soapenv:Body>
<tem:EstadoLegalDocumentos>

<tem:tokenEmpresa>2afb</tem:tokenEmpresa>

<tem:tokenPassword>a809aee92bd</tem:tokenPassword>

<tem:cufe>794847abf0edfd959b38a2246</tem:cufe>

<tem:supplierIdentification>900390126</tem:supplierIdentification>

<tem:documentId>SETP990183</tem:documentId>
</tem:EstadoLegalDocumentos>
</soapenv:Body>
</soapenv:Envelope>
</pre>

====Ejemplo de Salida====
<pre>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EstadoLegalDocumentosResponse xmlns="http://tempuri.org/">
<EstadoLegalDocumentosResult xmlns:a="http://schemas.datacontract.org/2004/07/ServiceSoap.Models.Response" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
<a:EstadoDocumentoDIANResult>
<a:codigoEstadoFacturaDIAN>200</a:codigoEstadoFacturaDIAN>
<a:DocumentoValidoenDIAN>Valido</a:DocumentoValidoenDIAN>
<a:numeroDocumento>SETP990054183</a:numeroDocumento>
<a:cufeCudeDocumento>794847abf0edfc5f8c432a094648e944bdfce8789e00f31662c76c7037236c52b6c2b515849327a0f082d959b38a2246</a:cufeCudeDocumento>
<a:numeroIdentificacionEmisor>900390126</a:numeroIdentificacionEmisor>
<a:tipoIdentificacionEmisor>31</a:tipoIdentificacionEmisor>
<a:numeroIdentificacionReceptor>900390126</a:numeroIdentificacionReceptor>
<a:TipoIdentificacionReceptor>31</a:TipoIdentificacionReceptor>
</a:EstadoDocumentoDIANResult>
<a:EventosResult xmlns:b="http://schemas.datacontract.org/2004/07/WebApi.Domain.Models">
<b:EventsDocumentResponse>
<b:codigoEvento>030</b:codigoEvento>
<b:descripcionEvento>Acuse de recibo de Factura Electrónica de Venta</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:39Z</b:fechaEvento>
<b:numeroEvento>240122389968251</b:numeroEvento>
<b:cudeEvento>5333a02e2a29cbed56c8989221b4e4712818c4f98dfd7347a61f2cd4619b21d6e7e2169f62f0b15e121a51d40127402e</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>DRodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>032</b:codigoEvento>
<b:descripcionEvento>Recibo del bien y/o prestación del servicio</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:40Z</b:fechaEvento>
<b:numeroEvento>240122429077715</b:numeroEvento>
<b:cudeEvento>d6015b90e7cd86ffe2273ad14095935a61cadaef963ae9bbb3eac9615a4948b03127561c56e8939004bba1699b059c68</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
<b:EventsDocumentResponse>
<b:codigoEvento>033</b:codigoEvento>
<b:descripcionEvento>Aceptación expresa</b:descripcionEvento>
<b:fechaEvento>2024-01-22T17:10:41Z</b:fechaEvento>
<b:numeroEvento>240122276806767</b:numeroEvento>
<b:cudeEvento>2da1e89e3f4c7c039b25aaca0f241f1c115dd09556a4226b8e0bf0b7db303a4eac07481a83994ef6d8bad384499a284a</b:cudeEvento>
<b:emisorEvento>RUT ALEJANDRO</b:emisorEvento>
<b:tipoIdentificacionEmisor>31</b:tipoIdentificacionEmisor>
<b:numeroIdentificacionEmisor>900390126</b:numeroIdentificacionEmisor>
<b:receptorEvento>D Rodriguez</b:receptorEvento>
<b:numeroIdentificacionReceptor>31</b:numeroIdentificacionReceptor>
<b:tipoIdentificacionReceptor>900390126</b:tipoIdentificacionReceptor>
</b:EventsDocumentResponse>
</a:EventosResult>
<a:CódigoRespuesta>0</a:CódigoRespuesta>
<a:MensajeRespuesta i:nil="true"/>
<a:ResumenEventosDocumento>
<a:CódigoRespuesta>201</a:CódigoRespuesta>
<a:MensajeRespuesta>Se retorna el ultimo estatus legal de la factura</a:MensajeRespuesta>
<a:CantidadEventos>3</a:CantidadEventos>
<a:EsAceptada>Si</a:EsAceptada>
<a:AceptaciónTácita>No</a:AceptaciónTácita>
<a:EsBienoServicio>Recibido</a:EsBienoServicio>
<a:EsReclamada>No</a:EsReclamada>
<a:EsRecibida>Si</a:EsRecibida>
<a:TieneEventos>Si</a:TieneEventos>
<a:EsTituloValor>No</a:EsTituloValor>
<a:EstaEndosada>No</a:EstaEndosada>
</a:ResumenEventosDocumento>
</EstadoLegalDocumentosResult>
</EstadoLegalDocumentosResponse>
</s:Body>
</s:Envelope>

</pre>

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|Array <EstadoDocumentoDIANResult>
|EstadoDocumentoDIANResult
|Indica el estatus actual en el que se encuentra actualmente el documento ante la DIAN con los detalles del documento.
|-
|Array <EventosResult>
|EventosResult
|Detalle del documento ante la DIAN, resultado de los eventos obtenidos.
|-
|String
|CodigoRespuesta
|
|-
|String
|MensajeRespuesta
|Mensaje de respuesta del método.
|-
|Array <ResumenEventosDocumento>
|ResumenEventosDocumento
|Resumen a nivel general de los diferentes estatus que tiene el documento.
|}

Donde Class.EstadoDocumentoDIANResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigoEstadoFacturaDIAN
|Indica el estado de la operación retornado por la DIAN.
|-
|String
|DocumentoValidoenDIAN
|Indica validación del documento ante la DIAN.
|-
|String
|numeroDocumento
|Consecutivo del Documento TFHKA/DIAN.
|-
|String
|cufeCudeDocumento
|CUFE del documento electronico
|-
|String
|numeroIdentificacionEmisor
|Número de Identificación del Emisor.
|-
|int
|tipoIdentificacionEmisor
|Indicador del Emisor
|-
|String
|numeroIdentificacionReceptor
|Número de Identificación del Receptor o adquieriente del documento.
|-
|int
|TipoIdentificacionReceptor
|Indicador del Receptor
|}

Y Class.EventosResult contiene la siguiente información:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoEvento
|Etiqueta
|-
|String
|descripcionEvento
|Descripción del evento actual
|-
|String
|fechaEvento
|fecha de registro del evento
|-
|String
|cudeEvento
| Código Único de Documento Electrónico del evento.
|-
|String
|emisorEvento
|Evento ejecutado por la persona encargada.
|-
|String
|tipoIdentificacionEmisor
|Tipo indentificación del emisor
|-
|String
|numeroIdentificacionEmisor
|Indentificación del emisor
|-
|String
|receptorEvento
|Usuario que recibe los eventos(emisor)
|-
|String
|numeroIdentificacionReceptor
|Indentificación del receptor.
|-
|String
|tipoIdentificacionReceptor
|Tipo indentificación del receptor.
|}

Class.ResumenEventosDocumento corresponderá a:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|CódigoRespuesta
|Código correspondiente al catalogo de la tabla.
|-
|String
|MensajeRespuesta
|Mensaje de satisfacción o error de resumen de eventos del documento.
|-
|String
|CantidadEventos
|Número de eventos que se han dado al documento (1, 2 ó 3)
|-
|String
|EsAceptada
|Si el documento tiene los 3 eventos y tiene una aceptación expresa como evento.(SI/NO)
|-
|String
|AceptaciónTácita
|Si el documento tiene una aceptación tácita como evento realizada por el emisor.(SI/NO)
|-
|String
|EsBienoServicio
|Si el documento tiene un segundo evento DIAN, recibo del bien o prestación del servicio como evento.(SI/NO)
|-
|String
|EsReclamada
|Si el documento tiene un reclamo como evento por parte del receptor.(SI/NO)
|-
|String
|EsRecibida
|Si el documento tiene un acuse de recibo como evento por parte del receptor.(SI/NO)
|-
|String
|TieneEventos
|Si cumple con por lo menos un evento por parte del receptor.(SI/NO)
|-
|String
|EsTituloValor
|El documento cuenta con titulo valor despues de dar los 3 eventos por parte del receptor
|-
|String
|EstaEndosada
|
|}
'''@Importante:''' La estructura de éste Response, aún puede estar sujeta a cambios en una próxima actualización.
{{clear}}

===Método EnvioCorreo===
Permite reenviar a una o varias direcciones de correos el documento indicado.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="5"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|rowspan="2"|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.
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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).
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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”
|}
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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”
|}
{{clear}}
===Método CargarCertificado===
Este método por ahora se mantendrá solo como uso interno de The Factory HKA Colombia.
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="4"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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
|}
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="3"|String
|tokenEmpresa
|rowspan="2"|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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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”
|}
{{clear}}
===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
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|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:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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:
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|codigoInterno1
|Etiqueta
|-
|String
|codigoInterno2
|Descripción Adicional
|-
|String
|Nombre Código
|del campo
|-
|String
|valor
|Información adicional
|}
; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|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
|}
{{clear}}
===Método EstadoCertificado===
Permite conocer el estado del certificado digital adquirido en ambiente demo o ambiente producción, indica su vigencia y los días restantes para cumplir su vencimiento.
; REQUEST: Parámetros a Enviar
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|rowspan="2"|String
|tokenEmpresa
|rowspan="2"|Suministrado por The Factory HKA Colombia
|-
|tokenPassword
|}

; RESPONSE: Parámetros a Recibir
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Tipo
! style="background:#f2f2f2; text-align:center;"|Identificador
! style="background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|String
|active
|Indica el Estatus actual en el que se encuentra el certificado digital
|-
|String
|dateFrom
|Indica la fecha desde la cual se encuentra activo el certificado digital
|-
|String
|dateTo
|Indica la fecha de vencimiento del certificado digital.
|-
|Int
|identification
|Muestra el numero de identificación del contribuyente al que pertenece el certificado
|-
|Int
|codigo
|Indica el Estado de la operación retornado por el servicio
|-
|String
|mensaje
|Este mensaje está asociado a los días faltantes para el vencimiento del certificado digital.
|}
{{clear}}

'''@IMPORTANTE:''' El consumo de este método está contemplado solamente con la versión url V4 del servicio a través de Web Service.

:Para mayor información pude visitar la siguiente sección:
'''[[Tips Urls de Emisión| Tips Urls de Emisión]]'''
{{clear}}

Tips Urls de Emisión

2021-08-25T14:42:15Z

Paguirre: /* Versión 4 */

<includeonly>=</includeonly>== URL´s Servicio de integración de Emisión-Ambiente de Producción ==<includeonly>=</includeonly>
 
===Versión 1===
*URL:[https://emision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl https://emision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl]

===Versión 2===
*URL:[https://emision21v2.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl https://emision21v2.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl]

===Versión 4===
*URL:[https://emision21v4.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl https://emision21v4.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl]
 
<includeonly>=</includeonly>== ¿Cómo saber que versión del servicio de emisión debo usar a partir del 18 de agosto de 2021? ==<includeonly>=</includeonly>
 

===Orientaciones Principales:===

<DIV ALIGN=justify>En el marco de la entrada en vigencia de la fecha de obligatoriedad para la implementación del Anexo Técnico 1.8 de Factura Electrónica de Venta a partir del próximo 18 de agosto de 2021, le indicamos:</DIV>
#La ''''versión 4'''' del servicio de emisión contempla optimizaciones y mejoras que se requieren para la emisión de facturas electrónicas bajo el anexo técnico 1.8.
#Las '''versiones 1 y 2''' cuentan con todas las validaciones correspondientes con el anexo 1.8 para facturas electrónicas de ventas comerciales y puede seguir usando temporalmente estas URL´s si no le aplican las adaptaciones que se describen en las próximas secciones.
#Usted no estaría obligado el día 18 de agosto de 2021 a hacer el cambio a la versión 4, a no ser que requiera algunas de las adaptaciones que se describen en las próximas secciones , es decir, que cuenta con más tiempo para realizar la adaptación a la versión 4 del servicio.
#Se recomienda en el futuro migrar a la versión más actualizada, de igual forma, a la hora de que se vaya a generar un cambio o apagado de URL´s, The Factory HKA Colombia SAS notificará con la debida antelación para no causar efectos adversos.
 
===Aplica o se debe usar la versión 4 del servicio de emisión===
*Si necesita establecer el campo de redondeo aplicado en los Impuestos Totales:
 
<center>'''Class.ImpuestosTotales'''</center>
[[Archivo:ClassImpuestosT.png|centro|Class.ImpuestosTotales]]
 
'''Nota:''' Si no necesita aplicar el redondeo aplicado a nivel de impuestos tiene la opción de no enviar dicho campo, ya que el servicio interpretará esto como un redondeo de 0.00.
 
 
*Si realiza emisiones para los distintos sectores:
#Salud.
#Transporte.
#Notaria.
#Mandato.
 
*Si requiere enviar el campo régimen:
Tal como se estableció en el anexo técnico el campo régimen de la clase Obligaciones pasa a ser '''opcional''', si es informado indicar “No aplica”.

<pre>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>No aplica</regimen>
</Obligaciones>
</responsabilidadesRut>
</pre>

<DIV ALIGN=justify>'''@IMPORTANTE''' Todos los clientes de TFHKA deberán migrar a la nueva versión, dado que es la versión que se mantendrá adecuada y adaptada en el futuro a los cambios técnicos planteados por la DIAN en el anexo técnico 1.8. Sin embargo, si no le aplican los elementos antes mencionados, no necesita hacer el cambio para el 18 de agosto de 2021, bien debe hacerlo en algún momento antes de finalizar el presente año.</DIV>