tfhkacolwiki - Contribuciones del usuario [es]

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

2020-09-29T16:42:57Z

Fpinto:

<includeonly>=</includeonly>==Método Servicio Emisión Web Soap==<includeonly>=</includeonly>
Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Formato
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| A || Carácter alfabético
|-
| N || Carácter numérico
|-
| AN || Carácter alfanumérico
|-
| <nowiki> A|3 </nowiki> || 3 caracteres alfabéticos (longitud fija)
|-
| <nowiki> N|3 </nowiki> || 3 caracteres numéricos (longitud fija)
|-
| <nowiki> AN|3 </nowiki> || 3 caracteres alfanuméricos (longitud fija)
|-
| <nowiki> A|..3 </nowiki> || Hasta 3 caracteres alfabéticos (longitud variable)
|-
| <nowiki> N|..3 </nowiki> || Hasta 3 caracteres numéricos (longitud variable)
|-
| <nowiki> AN|..3 </nowiki> || Hasta 3 caracteres alfanuméricos (longitud variable)
|-
| <nowiki> N|2..6 </nowiki> || Entre 2 y 6 caracteres numéricos (longitud variable)
|-
| INT32 || Entero. (Valor Máximo: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Obligatorio
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| SI || Si es obligatorio para la DIAN
|-
| NO || No es obligatorio para la DIAN
|-
| C/C || Es requerido cuando corresponda (o bajo cierta condición por el modelo de negocio del cliente)
|}
{{clear}}

===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 solo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera solo 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 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
: '''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..20
|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’
: '''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
|-
|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]]
|-
|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.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: 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>
|SI
|
: Descripción del producto o servicio
: '''PATH''': ../Item/cbc:Description
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: 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
|NO
|
: Código del producto según el estándar informado en estandarCodigo
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|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.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.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)
|-
|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,
: 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
|}
'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: 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.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.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>
|C/C
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}
'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.
====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|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.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|..50</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: 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.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.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]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: 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.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.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.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)
|-
|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”
: '''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]]
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"
; RESPONSE: Parámetros a Recibir
{| 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 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}}

Preguntas Frecuentes de Integración con servicio Web (Val. Previa)

2020-09-22T16:09:09Z

Fpinto:

<includeonly>=</includeonly>==Historial de versiones==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Versión
! style="background:#e9e9e9; text-align:center;"|Fecha lanzamiento
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| 0
| 07/05/2019
|
* Versión Preliminar.
|}
<includeonly>=</includeonly>==Cómo obtener soporte==<includeonly>=</includeonly>
*Soporte de 1er nivel:
::Soporte telefónico / email / chat o tele-conferencias en horario 5x8 para atención de consultas y fallas de usuario.
*Soporte de 2do nivel:
::Soporte resolución remota de incidencias en el sistema en horario 5x8
::::Llame a nuestro CENTRO DE ATENCIÓN +(57) 1 311.31.12 
::::Escriba a [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Visítenos el sitio Web: https://www.thefactoryhka.com/co
{{clear}}
<includeonly>=</includeonly>==Ambiente de HABILITACIÓN ==<includeonly>=</includeonly>
El proceso en el ambiente de habilitación es asíncrono por lo que primero es recibido por The Factory HKA y luego en una tarea secundaria buscando las condiciones óptimas de conexión con la DIAN los mismos son enviados a la entidad tributaria.
Secuencia del servicio asíncrono:
* El software cliente realiza la conexión, autenticación por medio de certificado digital, enviando la solicitud (Request) al servicio de la DIAN.
* El WS DIAN recibe la solicitud y responde con un mensaje de aprobación o rechazo, según las primeras validaciones y entrega un trackId.
* El software cliente, al obtener la respuesta, cierra la conexión.
* Con el trackId obtenido en el método, se consume otro método de consulta para obtener el resultado de la transacción anterior.

<includeonly>=</includeonly>==Transmisión de documentos de contingencia tipo 03 (path additionaldocumentreference)==<includeonly>=</includeonly>
Los inconvenientes tecnológicos por parte del facturador electrónico implican que la facturación electrónica tenga las siguientes características:
* Generar la facturación con numeración de contingencia en papel o por computador.
* El facturador tendrá 30 días (48 horas en la última resolución) a partir de la fecha en que supera la contingencia para transmitir las facturas electrónicas en formato XML a la DIAN.
* Las facturas electrónicas generadas y emitidas en contingencia pasarán la malla de validaciones de anexo, es decir, la DIAN responderá con un Application Response de Documento Validado por la DIAN, que informará las notificaciones a que haya lugar.
* Una vez el facturador electrónico salga de contingencia deberá proceder al proceso de generación normal.
* Para los documentos de notas crédito y notas débito, el facturador NO debe usar la numeración de contingencia, sino el consecutivo propio normal. Las notas enviadas a la DIAN se validarán de manera normal en la DIAN. Por lo anterior, no existe el concepto de nota en contingencia, por lo que debe cuidarse enviar primeramente las Facturas de Contingencia antes de generar notas sobre las mismas y se recomienda generarlas en un ambiente de operación normal.

===¿Cómo transmitir un documento de contingencia Tipo 03?===
La transmisión del documento se realiza por medio del método Enviar del Web Service de Emisión que brinda The Factory HKA, indicando el atributo tipoDocumento del objeto FacturaGeneral igual a ‘03’ y enviar en la sección de documentosReferenciados un objeto de tipo DocumentosReferenciados indicando lo siguiente:
* codigoInterno = ‘1’
* fecha = ‘Fecha de emisión del documento de contingencia’
* numeroDocumento = ‘número del consecutivo del documento de contingencia emitido’
* tipoCodigoDocumento = ‘Tipo de documento de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico a transmitir, según lo estipulado en el numeral 12.1.4 de la versión 1.8 del Anexo Técnico de la DIAN ’.

{| class="wikitable" style="width: 80%;"
|+ Tipos de documentos de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico
! style="color:black;background:#f2f2f2; text-align:center;"|Código
! style="color:black;background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|FTC
|Factura Talonario Contingencia
|-
|FTP
|Factura Talonario Papel
|-
|FTPC
|Factura Talonario por Computador
|}
===¿Cuál será el código de respuesta de transmisión exitosa que retornará el WS de TFHKA?===
El método Enviar retornará código 201 ó 208 ante la recepción exitosa del documento en nuestra plataforma, con el siguiente mensaje: “El documento se recibió como Documento Electrónico de Contingencia Tipo 03, este se entregará de manera asíncrona a la DIAN, para más información favor consumir '''EstadoDocumento''' luego de 48 horas.” En dicho Response se contará con CUDE y UBL.

===¿Cuándo puedo consultar el resultado de la transmisión del documento hacia la DIAN?===
Pasadas 48 horas luego de la radicación del documento en la plataforma, pueden consultar el estatus del mismo para conocer el resultado de la transacción ante la DIAN.

===Ejemplo SOAP Request de Factura de Contingencia Tipo 03:===
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Ver ejemplo:</div>
<div class="mw-collapsible-content">

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales>
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>email1@thefactoryhka.com</arr:string>
<arr:string>email2@thefactoryhka.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos>
<codigoImpuesto>ZY</codigoImpuesto>
</Tributos>
</detallesTributarios>

<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<direccionFiscal>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionFiscal>
<email>email@thefactoryhka.com</email>

<informacionLegalCliente>
<nombreRegistroRUT>CONSORCIO ALIANZA SAN CRISTOBAL 4</nombreRegistroRUT>
<numeroIdentificacion>901041710</numeroIdentificacion>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<tipoIdentificacion>31</tipoIdentificacion>
</informacionLegalCliente>
<nombreRazonSocial>The Factory HKA Colombia</nombreRazonSocial>
<notificar>SI</notificar>
<numeroDocumento>901041710</numeroDocumento>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>31</tipoIdentificacion>
<tipoPersona>1</tipoPersona>
</cliente>
<consecutivoDocumento>PREFIJOCONSECUTIVO</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadPorEmpaque>1</cantidadPorEmpaque>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>P000001</codigoProducto>
<descripcion>Impresora HKA80</descripcion>
<descripcionTecnica>Impresora térmica de punto de venta, ideal para puntos de venta con alto rendimiento</descripcionTecnica>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>PHKA80</estandarCodigoProducto>
<impuestosDetalles>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosDetalles>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<marca>HKA</marca>
<muestraGratis>0</muestraGratis>
<precioTotal>1193.57</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura></pre>
<pre style="color: red">
<documentosReferenciados>

<DocumentoReferenciado>
<codigoInterno>1</codigoInterno>
<fecha>2020-01-01</fecha>
<numeroDocumento>CTG12</numeroDocumento>

<tipoDocumentoCodigo>FTC</tipoDocumentoCodigo>
</DocumentoReferenciado>
</documentosReferenciados></pre>
<pre>
<fechaEmision>2020-01-08 00:00:00</fechaEmision>
<impuestosGenerales>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<unidadMedida>WSD</unidadMedida>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosGenerales>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-RANGODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado></pre>
<pre style="color: red">
<tipoDocumento>03</tipoDocumento></pre>
<pre>
<tipoOperacion>10</tipoOperacion>
<totalBaseImponible>1003.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</pre>
</div></div>

@IMPORTANTE: No es requerido que se notifique a los adquirientes los documentos de contingencia transmitidos a la DIAN, ya que el documento entregado físicamente al mismo durante el período en que mantuvo la contingencia, corresponde al documento legal de la transacción realizada. La transmisión de dicha información a la DIAN es con el fin de notificar al ente regulador las transacciones realizadas durante dicho periodo. Por lo anteriormente descrito, se recomienda enviar el campo notificar = ‘NO’ y no realizar el envío de la información correspondiente al Destinatario:

<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Ver ejemplo:</div>
<div class="mw-collapsible-content">

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales></pre>
<pre style="color: red">
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>email1@thefactoryhka.com</arr:string>
<arr:string>email2@thefactoryhka.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos>
<codigoImpuesto>ZY</codigoImpuesto>
</Tributos>
</detallesTributarios>

<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<direccionFiscal>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionFiscal>
<email>email@thefactoryhka.com</email>

<informacionLegalCliente>
<nombreRegistroRUT>CONSORCIO ALIANZA SAN CRISTOBAL 4</nombreRegistroRUT>
<numeroIdentificacion>901041710</numeroIdentificacion>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<tipoIdentificacion>31</tipoIdentificacion>
</informacionLegalCliente>
<nombreRazonSocial>The Factory HKA Colombia</nombreRazonSocial>
<notificar>NO</notificar>
<numeroDocumento>901041710</numeroDocumento>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>31</tipoIdentificacion>
<tipoPersona>1</tipoPersona>
</cliente></pre>
<pre>
<consecutivoDocumento>PREFIJOCONSECUTIVO</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadPorEmpaque>1</cantidadPorEmpaque>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>P000001</codigoProducto>
<descripcion>Impresora HKA80</descripcion>
<descripcionTecnica>Impresora térmica de punto de venta, ideal para puntos de venta con alto rendimiento</descripcionTecnica>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>PHKA80</estandarCodigoProducto>
<impuestosDetalles>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosDetalles>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<marca>HKA</marca>
<muestraGratis>0</muestraGratis>
<precioTotal>1193.57</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura>
<documentosReferenciados>

<DocumentoReferenciado>
<codigoInterno>1</codigoInterno>
<fecha>2020-01-01</fecha>
<numeroDocumento>CTG12</numeroDocumento>

<tipoDocumentoCodigo>FTC</tipoDocumentoCodigo>
</DocumentoReferenciado>
</documentosReferenciados>
<fechaEmision>2020-01-08 00:00:00</fechaEmision>
<impuestosGenerales>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<unidadMedida>WSD</unidadMedida>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosGenerales>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-RANGODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>
<tipoDocumento>03</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<totalBaseImponible>1003.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</pre>
</div></div>

<includeonly>=</includeonly>==Campos extensibles en R.G estándar==<includeonly>=</includeonly>

El '''valor''' de estos campos es texto plano, por lo tanto el formato es gestionado desde el ERP.
* TOTAL Descuento Detalle (Campo Extensible 5170001).
* Total Base Excluida (Campo Extensible 5170000)
* TOTAL Retenciones (Campo Extensible 5170002)
* TOTAL a Pagar (Campo Extensible 5170003)
* TOTAL A PAGAR en Letras (Campo Extensible 5170004)

===Ejemplo sobre la estructura de los campos:===
<pre>
<extras>
<Extras>
<controlInterno1>Total Base Excluida</controlInterno1>
<controlInterno2/>
<nombre>5170000</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL Descuento Detalle</controlInterno1>
<controlInterno2/>
<nombre>5170001</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL Retenciones</controlInterno1>
<controlInterno2/>
<nombre>5170002</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL a Pagar</controlInterno1>
<controlInterno2/>
<nombre>5170003</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>
</extras>
</pre>
En la Representación Gráfica se visualizará de la siguiente manera:

[[Archivo:visualizaRGcamposExtras.png|centro|'''Campos extensibles en representación grpafica estándar''']]

<includeonly>=</includeonly>==Estructura del QR de acuerdo al Anexo 1.8==<includeonly>=</includeonly>
Para la representación gráfica de las facturas electrónicas, es requisito la generación de un código QR con la siguiente información:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:black;background:#FFD966; text-align:center;"|Detalle
! style="color:black;background:#FFD966; text-align:center;"|XPath
|- valign="center"
|-
|NumFac: [NUMERO_FACTURA]
|/Invoice/cbc:ID
|-
|FecFac: [FECHA_FACTURA]
|/Invoice/cbc:IssueDate
|-
|HorFac: [HORA_FACTURA(con GMT)]
|/Invoice/cbc:IssueTime
|-
|NitFac: [NIT FACTURADOR]
|/Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|DocAdq: [NUMERO_ID_ADQUIRENTE]
|/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|ValFac: [VALOR_FACTURA]
|/Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount
|-
|ValIva: [VALOR_IVA]
|/Invoice/cac:TaxTotal/cbc:TaxAmount Donde /Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
|-
|ValOtroIm: [VALOR_OTROS_IMPUESTOS]
|Sumatoria de /Invoice/cac:TaxTotal[X]/cbc:TaxAmount[X] Donde /Invoice/cac:TaxTotal[X]/cac:TaxSubtotal[X]/cac:TaxCategory[X]/cac:TaxScheme[X]/cbc:ID[X] sea diferente a 01
|-
|ValTolFac: [VALOR_TOTAL_FACTURA
|/Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount
|-
|CUFE
|/Invoice/cbc:UUID
|-
|QRCode
|/Invoice/ext:UBLExtensions[1]/ext:UBLExtension[1]/ext:ExtensionContent[1]/sts:DianExtensions[1]/sts:QRCode
|}
Debe tener las siguientes consideraciones:

: '''NitFac:''' sin puntos ni guiones
: '''DocAdq:''' sin puntos ni guiones
: '''ValFac:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValIva:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValOtroIm:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValTolFac:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''QRCode:''' URL disponible por la DIAN
:* Ambiente Habilitación: https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=CUFE
:* Ambiente Producción: https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUFE

===Ejemplo sobre la estructura de los campos:===
Teniendo en cuenta los datos de entrada, se presenta el código QR que se incluye en la representación gráfica de la factura electrónica:
<pre>
<a:qr>
NumFac: VAF472
FecFac: 2019-12-20
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 2006.00
ValIva: 381.14
ValOtroIm: 0.00
ValTolFac: 2387.14
CUFE: 95d062a141ff0f1a55f9f684167e00544617f4ed714b283934ad939fc056c6fb2ae6ab34ad8ba9a9db94aa2c253d3c05
https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=95d062a141ff0f1a55f9f684167e00544617f4ed714b283934ad939fc056c6fb2ae6ab34ad8ba9a9db94aa2c253d3c05
</a:qr>
</pre>

<includeonly>=</includeonly>==Campos de direcciones mínimos para evitar rechazo FAK08==<includeonly>=</includeonly>
Esto se debe a que la DIAN está validando que se envíen obligatoriamente los campos '''ciudad''', '''codigoDepartamento''', '''departamento''', '''dirección''', '''municipio''' y '''país''' en la dirección del cliente.

<includeonly>=</includeonly>==Configuración de direcciones en el portal para evitar rechazo FAJ09, FAJ16, FAJ12.==<includeonly>=</includeonly>
: 1. Deben validar que en nuestro portal web en la sección '''Catálogos->Establecimientos''', la dirección física del establecimiento se encuentre correctamente configurada:

[[Archivo:CatálogosEstablecimientosPortal.png|centro|'''Catálogos->Establecimientos''']]

: 2. Validar que la dirección fiscal o dirección física del receptor está correctamente construida mínimo con lo siguiente:

[[Archivo:direccionFiscalFisicaMinima.png|centro|'''Campos mínimos en dirección fiscal y dirección física''']]

<includeonly>=</includeonly>==Concatenación de nombre + apellido en campo nombreRazonSocial==<includeonly>=</includeonly>
En este caso, se recomienda enviar el nombre completo (Nombres y apellidos) en el atributo '''nombreRazonSocial''' del objeto factura y dejar vacíos los campos '''apellido y segundoNombre'''.

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que afecten a facturas de validación previa==<includeonly>=</includeonly>
Para la emisión de Notas de Crédito y Débito deben enviarse obligatoriamente dos arreglos de documentos referenciados, el primero indicando el codigoInterno = '4' el cual corresponde a los motivos por los cuales se genera la NC/ND ('''DiscrepancyResponse''') y un segundo arreglo, indicando el codigoInterno = '5' en el cual se reflejan los datos de la factura afectada por la NC/NC ('''BillingReference''').
Como se muestra a continuación:
<pre>
<a:documentosReferenciados>
<a:DocumentoReferenciado>
<a:codigoEstatusDocumento>2</a:codigoEstatusDocumento>
<a:codigoInterno>4</a:codigoInterno>
<a:cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1EkRoFzzvJqHhKqk5JpLSqtJ99pRMd32g40baab6b59cdc8b3</a:cufeDocReferenciado>
<a:descripción>
<b:string>Anulación de factura electrónica</b:string>
</a:descripción>
<a:extras i:nil="true"/>
<a:fecha>2019-10-07</a:fecha>
<a:fechaFinValidez i:nil="true"/>
<a:fechaInicioValidez i:nil="true"/>
<a:numeroDocumento>F4PM3</a:numeroDocumento>
<a:tipoCUFE i:nil="true"/>
<a:tipoDocumento i:nil="true"/>
<a:tipoDocumentoCodigo i:nil="true"/>
</a:DocumentoReferenciado>
<DocumentoReferenciado>
<codigoInterno>5</codigoInterno>
<cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1KqmCLKgxPpH6u5LiKrJvTb6FEyfVuoCcV0baab6b59cdc8b3</cufeDocReferenciado>
<fecha>2019-10-07</fecha>
<numeroDocumento>F4PM3</numeroDocumento>
</DocumentoReferenciado>
</a:documentosReferenciados>
</pre>
En el caso de la dll, basta con enviar cada arreglo separado por el carácter "%", por ejemplo:

ID02E = "02E|2|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954||||ASFF10|||01|||||¬02E1|Prueba NC Campos Minimos con Anulación de factura electrónica"+ "%" +"02E||5|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|||ASFF10|CUFE-SHA384||01|||||"

Esto se visualiza en la representación gráfica de la siguiente forma:

[[Archivo:DocRefNotasFactValPrev.png|centro|'''Documentos referenciados en representación gráfica''']]

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior==<includeonly>=</includeonly>
Tener en cuenta que para cada escenario se debe indicar correctamente el campo '''tipoOperacion''':
* Código '''23''' para '''Notas Crédito'''.
* Código '''33''' para '''Notas Débito'''.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:23-33-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png|800px|sinmarco|centro|Campo FacturaGeneral.tipoOperacion que afectan facturas de validación posterior]]

Para la emisión de Notas de Crédito y Débito deben enviarse obligatoriamente dos arreglos indicando el '''DiscrepancyResponse''' y el '''BillingReference'''.

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que no afecten a facturas==<includeonly>=</includeonly>
Tener en cuenta que para cada escenario se debe indicar correctamente el campo '''tipoOperacion''':
* Código '''22''' para '''Notas Crédito'''.
* Código '''32''' para '''Notas Débito'''.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:22-32-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png|800px|sinmarco|centro|Campo FacturaGeneral.tipoOperacion que no afectan facturas]]

@IMPORTANTE: La clase Documentos Referenciados debe enviarse en null.

<includeonly>=</includeonly>==Error 101 token emisor inválido==<includeonly>=</includeonly>
El código de Error '''101''' hace referencia a un inconveniente en la configuración de los tokens y URL en su sistema. Por favor, validar en la configuración del ERP que se encuentran configurados correctamente estos dos puntos dependiendo del ambiente en el cual desean realizar las emisiones de documentos:

'''URL Ambiente Demo''' (ambiente de pruebas en el cual las emisiones no son transmitidas a la DIAN):
<pre>
Servicio Emisión:
http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl

Servicio Adjuntos:
http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsd

Servicio Reportes:
http://demoemision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl
</pre>
'''URL Ambiente Productivo''' (ambiente en el cual se realizan las emisiones correspondientes al set de habilitación y posteriormente la emisión de documentos en operación):
<pre>
Servicio Emisión (HTTPS):
URL compartida por el área de proyectos.
Servicio Adjuntos (HTTPS):
URL compartida por el área de proyectos.
Servicio Reportes (HTTPS)
URL compartida por el área de proyectos.
</pre>

<includeonly>=</includeonly>==Mostrar dirección completa en la representación gráfica==<includeonly>=</includeonly>
Dicha información se debe enviar a través del atributo [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|'''DireccionCliente''']]

[[Archivo:Mostrar dirección completa en la representación gráfica.png|centro|'''Clase direccionCliente''']]

Los campos necesarios para que se muestre en la representación gráfica son los siguientes:

[[Archivo:camposDireccionRepGraf.png|centro|'''Campos necesarios para representación gráfica''']]

En la representación gráfica se mostraría de la siguiente manera:

[[Archivo:dirección completa en la representación gráfica.png|centro|'''Representación gráfica con campos los necesarios''']]

<includeonly>=</includeonly>==Regla: FAW01, Rechazo: Línea de factura informado con LineExtensionAmount en cero y grupo cac:PricingReference no informado==<includeonly>=</includeonly>
Este error surge cuando la DIAN recibe un UBL indicando que la base imponible de un elemento a nivel de línea es 0 y la validación rechaza el documento. En el caso de estar enviando una muestra se deben enviar los campos obligatoriamente: '''codigoTipoPrecio, muestraGratis, precioReferencia, precioTotal, precioTotalSinImpuestos'''.

<includeonly>=</includeonly>==Envío de representación gráfica personalizada==<includeonly>=</includeonly>
La emisión con adjuntos se realiza en dos pasos. El primero consiste en generar el UBL fiscal a través de la url de emisión (http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl en ambiente Demo)

En este caso, se debe indicar en el método Enviar el parámetro adjunto en 11 para indicarle al servicio que no se genere nuestra representación gráfica estándar y adicionalmente que el documento no se envíe por correo hasta que no se realice la carga de adjuntos.

[[Archivo:tabRequestParamEnviar.png|centro|'''Descripción de parámetros a Enviar''']]

Posteriormente, debe consumirse el método CargarArchivo a traves de la url de adjunto (http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl en ambiente Demo)

Este método presenta los siguientes campos

[[Archivo:tabCamposParamEnviar.png|centro|'''Descripción de campos en parámetros a Enviar''']]

Dónde Class.Adjunto contiene la siguiente información:

[[Archivo:tabClaseAdjuntos.png|centro|'''Descripción de Class.Adjunto''']]

RESPONSE: Parámetros a Recibir

[[Archivo:tabResponseParamRecibir.png|centro|'''Descripción de parámetros a Recibir''']]

@IMPORTANTE: Si un documento queda a la espera de adjuntos, no se enviará el correo de notificación hasta que no se realice el cargue de los archivos anexos.

<includeonly>=</includeonly>==Correo electrónico personalizado==<includeonly>=</includeonly>
El objeto “extras” también permite manejar algunas funcionalidades especiales de la plataforma, como la de correo electrónico personalizado. Para que esta información no aparezca en la representación gráfica, el parámetro pdf del objeto “extras” debe ir en “0”.

La funcionalidad de correo electrónico personalizado permite configurar transacción a transacción el asunto, la dirección de respuesta y el cuerpo del correo electrónico. La vía para exponer esta información será a través de campos extensibles.

[[Archivo:tabCampsExtensiblesCorreoPers.png|centro|'''Descripción de campos extensibles para correo electrónico personalizado''']]

===Ejemplo de uso de Campos Extensibles 11,13 y 14 para personalizar el Correo Electrónico:===

[[Archivo:ejemXMLCamposExtensiblesCorreoPers.png|centro|'''Ejemplo XML''']]

Tomando el ejemplo dado el correo se visualizará de la siguiente manera:

[[Archivo:ejembandejaCorreoCamposExtensiblesCorreoPers.png|centro|'''Factura electrónica en bandeja de correo''']]

<includeonly>=</includeonly>==Radicar documentos electrónicos en plataformas de recepción==<includeonly>=</includeonly>
Aclaramos la situación, indicando que el el XML que se debe radicar en las plataformas de recepción es el que nuestro servicio envía en la notificación de correo llamado AttachedDocument (Contenedor de Documentos), la estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha, este XML también puede ser descargado a través del método GenerarContenedor

[[Archivo:radicarDocumentos.png|centro|'''Documentos electrónicos en plataformas de recepción''']]

'''Nota:''' Si usted es cliente final, por favor comunicar lo anterior a su casa de software o proveedor de ERP.

<includeonly>=</includeonly>==Regla [FAJ26], Rechazo: No indica un valor autorizado==<includeonly>=</includeonly>
En el catálogo/cliente y en datos fiscales de la empresa, valide que en el campo de responsabilidades no se encuentre seleccionada las siguientes opciones:
# O-47 Régimen Simple de Tributación – SIMPLE.
# O-48 Impuesto sobre las ventas.
# O-49 No responsable de IVA.
# O-52 Facturador electrónico.

Ya que el error de validación que está presentando es debido a que la DIAN no ha actualizado los catálogos donde se incluyen estos nuevos elementos, y por eso están siendo rechazados. Se recomienda retirarlos temporalmente hasta que la DIAN permita su uso.

Dicha modificación la puede realizar en nuestro portal de la siguiente manera:

En la opción de Datos fiscales/ Información Adicional/Responsabilidades debe tener configurado la responsabilidad Responsabilidad sobre las ventas(O-48)

[[Archivo:editarPortalResponsabilidades.png|centro|'''Opción de edición de Responsabilidades en portal''']]

Debe destildar esa opción en la sección Responsabilidades:

[[Archivo:editarPortalRespOpciones.png|centro|'''Modificación de Responsabilidades en portal''']]

Posteriormente seleccione la opción de guardar para que dicha modificación se realice satisfactoriamente.

<includeonly>=</includeonly>==Rechazo: NIT XXXXXXXXX no autorizado a enviar documentos para emisor con NIT XXXXXXXXX==<includeonly>=</includeonly>
De acuerdo al error que presenta es posible que la asociación del proveedor tecnológico en el portal de habilitación de la DIAN puedo tener un problema. 

Se recomienda que ingrese al portal de habilitación, elimine los modos de operación, y vuelva a agregar el modo de operación Proveedor tecnológico - TFHKA en el portal de la Dian; luego actualice el '''TestSetID''' en los rangos de numeración en nuestro portal. 

Luego de realizar las configuraciones antes mencionadas en el portal HKA, intente emitir los documentos nuevamente. 

Se adjunta un video de asesoría NUEVO donde se explican las diferencias entre los ambiente DEMO y PRODUCCIÓN que entrega The Factory HKA a sus clientes. 

Adicional a esto, el video explica paso a paso a seguir para tener acceso al ambiente DEMO su posterior pase a PRODUCCIÓN, y los pasos necesarios ante la DIAN para actualizar el REGISTRO y PRUEBAS DE HABILITACIÓN, y en qué ambiente deben ser realizados en nuestros sistemas. 

Link video de asesoría: https://drive.google.com/file/d/1tslrefpqizIVnuYha8QAXUeGCgje5hbS/view

<includeonly>=</includeonly>==Configuración de secuenciales==<includeonly>=</includeonly>
En esta sección se muestran todos sus secuenciales configurados, los establecimientos a los que han sido agregados e información como fechas de vigencia y tipo de servicio. 

De igual forma podrá gestionar sus secuenciales, consultar la información configurada y si lo desea podrá inactivar secuenciales que ya no tendrán uso. 

Además podrá agregar secuenciales según el tipo de documento que desee emitir. 

En la pantalla Agregar Numeración Secuencial, el portal realizará una consulta a la DIAN con su número de identificación para la carga de sus secuenciales disponibles según el número de resolución, el mismo cargará los rangos de numeración, vigencia, prefijo y clave técnica.

[[Archivo:secEnPortal.png|centro|'''Gestión de secuenciales en portal''']]

===Agregar un secuencial===
Presionando Agregar secuencial emergerá otra pantalla. Ver imagen 306. Los datos disponibles para el registro del secuencial son:

* Tipo de servicio: Tipo de servicio de emisión de documentos (Habilitación o Producción 2.1).
* Tipo de Documento: Tipos de documentos (Factura, Nota de crédito, Nota de débito).
* Tipo de Operación: Operación que se va asociar al tipo documento (Venta/Exportación y Contingencia).
* Tipo de servicio: Servicio por donde se va gestionar el documento (Portal, Servicio de integración, App Móvil).
* Modalidad de Uso para Secuencial: Modo de uso, (Automático, Manual sin prefijo, Manual con prefijo).
* Establecimiento: Se listaran los establecimientos registrados en Catálogo Establecimiento.
* Número de la resolución: es el número obtenido cuando se solicita la numeración de factura electrónica. El portal deberá realizar la consulta a la DIAN, si se estableció la conexión se debe mostrar todas las resoluciones asociadas al cliente en un combo lista. Si no se pudo establecer la conexión debe ser ingresado manualmente
* Prefijo: se listara según la resolución seleccionada, siendo éste una serie de un máximo de 6 caracteres alfabética, numérica o alfanumérica que llevará en el inicio al número consecutivo del documento, es recomendable no duplicar la serie por otra ya existente con mismo o diferente tipo servicio.
* El Valor del rango desde y el valor del rango hasta: Es la numeración que debe ser válida otorgada por la DIAN.
: '''nota:''' cuando se haya agotado el rango de numeración que le fue asignado y se deba solicitar la autorización de uno nuevo este debe ser la continuación de un rango ya autorizado.
* El Valor del rango inicial: Es el valor inicial de facturas del secuencial seleccionado, este valor debe ser igual o mayor al valor del rango desde y menor al valor del rango hasta.
: '''nota:''' si se requiere los secuenciales se puede configurar de forma compartido por varios tipos de servicio, es decir; si dispone 200 secuenciales puede registrar para Portal 100, Servicio de integración 50, APP Móvil 50. Esto depende de las aplicaciones disponibles del cliente.
* La fecha inicio y fecha fin: Es el rango de fecha valida otorgado por la DIAN.
* Clave técnica: Es generada por la DIAN en caso de fallas de comunicación debe ser solicitada a The Factory HKA Colombia SAS y solo su Proveedor Tecnológico la puede consultar.
* SetTestID (Solo Habilitación): Es generada por la DIAN. Esta información se encuentra disponible en el Portal de Habilitación de la DIAN (dian.gov.co) en la sección '''"Tablero"'''.

[[Archivo:agregarNumerSecuEnPortal.png|centro|'''Agregar numeración secuencial''']]

<includeonly>=</includeonly>==Transmisión de Documentos de prueba a la DIAN en ambiente DEMO==<includeonly>=</includeonly>
En estos momentos se encuentra funcional la emisión de documentos de pruebas ('''ambiente DEMO''') directamente contra la DIAN, es decir, poder realizar pruebas de integración desde su ERP con el 100% de validaciones DIAN sin pasar por el XSLT local.

Para reproducir este escenario de pruebas se debe tener en cuenta la siguiente configuración en el portal web DEMO:

https://demofactura.thefactoryhka.com.co/auth/login --> URL Portal DEMO

Configuración en el portal web:
: '''Paso 1:''' El cliente Emisor debe verificar que en los Datos Fiscales se encuentre configurado su NIT, independientemente si posee cargado el certificado propio o el de The factory HKA:

[[Archivo:validarDatFiscalesPortal.png|centro|'''Validación de NIT''']]

: '''Paso 2:''' Se debe tener solicitado la resolución de habilitación otorgada por la DIAN (resolución para set de pruebas de habilitación), esta resolución debe ser configurada en el portal web DEMO como se muestra en la siguiente imagen (tener en cuenta que la modalidad puede ser 'Manual con Prefijo' o 'Manual sin Prefijo', esto depende del ERP):

[[Archivo:configResolPortal.png|centro|'''Configuración y validación de resolución para set de pruebas''']]

'''@Importante:''' El secuencial debe estar configurado con tipo de ambiente Producción2.1, por lo tanto no se deberá ingresar el campo setTestID.

: '''Paso 3:''' Solicitar a través de correo al equipo de Integración ó Soporte la '''activación''' del secuencial creado previamente en en portal DEMO con la opción de envió a la DIAN:

* integracion_fel_co@thefactoryhka.com
* soporte_fel_co@thefactoryhka.com

En el correo se deberá indicar NIT del Emisor y prefijo configurado, que pueden ser SETT o SETP dependiendo del prefijo que la DIAN otorgó al Emisor para su habilitación.

<includeonly>=</includeonly>==Generar código QR en documentos en el documento en papel generado desde el ERP durante la contingencia tipo '03'==<includeonly>=</includeonly>
Para la generación del Código de respuesta rápido – Código QR, en los casos que la factura de venta de talonario o de papel se genere a través de sistemas informáticos electrónicos deberán corresponder a la siguiente tabla:

[[Archivo:codQrDetalle.png|centro|'''Detalle de Código QR''']]

<pre>
Ejemplo:
NumFac: CTG2
FecFac: 2020-06-16
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 1003.00
ValIva: 190.57
ValOtroIm: 0.00
ValTolFac: 1193.57
</pre>

<includeonly>=</includeonly>==Generación de documentos electrónicos para 'Consumidor final'==<includeonly>=</includeonly>
En estos momentos TFHKA_CO se encuentra implementado el nodo PartyIdentification en UBL, por lo cual para facturas generadas a personas naturales se retorna la regla FAK61 como notificación.

[[Archivo:docElectrConsumFinal.png|centro|'''Documentos Electrónicos para Consumidor Final''']]

Los ejemplos para este escenario se encuentran en los Request-SOAP, a continuación:

https://drive.google.com/drive/folders/1lT0TnDhigCpMx5xsQHcHLWNkiQIN45Pc

'''Nota:''' Este ajuste debe generarse desde TFHKA. Lo anterior es el ejemplo sobre cómo manejar el escenario de consumidor final desde el ERP, y de esta forma cuando TFHKA informe a la DIAN el nodo PartyIdentification este ajuste sea un cambio silente para las integraciones. Este cambio debe estar funcional en producción por parte de TFHKA antes del 1 de agosto de 2020.

<includeonly>=</includeonly>==Uso de archivos .ZIP en Correos==<includeonly>=</includeonly>
Por defecto se enviará en el correo como adjunto un archivo .Zip que contiene el xml-AttachedDocument (obligatorio), PDF de la representación gráfica (obligatorio), .Zip con adjuntos (opcional).
Ejemplo:

[[Archivo:zipEnCorreos.png|centro|'''Uso de .Zip en correos''']]

===Contenido del .Zip con adjuntos===
[[Archivo:zipConAdjuntos.png|centro|'''Con Adjuntos''']]

===Contenido del .Zip sin adjuntos===
[[Archivo:zipSinAjduntos.png|centro|'''Sin Adjuntos''']]

<includeonly>=</includeonly>==Como enviar el correo con el método tradicional==<includeonly>=</includeonly>
Se podrá optar como segunda opción continuar enviando el correo con el '''método tradicional''' actual, para esto desde la integración con el ERP se deberá indicar a través del campo Extra 100500, ejemplo:

[[Archivo:envCorreoMetTrad.png|centro|'''Enviar el correo con el método tradicional''']]

'''@Importante1:''' El tamaño máximo de todos los adjuntos que se carguen al documento no debe superar los 2 MB.

'''@Importante2:''' El nombre del xml-AttachedDocument y PDF de la representación gráfica deben ser iguales, por lo tanto para las integraciones que generan R.G de manera local (adjuntos = 11) pueden leer este nombre de la respuesta del método Enviar->parámetro nombre.

<includeonly>=</includeonly>==Consideraciones sobre Uso del .ZIP en el correo con adjuntos en 11==<includeonly>=</includeonly>
Al momento de sincronizar o cargar el adjunto, se contemplan dos tipos de anexos:
===CargarAdjunto.tipo = 1:===
Indica al web services de adjuntos que es una representación gráfica, estos hará que nuestra plataforma renombre y coloque en él .Zip principal el PDF de la R.G local, de lo contario estará colocando el PDF en él .Zip de adjuntos y esto puede tener complicaciones al momento de la recepción.

Ejemplo:
[[Archivo:cargaAdjuntoTip1.png|centro|'''Ejemplo para tipo 1''']]

===CargarAdjunto.tipo = 2:===
Indicar al web services de adjuntos que es un anexo común.

Ejemplo:
[[Archivo:cargaAdjuntoTip2.png|centro|'''Ejemplo para tipo 2''']]

<includeonly>=</includeonly>==Informar direcciones del adquiriente o receptor del documento electrónico==<includeonly>=</includeonly>
Para este escenario, recomendamos revisar los ejemplos Request-SOAP asociados a direcciones, en los que se detalla cómo no reportar direcciones y en caso de que se reporten cuáles son los campos mínimos obligatorios para clientes nacionales y del extranjero (tipo exportación).

La zona postal pasará a ser opcional, es decir este campo debe ser null o enviarse vació en caso de que no se conozca, ejemplo direccionCliente.zonaPostal = null o direccionCliente.zonaPostal = '', si a partir del 1 de agosto se envía la zona postal en '000000' o un código fuera del catálogo será motivo de rechazo en la DIAN.

<includeonly>=</includeonly>==Responsabilidades Fiscales y Tipos de operación==<includeonly>=</includeonly>
A partir del 1 de agosto deberá informarse en responsabilidadesRut.Obligaciones.obligaciones y FacturaGeneral.tipoOperacion solo los siguientes códigos (cualquier otro código informado puede ser motivo de rechazo en la DIAN):

[[Archivo:respoFiscaTipOpera.png|centro|'''Responsabilidades Fiscales y Tipos de operación''']]

Preguntas Frecuentes de Integración con servicio Web (Val. Previa)

2020-09-18T21:25:11Z

Fpinto:

<includeonly>=</includeonly>==Historial de versiones==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Versión
! style="background:#e9e9e9; text-align:center;"|Fecha lanzamiento
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| 0
| 07/05/2019
|
* Versión Preliminar.
|}
<includeonly>=</includeonly>==Cómo obtener soporte==<includeonly>=</includeonly>
*Soporte de 1er nivel:
::Soporte telefónico / email / chat o tele-conferencias en horario 5x8 para atención de consultas y fallas de usuario.
*Soporte de 2do nivel:
::Soporte resolución remota de incidencias en el sistema en horario 5x8
::::Llame a nuestro CENTRO DE ATENCIÓN +(57) 1 311.31.12 
::::Escriba a [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Visítenos el sitio Web: https://www.thefactoryhka.com/co
{{clear}}
<includeonly>=</includeonly>==Ambiente de HABILITACIÓN ==<includeonly>=</includeonly>
El proceso en el ambiente de habilitación es asíncrono por lo que primero es recibido por The Factory HKA y luego en una tarea secundaria buscando las condiciones óptimas de conexión con la DIAN los mismos son enviados a la entidad tributaria.
Secuencia del servicio asíncrono:
* El software cliente realiza la conexión, autenticación por medio de certificado digital, enviando la solicitud (Request) al servicio de la DIAN.
* El WS DIAN recibe la solicitud y responde con un mensaje de aprobación o rechazo, según las primeras validaciones y entrega un trackId.
* El software cliente, al obtener la respuesta, cierra la conexión.
* Con el trackId obtenido en el método, se consume otro método de consulta para obtener el resultado de la transacción anterior.

<includeonly>=</includeonly>==Transmisión de documentos de contingencia tipo 03 (path additionaldocumentreference)==<includeonly>=</includeonly>
Los inconvenientes tecnológicos por parte del facturador electrónico implican que la facturación electrónica tenga las siguientes características:
* Generar la facturación con numeración de contingencia en papel o por computador.
* El facturador tendrá 30 días (48 horas en la última resolución) a partir de la fecha en que supera la contingencia para transmitir las facturas electrónicas en formato XML a la DIAN.
* Las facturas electrónicas generadas y emitidas en contingencia pasarán la malla de validaciones de anexo, es decir, la DIAN responderá con un Application Response de Documento Validado por la DIAN, que informará las notificaciones a que haya lugar.
* Una vez el facturador electrónico salga de contingencia deberá proceder al proceso de generación normal.
* Para los documentos de notas crédito y notas débito, el facturador NO debe usar la numeración de contingencia, sino el consecutivo propio normal. Las notas enviadas a la DIAN se validarán de manera normal en la DIAN. Por lo anterior, no existe el concepto de nota en contingencia, por lo que debe cuidarse enviar primeramente las Facturas de Contingencia antes de generar notas sobre las mismas y se recomienda generarlas en un ambiente de operación normal.

===¿Cómo transmitir un documento de contingencia Tipo 03?===
La transmisión del documento se realiza por medio del método Enviar del Web Service de Emisión que brinda The Factory HKA, indicando el atributo tipoDocumento del objeto FacturaGeneral igual a ‘03’ y enviar en la sección de documentosReferenciados un objeto de tipo DocumentosReferenciados indicando lo siguiente:
* codigoInterno = ‘1’
* fecha = ‘Fecha de emisión del documento de contingencia’
* numeroDocumento = ‘número del consecutivo del documento de contingencia emitido’
* tipoCodigoDocumento = ‘Tipo de documento de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico a transmitir, según lo estipulado en el numeral 12.1.4 de la versión 1.8 del Anexo Técnico de la DIAN ’.

{| class="wikitable" style="width: 80%;"
|+ Tipos de documentos de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico
! style="color:black;background:#f2f2f2; text-align:center;"|Código
! style="color:black;background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|FTC
|Factura Talonario Contingencia
|-
|FTP
|Factura Talonario Papel
|-
|FTPC
|Factura Talonario por Computador
|}
===¿Cuál será el código de respuesta de transmisión exitosa que retornará el WS de TFHKA?===
El método Enviar retornará código 201 ó 208 ante la recepción exitosa del documento en nuestra plataforma, con el siguiente mensaje: “El documento se recibió como Documento Electrónico de Contingencia Tipo 03, este se entregará de manera asíncrona a la DIAN, para más información favor consumir '''EstadoDocumento''' luego de 48 horas.” En dicho Response se contará con CUDE y UBL.

===¿Cuándo puedo consultar el resultado de la transmisión del documento hacia la DIAN?===
Pasadas 48 horas luego de la radicación del documento en la plataforma, pueden consultar el estatus del mismo para conocer el resultado de la transacción ante la DIAN.

===Ejemplo SOAP Request de Factura de Contingencia Tipo 03:===
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Ver ejemplo:</div>
<div class="mw-collapsible-content">

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales>
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>email1@thefactoryhka.com</arr:string>
<arr:string>email2@thefactoryhka.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos>
<codigoImpuesto>ZY</codigoImpuesto>
</Tributos>
</detallesTributarios>

<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<direccionFiscal>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionFiscal>
<email>email@thefactoryhka.com</email>

<informacionLegalCliente>
<nombreRegistroRUT>CONSORCIO ALIANZA SAN CRISTOBAL 4</nombreRegistroRUT>
<numeroIdentificacion>901041710</numeroIdentificacion>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<tipoIdentificacion>31</tipoIdentificacion>
</informacionLegalCliente>
<nombreRazonSocial>The Factory HKA Colombia</nombreRazonSocial>
<notificar>SI</notificar>
<numeroDocumento>901041710</numeroDocumento>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>31</tipoIdentificacion>
<tipoPersona>1</tipoPersona>
</cliente>
<consecutivoDocumento>PREFIJOCONSECUTIVO</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadPorEmpaque>1</cantidadPorEmpaque>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>P000001</codigoProducto>
<descripcion>Impresora HKA80</descripcion>
<descripcionTecnica>Impresora térmica de punto de venta, ideal para puntos de venta con alto rendimiento</descripcionTecnica>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>PHKA80</estandarCodigoProducto>
<impuestosDetalles>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosDetalles>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<marca>HKA</marca>
<muestraGratis>0</muestraGratis>
<precioTotal>1193.57</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura></pre>
<pre style="color: red">
<documentosReferenciados>

<DocumentoReferenciado>
<codigoInterno>1</codigoInterno>
<fecha>2020-01-01</fecha>
<numeroDocumento>CTG12</numeroDocumento>

<tipoDocumentoCodigo>FTC</tipoDocumentoCodigo>
</DocumentoReferenciado>
</documentosReferenciados></pre>
<pre>
<fechaEmision>2020-01-08 00:00:00</fechaEmision>
<impuestosGenerales>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<unidadMedida>WSD</unidadMedida>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosGenerales>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-RANGODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado></pre>
<pre style="color: red">
<tipoDocumento>03</tipoDocumento></pre>
<pre>
<tipoOperacion>10</tipoOperacion>
<totalBaseImponible>1003.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</pre>
</div></div>

@IMPORTANTE: No es requerido que se notifique a los adquirientes los documentos de contingencia transmitidos a la DIAN, ya que el documento entregado físicamente al mismo durante el período en que mantuvo la contingencia, corresponde al documento legal de la transacción realizada. La transmisión de dicha información a la DIAN es con el fin de notificar al ente regulador las transacciones realizadas durante dicho periodo. Por lo anteriormente descrito, se recomienda enviar el campo notificar = ‘NO’ y no realizar el envío de la información correspondiente al Destinatario:

<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Ver ejemplo:</div>
<div class="mw-collapsible-content">

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales></pre>
<pre style="color: red">
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>email1@thefactoryhka.com</arr:string>
<arr:string>email2@thefactoryhka.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos>
<codigoImpuesto>ZY</codigoImpuesto>
</Tributos>
</detallesTributarios>

<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<direccionFiscal>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionFiscal>
<email>email@thefactoryhka.com</email>

<informacionLegalCliente>
<nombreRegistroRUT>CONSORCIO ALIANZA SAN CRISTOBAL 4</nombreRegistroRUT>
<numeroIdentificacion>901041710</numeroIdentificacion>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<tipoIdentificacion>31</tipoIdentificacion>
</informacionLegalCliente>
<nombreRazonSocial>The Factory HKA Colombia</nombreRazonSocial>
<notificar>NO</notificar>
<numeroDocumento>901041710</numeroDocumento>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>31</tipoIdentificacion>
<tipoPersona>1</tipoPersona>
</cliente></pre>
<pre>
<consecutivoDocumento>PREFIJOCONSECUTIVO</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadPorEmpaque>1</cantidadPorEmpaque>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>P000001</codigoProducto>
<descripcion>Impresora HKA80</descripcion>
<descripcionTecnica>Impresora térmica de punto de venta, ideal para puntos de venta con alto rendimiento</descripcionTecnica>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>PHKA80</estandarCodigoProducto>
<impuestosDetalles>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosDetalles>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<marca>HKA</marca>
<muestraGratis>0</muestraGratis>
<precioTotal>1193.57</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura>
<documentosReferenciados>

<DocumentoReferenciado>
<codigoInterno>1</codigoInterno>
<fecha>2020-01-01</fecha>
<numeroDocumento>CTG12</numeroDocumento>

<tipoDocumentoCodigo>FTC</tipoDocumentoCodigo>
</DocumentoReferenciado>
</documentosReferenciados>
<fechaEmision>2020-01-08 00:00:00</fechaEmision>
<impuestosGenerales>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<unidadMedida>WSD</unidadMedida>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosGenerales>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-RANGODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>
<tipoDocumento>03</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<totalBaseImponible>1003.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</pre>
</div></div>

<includeonly>=</includeonly>==Campos extensibles en R.G estándar==<includeonly>=</includeonly>

El '''valor''' de estos campos es texto plano, por lo tanto el formato es gestionado desde el ERP.
* TOTAL Descuento Detalle (Campo Extensible 5170001).
* Total Base Excluida (Campo Extensible 5170000)
* TOTAL Retenciones (Campo Extensible 5170002)
* TOTAL a Pagar (Campo Extensible 5170003)
* TOTAL A PAGAR en Letras (Campo Extensible 5170004)

===Ejemplo sobre la estructura de los campos:===
<pre>
<extras>
<Extras>
<controlInterno1>Total Base Excluida</controlInterno1>
<controlInterno2/>
<nombre>5170000</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL Descuento Detalle</controlInterno1>
<controlInterno2/>
<nombre>5170001</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL Retenciones</controlInterno1>
<controlInterno2/>
<nombre>5170002</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL a Pagar</controlInterno1>
<controlInterno2/>
<nombre>5170003</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>
</extras>
</pre>
En la Representación Gráfica se visualizará de la siguiente manera:

[[Archivo:visualizaRGcamposExtras.png|centro|'''Campos extensibles en representación grpafica estándar''']]

<includeonly>=</includeonly>==Estructura del QR de acuerdo al Anexo 1.8==<includeonly>=</includeonly>
Para la representación gráfica de las facturas electrónicas, es requisito la generación de un código QR con la siguiente información:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:black;background:#FFD966; text-align:center;"|Detalle
! style="color:black;background:#FFD966; text-align:center;"|XPath
|- valign="center"
|-
|NumFac: [NUMERO_FACTURA]
|/Invoice/cbc:ID
|-
|FecFac: [FECHA_FACTURA]
|/Invoice/cbc:IssueDate
|-
|HorFac: [HORA_FACTURA(con GMT)]
|/Invoice/cbc:IssueTime
|-
|NitFac: [NIT FACTURADOR]
|/Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|DocAdq: [NUMERO_ID_ADQUIRENTE]
|/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|ValFac: [VALOR_FACTURA]
|/Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount
|-
|ValIva: [VALOR_IVA]
|/Invoice/cac:TaxTotal/cbc:TaxAmount Donde /Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
|-
|ValOtroIm: [VALOR_OTROS_IMPUESTOS]
|Sumatoria de /Invoice/cac:TaxTotal[X]/cbc:TaxAmount[X] Donde /Invoice/cac:TaxTotal[X]/cac:TaxSubtotal[X]/cac:TaxCategory[X]/cac:TaxScheme[X]/cbc:ID[X] sea diferente a 01
|-
|ValTolFac: [VALOR_TOTAL_FACTURA
|/Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount
|-
|CUFE
|/Invoice/cbc:UUID
|-
|QRCode
|/Invoice/ext:UBLExtensions[1]/ext:UBLExtension[1]/ext:ExtensionContent[1]/sts:DianExtensions[1]/sts:QRCode
|}
Debe tener las siguientes consideraciones:

: '''NitFac:''' sin puntos ni guiones
: '''DocAdq:''' sin puntos ni guiones
: '''ValFac:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValIva:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValOtroIm:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValTolFac:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''QRCode:''' URL disponible por la DIAN
:* Ambiente Habilitación: https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=CUFE
:* Ambiente Producción: https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUFE

===Ejemplo sobre la estructura de los campos:===
Teniendo en cuenta los datos de entrada, se presenta el código QR que se incluye en la representación gráfica de la factura electrónica:
<pre>
<a:qr>
NumFac: VAF472
FecFac: 2019-12-20
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 2006.00
ValIva: 381.14
ValOtroIm: 0.00
ValTolFac: 2387.14
CUFE: 95d062a141ff0f1a55f9f684167e00544617f4ed714b283934ad939fc056c6fb2ae6ab34ad8ba9a9db94aa2c253d3c05
https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=95d062a141ff0f1a55f9f684167e00544617f4ed714b283934ad939fc056c6fb2ae6ab34ad8ba9a9db94aa2c253d3c05
</a:qr>
</pre>

<includeonly>=</includeonly>==Campos de direcciones mínimos para evitar rechazo FAK08==<includeonly>=</includeonly>
Esto se debe a que la DIAN está validando que se envíen obligatoriamente los campos '''ciudad''', '''codigoDepartamento''', '''departamento''', '''dirección''', '''municipio''' y '''país''' en la dirección del cliente.

<includeonly>=</includeonly>==Configuración de direcciones en el portal para evitar rechazo FAJ09, FAJ16, FAJ12.==<includeonly>=</includeonly>
: 1. Deben validar que en nuestro portal web en la sección '''Catálogos->Establecimientos''', la dirección física del establecimiento se encuentre correctamente configurada:

[[Archivo:CatálogosEstablecimientosPortal.png|centro|'''Catálogos->Establecimientos''']]

: 2. Validar que la dirección fiscal o dirección física del receptor está correctamente construida mínimo con lo siguiente:

[[Archivo:direccionFiscalFisicaMinima.png|centro|'''Campos mínimos en dirección fiscal y dirección física''']]

<includeonly>=</includeonly>==Concatenación de nombre + apellido en campo nombreRazonSocial==<includeonly>=</includeonly>
En este caso, se recomienda enviar el nombre completo (Nombres y apellidos) en el atributo '''nombreRazonSocial''' del objeto factura y dejar vacíos los campos '''apellido y segundoNombre'''.

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que afecten a facturas de validación previa==<includeonly>=</includeonly>
Para la emisión de Notas de Crédito y Débito deben enviarse obligatoriamente dos arreglos de documentos referenciados, el primero indicando el codigoInterno = '4' el cual corresponde a los motivos por los cuales se genera la NC/ND ('''DiscrepancyResponse''') y un segundo arreglo, indicando el codigoInterno = '5' en el cual se reflejan los datos de la factura afectada por la NC/NC ('''BillingReference''').
Como se muestra a continuación:
<pre>
<a:documentosReferenciados>
<a:DocumentoReferenciado>
<a:codigoEstatusDocumento>2</a:codigoEstatusDocumento>
<a:codigoInterno>4</a:codigoInterno>
<a:cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1EkRoFzzvJqHhKqk5JpLSqtJ99pRMd32g40baab6b59cdc8b3</a:cufeDocReferenciado>
<a:descripción>
<b:string>Anulación de factura electrónica</b:string>
</a:descripción>
<a:extras i:nil="true"/>
<a:fecha>2019-10-07</a:fecha>
<a:fechaFinValidez i:nil="true"/>
<a:fechaInicioValidez i:nil="true"/>
<a:numeroDocumento>F4PM3</a:numeroDocumento>
<a:tipoCUFE i:nil="true"/>
<a:tipoDocumento i:nil="true"/>
<a:tipoDocumentoCodigo i:nil="true"/>
</a:DocumentoReferenciado>
<DocumentoReferenciado>
<codigoInterno>5</codigoInterno>
<cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1KqmCLKgxPpH6u5LiKrJvTb6FEyfVuoCcV0baab6b59cdc8b3</cufeDocReferenciado>
<fecha>2019-10-07</fecha>
<numeroDocumento>F4PM3</numeroDocumento>
</DocumentoReferenciado>
</a:documentosReferenciados>
</pre>
En el caso de la dll, basta con enviar cada arreglo separado por el carácter "%", por ejemplo:

ID02E = "02E|2|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954||||ASFF10|||01|||||¬02E1|Prueba NC Campos Minimos con Anulación de factura electrónica"+ "%" +"02E||5|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|||ASFF10|CUFE-SHA384||01|||||"

Esto se visualiza en la representación gráfica de la siguiente forma:

[[Archivo:DocRefNotasFactValPrev.png|centro|'''Documentos referenciados en representación gráfica''']]

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior==<includeonly>=</includeonly>
Tener en cuenta que para cada escenario se debe indicar correctamente el campo '''tipoOperacion''':
* Código '''23''' para '''Notas Crédito'''.
* Código '''33''' para '''Notas Débito'''.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:23-33-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png|800px|sinmarco|centro|Campo FacturaGeneral.tipoOperacion que afectan facturas de validación posterior]]

Para la emisión de Notas de Crédito y Débito deben enviarse obligatoriamente dos arreglos indicando el '''DiscrepancyResponse''' y el '''BillingReference'''.

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que no afecten a facturas==<includeonly>=</includeonly>
Tener en cuenta que para cada escenario se debe indicar correctamente el campo '''tipoOperacion''':
* Código '''22''' para '''Notas Crédito'''.
* Código '''32''' para '''Notas Débito'''.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:22-32-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png|800px|sinmarco|centro|Campo FacturaGeneral.tipoOperacion que no afectan facturas]]

@IMPORTANTE: La clase Documentos Referenciados debe enviarse en null.

<includeonly>=</includeonly>==Error 101 token emisor inválido==<includeonly>=</includeonly>
El código de Error '''101''' hace referencia a un inconveniente en la configuración de los tokens y URL en su sistema. Por favor, validar en la configuración del ERP que se encuentran configurados correctamente estos dos puntos dependiendo del ambiente en el cual desean realizar las emisiones de documentos:

'''URL Ambiente Demo''' (ambiente de pruebas en el cual las emisiones no son transmitidas a la DIAN):
<pre>
Servicio Emisión:
http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl

Servicio Adjuntos:
http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsd

Servicio Reportes:
http://demoemision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl
</pre>
'''URL Ambiente Productivo''' (ambiente en el cual se realizan las emisiones correspondientes al set de habilitación y posteriormente la emisión de documentos en operación):
<pre>
Servicio Emisión (HTTPS):
https://emision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl

Servicio Adjuntos (HTTPS):
https://emision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl

Servicio Reportes (HTTPS)
https://emision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl
</pre>

<includeonly>=</includeonly>==Mostrar dirección completa en la representación gráfica==<includeonly>=</includeonly>
Dicha información se debe enviar a través del atributo [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|'''DireccionCliente''']]

[[Archivo:Mostrar dirección completa en la representación gráfica.png|centro|'''Clase direccionCliente''']]

Los campos necesarios para que se muestre en la representación gráfica son los siguientes:

[[Archivo:camposDireccionRepGraf.png|centro|'''Campos necesarios para representación gráfica''']]

En la representación gráfica se mostraría de la siguiente manera:

[[Archivo:dirección completa en la representación gráfica.png|centro|'''Representación gráfica con campos los necesarios''']]

<includeonly>=</includeonly>==Regla: FAW01, Rechazo: Línea de factura informado con LineExtensionAmount en cero y grupo cac:PricingReference no informado==<includeonly>=</includeonly>
Este error surge cuando la DIAN recibe un UBL indicando que la base imponible de un elemento a nivel de línea es 0 y la validación rechaza el documento. En el caso de estar enviando una muestra se deben enviar los campos obligatoriamente: '''codigoTipoPrecio, muestraGratis, precioReferencia, precioTotal, precioTotalSinImpuestos'''.

<includeonly>=</includeonly>==Envío de representación gráfica personalizada==<includeonly>=</includeonly>
La emisión con adjuntos se realiza en dos pasos. El primero consiste en generar el UBL fiscal a través de la url de emisión (http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl en ambiente Demo)

En este caso, se debe indicar en el método Enviar el parámetro adjunto en 11 para indicarle al servicio que no se genere nuestra representación gráfica estándar y adicionalmente que el documento no se envíe por correo hasta que no se realice la carga de adjuntos.

[[Archivo:tabRequestParamEnviar.png|centro|'''Descripción de parámetros a Enviar''']]

Posteriormente, debe consumirse el método CargarArchivo a traves de la url de adjunto (http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl en ambiente Demo)

Este método presenta los siguientes campos

[[Archivo:tabCamposParamEnviar.png|centro|'''Descripción de campos en parámetros a Enviar''']]

Dónde Class.Adjunto contiene la siguiente información:

[[Archivo:tabClaseAdjuntos.png|centro|'''Descripción de Class.Adjunto''']]

RESPONSE: Parámetros a Recibir

[[Archivo:tabResponseParamRecibir.png|centro|'''Descripción de parámetros a Recibir''']]

@IMPORTANTE: Si un documento queda a la espera de adjuntos, no se enviará el correo de notificación hasta que no se realice el cargue de los archivos anexos.

<includeonly>=</includeonly>==Correo electrónico personalizado==<includeonly>=</includeonly>
El objeto “extras” también permite manejar algunas funcionalidades especiales de la plataforma, como la de correo electrónico personalizado. Para que esta información no aparezca en la representación gráfica, el parámetro pdf del objeto “extras” debe ir en “0”.

La funcionalidad de correo electrónico personalizado permite configurar transacción a transacción el asunto, la dirección de respuesta y el cuerpo del correo electrónico. La vía para exponer esta información será a través de campos extensibles.

[[Archivo:tabCampsExtensiblesCorreoPers.png|centro|'''Descripción de campos extensibles para correo electrónico personalizado''']]

===Ejemplo de uso de Campos Extensibles 11,13 y 14 para personalizar el Correo Electrónico:===

[[Archivo:ejemXMLCamposExtensiblesCorreoPers.png|centro|'''Ejemplo XML''']]

Tomando el ejemplo dado el correo se visualizará de la siguiente manera:

[[Archivo:ejembandejaCorreoCamposExtensiblesCorreoPers.png|centro|'''Factura electrónica en bandeja de correo''']]

<includeonly>=</includeonly>==Radicar documentos electrónicos en plataformas de recepción==<includeonly>=</includeonly>
Aclaramos la situación, indicando que el el XML que se debe radicar en las plataformas de recepción es el que nuestro servicio envía en la notificación de correo llamado AttachedDocument (Contenedor de Documentos), la estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha, este XML también puede ser descargado a través del método GenerarContenedor

[[Archivo:radicarDocumentos.png|centro|'''Documentos electrónicos en plataformas de recepción''']]

'''Nota:''' Si usted es cliente final, por favor comunicar lo anterior a su casa de software o proveedor de ERP.

<includeonly>=</includeonly>==Regla [FAJ26], Rechazo: No indica un valor autorizado==<includeonly>=</includeonly>
En el catálogo/cliente y en datos fiscales de la empresa, valide que en el campo de responsabilidades no se encuentre seleccionada las siguientes opciones:
# O-47 Régimen Simple de Tributación – SIMPLE.
# O-48 Impuesto sobre las ventas.
# O-49 No responsable de IVA.
# O-52 Facturador electrónico.

Ya que el error de validación que está presentando es debido a que la DIAN no ha actualizado los catálogos donde se incluyen estos nuevos elementos, y por eso están siendo rechazados. Se recomienda retirarlos temporalmente hasta que la DIAN permita su uso.

Dicha modificación la puede realizar en nuestro portal de la siguiente manera:

En la opción de Datos fiscales/ Información Adicional/Responsabilidades debe tener configurado la responsabilidad Responsabilidad sobre las ventas(O-48)

[[Archivo:editarPortalResponsabilidades.png|centro|'''Opción de edición de Responsabilidades en portal''']]

Debe destildar esa opción en la sección Responsabilidades:

[[Archivo:editarPortalRespOpciones.png|centro|'''Modificación de Responsabilidades en portal''']]

Posteriormente seleccione la opción de guardar para que dicha modificación se realice satisfactoriamente.

<includeonly>=</includeonly>==Rechazo: NIT XXXXXXXXX no autorizado a enviar documentos para emisor con NIT XXXXXXXXX==<includeonly>=</includeonly>
De acuerdo al error que presenta es posible que la asociación del proveedor tecnológico en el portal de habilitación de la DIAN puedo tener un problema. 

Se recomienda que ingrese al portal de habilitación, elimine los modos de operación, y vuelva a agregar el modo de operación Proveedor tecnológico - TFHKA en el portal de la Dian; luego actualice el '''TestSetID''' en los rangos de numeración en nuestro portal. 

Luego de realizar las configuraciones antes mencionadas en el portal HKA, intente emitir los documentos nuevamente. 

Se adjunta un video de asesoría NUEVO donde se explican las diferencias entre los ambiente DEMO y PRODUCCIÓN que entrega The Factory HKA a sus clientes. 

Adicional a esto, el video explica paso a paso a seguir para tener acceso al ambiente DEMO su posterior pase a PRODUCCIÓN, y los pasos necesarios ante la DIAN para actualizar el REGISTRO y PRUEBAS DE HABILITACIÓN, y en qué ambiente deben ser realizados en nuestros sistemas. 

Link video de asesoría: https://drive.google.com/file/d/1tslrefpqizIVnuYha8QAXUeGCgje5hbS/view

<includeonly>=</includeonly>==Configuración de secuenciales==<includeonly>=</includeonly>
En esta sección se muestran todos sus secuenciales configurados, los establecimientos a los que han sido agregados e información como fechas de vigencia y tipo de servicio. 

De igual forma podrá gestionar sus secuenciales, consultar la información configurada y si lo desea podrá inactivar secuenciales que ya no tendrán uso. 

Además podrá agregar secuenciales según el tipo de documento que desee emitir. 

En la pantalla Agregar Numeración Secuencial, el portal realizará una consulta a la DIAN con su número de identificación para la carga de sus secuenciales disponibles según el número de resolución, el mismo cargará los rangos de numeración, vigencia, prefijo y clave técnica.

[[Archivo:secEnPortal.png|centro|'''Gestión de secuenciales en portal''']]

===Agregar un secuencial===
Presionando Agregar secuencial emergerá otra pantalla. Ver imagen 306. Los datos disponibles para el registro del secuencial son:

* Tipo de servicio: Tipo de servicio de emisión de documentos (Habilitación o Producción 2.1).
* Tipo de Documento: Tipos de documentos (Factura, Nota de crédito, Nota de débito).
* Tipo de Operación: Operación que se va asociar al tipo documento (Venta/Exportación y Contingencia).
* Tipo de servicio: Servicio por donde se va gestionar el documento (Portal, Servicio de integración, App Móvil).
* Modalidad de Uso para Secuencial: Modo de uso, (Automático, Manual sin prefijo, Manual con prefijo).
* Establecimiento: Se listaran los establecimientos registrados en Catálogo Establecimiento.
* Número de la resolución: es el número obtenido cuando se solicita la numeración de factura electrónica. El portal deberá realizar la consulta a la DIAN, si se estableció la conexión se debe mostrar todas las resoluciones asociadas al cliente en un combo lista. Si no se pudo establecer la conexión debe ser ingresado manualmente
* Prefijo: se listara según la resolución seleccionada, siendo éste una serie de un máximo de 6 caracteres alfabética, numérica o alfanumérica que llevará en el inicio al número consecutivo del documento, es recomendable no duplicar la serie por otra ya existente con mismo o diferente tipo servicio.
* El Valor del rango desde y el valor del rango hasta: Es la numeración que debe ser válida otorgada por la DIAN.
: '''nota:''' cuando se haya agotado el rango de numeración que le fue asignado y se deba solicitar la autorización de uno nuevo este debe ser la continuación de un rango ya autorizado.
* El Valor del rango inicial: Es el valor inicial de facturas del secuencial seleccionado, este valor debe ser igual o mayor al valor del rango desde y menor al valor del rango hasta.
: '''nota:''' si se requiere los secuenciales se puede configurar de forma compartido por varios tipos de servicio, es decir; si dispone 200 secuenciales puede registrar para Portal 100, Servicio de integración 50, APP Móvil 50. Esto depende de las aplicaciones disponibles del cliente.
* La fecha inicio y fecha fin: Es el rango de fecha valida otorgado por la DIAN.
* Clave técnica: Es generada por la DIAN en caso de fallas de comunicación debe ser solicitada a The Factory HKA Colombia SAS y solo su Proveedor Tecnológico la puede consultar.
* SetTestID (Solo Habilitación): Es generada por la DIAN. Esta información se encuentra disponible en el Portal de Habilitación de la DIAN (dian.gov.co) en la sección '''"Tablero"'''.

[[Archivo:agregarNumerSecuEnPortal.png|centro|'''Agregar numeración secuencial''']]

<includeonly>=</includeonly>==Transmisión de Documentos de prueba a la DIAN en ambiente DEMO==<includeonly>=</includeonly>
En estos momentos se encuentra funcional la emisión de documentos de pruebas ('''ambiente DEMO''') directamente contra la DIAN, es decir, poder realizar pruebas de integración desde su ERP con el 100% de validaciones DIAN sin pasar por el XSLT local.

Para reproducir este escenario de pruebas se debe tener en cuenta la siguiente configuración en el portal web DEMO:

https://demofactura.thefactoryhka.com.co/auth/login --> URL Portal DEMO

Configuración en el portal web:
: '''Paso 1:''' El cliente Emisor debe verificar que en los Datos Fiscales se encuentre configurado su NIT, independientemente si posee cargado el certificado propio o el de The factory HKA:

[[Archivo:validarDatFiscalesPortal.png|centro|'''Validación de NIT''']]

: '''Paso 2:''' Se debe tener solicitado la resolución de habilitación otorgada por la DIAN (resolución para set de pruebas de habilitación), esta resolución debe ser configurada en el portal web DEMO como se muestra en la siguiente imagen (tener en cuenta que la modalidad puede ser 'Manual con Prefijo' o 'Manual sin Prefijo', esto depende del ERP):

[[Archivo:configResolPortal.png|centro|'''Configuración y validación de resolución para set de pruebas''']]

'''@Importante:''' El secuencial debe estar configurado con tipo de ambiente Producción2.1, por lo tanto no se deberá ingresar el campo setTestID.

: '''Paso 3:''' Solicitar a través de correo al equipo de Integración ó Soporte la '''activación''' del secuencial creado previamente en en portal DEMO con la opción de envió a la DIAN:

* integracion_fel_co@thefactoryhka.com
* soporte_fel_co@thefactoryhka.com

En el correo se deberá indicar NIT del Emisor y prefijo configurado, que pueden ser SETT o SETP dependiendo del prefijo que la DIAN otorgó al Emisor para su habilitación.

<includeonly>=</includeonly>==Generar código QR en documentos en el documento en papel generado desde el ERP durante la contingencia tipo '03'==<includeonly>=</includeonly>
Para la generación del Código de respuesta rápido – Código QR, en los casos que la factura de venta de talonario o de papel se genere a través de sistemas informáticos electrónicos deberán corresponder a la siguiente tabla:

[[Archivo:codQrDetalle.png|centro|'''Detalle de Código QR''']]

<pre>
Ejemplo:
NumFac: CTG2
FecFac: 2020-06-16
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 1003.00
ValIva: 190.57
ValOtroIm: 0.00
ValTolFac: 1193.57
</pre>

<includeonly>=</includeonly>==Generación de documentos electrónicos para 'Consumidor final'==<includeonly>=</includeonly>
En estos momentos TFHKA_CO se encuentra implementado el nodo PartyIdentification en UBL, por lo cual para facturas generadas a personas naturales se retorna la regla FAK61 como notificación.

[[Archivo:docElectrConsumFinal.png|centro|'''Documentos Electrónicos para Consumidor Final''']]

Los ejemplos para este escenario se encuentran en los Request-SOAP, a continuación:

https://drive.google.com/drive/folders/1lT0TnDhigCpMx5xsQHcHLWNkiQIN45Pc

'''Nota:''' Este ajuste debe generarse desde TFHKA. Lo anterior es el ejemplo sobre cómo manejar el escenario de consumidor final desde el ERP, y de esta forma cuando TFHKA informe a la DIAN el nodo PartyIdentification este ajuste sea un cambio silente para las integraciones. Este cambio debe estar funcional en producción por parte de TFHKA antes del 1 de agosto de 2020.

<includeonly>=</includeonly>==Uso de archivos .ZIP en Correos==<includeonly>=</includeonly>
Por defecto se enviará en el correo como adjunto un archivo .Zip que contiene el xml-AttachedDocument (obligatorio), PDF de la representación gráfica (obligatorio), .Zip con adjuntos (opcional).
Ejemplo:

[[Archivo:zipEnCorreos.png|centro|'''Uso de .Zip en correos''']]

===Contenido del .Zip con adjuntos===
[[Archivo:zipConAdjuntos.png|centro|'''Con Adjuntos''']]

===Contenido del .Zip sin adjuntos===
[[Archivo:zipSinAjduntos.png|centro|'''Sin Adjuntos''']]

<includeonly>=</includeonly>==Como enviar el correo con el método tradicional==<includeonly>=</includeonly>
Se podrá optar como segunda opción continuar enviando el correo con el '''método tradicional''' actual, para esto desde la integración con el ERP se deberá indicar a través del campo Extra 100500, ejemplo:

[[Archivo:envCorreoMetTrad.png|centro|'''Enviar el correo con el método tradicional''']]

'''@Importante1:''' El tamaño máximo de todos los adjuntos que se carguen al documento no debe superar los 2 MB.

'''@Importante2:''' El nombre del xml-AttachedDocument y PDF de la representación gráfica deben ser iguales, por lo tanto para las integraciones que generan R.G de manera local (adjuntos = 11) pueden leer este nombre de la respuesta del método Enviar->parámetro nombre.

<includeonly>=</includeonly>==Consideraciones sobre Uso del .ZIP en el correo con adjuntos en 11==<includeonly>=</includeonly>
Al momento de sincronizar o cargar el adjunto, se contemplan dos tipos de anexos:
===CargarAdjunto.tipo = 1:===
Indica al web services de adjuntos que es una representación gráfica, estos hará que nuestra plataforma renombre y coloque en él .Zip principal el PDF de la R.G local, de lo contario estará colocando el PDF en él .Zip de adjuntos y esto puede tener complicaciones al momento de la recepción.

Ejemplo:
[[Archivo:cargaAdjuntoTip1.png|centro|'''Ejemplo para tipo 1''']]

===CargarAdjunto.tipo = 2:===
Indicar al web services de adjuntos que es un anexo común.

Ejemplo:
[[Archivo:cargaAdjuntoTip2.png|centro|'''Ejemplo para tipo 2''']]

<includeonly>=</includeonly>==Informar direcciones del adquiriente o receptor del documento electrónico==<includeonly>=</includeonly>
Para este escenario, recomendamos revisar los ejemplos Request-SOAP asociados a direcciones, en los que se detalla cómo no reportar direcciones y en caso de que se reporten cuáles son los campos mínimos obligatorios para clientes nacionales y del extranjero (tipo exportación).

La zona postal pasará a ser opcional, es decir este campo debe ser null o enviarse vació en caso de que no se conozca, ejemplo direccionCliente.zonaPostal = null o direccionCliente.zonaPostal = '', si a partir del 1 de agosto se envía la zona postal en '000000' o un código fuera del catálogo será motivo de rechazo en la DIAN.

<includeonly>=</includeonly>==Responsabilidades Fiscales y Tipos de operación==<includeonly>=</includeonly>
A partir del 1 de agosto deberá informarse en responsabilidadesRut.Obligaciones.obligaciones y FacturaGeneral.tipoOperacion solo los siguientes códigos (cualquier otro código informado puede ser motivo de rechazo en la DIAN):

[[Archivo:respoFiscaTipOpera.png|centro|'''Responsabilidades Fiscales y Tipos de operación''']]

Preguntas Frecuentes de Integración con servicio Web (Val. Previa)

2020-09-18T20:10:25Z

Fpinto:

<includeonly>=</includeonly>==Historial de versiones==<includeonly>=</includeonly>
{| class="wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Versión
! style="background:#e9e9e9; text-align:center;"|Fecha lanzamiento
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| 0
| 07/05/2019
|
* Versión Preliminar.
|}
<includeonly>=</includeonly>==Cómo obtener soporte==<includeonly>=</includeonly>
*Soporte de 1er nivel:
::Soporte telefónico / email / chat o tele-conferencias en horario 5x8 para atención de consultas y fallas de usuario.
*Soporte de 2do nivel:
::Soporte resolución remota de incidencias en el sistema en horario 5x8
::::Llame a nuestro CENTRO DE ATENCIÓN +(57) 1 311.31.12 
::::Escriba a [mailto:soporte@thefactoryhka.com.co soporte@thefactoryhka.com.co]

Visítenos el sitio Web: https://www.thefactoryhka.com/co
{{clear}}
<includeonly>=</includeonly>==Ambiente de HABILITACIÓN ==<includeonly>=</includeonly>
El proceso en el ambiente de habilitación es asíncrono por lo que primero es recibido por The Factory HKA y luego en una tarea secundaria buscando las condiciones óptimas de conexión con la DIAN los mismos son enviados a la entidad tributaria.
Secuencia del servicio asíncrono:
* El software cliente realiza la conexión, autenticación por medio de certificado digital, enviando la solicitud (Request) al servicio de la DIAN.
* El WS DIAN recibe la solicitud y responde con un mensaje de aprobación o rechazo, según las primeras validaciones y entrega un trackId.
* El software cliente, al obtener la respuesta, cierra la conexión.
* Con el trackId obtenido en el método, se consume otro método de consulta para obtener el resultado de la transacción anterior.

<includeonly>=</includeonly>==Transmisión de documentos de contingencia tipo 03 (path additionaldocumentreference)==<includeonly>=</includeonly>
Los inconvenientes tecnológicos por parte del facturador electrónico implican que la facturación electrónica tenga las siguientes características:
* Generar la facturación con numeración de contingencia en papel o por computador.
* El facturador tendrá 30 días (48 horas en la última resolución) a partir de la fecha en que supera la contingencia para transmitir las facturas electrónicas en formato XML a la DIAN.
* Las facturas electrónicas generadas y emitidas en contingencia pasarán la malla de validaciones de anexo, es decir, la DIAN responderá con un Application Response de Documento Validado por la DIAN, que informará las notificaciones a que haya lugar.
* Una vez el facturador electrónico salga de contingencia deberá proceder al proceso de generación normal.
* Para los documentos de notas crédito y notas débito, el facturador NO debe usar la numeración de contingencia, sino el consecutivo propio normal. Las notas enviadas a la DIAN se validarán de manera normal en la DIAN. Por lo anterior, no existe el concepto de nota en contingencia, por lo que debe cuidarse enviar primeramente las Facturas de Contingencia antes de generar notas sobre las mismas y se recomienda generarlas en un ambiente de operación normal.

===¿Cómo transmitir un documento de contingencia Tipo 03?===
La transmisión del documento se realiza por medio del método Enviar del Web Service de Emisión que brinda The Factory HKA, indicando el atributo tipoDocumento del objeto FacturaGeneral igual a ‘03’ y enviar en la sección de documentosReferenciados un objeto de tipo DocumentosReferenciados indicando lo siguiente:
* codigoInterno = ‘1’
* fecha = ‘Fecha de emisión del documento de contingencia’
* numeroDocumento = ‘número del consecutivo del documento de contingencia emitido’
* tipoCodigoDocumento = ‘Tipo de documento de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico a transmitir, según lo estipulado en el numeral 12.1.4 de la versión 1.8 del Anexo Técnico de la DIAN ’.

{| class="wikitable" style="width: 80%;"
|+ Tipos de documentos de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico
! style="color:black;background:#f2f2f2; text-align:center;"|Código
! style="color:black;background:#f2f2f2; text-align:center;"|Descripción
|- valign="center"
|-
|FTC
|Factura Talonario Contingencia
|-
|FTP
|Factura Talonario Papel
|-
|FTPC
|Factura Talonario por Computador
|}
===¿Cuál será el código de respuesta de transmisión exitosa que retornará el WS de TFHKA?===
El método Enviar retornará código 201 ó 208 ante la recepción exitosa del documento en nuestra plataforma, con el siguiente mensaje: “El documento se recibió como Documento Electrónico de Contingencia Tipo 03, este se entregará de manera asíncrona a la DIAN, para más información favor consumir '''EstadoDocumento''' luego de 48 horas.” En dicho Response se contará con CUDE y UBL.

===¿Cuándo puedo consultar el resultado de la transmisión del documento hacia la DIAN?===
Pasadas 48 horas luego de la radicación del documento en la plataforma, pueden consultar el estatus del mismo para conocer el resultado de la transacción ante la DIAN.

===Ejemplo SOAP Request de Factura de Contingencia Tipo 03:===
<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Ver ejemplo:</div>
<div class="mw-collapsible-content">

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales>
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>email1@thefactoryhka.com</arr:string>
<arr:string>email2@thefactoryhka.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos>
<codigoImpuesto>ZY</codigoImpuesto>
</Tributos>
</detallesTributarios>

<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<direccionFiscal>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionFiscal>
<email>email@thefactoryhka.com</email>

<informacionLegalCliente>
<nombreRegistroRUT>CONSORCIO ALIANZA SAN CRISTOBAL 4</nombreRegistroRUT>
<numeroIdentificacion>901041710</numeroIdentificacion>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<tipoIdentificacion>31</tipoIdentificacion>
</informacionLegalCliente>
<nombreRazonSocial>The Factory HKA Colombia</nombreRazonSocial>
<notificar>SI</notificar>
<numeroDocumento>901041710</numeroDocumento>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>31</tipoIdentificacion>
<tipoPersona>1</tipoPersona>
</cliente>
<consecutivoDocumento>PREFIJOCONSECUTIVO</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadPorEmpaque>1</cantidadPorEmpaque>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>P000001</codigoProducto>
<descripcion>Impresora HKA80</descripcion>
<descripcionTecnica>Impresora térmica de punto de venta, ideal para puntos de venta con alto rendimiento</descripcionTecnica>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>PHKA80</estandarCodigoProducto>
<impuestosDetalles>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosDetalles>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<marca>HKA</marca>
<muestraGratis>0</muestraGratis>
<precioTotal>1193.57</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura></pre>
<pre style="color: red">
<documentosReferenciados>

<DocumentoReferenciado>
<codigoInterno>1</codigoInterno>
<fecha>2020-01-01</fecha>
<numeroDocumento>CTG12</numeroDocumento>

<tipoDocumentoCodigo>FTC</tipoDocumentoCodigo>
</DocumentoReferenciado>
</documentosReferenciados></pre>
<pre>
<fechaEmision>2020-01-08 00:00:00</fechaEmision>
<impuestosGenerales>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<unidadMedida>WSD</unidadMedida>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosGenerales>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-RANGODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado></pre>
<pre style="color: red">
<tipoDocumento>03</tipoDocumento></pre>
<pre>
<tipoOperacion>10</tipoOperacion>
<totalBaseImponible>1003.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</pre>
</div></div>

@IMPORTANTE: No es requerido que se notifique a los adquirientes los documentos de contingencia transmitidos a la DIAN, ya que el documento entregado físicamente al mismo durante el período en que mantuvo la contingencia, corresponde al documento legal de la transacción realizada. La transmisión de dicha información a la DIAN es con el fin de notificar al ente regulador las transacciones realizadas durante dicho periodo. Por lo anteriormente descrito, se recomienda enviar el campo notificar = ‘NO’ y no realizar el envío de la información correspondiente al Destinatario:

<div class="toccolours mw-collapsible mw-collapsed">
<div style="font-weight:bold;line-height:1.6;">Ver ejemplo:</div>
<div class="mw-collapsible-content">

<pre>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soapenv:Header/>
<soapenv:Body>
<tem:Enviar>
<tem:tokenEmpresa>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenEmpresa>
<tem:tokenPassword>xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx</tem:tokenPassword>
<tem:factura xmlns="http://schemas.datacontract.org/2004/07/ServiceSoap.UBL2._0.Models.Object">
<cantidadDecimales>2</cantidadDecimales></pre>
<pre style="color: red">
<cliente>
<destinatario>
<Destinatario>
<canalDeEntrega>0</canalDeEntrega>
<email>
<arr:string>email1@thefactoryhka.com</arr:string>
<arr:string>email2@thefactoryhka.com</arr:string>
</email>
</Destinatario>
</destinatario>
<detallesTributarios>
<Tributos>
<codigoImpuesto>ZY</codigoImpuesto>
</Tributos>
</detallesTributarios>

<direccionCliente>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionCliente>
<direccionFiscal>
<ciudad>BOGOTÁ, D.C.</ciudad>
<codigoDepartamento>11</codigoDepartamento>
<departamento>Bogotá</departamento>
<direccion>Direccion</direccion>
<lenguaje>es</lenguaje>
<municipio>11001</municipio>
<pais>CO</pais>
</direccionFiscal>
<email>email@thefactoryhka.com</email>

<informacionLegalCliente>
<nombreRegistroRUT>CONSORCIO ALIANZA SAN CRISTOBAL 4</nombreRegistroRUT>
<numeroIdentificacion>901041710</numeroIdentificacion>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<tipoIdentificacion>31</tipoIdentificacion>
</informacionLegalCliente>
<nombreRazonSocial>The Factory HKA Colombia</nombreRazonSocial>
<notificar>NO</notificar>
<numeroDocumento>901041710</numeroDocumento>
<numeroIdentificacionDV>5</numeroIdentificacionDV>
<responsabilidadesRut>
<Obligaciones>
<obligaciones>R-99-PN</obligaciones>
<regimen>49</regimen>
</Obligaciones>
</responsabilidadesRut>
<tipoIdentificacion>31</tipoIdentificacion>
<tipoPersona>1</tipoPersona>
</cliente></pre>
<pre>
<consecutivoDocumento>PREFIJOCONSECUTIVO</consecutivoDocumento>
<detalleDeFactura>
<FacturaDetalle>
<cantidadPorEmpaque>1</cantidadPorEmpaque>
<cantidadReal>1.00</cantidadReal>
<cantidadRealUnidadMedida>WSD</cantidadRealUnidadMedida>
<cantidadUnidades>1.00</cantidadUnidades>
<codigoProducto>P000001</codigoProducto>
<descripcion>Impresora HKA80</descripcion>
<descripcionTecnica>Impresora térmica de punto de venta, ideal para puntos de venta con alto rendimiento</descripcionTecnica>
<estandarCodigo>999</estandarCodigo>
<estandarCodigoProducto>PHKA80</estandarCodigoProducto>
<impuestosDetalles>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosDetalles>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<marca>HKA</marca>
<muestraGratis>0</muestraGratis>
<precioTotal>1193.57</precioTotal>
<precioTotalSinImpuestos>1003.00</precioTotalSinImpuestos>
<precioVentaUnitario>1003.00</precioVentaUnitario>
<secuencia>1</secuencia>
<unidadMedida>WSD</unidadMedida>
</FacturaDetalle>
</detalleDeFactura>
<documentosReferenciados>

<DocumentoReferenciado>
<codigoInterno>1</codigoInterno>
<fecha>2020-01-01</fecha>
<numeroDocumento>CTG12</numeroDocumento>

<tipoDocumentoCodigo>FTC</tipoDocumentoCodigo>
</DocumentoReferenciado>
</documentosReferenciados>
<fechaEmision>2020-01-08 00:00:00</fechaEmision>
<impuestosGenerales>
<FacturaImpuestos>
<baseImponibleTOTALImp>1003.00</baseImponibleTOTALImp>
<codigoTOTALImp>01</codigoTOTALImp>
<porcentajeTOTALImp>19.00</porcentajeTOTALImp>
<unidadMedida>WSD</unidadMedida>
<valorTOTALImp>190.57</valorTOTALImp>
</FacturaImpuestos>
</impuestosGenerales>
<impuestosTotales>
<ImpuestosTotales>
<codigoTOTALImp>01</codigoTOTALImp>
<montoTotal>190.57</montoTotal>
</ImpuestosTotales>
</impuestosTotales>
<mediosDePago>
<MediosDePago>
<medioPago>10</medioPago>
<metodoDePago>1</metodoDePago>
<numeroDeReferencia>01</numeroDeReferencia>
</MediosDePago>
</mediosDePago>
<moneda>COP</moneda>
<rangoNumeracion>PREFIJO-RANGODESDE</rangoNumeracion>
<redondeoAplicado>0.00</redondeoAplicado>
<tipoDocumento>03</tipoDocumento>
<tipoOperacion>10</tipoOperacion>
<totalBaseImponible>1003.00</totalBaseImponible>
<totalBrutoConImpuesto>1193.57</totalBrutoConImpuesto>
<totalMonto>1193.57</totalMonto>
<totalProductos>1</totalProductos>
<totalSinImpuestos>1003.00</totalSinImpuestos>
</tem:factura>
<tem:adjuntos>0</tem:adjuntos>
</tem:Enviar>
</soapenv:Body>
</soapenv:Envelope>
</pre>
</div></div>

<includeonly>=</includeonly>==Campos extensibles en R.G estándar==<includeonly>=</includeonly>

El '''valor''' de estos campos es texto plano, por lo tanto el formato es gestionado desde el ERP.
* TOTAL Descuento Detalle (Campo Extensible 5170001).
* Total Base Excluida (Campo Extensible 5170000)
* TOTAL Retenciones (Campo Extensible 5170002)
* TOTAL a Pagar (Campo Extensible 5170003)
* TOTAL A PAGAR en Letras (Campo Extensible 5170004)

===Ejemplo sobre la estructura de los campos:===
<pre>
<extras>
<Extras>
<controlInterno1>Total Base Excluida</controlInterno1>
<controlInterno2/>
<nombre>5170000</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL Descuento Detalle</controlInterno1>
<controlInterno2/>
<nombre>5170001</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL Retenciones</controlInterno1>
<controlInterno2/>
<nombre>5170002</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>

<Extras>
<controlInterno1>TOTAL a Pagar</controlInterno1>
<controlInterno2/>
<nombre>5170003</nombre>
<pdf>1</pdf>
<valor>10000.25</valor>
<xml>1</xml>
</Extras>
</extras>
</pre>
En la Representación Gráfica se visualizará de la siguiente manera:

[[Archivo:visualizaRGcamposExtras.png|centro|'''Campos extensibles en representación grpafica estándar''']]

<includeonly>=</includeonly>==Estructura del QR de acuerdo al Anexo 1.8==<includeonly>=</includeonly>
Para la representación gráfica de las facturas electrónicas, es requisito la generación de un código QR con la siguiente información:
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:black;background:#FFD966; text-align:center;"|Detalle
! style="color:black;background:#FFD966; text-align:center;"|XPath
|- valign="center"
|-
|NumFac: [NUMERO_FACTURA]
|/Invoice/cbc:ID
|-
|FecFac: [FECHA_FACTURA]
|/Invoice/cbc:IssueDate
|-
|HorFac: [HORA_FACTURA(con GMT)]
|/Invoice/cbc:IssueTime
|-
|NitFac: [NIT FACTURADOR]
|/Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|DocAdq: [NUMERO_ID_ADQUIRENTE]
|/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
|-
|ValFac: [VALOR_FACTURA]
|/Invoice/cac:LegalMonetaryTotal/cbc:LineExtensionAmount
|-
|ValIva: [VALOR_IVA]
|/Invoice/cac:TaxTotal/cbc:TaxAmount Donde /Invoice/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cac:TaxScheme/cbc:ID = 01
|-
|ValOtroIm: [VALOR_OTROS_IMPUESTOS]
|Sumatoria de /Invoice/cac:TaxTotal[X]/cbc:TaxAmount[X] Donde /Invoice/cac:TaxTotal[X]/cac:TaxSubtotal[X]/cac:TaxCategory[X]/cac:TaxScheme[X]/cbc:ID[X] sea diferente a 01
|-
|ValTolFac: [VALOR_TOTAL_FACTURA
|/Invoice/cac:LegalMonetaryTotal/cbc:PayableAmount
|-
|CUFE
|/Invoice/cbc:UUID
|-
|QRCode
|/Invoice/ext:UBLExtensions[1]/ext:UBLExtension[1]/ext:ExtensionContent[1]/sts:DianExtensions[1]/sts:QRCode
|}
Debe tener las siguientes consideraciones:

: '''NitFac:''' sin puntos ni guiones
: '''DocAdq:''' sin puntos ni guiones
: '''ValFac:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValIva:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValOtroIm:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''ValTolFac:''' con punto decimal, con decimales a dos (2) dígitos, sin separadores de miles, ni símbolo pesos.
: '''QRCode:''' URL disponible por la DIAN
:* Ambiente Habilitación: https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=CUFE
:* Ambiente Producción: https://catalogo-vpfe.dian.gov.co/document/searchqr?documentkey=CUFE

===Ejemplo sobre la estructura de los campos:===
Teniendo en cuenta los datos de entrada, se presenta el código QR que se incluye en la representación gráfica de la factura electrónica:
<pre>
<a:qr>
NumFac: VAF472
FecFac: 2019-12-20
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 2006.00
ValIva: 381.14
ValOtroIm: 0.00
ValTolFac: 2387.14
CUFE: 95d062a141ff0f1a55f9f684167e00544617f4ed714b283934ad939fc056c6fb2ae6ab34ad8ba9a9db94aa2c253d3c05
https://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=95d062a141ff0f1a55f9f684167e00544617f4ed714b283934ad939fc056c6fb2ae6ab34ad8ba9a9db94aa2c253d3c05
</a:qr>
</pre>

<includeonly>=</includeonly>==Campos de direcciones mínimos para evitar rechazo FAK08==<includeonly>=</includeonly>
Esto se debe a que la DIAN está validando que se envíen obligatoriamente los campos '''ciudad''', '''codigoDepartamento''', '''departamento''', '''dirección''', '''municipio''' y '''país''' en la dirección del cliente.

<includeonly>=</includeonly>==Configuración de direcciones en el portal para evitar rechazo FAJ09, FAJ16, FAJ12.==<includeonly>=</includeonly>
: 1. Deben validar que en nuestro portal web en la sección '''Catálogos->Establecimientos''', la dirección física del establecimiento se encuentre correctamente configurada:

[[Archivo:CatálogosEstablecimientosPortal.png|centro|'''Catálogos->Establecimientos''']]

: 2. Validar que la dirección fiscal o dirección física del receptor está correctamente construida mínimo con lo siguiente:

[[Archivo:direccionFiscalFisicaMinima.png|centro|'''Campos mínimos en dirección fiscal y dirección física''']]

<includeonly>=</includeonly>==Concatenación de nombre + apellido en campo nombreRazonSocial==<includeonly>=</includeonly>
En este caso, se recomienda enviar el nombre completo (Nombres y apellidos) en el atributo '''nombreRazonSocial''' del objeto factura y dejar vacíos los campos '''apellido y segundoNombre'''.

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que afecten a facturas de validación previa==<includeonly>=</includeonly>
Para la emisión de Notas de Crédito y Débito deben enviarse obligatoriamente dos arreglos de documentos referenciados, el primero indicando el codigoInterno = '4' el cual corresponde a los motivos por los cuales se genera la NC/ND ('''DiscrepancyResponse''') y un segundo arreglo, indicando el codigoInterno = '5' en el cual se reflejan los datos de la factura afectada por la NC/NC ('''BillingReference''').
Como se muestra a continuación:
<pre>
<a:documentosReferenciados>
<a:DocumentoReferenciado>
<a:codigoEstatusDocumento>2</a:codigoEstatusDocumento>
<a:codigoInterno>4</a:codigoInterno>
<a:cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1EkRoFzzvJqHhKqk5JpLSqtJ99pRMd32g40baab6b59cdc8b3</a:cufeDocReferenciado>
<a:descripción>
<b:string>Anulación de factura electrónica</b:string>
</a:descripción>
<a:extras i:nil="true"/>
<a:fecha>2019-10-07</a:fecha>
<a:fechaFinValidez i:nil="true"/>
<a:fechaInicioValidez i:nil="true"/>
<a:numeroDocumento>F4PM3</a:numeroDocumento>
<a:tipoCUFE i:nil="true"/>
<a:tipoDocumento i:nil="true"/>
<a:tipoDocumentoCodigo i:nil="true"/>
</a:DocumentoReferenciado>
<DocumentoReferenciado>
<codigoInterno>5</codigoInterno>
<cufeDocReferenciado>85ea749b18ee5bd251b87442935650e30b4e0e4cd662bef1KqmCLKgxPpH6u5LiKrJvTb6FEyfVuoCcV0baab6b59cdc8b3</cufeDocReferenciado>
<fecha>2019-10-07</fecha>
<numeroDocumento>F4PM3</numeroDocumento>
</DocumentoReferenciado>
</a:documentosReferenciados>
</pre>
En el caso de la dll, basta con enviar cada arreglo separado por el carácter "%", por ejemplo:

ID02E = "02E|2|4|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954||||ASFF10|||01|||||¬02E1|Prueba NC Campos Minimos con Anulación de factura electrónica"+ "%" +"02E||5|4191110db1f3c8060a4ce34e40c6ec6541ac1bd248264624bfe1b60fdf02aea7e15c5a49969cc08f498b938a9e3cd954|2019-07-29|||ASFF10|CUFE-SHA384||01|||||"

Esto se visualiza en la representación gráfica de la siguiente forma:

[[Archivo:DocRefNotasFactValPrev.png|centro|'''Documentos referenciados en representación gráfica''']]

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior==<includeonly>=</includeonly>
Tener en cuenta que para cada escenario se debe indicar correctamente el campo '''tipoOperacion''':
* Código '''23''' para '''Notas Crédito'''.
* Código '''33''' para '''Notas Débito'''.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:23-33-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png|800px|sinmarco|centro|Campo FacturaGeneral.tipoOperacion que afectan facturas de validación posterior]]

Para la emisión de Notas de Crédito y Débito deben enviarse obligatoriamente dos arreglos indicando el '''DiscrepancyResponse''' y el '''BillingReference'''.

<includeonly>=</includeonly>==Documentos Referenciados en Notas de previa que no afecten a facturas==<includeonly>=</includeonly>
Tener en cuenta que para cada escenario se debe indicar correctamente el campo '''tipoOperacion''':
* Código '''22''' para '''Notas Crédito'''.
* Código '''32''' para '''Notas Débito'''.
De acuerdo a lo descrito en el Anexo Técnico versión 1.8

[[Archivo:22-32-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png|800px|sinmarco|centro|Campo FacturaGeneral.tipoOperacion que no afectan facturas]]

@IMPORTANTE: La clase Documentos Referenciados debe enviarse en null.

<includeonly>=</includeonly>==Error 101 token emisor inválido==<includeonly>=</includeonly>
El código de Error '''101''' hace referencia a un inconveniente en la configuración de los tokens y URL en su sistema. Por favor, validar en la configuración del ERP que se encuentran configurados correctamente estos dos puntos dependiendo del ambiente en el cual desean realizar las emisiones de documentos:

'''URL Ambiente Demo''' (ambiente de pruebas en el cual las emisiones no son transmitidas a la DIAN):
<pre>
Servicio Emisión:
http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl

Servicio Adjuntos:
http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsd

Servicio Reportes:
http://demoemision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl
</pre>
'''URL Ambiente Productivo''' (ambiente en el cual se realizan las emisiones correspondientes al set de habilitación y posteriormente la emisión de documentos en operación):
<pre>
Servicio Emisión (HTTPS):
https://emision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl

Servicio Adjuntos (HTTPS):
https://emision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl

Servicio Reportes (HTTPS)
https://emision21.thefactoryhka.com.co/ws/reportes/Service.svc?wsdl
</pre>

<includeonly>=</includeonly>==Mostrar dirección completa en la representación gráfica==<includeonly>=</includeonly>
Dicha información se debe enviar a través del atributo [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|'''DireccionCliente''']]

[[Archivo:Mostrar dirección completa en la representación gráfica.png|centro|'''Clase direccionCliente''']]

Los campos necesarios para que se muestre en la representación gráfica son los siguientes:

[[Archivo:camposDireccionRepGraf.png|centro|'''Campos necesarios para representación gráfica''']]

En la representación gráfica se mostraría de la siguiente manera:

[[Archivo:dirección completa en la representación gráfica.png|centro|'''Representación gráfica con campos los necesarios''']]

<includeonly>=</includeonly>==Regla: FAW01, Rechazo: Línea de factura informado con LineExtensionAmount en cero y grupo cac:PricingReference no informado==<includeonly>=</includeonly>
Este error surge cuando la DIAN recibe un UBL indicando que la base imponible de un elemento a nivel de línea es 0 y la validación rechaza el documento. En el caso de estar enviando una muestra se deben enviar los campos obligatoriamente: '''codigoTipoPrecio, muestraGratis, precioReferencia, precioTotal, precioTotalSinImpuestos'''.

<includeonly>=</includeonly>==Envío de representación gráfica personalizada==<includeonly>=</includeonly>
La emisión con adjuntos se realiza en dos pasos. El primero consiste en generar el UBL fiscal a través de la url de emisión (http://demoemision21.thefactoryhka.com.co/ws/v1.0/Service.svc?wsdl en ambiente Demo)

En este caso, se debe indicar en el método Enviar el parámetro adjunto en 11 para indicarle al servicio que no se genere nuestra representación gráfica estándar y adicionalmente que el documento no se envíe por correo hasta que no se realice la carga de adjuntos.

[[Archivo:tabRequestParamEnviar.png|centro|'''Descripción de parámetros a Enviar''']]

Posteriormente, debe consumirse el método CargarArchivo a traves de la url de adjunto (http://demoemision21.thefactoryhka.com.co/ws/adjuntos/Service.svc?wsdl en ambiente Demo)

Este método presenta los siguientes campos

[[Archivo:tabCamposParamEnviar.png|centro|'''Descripción de campos en parámetros a Enviar''']]

Dónde Class.Adjunto contiene la siguiente información:

[[Archivo:tabClaseAdjuntos.png|centro|'''Descripción de Class.Adjunto''']]

RESPONSE: Parámetros a Recibir

[[Archivo:tabResponseParamRecibir.png|centro|'''Descripción de parámetros a Recibir''']]

@IMPORTANTE: Si un documento queda a la espera de adjuntos, no se enviará el correo de notificación hasta que no se realice el cargue de los archivos anexos.

<includeonly>=</includeonly>==Correo electrónico personalizado==<includeonly>=</includeonly>
El objeto “extras” también permite manejar algunas funcionalidades especiales de la plataforma, como la de correo electrónico personalizado. Para que esta información no aparezca en la representación gráfica, el parámetro pdf del objeto “extras” debe ir en “0”.

La funcionalidad de correo electrónico personalizado permite configurar transacción a transacción el asunto, la dirección de respuesta y el cuerpo del correo electrónico. La vía para exponer esta información será a través de campos extensibles.

[[Archivo:tabCampsExtensiblesCorreoPers.png|centro|'''Descripción de campos extensibles para correo electrónico personalizado''']]

===Ejemplo de uso de Campos Extensibles 11,13 y 14 para personalizar el Correo Electrónico:===

[[Archivo:ejemXMLCamposExtensiblesCorreoPers.png|centro|'''Ejemplo XML''']]

Tomando el ejemplo dado el correo se visualizará de la siguiente manera:

[[Archivo:ejembandejaCorreoCamposExtensiblesCorreoPers.png|centro|'''Factura electrónica en bandeja de correo''']]

<includeonly>=</includeonly>==Radicar documentos electrónicos en plataformas de recepción==<includeonly>=</includeonly>
Aclaramos la situación, indicando que el el XML que se debe radicar en las plataformas de recepción es el que nuestro servicio envía en la notificación de correo llamado AttachedDocument (Contenedor de Documentos), la estructura de este documento tiene por objetivo contener en un único archivo XML un documento electrónico (Invoice, CreditNote ó DebitNote) y todos los eventos (ApplicationResponse) registrados hasta la fecha, este XML también puede ser descargado a través del método GenerarContenedor

[[Archivo:radicarDocumentos.png|centro|'''Documentos electrónicos en plataformas de recepción''']]

'''Nota:''' Si usted es cliente final, por favor comunicar lo anterior a su casa de software o proveedor de ERP.

<includeonly>=</includeonly>==Regla [FAJ26], Rechazo: No indica un valor autorizado==<includeonly>=</includeonly>
En el catálogo/cliente y en datos fiscales de la empresa, valide que en el campo de responsabilidades no se encuentre seleccionada las siguientes opciones:
# O-47 Régimen Simple de Tributación – SIMPLE.
# O-48 Impuesto sobre las ventas.
# O-49 No responsable de IVA.
# O-52 Facturador electrónico.

Ya que el error de validación que está presentando es debido a que la DIAN no ha actualizado los catálogos donde se incluyen estos nuevos elementos, y por eso están siendo rechazados. Se recomienda retirarlos temporalmente hasta que la DIAN permita su uso.

Dicha modificación la puede realizar en nuestro portal de la siguiente manera:

En la opción de Datos fiscales/ Información Adicional/Responsabilidades debe tener configurado la responsabilidad Responsabilidad sobre las ventas(O-48)

[[Archivo:editarPortalResponsabilidades.png|centro|'''Opción de edición de Responsabilidades en portal''']]

Debe destildar esa opción en la sección Responsabilidades:

[[Archivo:editarPortalRespOpciones.png|centro|'''Modificación de Responsabilidades en portal''']]

Posteriormente seleccione la opción de guardar para que dicha modificación se realice satisfactoriamente.

<includeonly>=</includeonly>==Rechazo: NIT XXXXXXXXX no autorizado a enviar documentos para emisor con NIT XXXXXXXXX==<includeonly>=</includeonly>
De acuerdo al error que presenta es posible que la asociación del proveedor tecnológico en el portal de habilitación de la DIAN puedo tener un problema. 

Se recomienda que ingrese al portal de habilitación, elimine los modos de operación, y vuelva a agregar el modo de operación Proveedor tecnológico - TFHKA en el portal de la Dian; luego actualice el '''TestSetID''' en los rangos de numeración en nuestro portal. 

Luego de realizar las configuraciones antes mencionadas en el portal HKA, intente emitir los documentos nuevamente. 

Se adjunta un video de asesoría NUEVO donde se explican las diferencias entre los ambiente DEMO y PRODUCCIÓN que entrega The Factory HKA a sus clientes. 

Adicional a esto, el video explica paso a paso a seguir para tener acceso al ambiente DEMO su posterior pase a PRODUCCIÓN, y los pasos necesarios ante la DIAN para actualizar el REGISTRO y PRUEBAS DE HABILITACIÓN, y en qué ambiente deben ser realizados en nuestros sistemas. 

Link video de asesoría: https://drive.google.com/file/d/1tslrefpqizIVnuYha8QAXUeGCgje5hbS/view

<includeonly>=</includeonly>==Configuración de secuenciales==<includeonly>=</includeonly>
En esta sección se muestran todos sus secuenciales configurados, los establecimientos a los que han sido agregados e información como fechas de vigencia y tipo de servicio. 

De igual forma podrá gestionar sus secuenciales, consultar la información configurada y si lo desea podrá inactivar secuenciales que ya no tendrán uso. 

Además podrá agregar secuenciales según el tipo de documento que desee emitir. 

En la pantalla Agregar Numeración Secuencial, el portal realizará una consulta a la DIAN con su número de identificación para la carga de sus secuenciales disponibles según el número de resolución, el mismo cargará los rangos de numeración, vigencia, prefijo y clave técnica.

[[Archivo:secEnPortal.png|centro|'''Gestión de secuenciales en portal''']]

===Agregar un secuencial===
Presionando Agregar secuencial emergerá otra pantalla. Ver imagen 306. Los datos disponibles para el registro del secuencial son:

* Tipo de servicio: Tipo de servicio de emisión de documentos (Habilitación o Producción 2.1).
* Tipo de Documento: Tipos de documentos (Factura, Nota de crédito, Nota de débito).
* Tipo de Operación: Operación que se va asociar al tipo documento (Venta/Exportación y Contingencia).
* Tipo de servicio: Servicio por donde se va gestionar el documento (Portal, Servicio de integración, App Móvil).
* Modalidad de Uso para Secuencial: Modo de uso, (Automático, Manual sin prefijo, Manual con prefijo).
* Establecimiento: Se listaran los establecimientos registrados en Catálogo Establecimiento.
* Número de la resolución: es el número obtenido cuando se solicita la numeración de factura electrónica. El portal deberá realizar la consulta a la DIAN, si se estableció la conexión se debe mostrar todas las resoluciones asociadas al cliente en un combo lista. Si no se pudo establecer la conexión debe ser ingresado manualmente
* Prefijo: se listara según la resolución seleccionada, siendo éste una serie de un máximo de 6 caracteres alfabética, numérica o alfanumérica que llevará en el inicio al número consecutivo del documento, es recomendable no duplicar la serie por otra ya existente con mismo o diferente tipo servicio.
* El Valor del rango desde y el valor del rango hasta: Es la numeración que debe ser válida otorgada por la DIAN.
: '''nota:''' cuando se haya agotado el rango de numeración que le fue asignado y se deba solicitar la autorización de uno nuevo este debe ser la continuación de un rango ya autorizado.
* El Valor del rango inicial: Es el valor inicial de facturas del secuencial seleccionado, este valor debe ser igual o mayor al valor del rango desde y menor al valor del rango hasta.
: '''nota:''' si se requiere los secuenciales se puede configurar de forma compartido por varios tipos de servicio, es decir; si dispone 200 secuenciales puede registrar para Portal 100, Servicio de integración 50, APP Móvil 50. Esto depende de las aplicaciones disponibles del cliente.
* La fecha inicio y fecha fin: Es el rango de fecha valida otorgado por la DIAN.
* Clave técnica: Es generada por la DIAN en caso de fallas de comunicación debe ser solicitada a The Factory HKA Colombia SAS y solo su Proveedor Tecnológico la puede consultar.
* SetTestID (Solo Habilitación): Es generada por la DIAN. Esta información se encuentra disponible en el Portal de Habilitación de la DIAN (dian.gov.co) en la sección '''"Tablero"'''.

[[Archivo:agregarNumerSecuEnPortal.png|centro|'''Agregar numeración secuencial''']]

<includeonly>=</includeonly>==Transmisión de Documentos de prueba a la DIAN en ambiente DEMO==<includeonly>=</includeonly>
En estos momentos se encuentra funcional la emisión de documentos de pruebas ('''ambiente DEMO''') directamente contra la DIAN, es decir, poder realizar pruebas de integración desde su ERP con el 100% de validaciones DIAN sin pasar por el XSLT local.

Para reproducir este escenario de pruebas se debe tener en cuenta la siguiente configuración en el portal web DEMO:

https://demofactura.thefactoryhka.com.co/auth/login --> URL Portal DEMO

Configuración en el portal web:
: Paso 1: El cliente Emisor debe verificar que en los Datos Fiscales se encuentre configurado su NIT, independientemente si posee cargado el certificado propio o el de The factory HKA:

[[Archivo:validarDatFiscalesPortal.png|centro|'''Validación de NIT''']]

: Paso 2: Se debe tener solicitado la resolución de habilitación otorgada por la DIAN (resolución para set de pruebas de habilitación), esta resolución debe ser configurada en el portal web DEMO como se muestra en la siguiente imagen (tener en cuenta que la modalidad puede ser 'Manual con Prefijo' o 'Manual sin Prefijo', esto depende del ERP):

[[Archivo:configResolPortal.png|centro|'''Configuración y validación de resolución para set de pruebas''']]

'''@Importante:''' El secuencial debe estar configurado con tipo de ambiente Producción2.1, por lo tanto no se deberá ingresar el campo setTestID.

Paso 3: Solicitar a través de correo al equipo de Integración ó Soporte la '''activación''' del secuencial creado previamente en en portal DEMO con la opción de envió a la DIAN:

* integracion_fel_co@thefactoryhka.com
* soporte_fel_co@thefactoryhka.com

En el correo se deberá indicar NIT del Emisor y prefijo configurado, que pueden ser SETT o SETP dependiendo del prefijo que la DIAN otorgó al Emisor para su habilitación.

<includeonly>=</includeonly>==Generar código QR en documentos en el documento en papel generado desde el ERP durante la contingencia tipo '03'==<includeonly>=</includeonly>
Para la generación del Código de respuesta rápido – Código QR, en los casos que la factura de venta de talonario o de papel se genere a través de sistemas informáticos electrónicos deberán corresponder a la siguiente tabla:

[[Archivo:codQrDetalle.png|centro|'''Detalle de Código QR''']]

<pre>
Ejemplo:
NumFac: CTG2
FecFac: 2020-06-16
HorFac: 00:00:00-05:00
NitFac: 900390126
DocAdq: 901041710
ValFac: 1003.00
ValIva: 190.57
ValOtroIm: 0.00
ValTolFac: 1193.57
</pre>

<includeonly>=</includeonly>==Generación de documentos electrónicos para 'Consumidor final'==<includeonly>=</includeonly>
En estos momentos TFHKA_CO se encuentra implementado el nodo PartyIdentification en UBL, por lo cual para facturas generadas a personas naturales se retorna la regla FAK61 como notificación.

[[Archivo:docElectrConsumFinal.png|centro|'''Documentos Electrónicos para Consumidor Final''']]

Los ejemplos para este escenario se encuentran en los Request-SOAP, a continuación:

https://drive.google.com/drive/folders/1lT0TnDhigCpMx5xsQHcHLWNkiQIN45Pc

'''Nota:''' Este ajuste debe generarse desde TFHKA. Lo anterior es el ejemplo sobre cómo manejar el escenario de consumidor final desde el ERP, y de esta forma cuando TFHKA informe a la DIAN el nodo PartyIdentification este ajuste sea un cambio silente para las integraciones. Este cambio debe estar funcional en producción por parte de TFHKA antes del 1 de agosto de 2020.

<includeonly>=</includeonly>==Uso de archivos .ZIP en Correos==<includeonly>=</includeonly>
Por defecto se enviará en el correo como adjunto un archivo .Zip que contiene el xml-AttachedDocument (obligatorio), PDF de la representación gráfica (obligatorio), .Zip con adjuntos (opcional).
Ejemplo:

[[Archivo:zipEnCorreos.png|centro|'''Uso de .Zip en correos''']]

===Contenido del .Zip con adjuntos===
[[Archivo:zipConAdjuntos.png|centro|'''Con Adjuntos''']]

===Contenido del .Zip sin adjuntos===
[[Archivo:zipSinAjduntos.png|centro|'''Sin Adjuntos''']]

<includeonly>=</includeonly>==Como enviar el correo con el método tradicional==<includeonly>=</includeonly>
Se podrá optar como segunda opción continuar enviando el correo con el '''método tradicional''' actual, para esto desde la integración con el ERP se deberá indicar a través del campo Extra 100500, ejemplo:

[[Archivo:envCorreoMetTrad.png|centro|'''Enviar el correo con el método tradicional''']]

'''@Importante1:''' El tamaño máximo de todos los adjuntos que se carguen al documento no debe superar los 2 MB.

'''@Importante2:''' El nombre del xml-AttachedDocument y PDF de la representación gráfica deben ser iguales, por lo tanto para las integraciones que generan R.G de manera local (adjuntos = 11) pueden leer este nombre de la respuesta del método Enviar->parámetro nombre.

<includeonly>=</includeonly>==Consideraciones sobre Uso del .ZIP en el correo con adjuntos en 11==<includeonly>=</includeonly>
Al momento de sincronizar o cargar el adjunto, se contemplan dos tipos de anexos:
===CargarAdjunto.tipo = 1:===
Indica al web services de adjuntos que es una representación gráfica, estos hará que nuestra plataforma renombre y coloque en él .Zip principal el PDF de la R.G local, de lo contario estará colocando el PDF en él .Zip de adjuntos y esto puede tener complicaciones al momento de la recepción.

Ejemplo:
[[Archivo:cargaAdjuntoTip1.png|centro|'''Ejemplo para tipo 1''']]

===CargarAdjunto.tipo = 2:===
Indicar al web services de adjuntos que es un anexo común.

Ejemplo:
[[Archivo:cargaAdjuntoTip2.png|centro|'''Ejemplo para tipo 2''']]

<includeonly>=</includeonly>==Informar direcciones del adquiriente o receptor del documento electrónico==<includeonly>=</includeonly>
Para este escenario, recomendamos revisar los ejemplos Request-SOAP asociados a direcciones, en los que se detalla cómo no reportar direcciones y en caso de que se reporten cuáles son los campos mínimos obligatorios para clientes nacionales y del extranjero (tipo exportación).

La zona postal pasará a ser opcional, es decir este campo debe ser null o enviarse vació en caso de que no se conozca, ejemplo direccionCliente.zonaPostal = null o direccionCliente.zonaPostal = '', si a partir del 1 de agosto se envía la zona postal en '000000' o un código fuera del catálogo será motivo de rechazo en la DIAN.

<includeonly>=</includeonly>==Responsabilidades Fiscales y Tipos de operación==<includeonly>=</includeonly>
A partir del 1 de agosto deberá informarse en responsabilidadesRut.Obligaciones.obligaciones y FacturaGeneral.tipoOperacion solo los siguientes códigos (cualquier otro código informado puede ser motivo de rechazo en la DIAN):

[[Archivo:respoFiscaTipOpera.png|centro|'''Responsabilidades Fiscales y Tipos de operación''']]

Archivo:AgregarNumerSecuEnPortal.png

2020-09-18T19:30:12Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:23-33-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png

2020-09-18T19:30:08Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:22-32-Documentos Referenciados en Notas de previa que afecten a facturas de validación posterior.png

2020-09-18T19:30:05Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:ZipSinAjduntos.png

2020-09-18T19:08:15Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:ZipEnCorreos.png

2020-09-18T19:07:52Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:ZipConAdjuntos.png

2020-09-18T19:07:43Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:VisualizaRGcamposExtras.png

2020-09-18T19:07:34Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:ValidarDatFiscalesPortal.png

2020-09-18T19:07:23Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:TabResponseParamRecibir.png

2020-09-18T19:06:23Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:TabRequestParamEnviar.png

2020-09-18T19:06:16Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:TabClaseAdjuntos.png

2020-09-18T19:06:04Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:TabCampsExtensiblesCorreoPers.png

2020-09-18T19:05:51Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:TabCamposParamEnviar.png

2020-09-18T19:05:24Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:SecEnPortal.png

2020-09-18T19:05:21Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:RespoFiscaTipOpera.png

2020-09-18T19:05:15Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:RadicarDocumentos.png

2020-09-18T19:05:14Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Mostrar dirección completa en la representación gráfica.png

2020-09-18T19:05:06Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:EnvCorreoMetTrad.png

2020-09-18T19:05:05Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:EjemXMLCamposExtensiblesCorreoPers.png

2020-09-18T19:05:04Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:EjembandejaCorreoCamposExtensiblesCorreoPers.png

2020-09-18T19:05:01Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:EditarPortalRespOpciones.png

2020-09-18T19:04:54Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:EditarPortalResponsabilidades.png

2020-09-18T19:04:49Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:DocRefNotasFactValPrev.png

2020-09-18T19:04:48Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:DocElectrConsumFinal.png

2020-09-18T19:04:45Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:DireccionFiscalFisicaMinima.png

2020-09-18T19:04:42Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:Dirección completa en la representación gráfica.png

2020-09-18T19:04:39Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:ConfigResolPortal.png

2020-09-18T19:04:25Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:CodQrDetalle.png

2020-09-18T19:04:19Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:CatálogosEstablecimientosPortal.png

2020-09-18T19:04:17Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:CargaAdjuntoTip2.png

2020-09-18T19:04:14Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:CargaAdjuntoTip1.png

2020-09-18T19:04:10Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Archivo:CamposDireccionRepGraf.png

2020-09-18T19:04:07Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Pasos que debe seguir si se integra a través de Casa de Software

2020-09-11T16:27:41Z

Fpinto:

[[Archivo:VCS1.jpg|500px|thumb|'''Pasos para Vinculación Casa de Software''']]
__TOC__
 
Pasos que debe seguir para la vinculación a través del Portal Web:

<includeonly>=</includeonly>==Gestión de Credenciales de acceso a la Plataforma Demo de Validación Previa==<includeonly>=</includeonly>
[[Archivo:TokensDemo.png|500px|thumb|'''Credenciales de acceso a Plataforma DEMO''']]
Ingresar al portal y realizar las siguientes configuraciones:

===Paso 1. Registro en el Portal DEMO de Facturación===
: Para crear una cuenta en el Portal Web de Facturación en Ambiente Demo por favor siga las indicaciones del siguiente enlace:
:: [[Pasos que debe seguir para la vinculación a través del Portal Web - Pasos que debe seguir para facturar electrónicamente#Registro en el Portal de Facturación|Registro en el Portal]]

===Paso 2. Configuración de Datos Fiscales===
: Para configurar su cuenta en Demo por favor considere las indicaciones del siguiente enlace:
:: [[Pasos que debe seguir para la vinculación a través del Portal Web - Pasos que debe seguir para facturar electrónicamente#Configuración de Cuenta en el Portal Demo 2.1-Validación Previa|Configuración de Cuenta en el Portal Demo]]

===Paso 3. Configuración de Secuenciales de Numeración===
: Para configurar sus secuenciales por favor siga el siguiente enlace:
:: [[Configuración - Portal DFactura Validación Previa#Configuración de los Secuenciales|Configuración de los Secuenciales]]

===Paso 4. Consulta de Tokens de acceso a la Plataforma DEMO===
: Ingrese al Portal DEMO de Facturación y seguir la ruta: Configuración → Datos Fiscales → Datos del Contribuyente

<includeonly>=</includeonly>==Compartir Credenciales de acceso a la Plataforma Demo de Validación Previa con su Casa de Software==<includeonly>=</includeonly>
Compartir con la Casa de Software o integrador los tokens consultados y URL's suministrados en el correo de '''Inicio de Proyecto'''.
{{clear}}

<includeonly>=</includeonly>==Ensayar diferentes escenarios de facturación propios de su operación==<includeonly>=</includeonly>
[[Archivo:VCS3.jpg|miniaturadeimagen|'''Figura 1: Sección de Soporte''']]
[[Archivo:VCS4.jpg|miniaturadeimagen|'''Figura 2: Manual de Usuario Portal DFactura''']]
Realizar documentos de prueba para verificar que todos los datos se muestran correctamente. Se recomienda simular los diferentes escenarios que puedan presentarse en su Operación de Facturación.

En caso de dudas durante las Fases 2 y 3 puede solicitar soporte a través de los siguientes medios:

'''• Sesiones Virtuales de Consultas:'''

:'''• Sesiones Soporte:''' Inscripción como facturador electrónico, Configuración de Rangos de Numeración, Configuración Datos Fiscales, Pruebas de Habilitación, Configuración ambiente Producción, manejo y uso del Portal de Facturación electrónica de TFHKA

:'''• Dirigido a:''' Agencias Comerciales – Casas de Software Aliadas - Clientes Finales

:'''• Fechas:''' martes & jueves a las 8:30 AM

:'''• Enlace: https://meet.google.com/yyg-pujr-yqv'''

:'''• Chat de soporte de página web: https://www.thefactoryhka.com/co/'''
:'''• Correo electrónico: [[soporte_fel_co@thefactoryhka.com]]'''
:'''• Línea de atención telefónica:''' MASTER +57 (1) 746.08.12 '''Opción 4''', luego '''opción 1'''.
 
Como apoyo para la configuración de su cuenta y creación de Catálogos, en el Portal Demo 2.1, Sección '''Soporte''' ('''Ver Figura 1''') ubicada en el Menú principal, encontrará el '''MANUAL DEL USUARIO PORTAL DFACTURA.''' ('''Ver figura 2''').
{{clear}}

<includeonly>=</includeonly>==Solicitud de Pase a Producción==<includeonly>=</includeonly>
[[Archivo:VCS5.jpg|miniaturadeimagen|'''Figura 3: Formulario Pase a Producción''']]
El pase a producción se debe solicitar con al menos una semana de anticipación para que sea incluido en el cronograma de salida a producción de la semana siguiente, este se solicita a través del siguiente enlace: [https://forms.gle/fFp9xwgHAadjvAg38 '''Formulario Pase a Producción]'''
 
Es importante mencionar, que para migrar su cuenta a ambiente de producción, deberá cumplir con las siguientes validaciones:
 
:• Gestión de Facturación y Pago finalizada
:• Gestión del Certificado Digital finalizado
:• La Razón Social tenga cuenta en Ambiente de Pruebas
{{clear}}

<includeonly>=</includeonly>==Inicio de Emisión de Documentos Electrónicos en Validación Previa==<includeonly>=</includeonly>
Una vez concluidas de forma satisfactoria las pruebas de Habilitación, usted podrá realizar:
 
:- Solicitud de Rangos de Factura Electrónica para Validación Previa
:- Asociar Rangos al Proveedor Tecnológico
:- Configurar el Portal Web de Producción con los nuevos Rangos de Numeración

Se recomienda emitir una Factura de Pruebas por un monto bajo (Ejm: 1 peso) para confirmar que las validaciones del mismo sean exitosas ante la DIAN. Posteriormente se debe realizar la Nota de Crédito correspondiente e iniciar su Operación de Facturación.
{{clear}}

<includeonly>=</includeonly>==Información Adicional==<includeonly>=</includeonly>
Como complemento a las actividades antes mencionadas, se envía el siguiente material:
 
'''Video demostrativo del Portal DEMO de Facturación en Validación Previa''' 
En este vídeo se explican todas las funcionalidades del Portal Web de Facturación de Validación Previa, sirve para familiarizar a los clientes con el entorno, configuración y gestión del portal de Facturación de Validación Previa. Ventana de Inicio, Configuración(Datos fiscales, Personalización de correo, Cambiar contraseña), Catálogos (Clientes, Productos, Unidades de medida, Establecimientos, Usuarios), entre otros.
 
[https://drive.google.com/file/d/1TcCZAt8wmwI-mCPCLlBuwkVdzzjASS1R/view '''Demostracion Portal 2.1''']

'''Video Pasos para la Habilitación ante la DIAN''' 
En este vídeo se explican las diferencias entre los ambiente DEMO y PRODUCCIÓN de The Factory HKA, el paso a paso a seguir para tener acceso al ambiente DEMO su posterior pase a PRODUCCIÓN, y los pasos necesarios ante la DIAN para actualizar el REGISTRO y PRUEBAS DE HABILITACIÓN, y en qué ambiente deben ser realizados en nuestros sistemas.
 
[https://drive.google.com/file/d/1tslrefpqizIVnuYha8QAXUeGCgje5hbS/view '''Habilitacion DIAN''']

'''Documentación de apoyo según el servicio contratado''' 
'''-'''Guía de Habilitación para Validación Previa 
'''-'''Canales de Comunicación en The Factory HKA 
'''-'''Campos Obligatorios para Facturación Electrónica Validación Previa 
'''-'''Flujograma general del proceso Integración Casa de Software 

[https://drive.google.com/drive/folders/1JVFlZlrf1uJk5Kchmv3mut4zCTaYXhwE '''Integración a través de Casa de Software''']
{{clear}}

Archivo:TokensDemo.png

2020-09-11T15:37:38Z

Fpinto: Archivo subido con MsUpload

Archivo subido con MsUpload

Pasos que debe seguir si se integra a través de Casa de Software

2020-09-11T13:31:47Z

Fpinto:

Pasos que debe seguir para la vinculación a través del Portal Web:
[[Archivo:VCS1.jpg|600px|thumb|'''Pasos para Vinculación Casa de Software''']]

<includeonly>=</includeonly>==Gestión de Credenciales de acceso a la Plataforma Demo de Validación Previa==<includeonly>=</includeonly>

Ingresar al portal y realizar las siguientes configuraciones:

===Paso 1. Registro en el Portal DEMO de Facturación===
: Para crear una cuenta en el Portal Web de Facturación en Ambiente Demo por favor siga las indicaciones del siguiente enlace:
:: [[Pasos que debe seguir para la vinculación a través del Portal Web - Pasos que debe seguir para facturar electrónicamente#Registro en el Portal de Facturación|Registro en el Portal]]

===Paso 2. Configuración de Datos Fiscales===
: Para configurar su cuenta en Demo por favor considere las indicaciones del siguiente enlace:
:: [[Pasos que debe seguir para la vinculación a través del Portal Web - Pasos que debe seguir para facturar electrónicamente#Configuración de Cuenta en el Portal Demo 2.1-Validación Previa|Configuración de Cuenta en el Portal Demo]]
===Paso 3. Configuración de Secuenciales de Numeración===
: Para configurar sus secuenciales por favor siga el siguiente enlace:
:: [[Configuración - Portal DFactura Validación Previa#Configuración de los Secuenciales|Configuración de los Secuenciales]]
===Paso 4. Consulta de Tokens de acceso a la Plataforma DEMO===
Ingrese al Portal DEMO de Facturación y seguir la ruta: Configuración → Datos Fiscales → Datos del Contribuyente

[[TokensDemo.png|800px|thumb|'''Credenciales de acceso a Plataforma DEMO''']]

<includeonly>=</includeonly>==Compartir Credenciales de acceso a la Plataforma Demo de Validación Previa con su Casa de Software==<includeonly>=</includeonly>
Compartir con la Casa de Software o integrador los tokens consultados y URL's suministrados en el correo de '''Inicio de Proyecto'''.
{{clear}}

<includeonly>=</includeonly>==Ensayar diferentes escenarios de facturación propios de su operación==<includeonly>=</includeonly>
[[Archivo:VCS3.jpg|miniaturadeimagen|'''Figura 1: Sección de Soporte''']]
[[Archivo:VCS4.jpg|miniaturadeimagen|'''Figura 2: Manual de Usuario Portal DFactura''']]
Realizar documentos de prueba para verificar que todos los datos se muestran correctamente. Se recomienda simular los diferentes escenarios que puedan presentarse en su Operación de Facturación.

En caso de dudas durante las Fases 2 y 3 puede solicitar soporte a través de los siguientes medios:

'''• Sesiones Virtuales de Consultas:'''

:'''• Sesiones Soporte:''' Inscripción como facturador electrónico, Configuración de Rangos de Numeración, Configuración Datos Fiscales, Pruebas de Habilitación, Configuración ambiente Producción, manejo y uso del Portal de Facturación electrónica de TFHKA

:'''• Dirigido a:''' Agencias Comerciales – Casas de Software Aliadas - Clientes Finales

:'''• Fechas:''' martes & jueves a las 8:30 AM

:'''• Enlace: https://meet.google.com/yyg-pujr-yqv'''

:'''• Chat de soporte de página web: https://www.thefactoryhka.com/co/'''
:'''• Correo electrónico: [[soporte_fel_co@thefactoryhka.com]]'''
:'''• Línea de atención telefónica:''' MASTER +57 (1) 746.08.12 '''Opción 4''', luego '''opción 1'''.
 
Como apoyo para la configuración de su cuenta y creación de Catálogos, en el Portal Demo 2.1, Sección '''Soporte''' ('''Ver Figura 1''') ubicada en el Menú principal, encontrará el '''MANUAL DEL USUARIO PORTAL DFACTURA.''' ('''Ver figura 2''').
{{clear}}

<includeonly>=</includeonly>==Solicitud de Pase a Producción==<includeonly>=</includeonly>
[[Archivo:VCS5.jpg|miniaturadeimagen|'''Figura 3: Formulario Pase a Producción''']]
El pase a producción se debe solicitar con al menos una semana de anticipación para que sea incluido en el cronograma de salida a producción de la semana siguiente, este se solicita a través del siguiente enlace: [https://forms.gle/fFp9xwgHAadjvAg38 '''Formulario Pase a Producción]'''
 
Es importante mencionar, que para migrar su cuenta a ambiente de producción, deberá cumplir con las siguientes validaciones:
 
:• Gestión de Facturación y Pago finalizada
:• Gestión del Certificado Digital finalizado
:• La Razón Social tenga cuenta en Ambiente de Pruebas
{{clear}}

<includeonly>=</includeonly>==Inicio de Emisión de Documentos Electrónicos en Validación Previa==<includeonly>=</includeonly>
Una vez concluidas de forma satisfactoria las pruebas de Habilitación, usted podrá realizar:
 
:- Solicitud de Rangos de Factura Electrónica para Validación Previa
:- Asociar Rangos al Proveedor Tecnológico
:- Configurar el Portal Web de Producción con los nuevos Rangos de Numeración

Se recomienda emitir una Factura de Pruebas por un monto bajo (Ejm: 1 peso) para confirmar que las validaciones del mismo sean exitosas ante la DIAN. Posteriormente se debe realizar la Nota de Crédito correspondiente e iniciar su Operación de Facturación.
{{clear}}

<includeonly>=</includeonly>==Información Adicional==<includeonly>=</includeonly>
Como complemento a las actividades antes mencionadas, se envía el siguiente material:
 
'''Video demostrativo del Portal DEMO de Facturación en Validación Previa''' 
En este vídeo se explican todas las funcionalidades del Portal Web de Facturación de Validación Previa, sirve para familiarizar a los clientes con el entorno, configuración y gestión del portal de Facturación de Validación Previa. Ventana de Inicio, Configuración(Datos fiscales, Personalización de correo, Cambiar contraseña), Catálogos (Clientes, Productos, Unidades de medida, Establecimientos, Usuarios), entre otros.
 
[https://drive.google.com/file/d/1TcCZAt8wmwI-mCPCLlBuwkVdzzjASS1R/view '''Demostracion Portal 2.1''']

'''Video Pasos para la Habilitación ante la DIAN''' 
En este vídeo se explican las diferencias entre los ambiente DEMO y PRODUCCIÓN de The Factory HKA, el paso a paso a seguir para tener acceso al ambiente DEMO su posterior pase a PRODUCCIÓN, y los pasos necesarios ante la DIAN para actualizar el REGISTRO y PRUEBAS DE HABILITACIÓN, y en qué ambiente deben ser realizados en nuestros sistemas.
 
[https://drive.google.com/file/d/1tslrefpqizIVnuYha8QAXUeGCgje5hbS/view '''Habilitacion DIAN''']

'''Documentación de apoyo según el servicio contratado''' 
'''-'''Guía de Habilitación para Validación Previa 
'''-'''Canales de Comunicación en The Factory HKA 
'''-'''Campos Obligatorios para Facturación Electrónica Validación Previa 
'''-'''Flujograma general del proceso Integración Casa de Software 

[https://drive.google.com/drive/folders/1JVFlZlrf1uJk5Kchmv3mut4zCTaYXhwE '''Integración a través de Casa de Software''']
{{clear}}

Preguntas Frecuentes de Integración con servicio Web (Val. Previa)

2020-09-11T00:03:42Z

Fpinto: Página creada con «<includeonly>=</includeonly>==Historial de versiones==<includeonly>=</includeonly> {| class="wikitable" style="margin: auto;" |- ! style="background:#e9e9e9; text-align:cen…»

Pasos que debe seguir si se integra a través de Casa de Software

2020-09-10T23:55:37Z

Fpinto:

Pasos que debe seguir para la vinculación a través del Portal Web:
[[Archivo:VCS1.jpg|800px|thumb|'''Pasos para Vinculación Casa de Software''']]

<includeonly>=</includeonly>==Gestión de Credenciales de acceso a la Plataforma Demo de Validación Previa==<includeonly>=</includeonly>

Ingresar al portal y realizar las siguientes configuraciones:

===Paso 1. Registro en el Portal DEMO de Facturación===
: Para crear una cuenta en el Portal Web de Facturación en Ambiente Demo por favor siga las indicaciones del siguiente enlace:
:: [[Pasos que debe seguir para la vinculación a través del Portal Web - Pasos que debe seguir para facturar electrónicamente#Registro en el Portal de Facturación|Registro en el Portal]]

===Paso 2. Configuración de Datos Fiscales===
: Para configurar su cuenta en Demo por favor considere las indicaciones del siguiente enlace:
:: [[Pasos que debe seguir para la vinculación a través del Portal Web - Pasos que debe seguir para facturar electrónicamente#Configuración de Cuenta en el Portal Demo 2.1-Validación Previa|Configuración de Cuenta en el Portal Demo]]
===Paso 3. Configuración de Secuenciales de Numeración===
: Para configurar sus secuenciales por favor siga el siguiente enlace:
:: [[Configuración - Portal DFactura Validación Previa#Configuración de los Secuenciales|Configuración de los Secuenciales]]
===Paso 4. Consulta de Tokens de acceso a la Plataforma DEMO===
Ingrese al Portal DEMO de Facturación y seguir la ruta: Configuración → Datos Fiscales → Datos del Contribuyente

[[TokensDemo.png|800px|thumb|'''Credenciales de acceso a Plataforma DEMO''']]

<includeonly>=</includeonly>==Compartir Credenciales de acceso a la Plataforma Demo de Validación Previa con su Casa de Software==<includeonly>=</includeonly>
Compartir con la Casa de Software o integrador los tokens consultados y URL's suministrados en el correo de '''Inicio de Proyecto'''.
{{clear}}

<includeonly>=</includeonly>==Ensayar diferentes escenarios de facturación propios de su operación==<includeonly>=</includeonly>
[[Archivo:VCS3.jpg|miniaturadeimagen|'''Figura 1: Sección de Soporte''']]
[[Archivo:VCS4.jpg|miniaturadeimagen|'''Figura 2: Manual de Usuario Portal DFactura''']]
Realizar documentos de prueba para verificar que todos los datos se muestran correctamente. Se recomienda simular los diferentes escenarios que puedan presentarse en su Operación de Facturación.

En caso de dudas durante las Fases 2 y 3 puede solicitar soporte a través de los siguientes medios:

'''• Sesiones Virtuales de Consultas:'''

:'''• Sesiones Soporte:''' Inscripción como facturador electrónico, Configuración de Rangos de Numeración, Configuración Datos Fiscales, Pruebas de Habilitación, Configuración ambiente Producción, manejo y uso del Portal de Facturación electrónica de TFHKA

:'''• Dirigido a:''' Agencias Comerciales – Casas de Software Aliadas - Clientes Finales

:'''• Fechas:''' martes & jueves a las 8:30 AM

:'''• Enlace: https://meet.google.com/yyg-pujr-yqv'''

:'''• Chat de soporte de página web: https://www.thefactoryhka.com/co/'''
:'''• Correo electrónico: [[soporte_fel_co@thefactoryhka.com]]'''
:'''• Línea de atención telefónica:''' MASTER +57 (1) 746.08.12 '''Opción 4''', luego '''opción 1'''.
 
Como apoyo para la configuración de su cuenta y creación de Catálogos, en el Portal Demo 2.1, Sección '''Soporte''' ('''Ver Figura 1''') ubicada en el Menú principal, encontrará el '''MANUAL DEL USUARIO PORTAL DFACTURA.''' ('''Ver figura 2''').
{{clear}}

<includeonly>=</includeonly>==Solicitud de Pase a Producción==<includeonly>=</includeonly>
[[Archivo:VCS5.jpg|miniaturadeimagen|'''Figura 3: Formulario Pase a Producción''']]
El pase a producción se debe solicitar con al menos una semana de anticipación para que sea incluido en el cronograma de salida a producción de la semana siguiente, este se solicita a través del siguiente enlace: [https://forms.gle/fFp9xwgHAadjvAg38 '''Formulario Pase a Producción]'''
 
Es importante mencionar, que para migrar su cuenta a ambiente de producción, deberá cumplir con las siguientes validaciones:
 
:• Gestión de Facturación y Pago finalizada
:• Gestión del Certificado Digital finalizado
:• La Razón Social tenga cuenta en Ambiente de Pruebas
{{clear}}

<includeonly>=</includeonly>==Inicio de Emisión de Documentos Electrónicos en Validación Previa==<includeonly>=</includeonly>
Una vez concluidas de forma satisfactoria las pruebas de Habilitación, usted podrá realizar:
 
:- Solicitud de Rangos de Factura Electrónica para Validación Previa
:- Asociar Rangos al Proveedor Tecnológico
:- Configurar el Portal Web de Producción con los nuevos Rangos de Numeración

Se recomienda emitir una Factura de Pruebas por un monto bajo (Ejm: 1 peso) para confirmar que las validaciones del mismo sean exitosas ante la DIAN. Posteriormente se debe realizar la Nota de Crédito correspondiente e iniciar su Operación de Facturación.
{{clear}}

<includeonly>=</includeonly>==Información Adicional==<includeonly>=</includeonly>
Como complemento a las actividades antes mencionadas, se envía el siguiente material:
 
'''Video demostrativo del Portal DEMO de Facturación en Validación Previa''' 
En este vídeo se explican todas las funcionalidades del Portal Web de Facturación de Validación Previa, sirve para familiarizar a los clientes con el entorno, configuración y gestión del portal de Facturación de Validación Previa. Ventana de Inicio, Configuración(Datos fiscales, Personalización de correo, Cambiar contraseña), Catálogos (Clientes, Productos, Unidades de medida, Establecimientos, Usuarios), entre otros.
 
[https://drive.google.com/file/d/1TcCZAt8wmwI-mCPCLlBuwkVdzzjASS1R/view '''Demostracion Portal 2.1''']

'''Video Pasos para la Habilitación ante la DIAN''' 
En este vídeo se explican las diferencias entre los ambiente DEMO y PRODUCCIÓN de The Factory HKA, el paso a paso a seguir para tener acceso al ambiente DEMO su posterior pase a PRODUCCIÓN, y los pasos necesarios ante la DIAN para actualizar el REGISTRO y PRUEBAS DE HABILITACIÓN, y en qué ambiente deben ser realizados en nuestros sistemas.
 
[https://drive.google.com/file/d/1tslrefpqizIVnuYha8QAXUeGCgje5hbS/view '''Habilitacion DIAN''']

'''Documentación de apoyo según el servicio contratado''' 
'''-'''Guía de Habilitación para Validación Previa 
'''-'''Canales de Comunicación en The Factory HKA 
'''-'''Campos Obligatorios para Facturación Electrónica Validación Previa 
'''-'''Flujograma general del proceso Integración Casa de Software 

[https://drive.google.com/drive/folders/1JVFlZlrf1uJk5Kchmv3mut4zCTaYXhwE '''Integración a través de Casa de Software''']
{{clear}}

Archivo:VCS1.jpg

2020-09-10T23:54:08Z

Fpinto: Fpinto subió una nueva versión de Archivo:VCS1.jpg

Sección para clientes de Integración

2020-09-03T16:51:32Z

Fpinto:

[[Archivo:Tfhka-co.png|sinmarco|derecha]]
Bienvenido a la sección para clientes de integración donde podrá encontrar información tal como preguntas frecuentes y manuales útiles en el proceso de integración entre otros.

 
<big>Artículos de Interés:</big>

* [[Indice del Manual de Integración Directa]]
* [[Preguntas Frecuentes de Integración con servicio Web (Val. Previa)]]

Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa

2020-09-02T20:12:25Z

Fpinto:

<includeonly>=</includeonly>==Tablas de códigos de propiedades para emisión de documentos==<includeonly>=</includeonly>
En la siguiente sección encontrará información referente a las diferentes tablas de códigos de propiedades definidas por la DIAN en el anexo técnico.
==Tabla 1==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Documentos
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.1.3. Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
! style="color:white;background:#2F5496; text-align:center;"|Uso
|- valign="center"
|-
|01
|Factura electrónica de Venta
|rowspan="4"|Tipos de factura
|-
|02
|Factura electrónica de Venta - exportación
|-
|03
|Documento electrónico de transmisión - tipo 03
|-
|04
|Factura electrónica de Venta - tipo 04
|-
|91
|Nota Crédito
|rowspan="4"|Exclusivo en referencias a documentos (elementos DocumentReference)
|-
|92
|Nota Débito
|}
|}
==Tabla 2==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Operación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.1.5. Tipos de operación
Para Facturas:
{| 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;"|Valor
|- valign="center"
|-
|10
|Estandar*
|-
|09
|AIU
|-
|11
|Mandatos
|}
Nota: (*) Valor por default
Operación Salud
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|}
Nota: La explicación y vigencia de los tipos de operación para el sector salud se informará en http://url.minsalud.gov.co/facturacion-electronica una vez que el Ministerio de Salud informe a todos los actores regulados por ellos.
Para Notas Crédito:
{| 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;"|Valor
|- valign="center"
|-
|20
|Nota Crédito que referencia una factura electrónica*
|-
|22
|Nota Crédito sin referencia a facturas*.
|-
|23
|Nota Crédito para facturación electrónica V1 (Decreto 2242).
|}
Nota: (*) Preferible para uso de notas rebate o de descuentos condicionados.
Para Notas Débito:
{| 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;"|Valor
|- valign="center"
|-
|30
|Nota Débito que referencia una factura electrónica*
|-
|32
|Nota Débito sin referencia a facturas*.
|-
|33
|Nota Débito para facturación electrónica V1 (Decreto 2242).
|}
Nota: (*) Preferible para uso de notas rebate o de descuentos condicionados.
|}
'''@IMPORTANTE:''' Las notas tipo 22, 23, 32 y 33 no tienen validación de rechazo. (Objeto de control Posterior).

==Tabla 3==
{| class="wikitable" style="width: 100%;"
|+ Tipos de identificación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.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
|-
|50
|NIT de otro país
|-
|91
|NUIP*
|}
|}
'''@IMPORTANTE:''' (*) Deberá utilizarse solamente para el adquirente, debido a que este tipo de documento no pertenece a los tipos de documento en la base de datos del RUT.
==Tabla 4==
{| class="wikitable" style="width: 100%;"
|+ Código de descuento
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.7. Códigos de descuento
{| 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"
|-
|00
|Descuento por impuesto asumido
|-
|01
|Pague uno lleve otro
|-
|02
|Descuentos contractuales
|-
|03
|Descuento por pronto pago
|-
|04
|Envío gratis
|-
|05
|Descuentos específicos por inventarios
|-
|06
|Descuento por monto de compras
|-
|07
|Descuento de temporada
|-
|08
|Descuento por actualización de productos/servicios
|-
|09
|Descuento general
|-
|10
|Descuento por volumen
|-
|11
|Otro descuento
|}
|}
==Tabla 5==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Persona
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| 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
|-
|2
|Persona Natural
|}
|}
==Tabla 6==
{| class="wikitable" style="width: 100%;"
|+ Unidades de Medida
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.5.1. Unidades de Cantidad: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|04
|spray pequeño
|BIL
|trillón de dólares
|HUR
|hora
|-
|05
|levantar
|BJ
|cangilón
|HY
|cien yardas
|-
|08
|Lote calor
|BK
|cesta
|IA
|pulgada libra
|-
|10
|grupo
|BL
|bala
|IC
|contar por pulgada
|-
|11
|equipar
|BLD
|barril seco
|IE
|persona
|-
|13
|ración
|BLL
|barril (EE.UU.)(petróleo, etc.)
|IF
|pulgadas de agua
|-
|14
|disparo
|BO
|botella
|II
|columna pulgada
|-
|15
|palo
|BP
|cien pies de tabla
|IL
|pulgada por minuto
|-
|16
|tambor de ciento quince kg
|BQL
|becquerel
|IM
|impresión
|-
|17
|tambor de cien libras
|BR
|bar
|INH
|pulgada
|}
|}
'''@IMPORTANTE:''' Esta catalogo es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.
==Tabla 7==
{| class="wikitable" style="width: 100%;"
|+ Códigos para precios de referencia
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| 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"
|-
|01
|Valor comercial
|-
|02
|Valor en inventarios
|-
|03
|Otro valor
|}
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo '''codigoTipoPrecio'''
|}
==Tabla 8==
{| class="wikitable" style="width: 100%;"
|+ Códigos para productos y servicios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|Utilizar
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Compra Eficiente: utilizar contenido de la columna "Código"
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Números Globales de Identificación de Productos - GTIN
* Ver 8.2
* Cuando hay menos de 14 números en una estructura de datos (por ejemplo, GTIN8), los números se deben justificar a la derecha en un campo de 14 dígitos rellenado con cerros en las posiciones ubicadas más a la izquierda.
|-
|020
|Partida Arancelarias
|195
|style="text-align:left;"|Partida arancelaria
|-
|999
|Estándar de adopción del contribuyente
|
|style="text-align:left;"|
* El valor en el atributo @schemeName no será validado
* El atributo @schemeAgencyID no debe ser utilizado
|}
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo '''codigoTipoPrecio'''
|}
'''@IMPORTANTE:''' Para mayor información del código para productos y servicios hacer referencia a la sección del Anexo correspondiente.
==Tabla 9==
{| class="wikitable" style="width: 100%;"
|+ Motivos de Nota de crédito
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.5. Concepto de Corrección para Notas crédito: cac:DiscrepancyResponse/cbc:ResponseCode
{| 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"
|-
|1
|style="text-align:left;"|Devolución de parte de los bienes; no aceptación de parte del servicio
|-
|2
|style="text-align:left;"|Anulación de factura electrónica
|-
|3
|style="text-align:left;"|Rebaja total aplicada
|-
|4
|style="text-align:left;"|Descuento total aplicado
|-
|5
|style="text-align:left;"|Rescisión: nulidad por falta de requisitos
|-
|6
|style="text-align:left;"|Otros
|}
|}
==Tabla 10==
{| class="wikitable" style="width: 100%;"
|+ Motivos de Nota de débito
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.6. Concepto de Corrección para Notas débito: cac:DiscrepancyResponse/cbc:ResponseCode
{| 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"
|-
|1
|style="text-align:left;"|Intereses
|-
|2
|style="text-align:left;"|Gastos por cobrar
|-
|3
|style="text-align:left;"|Cambio del valor
|-
|4
|style="text-align:left;"|Otros
|}
|}
==Tabla 11==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Impuesto
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Impuesto de Valor Agregado
|-
|02
|IC
|style="text-align:left;"|Impuesto al Consumo
|-
|03
|ICA
|style="text-align:left;"|Impuesto de Industria, Comercio y Aviso
|-
|04
|INC
|style="text-align:left;"|Impuesto Nacional al Consumo
|-
|05
|ReteIVA
|style="text-align:left;"|Retención sobre el IVA
|-
|06
|ReteFuente
|style="text-align:left;"|Retención sobre Renta
|-
|07
|ReteICA
|style="text-align:left;"|Retención sobre el ICA
|-
|20
|FtoHorticultura
|style="text-align:left;"|Cuota de Fomento Hortifrutícula
|-
|21
|Timbre
|style="text-align:left;"|Impuesto de Timbre
|-
|22
|Bolsas
|style="text-align:left;"|Impuesto al Consumo de Bolsa Plástica
|-
|23
|INCarbono
|style="text-align:left;"|Impuesto Nacional al Carbono
|-
|24
|INCombustibles
|style="text-align:left;"|Impuesto Nacional a los Combustibles
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Sobretasa a los combustibles
|-
|26
|Sordicom
|style="text-align:left;"|Contribución minoristas (Combustibles)
|-
|ZY
|No causa
|style="text-align:left;"|No responsable de tributo
|-
|ZZ
|Nombre de la figura tributaria
|style="text-align:left;"|Otros tributos, tasas, contribuciones, y similares
|}
|}
==Tabla 12==
{| class="wikitable" style="width: 100%;"
|+ Tarifas por Impuesto
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.8. Tablas de tarifas por Impuesto
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Impuesto que reporta
! style="color:white;background:#2F5496; text-align:center;"|Valores posibles para el campo cbc:Percent
la tarifa a informar dependerá del aspecto tributario del impuesto reportado
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|Tarifa
| 
|-
| Concepto|| (cbc:Percent)||  
|-
| Excluido ||   || Cuando el item sea "excluido" del IVA, no se debe reportar el IVA en el grupo de impuestos.
|-
| Excento|| 0.00 ||  |
|-
| Bienes/Servicios al 5|| 5.00 ||  |
|-
| Contratos firmados con el estado antes de ley 1819|| 16.00 ||  
|-
| Tarifa general|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|Tarifa
| 
|-
| Concepto           || (cbc:Percent)||  
|-
| Tarifa especial|| 2.00 ||  
|-
| Tarifa especial|| 4.00 ||  |
|-
| Tarifa especial|| 8.00 ||  |
|-
| Tarifa especial|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|-
|ReteFuente
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|Tarifa
| 
|-
| Conceptos|| (cbc:Percent)||  
|-
| Compras generales (declarantes)|| 2.50 ||  
|-
| Compras generales (no declarantes)|| 3.50 ||  
|-
| Compras con tarjeta débito o crédito|| 1.50 ||  
|-
| Compras de bienes o productos agrícolas o pecuarios sin procesamiento industrial|| 1.50 ||  
|-
| Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial (declarantes)|| 2.50 ||  
|-
| Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial (no declarantes)|| 3.50 ||  
|-
| Compras de café pergamino o cereza|| 0.50 ||  
|-
| Compras de combustibles derivados del petróleo|| 0.10 ||  
|}
|}
|}
@IMPORTANTE: Este catálogo '''tarifas por Impuesto''' es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.

==Tabla 13==
{| class="wikitable" style="width: 100%;"
|+ Medios de Pago
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.4.2. Medios de Pago: cbc:PaymentMeansCode
{| 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;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|1
|Instrumento no definido
|39
|Crédito Negocio Intercambio Corporativo (CTX)
|-
|2
|Crédito ACH
|40
|Débito Negocio Intercambio Corporativo (CTX)
|-
|3
|Débito ACH
|41
|Concentración efectivo/Desembolso Crédito plus (CCD+)
|-
|4
|Reversión débito de demanda ACH
|42
|Consiganción bancaria
|-
|5
|Reversión crédito de demanda ACH
|43
|Concentración efectivo / Desembolso Débito plus (CCD+)
|-
|6
|Crédito de demanda ACH
|44
|Nota cambiaria
|-
|7
|Débito de demanda ACH
|45
|Transferencia Crédito Bancario
|-
|8
|Mantener
|46
|Transferencia Débito Interbancario
|-
|9
|Clearing Nacional o Regional
|47
|Transferencia Débito Bancaria
|-
|10
|Efectivo
|48
|Tarjeta Crédito
|-
|11
|Reversión Crédito Ahorro
|49
|Tarjeta Débito
|-
|12
|Reversión Débito Ahorro
|50
|Postgiro
|-
|13
|Crédito Ahorro
|51
|Telex estándar bancario francés
|-
|14
|Débito Ahorro
|52
|Pago comercial urgente
|-
|15
|Bookentry Crédito
|53
|Pago Tesorería Urgente
|-
|16
|Bookentry Débito
|60
|Nota promisoria
|-
|17
|Concentración de la demanda en efectivo/Desembolso Crédito (CCD)
|61
|Nota promisoria firmada por el acreedor
|-
|18
|Concentración de la demanda en efectivo /Desembolso (CCD) débito
|62
|Nota promisoria firmada por el acreedor, avalada por elbanco
|-
|19
|Crédito Pago negocio corporativo (CTP)
|63
|Nota promisoria firmada por el acreedor, avalada por untercero
|-
|20
|Cheque
|64
|Nota promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Nota promisoria firmada por un banco avalada por otrobanco
|-
|22
|Proyecto bancario certificado
|66
|Nota promisoria firmada
|-
|23
|Cheque bancario
|67
|Nota promisoria firmada por un tercero avalada por unbanco
|-
|24
|Nota cambiaria esperando aceptación
|70
|Retiro de nota por el por el acreedor
|-
|25
|Cheque certificado
|71
|Bonos
|-
|26
|Cheque Local
|72
|Vales
|-
|27
|Débito Pago Neogcio Corporativo (CTP)
|74
|Retiro de nota por el por el acreedor sobre un banco
|-
|28
|Crédito Negocio Intercambio Corporativo (CTX)
|75
|Retiro de nota por el acreedor, avalada por otro banco
|-
|29
|Débito Negocio Intercambio Corporativo (CTX)
|76
|Retiro de nota por el acreedor, sobre un banco avalada porun tercero
|-
|30
|Transferecia Crédito
|77
|Retiro de una nota por el acreedor sobre un tercero
|-
|31
|Transferencia Débito
|78
|Retiro de una nota por el acreedor sobre un terceroavalada por un banco
|-
|32
|Concentración Efectivo / Desembolso Crédito plus(CCD+)
|91
|Nota bancaria tranferible
|-
|33
|Concentración Efectivo / Desembolso Débito plus(CCD+)
|92
|Cheque local traferible
|-
|34
|Pago y depósito pre acordado (PPD)
|93
|Giro referenciado
|-
|35
|Concentración efectivo ahorros / Desembolso Crédito(CCD)
|94
|Giro urgente
|-
|36
|Concentración efectivo ahorros / Desembolso Drédito(CCD)
|95
|Giro formato abierto
|-
|37
|Pago Negocio Corporativo Ahorros Crédito (CTP)
|96
|Método de pago solicitado no usuado
|-
|38
|Pago Neogcio Corporativo Ahorros Débito (CTP)
|97
|Clearing entre partners
|-
|
|
|ZZZ
|Acuerdo mutuo
|}
|}
==Tabla 14==
{| class="wikitable" style="width: 100%;"
|+ Forma ó Metodo de Pago
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.4.1. Formas de Pago: cbc:PaymentMeans/ID
{| 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
|Contado
|-
|2
|Crédito
|}
|}
==Tabla 15==
{| class="wikitable" style="width: 100%;"
|+ Condiciones de entrega (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.6. Condiciones de entrega (INCOTERMS): …/cbc:LossRiskResponsibilityCode
{| 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"
|-
|CFR
|Costo y flete
|-
|CIF
|Costo, flete y seguro
|-
|CIP
|Transporte y Seguro Pagados hasta
|-
|CPT
|Transporte Pagado Hasta
|-
|DAP
|Entregado en un Lugar
|-
|DAT
|Entregado en Terminal
|-
|DDP
|Entregado con Pago de Derechos
|-
|EXW
|En Fábrica
|-
|FAS
|Franco al costado del buque
|-
|FCA
|Franco transportista
|-
|FOB
|Franco a bordo
|}
|}
==Tabla 16==
{| class="wikitable" style="width: 100%;"
|+ Departamentos (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.4.2. Departamentos (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode
{| 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;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Código ISO
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Código ISO
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}
==Tabla 17==
{| class="wikitable" style="width: 100%;"
|+ Responsabilidades fiscales
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.7. Responsabilidades fiscales: cbc:TaxLevelCode
{| 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"
|-
|0-13
|Gran contribuyente
|-
|0-15
|Autorretenedor
|-
|0-23
|Agente de retención en el impuesto sobre las ventas
|-
|0-47
|Régimen Simple de Tributación – SIMPLE
|-
|R-99-PN
|No responsable
|}
|}
==Tabla 18==
{| class="wikitable" style="width: 100%;"
|+ Detalles tributarios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|01
|IVA
|Impuesto de Valor Agregado
|-
|02
|IC
|Impuesto al Consumo
|-
|03
|ICA
|Impuesto de Industria, Comercio y Aviso
|-
|04
|INC
|Impuesto Nacional al Consumo
|-
|05
|ReteIVA
|Retención sobre el IVA
|-
|06
|ReteFuente
|Retención sobre Renta
|-
|07
|ReteICA
|Retención sobre el ICA
|-
|20
|FtoHorticultura
|Cuota de Fomento Hortifrutícula
|-
|21
|Timbre
|Impuesto de Timbre
|-
|22
|Bolsas
|Impuesto al Consumo de Bolsa Plástica
|-
|23
|INCarbono
|Impuesto Nacional al Carbono
|-
|24
|INCombustibles
|Impuesto Nacional a los Combustibles
|-
|25
|Sobretasa Combustibles
|Sobretasa a los combustibles
|-
|26
|Sordicom
|Contribución minoristas (Combustibles)
|-
|ZY
|No causa
|No responsable de tributo
|-
|ZZ
|Nombre de la figura tributaria
|Otros tributos, tasas, contribuciones, y similares
|}
|}
==Tabla 19==
{| class="wikitable" style="width: 100%;"
|+ Municipios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.4.3. Municipios: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código Departamento
! style="color:white;background:#2F5496; text-align:center;"|Código Municipio
! style="color:white;background:#2F5496; text-align:center;"|Nombre Departamento
! style="color:white;background:#2F5496; text-align:center;"|Nombre Municipio
|- valign="center"
|-
|05
|05044
|Antioquia
|ANZÁ
|-
|05
|05045
|Antioquia
|APARTADÓ
|-
|05
|05051
|Antioquia
|ARBOLETES
|-
|05
|05055
|Antioquia
|ARGELIA
|-
|05
|05059
|Antioquia
|ARMENIA
|-
|05
|05079
|Antioquia
|BARBOSA
|-
|05
|05086
|Antioquia
|BELMIRA
|-
|05
|05088
|Antioquia
|BELLO
|-
|05
|05091
|Antioquia
|BETANIA
|-
|05
|05093
|Antioquia
|BETULIA
|-
|05
|05101
|Antioquia
|CIUDAD BOLÍVAR
|-
|05
|05107
|Antioquia
|BRICEÑO
|-
|05
|05113
|Antioquia
|BURITICÁ
|-
|05
|05120
|Antioquia
|CÁCERES
|-
|05
|05125
|Antioquia
|CAICEDO
|-
|05
|05129
|Antioquia
|CALDAS
|-
|05
|05134
|Antioquia
|CAMPAMENTO
|-
|05
|05138
|Antioquia
|CAÑASGORDAS
|-
|05
|05142
|Antioquia
|CARACOLÍ
|-
|05
|05145
|Antioquia
|CARAMANTA
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANTE:''' Este catálogo '''municipios''' es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.
==Tabla 20==
{| class="wikitable" style="width: 100%;"
|+ Zona Postal
|- valign="center"
|colspan="2"|Anexo 1.7-2020 - 6.4.4. Código Postal cbc:PostalZone 
En Colombia el código postal consta de 6 dígitos (ejemplo: 578986) que señalan inicialmente la posición geográfica, seguida por la de encaminamiento y finalmente la que nos ubica dentro del área postal, así:

'''Departamentos Nacionales''' 
Los dos primeros dígitos representan a los departamentos nacionales, utilizando la codificación vigente Dane. Los códigos menores de 10 deben iniciar con un cero a la izquierda.

'''Zonas postales departamentales de encaminamiento''' 
La tercera y cuarta posición definen las zonas postales de encaminamiento para facilitar la clasificación a través del Código Postal: El 00 queda reservado para la capital del departamento. Del 01 al 89 permite dividir cada departamento hasta en 89 zonas de encaminamiento postal.

'''Distrito postales por municipio o localidad''' 
Las dos últimas posiciones del Código Postal Nacional permiten asignar cien distritos postales a cada una de las diez zonas postales creadas en cada departamento. Es decir, se pueden asignar hasta mil distritos distintos en cada departamento, para un total de treinta y tres mil a nivel nacional.
|}
@IMPORTANTE: Link de consulta para códigos de Zona Postal: http://visor.codigopostal.gov.co/472/visor/
==Tabla 21==
{| class="wikitable" style="width: 100%;"
|+ Referencia a otros documentos
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7 - 6.1.4. Referencia a documentos no tributarios: cbc:DocumentTypeCode
{| 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"
|-
|AAJ
|Orden de Entrega (remisión)
|-
|R1
|Referencias internas
|-
|R2
|Referencias internas
|}
|}
@IMPORTANTE: Estos documentos representan acciones comerciales y mercantiles que amparan o soportan transacciones relacionadas con este documento electrónico. Al tratar se una orden de entrega se debe utilizar el grupo de elemento OrderReference, al informar mas de una se debe disponer del grupo AdditionalDocumentReference.

Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa

2020-09-02T20:11:56Z

Fpinto:

<includeonly>=</includeonly>==Catálogo de errores de respuesta del servicio web ==<includeonly>=</includeonly>
En la siguiente sección encontrará información referente a las respuestas del servicio web.
==Códigos de respuesta para el Método Enviar==
{| class="wikitable" "style="text-align:center;"
|+ Método Enviar
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío Satisfactorio
|Procesado
|200
|El documento se envió correctamente (Síncrono).
|-
|Envío Satisfactorio
|Procesado
|201
|Documento recibido, se enviará más tarde a la DIAN (Asíncrono).
|-
|Envío Satisfactorio
|Procesado
|208
|Documento de contingencia recibido, se enviará más tarde a la DIAN (Asíncrono).
|-
|Error por Excepciones generales
|Error
|103
|Error de Procesamiento (Debe enviar xml-request para su análisis)
|-
|Error en capa de Validaciones TFHKA
|Error
|109
|
Ejm: El campo {nombre del campo} es obligatorio
Ejm: El campo {nombre del campo} debe ser numérico.
Ejm: El cliente No posee Folios Disponibles
(Debe enviar xml-request para su análisis)
|-
|Error por Excepciones XSLT Local (TFHKA)
|Error
|161
|
Debe validarse el XML/UBL generado
(Debe enviar xml-request para su análisis)
|-
|Error en Validaciones XSLT Local (TFHKA)
|Error
|110
|
Ejm: Fatal: [FAR08]- (R) Total de la factura 100.00 diferente de la suma de Total valor bruto + Total Tributos - Anticipos (+/-) Redondeos: 120.00}
(Debe enviar xml-request para su análisis)
|-
|Error Factura ya emitida o se encuentra en TFHKA y DIAN
|Error
|114
|
Documento emitido previamente
(Debe consultar el EstadoDocumento)
|-
|Documento rechazo por la DIAN
|Error
|99
|
Documento fue rechazado por la DIAN
(Debe validarse los motivos de rechazo o reglasValidacionDIAN)
|-
|Envío de Datos
|Error
|111
|
La longitud del campo Token [empresa/password] no cumple con el rango permitido.
El campo Token [empresa/password] solo debe tener números y letras
|-
|Token invalido
|Error
|101
|
El Token del Emisor es inválido.
(Debe validarse el ambiente al que corresponden los tokens utilizados y URL’s de conexión)
|-
|Error al parsear el documento
|Error
|112
|
Error al extraer la información del documento al comprobante.
(Debe enviar xml-request para su análisis)
|-
|Error validaciones incorrectas en los rangos
|Error
|117
|
Error. El rango, fecha de la factura o fecha de autorización son inválidos. / Error el número de documento es inválido.
(Debe validarse configuraciones del secuencial en el portal y ERP)
|-
|Error validación de autorización en los rangos
|Error
|118
|
Error, el número de autorización o el tipo de documento es inválido. / Error el número de documento es inválido.
(Debe validarse configuraciones del secuencial en el portal y ERP)
|-
|Error validación de Folios
|Error
|119
|
No posee folios disponibles.
Se debe contactar al nuestro equipo de facturación para adquirir un paquete de transacciones o folios.
|-
|Error validación en rango
|Error
|150
|
No existe el rango de numeración.
(Debe validarse el tipo de documento y si el rango está configurado en el portal)
|}
'''@IMPORTANTE:''' Ante un código de error diferente a los anteriores por favor enviar el '''request soap-Envelope''' del documento al alias [http://integracion_fel_co@thefactoryhka.com integracion_fel_co@thefactoryhka.com] exponiendo el caso.

==Códigos de respuesta para el Método EstadoDocumento==
{| class="wikitable" "style="text-align:center;"
|+ Método EstadoDocumento
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retornan datos de la factura
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error al extraer los datos del documento.
|}

==Códigos de respuesta para el Método EnvioCorreo==
{| class="wikitable" "style="text-align:center;"
|+ Método EnvioCorreo
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se ha enviado el email de manera correcta
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Correo inválido
|Error
|106
|Formato de correo electrónico inválido.
|}

==Códigos de respuesta para el Método DescargaPDF==
{| class="wikitable" "style="text-align:center;"
|+ Método DescargaPDF
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}

==Códigos de respuesta para el Método DescargaXML==
{| class="wikitable" "style="text-align:center;"
|+ Método DescargaXML
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}

==Códigos de respuesta para el Método GenerarContenedor==
{| class="wikitable" "style="text-align:center;"
|+ Método GenerarContenedor
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}

==Códigos de respuesta para el Método FoliosRestantes==
{| class="wikitable" "style="text-align:center;"
|+ Método FoliosRestantes
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna folios restantes.
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|}

==Códigos de respuesta para el Método CargarAdjuntos==
{| class="wikitable" "style="text-align:center;"
|+ Método CargarAdjuntos
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Archivo {nombreDelArchivo}{extensión} almacenado exitosamente
|-
|Error en carga de archivo
|Error
|107
|
Se señaló previamente que para el documento {consecutivo} emitido por {NIT Emisor} ya se habían completado los adjuntos esperados
: (Quiere decir que ya la propiedad enviar fue configurada en “1” anteriormente)
|-
|Error en Validaciones
|Error
|109
|
: [Sección del Error]El campo {nombre del campo} debe tener un valor del catálogo.
: [Sección del Error]El campo {nombre del campo} es requerido.
: [Sección del Error]El campo {nombre del campo} debe ser un {tipo de datos} de {tamaño} {numérico/alfanumérico}.
|}

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

2020-09-02T18:00:26Z

Fpinto:

<includeonly>=</includeonly>==Métodos servicio reportes web soap ==<includeonly>=</includeonly>
El Servicio Reportes Web SOAP, expone métodos a través de los cuales el software de facturación puede administrar la generación de reportes de los documentos emitidos, eliminando así la necesidad al facturador de ingresar al portal The Factory HKA - Dfactura para este fin. A continuación se detallan los métodos disponibles en este Web Services:
===Método “DescargarReporte”===
Permite descargar un reporte de los documentos electrónicos emitidos y almacenados en la plataforma TFHKA de acuerdo a los filtros indicados en el método '''''ProgramarReporte''''', es decir, es un proceso asíncrono.
; 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
|-
|IdReporte
|Identificador que se obtiene al programar el reporte
|}
; REQUEST: 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: (Por definir catálogo)
|-
|String
|formato
|Formato del reporte, formatos: (pdf, doc, docx, xls, xlsx)
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|String
|reporte
|Reporte solicitado codificado en Base64
|-
|String
|resultado
|Resultado del consumo del método: “Procesado” ó “Error”
|}
{{clear}}
===Método “ProgramarReporte”===
Método utilizado para programar los filtros del reporte de los documentos electrónicos emitidos que se desea obtener o descargar a través del método '''DescargarReporte'''.
; 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
|-
|Reporte
|reporte
|Objeto con los datos y filtros del reporte que se desea programar
|}
Donde Class.Reporte 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
|email
|Correo al cual se enviará el reporte programado
|-
|Filtros
|filtros
|Campos que se deben visualizar en el reporte
|-
|String
|formato
|Extensión del archivo adjunto, formatos permitidos: (pdf, doc, docx, xls, xlsx)
|}
Donde Class.Filtros 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
|CodigoProducto
|Código del producto
|-
|String
|Condicion
|Condición de la transacción (acuseEstatus)
|-
|int
|Estatus
|Estatus del documento (entregaCodigo)
|-
|String
|FechaHasta
|Fecha final del reporte
|-
|String
|FechaInicio
|Fecha inicial del reporte
|-
|String
|NumeroIdentificacionAdquiriente
|Número de identificación del adquiriente
|-
|Array <ExtrasFiltros>
|OtrosFiltros
|Información de otros filtros de interés
|-
|String
|TipoDocumento
|Tipo documento electrónico. Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|TipoIdentificacionAdquiriente
|Tipo de identificación del adquiriente Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}
Donde Class.ExtrasFiltros 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
|}
; REQUEST: 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 (Por definir catálogo)
|-
|String
|idReporte
|Este mensaje está asociado al código, útil para identificación de errores
|-
|String
|mensaje
|Este mensaje de identificación de errores
|-
|String
|resultado
|Resultado del consumo del método: “Procesado” ó “Error”
|}
{{clear}}
===Método “SolicitudReporteSincrono”===
Método utilizado para solicitar un reporte de manera inmediata (síncrona) de los documentos electrónicos emitidos.
; 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
|-
|Filtros
|filtros
|Campos que se deben visualizar en el reporte
|}
Donde Class.Filtros 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
|CodigoProducto
|Código del producto
|-
|String
|Condicion
|Condición de la transacción (acuseEstatus)
|-
|String
|Estatus
|Estatus del documento (entregaCodigo)
|-
|String
|FechaHasta
|Fecha final del reporte
|-
|String
|FechaInicio
|Fecha inicial del reporte
|-
|String
|NumeroIdentificacionAdquiriente
|Número de identificación del adquiriente
|-
|Array <ExtrasFiltros>
|OtrosFiltros
|Información de otros filtros de interés
|-
|String
|TipoDocumento
|Tipo documento electrónico. Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 1|Tabla 1]]
|-
|String
|TipoIdentificacionAdquiriente
|Tipo de identificación del adquiriente Ver [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
|}
Donde Class.ExtrasFiltros 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
|}
; REQUEST: 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
|ResultadosReporte
|Arreglo con los datos del reporte (En definición)
|-
|int
|código
|Indica el Estado de la operación retornado por el servicio (Por definir catálogo)
|-
|String
|hash
|Código de detección de errores
|-
|String
|mensaje
|Este mensaje está asociado al código, útil para identificación de errores
|-
|String
|pagina
|Número de página del reporte
|-
|String
|resultado
|Resultado del consumo del método: “Procesado” ó “Error”
|-
|int
|total
|Total páginas del reporte
|}
{{clear}}

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

2020-09-02T17:56:54Z

Fpinto:

<includeonly>=</includeonly>==Método Servicio Emisión Web Soap==<includeonly>=</includeonly>
Los parámetros a incorporar en los métodos de este Web Service deberán cumplir con el formato y las directivas que correspondan según las siguientes reglas:

{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Formato
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| A || Carácter alfabético
|-
| N || Carácter numérico
|-
| AN || Carácter alfanumérico
|-
| <nowiki> A|3 </nowiki> || 3 caracteres alfabéticos (longitud fija)
|-
| <nowiki> N|3 </nowiki> || 3 caracteres numéricos (longitud fija)
|-
| <nowiki> AN|3 </nowiki> || 3 caracteres alfanuméricos (longitud fija)
|-
| <nowiki> A|..3 </nowiki> || Hasta 3 caracteres alfabéticos (longitud variable)
|-
| <nowiki> N|..3 </nowiki> || Hasta 3 caracteres numéricos (longitud variable)
|-
| <nowiki> AN|..3 </nowiki> || Hasta 3 caracteres alfanuméricos (longitud variable)
|-
| <nowiki> N|2..6 </nowiki> || Entre 2 y 6 caracteres numéricos (longitud variable)
|-
| INT32 || Entero. (Valor Máximo: 2,147,483,647)
|}
{{clear}}
 
{| class="mw-collapsible mw-collapsed wikitable" style="margin: auto;"
|-
! style="background:#e9e9e9; text-align:center;"|Obligatorio
! style="background:#e9e9e9; text-align:center;"|Descripción
|- valign="center"
| SI || Si es obligatorio para la DIAN
|-
| NO || No es obligatorio para la DIAN
|-
| C/C || Es requerido cuando corresponda (o bajo cierta condición por el modelo de negocio del cliente)
|}
{{clear}}

===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 solo XML sin representación Gráfica estándar por The Factory HKA
: “11” Admite archivos adjuntos. Se genera solo 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 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
: '''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..20
|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’
: '''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
|-
|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]]
|-
|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.FacturaDetalle====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|cantidadPorEmpaque
|String
| <nowiki>N|..3 </nowiki>
| NO
|
: Cantidad de unidad de este artículo por empaque.
: Por ejemplo, si el artículo son tres “six pack”, la cantidad a reportar en cantidadPorEmpaque es 6, mientras la cantidad a reportar en cantidadReal es 3, y el total de latas que se está describiendo son 18
: '''PATH''': ..cac:Item/cbc:PackSizeNumeric
|-
|cantidadReal
|String
|<nowiki>N|..6</nowiki>
|SI
|
: Cantidad real sobre la cual el precio aplica
: '''PATH''': .. /cac:Price/cbc:BaseQuantity
|-
|cantidadRealUnidadMedida
|String
|<nowiki>AN|..6</nowiki>
|SI
|
: Unidad de la cantidad sobre la cual el precio aplica
: 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>
|SI
|
: Descripción del producto o servicio
: '''PATH''': ../Item/cbc:Description
|-
|descripcionTecnica
|String
|<nowiki>AN|..300</nowiki>
|NO
|
: Datos técnicos asociados al producto o servicio
: '''PATH''': .. /cac:Item/cbc:AdditionalInformation
|-
|documentosReferenciados
|Array <DocumentoReferenciado>
| -
|NO
|
: Informaciones que describen un documento referenciado
: '''Obligatorio''' En facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse)
: '''PATH''': /root/cac:DiscrepancyResponse,
: /root/cac:BillingReference,
: /root/cac: AdditionalDocumentReference,
: /root/cac: DespatchDocumentReference,
: /root/cac: ReceiptDocumentReference
: (ver detalle en [[#Class.DocumentoReferenciado|Class.DocumentoReferenciado]])
|-
|estandarCodigo
|String
|AN
|NO
|
: Código del estándar (identificación del artículo o servicio de acuerdo con un estándar)
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: 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
|NO
|
: Código del producto según el estándar informado en estandarCodigo
: Ver valores del atributo en la [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 8|Tabla 8]]
: '''PATH''': ../cac:Item/cac:StandardItemIdentification/cbc:ID
|-
|estandarOrganizacion
|String
| -
|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.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.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)
|-
|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,
: 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
|}
'''@IMPORTANTE:'''
''# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, ransferênc.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

====Class.Entrega====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|datosTransportistas
|DatoTransportistas
| -
|NO
|
: Datos del Transportista
: '''PATH''': ../cac:DeliveryParty
: (ver detalle en [[#Class.DatosTransportista|Class.DatosTransportista]])
|-
|direccionDespacho
|Direccion
| -
|NO
|
: Información de Despacho
: '''PATH''': ../cac:Despatch/cac:DespatchAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|direccionEntrega
|Direccion
| -
|NO
|
: Información de Entrega
: '''PATH''': ../cac:DeliveryAddress
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|fechaEfectivaSalida
|String
|<nowiki>AN|19</nowiki>
|NO
|
: Fecha y hora efectiva de salida de los bienes, en formato: YYYY-MM-DD HH:MM:SS
: 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.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.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>
|C/C
|
: Número de la Orden de Compra
: '''Obligatorio''' Para enviar la Orden de Compra
: '''PATH''': ../cbc:ID
|-
|numeroPedido
|String
|<nowiki>AN|..20</nowiki>
|C/C
|
: Número del Pedido
: '''Obligatorio''' Para enviar el Pedido
: '''PATH''': ../cbc:SalesOrderID
|-
|tipoCUFE
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Identificador del tipo de CUFE
: '''PATH''': ../cbc:UUID@schemeName
|-
|tipoOrden
|String
|<nowiki>AN|..20</nowiki>
|NO
|
: Tipo de Orden
: '''PATH''': ../cbc:OrderTypeCode
|-
|uuid
|String
|<nowiki>AN|..90</nowiki>
|NO
|
: UUID de algún documento referenciado
: '''PATH''': ../cbc:UUID
|}
'''NOTA:''' Al tratarse de una orden de entrega se debe informar la clase OrdenDeCompra, si es necesario indicar más de una orden se debe informar a través de la clase DocumentoReferenciado con '''codigoInterno''' =’1’, esto con el fin de enviar la información referente a las mismas en el grupo AdditionalDocumentReference.
====Class.TasaDeCambio====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|baseMonedaDestino
|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.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|..50</nowiki>
|NO
|
: Subdivisión (Nombre del Barrio)
: '''PATH''': ../cac:Address/cbc:CitySubdivisionName
|-
|ubicación
|String
|<nowiki>AN|..50</nowiki>
|NO
|
: Una ubicación específica dentro de un edificio
: '''PATH''': ../cac:Address/cbc:InhouseMail
|-
|zonaPostal
|String
|<nowiki>AN|..10</nowiki>
|NO
|
: Zona Postal
: 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.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.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]])
|}
====Class.InformacionLegalCliente====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|codigoEstablecimiento
|String
| -
|NO
|
: Código de Establecimiento
: <nowiki>PATH</nowiki>: /cac:CorporateRegistrationScheme/cbc:CorporateRegistrationTypeCode
|-
|nombreRegistroRUT
|String
|<nowiki>AN|..450</nowiki>
|SI
|
: Nombre o Razón Social del adquirente
: '''PATH''': ../cac:PartyLegalEntity/cbc:RegistrationName
|-
|numeroIdentificacion
|String
|<nowiki>AN|..12</nowiki>
|SI
|
: Identificador del Adquirente.
: Debe informar el NIT si es responsable
: '''PATH''': ../cac:Party/cac:PartyLegalEntity/cbc:CompanyID
|-
|numeroIdentificacionDV
|String
|<nowiki>N|..2</nowiki>
|C/C
|
: Digito Verificador
: '''Obligatorio''' Si tipoIdentificacion =31, el DV del NIT debe ser informado
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeID
|-
|numeroMatriculaMercantil
|String
|<nowiki>N|9</nowiki>
|NO
|
: Número de matrícula mercantil
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:Name
|-
|prefijoFacturacion
|String
| -
|NO
|
: Prefijo de facturación:
: '''PATH''': ../cac:CorporateRegistrationScheme/cbc:ID
|-
|tipoIdentificacion
|String
|<nowiki>N|2</nowiki>
|SI
|
: Tipo de identificación del cliente
: Rechazo Si el contenido de este elemento es diferente de “31”
: '''PATH''': ../cac:PartyLegalEntity/cbc:CompanyID@schemeName
|}
====Class.Obligaciones====
{| class="mw-collapsible mw-collapsed wikitable"
! style="background:#f2f2f2; text-align:center;"|Atributo
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
! style="background:#f2f2f2; text-align:center;"|Formato
! style="background:#f2f2f2; text-align:center;"|Requerido
! style="background:#f2f2f2; text-align:center;"|Descripción
|-
|extras
|Array <Extensible>
| -
|NO
|
: Campos o información opcional para el modelo de negocio del emisor
: '''PATH''': No definido
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
|-
|obligaciones
|String
|<nowiki>AN|7</nowiki>
|SI
|
: Obligaciones del adquiriente
: 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.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.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.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)
|-
|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”
: '''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]]
: '''PATH''': No definido
|}
'''''@IMPORTANTE:'''
# Para referenciar '''facturas de venta al emitir una NC o ND''', se deben enviar dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
#* '''Objeto 1''': indicando los campos codigoEstatusDocumento; codigoInterno = ‘4’, numeroDocumento, descripción.
#* '''Objeto 2''': si el '''tipoOperacion es igual a 20 (para NC) ó 30 (para ND)''' y codigoInterno = ‘5’, se validan los campos: cufeDocReferenciado, fecha, y numeroDocumento.
# Al transmitir una '''Factura de Contingencia''', se debe enviar un arreglo de tipo DocumentosReferenciados indicando los campos: codigoInterno = ‘1’, numeroDocumento, fecha, tipoDocumentoCodigo (correspondiente a Factura de Contingencia).
# Para referenciar '''Documentos de Despacho''' (codigoInterno = ’2’) o '''Documentos de Recepción''' (codigoInterno = ‘3’) se validan los campos: numeroDocumento y fecha.''

'''Importante''': En el caso del campo '''rangoNumeracion''', éste valor siempre debe tener el siguiente formato (Pefijo-campoDesde), es decir, dicho campo es independiente de la modalidad de secuencial configurado en el portal (manual con prefijo o manual sin prefijo).

En el caso del campo '''consecutivoDocumento''', este campo si depende de la modalidad de secuenciales configurados en el portal web.
* Si la modalidad asignada es ''“manual sin prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento’ deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "1000"

*Si la modalidad asignada es ''“manual con prefijo”'', los valores para los campos rangoNumeracion y consecutivoDocumento deben ser por ejemplo:
:: Factura #1: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1"
:: Factura #2: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE2"
:: ...
:: Factura #1000: rangoNumeracion= "PRUE-1", consecutivoDocumento= "PRUE1000"
; RESPONSE: Parámetros a Recibir
{| 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
|}
; REQUEST: 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 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.
|}
; REQUEST: 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”
|}
; REQUEST: 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
|}
; REQUEST: 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
|}
; REQUEST: 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
|}
; REQUEST: 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
|}
; REQUEST: 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
|}
; REQUEST: 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}}

Indice del Manual de Integración Directa

2020-09-02T16:35:44Z

Fpinto:

[[Category:Manuales]]
__NOTOC__
<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-DFACTURE?|¿Qué es The Factory HKA-DFACTURE?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es The Factory HKA-Dfactura?|¿Qué es The Factory HKA-Dfactura?]]
## [[Generalidades - Indice Manual Integración Directa#¿Qué es Dintegración?|¿Qué es Dintegració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#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 soap con validación previa|Web services soap con validación previa]]

<includeonly>=</includeonly>==[[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa|Métodos Servicio Emisión Web Soap]]==<includeonly>=</includeonly>
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método Enviar|Método Enviar]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaGeneral|Class.FacturaGeneral]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Anticipos|Class.Anticipos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Autorizado|Class.Autorizado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CargosDescuentos|Class.CargosDescuentos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Cliente|Class.Cliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.CondicionPago|Class.CondicionPago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaDetalle|Class.FacturaDetalle]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Destinatario|Class.Destinatario]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferenciado|Class.DocumentoReferenciado]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Entrega|Class.Entrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extras|Class.Extras]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Extensible|Class.Extensible]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.FacturaImpuestos|Class.FacturaImpuestos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.ImpuestosTotales|Class.ImpuestosTotales]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.MediosDePago|Class.MediosDePago]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.OrdenDeCompra|Class.OrdenDeCompra]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambio|Class.TasaDeCambio]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TasaDeCambioAlternativa|Class.TasaDeCambioAlternativa]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.TerminosEntrega|Class.TerminosEntrega]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Direccion|Class.Direccion]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Coordenadas|Class.Coordenadas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Tributos|Class.Tributos]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.InformacionLegalCliente|Class.InformacionLegalCliente]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.Obligaciones|Class.Obligaciones]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.LineaInformacionAdicional|Class.LineaInformacionAdicional]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DatosTransportistas|Class.DatosTransportistas]]
## [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Class.DocumentoReferencia|Class.DocumentoReferencia]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EstadoDocumento|Método EstadoDocumento]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método EnvioCorreo|Método EnvioCorreo]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaPDF|Método DescargaPDF]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargaXML|Método DescargaXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método FoliosRestantes|Método FoliosRestantes]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método CargarCertificado|Método CargarCertificado]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método DescargarEventoXML|Método DescargarEventoXML]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarContenedor|Método GenerarContenedor]]
# [[Métodos Servicio Emisión Web Soap - Indice Manual Integración Directa#Método GenerarEvento|Método GenerarEvento]]
<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#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’)]]
<includeonly>=</includeonly>==[[Métodos servicio reportes web soap - Indice Manual Integración Directa|Métodos servicio reportes web soap]]==<includeonly>=</includeonly>
# [[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>==[[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#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#Generacion de notas con y sin referencia a documento|Generacion de notas con y sin referencia a documento]]
## [[Caracteristicas adicionales - 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]]
## [[Caracteristicas adicionales - 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]]
## [[Caracteristicas adicionales - Indice Manual Integración Directa#Notas de crédito y débito que afecten a facturas emitidas en validación posterior|Notas de crédito y débito que afecten a facturas emitidas en validación posterior]]
# [[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 eletrónicos en plataformas de recepción|Radicar documentos eletró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]]
<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>
{{clear}}

Catálogo de errores de respuesta del servicio web - Indice Manual Integración Directa

2020-09-01T20:54:20Z

Fpinto: -

<includeonly>=</includeonly>==Catálogo de errores de respuesta del servicio web ==<includeonly>=</includeonly>
==Códigos de respuesta para el Método Enviar==
{| class="wikitable" "style="text-align:center;"
|+ Método Enviar
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío Satisfactorio
|Procesado
|200
|El documento se envió correctamente (Síncrono).
|-
|Envío Satisfactorio
|Procesado
|201
|Documento recibido, se enviará más tarde a la DIAN (Asíncrono).
|-
|Envío Satisfactorio
|Procesado
|208
|Documento de contingencia recibido, se enviará más tarde a la DIAN (Asíncrono).
|-
|Error por Excepciones generales
|Error
|103
|Error de Procesamiento (Debe enviar xml-request para su análisis)
|-
|Error en capa de Validaciones TFHKA
|Error
|109
|
Ejm: El campo {nombre del campo} es obligatorio
Ejm: El campo {nombre del campo} debe ser numérico.
Ejm: El cliente No posee Folios Disponibles
(Debe enviar xml-request para su análisis)
|-
|Error por Excepciones XSLT Local (TFHKA)
|Error
|161
|
Debe validarse el XML/UBL generado
(Debe enviar xml-request para su análisis)
|-
|Error en Validaciones XSLT Local (TFHKA)
|Error
|110
|
Ejm: Fatal: [FAR08]- (R) Total de la factura 100.00 diferente de la suma de Total valor bruto + Total Tributos - Anticipos (+/-) Redondeos: 120.00}
(Debe enviar xml-request para su análisis)
|-
|Error Factura ya emitida o se encuentra en TFHKA y DIAN
|Error
|114
|
Documento emitido previamente
(Debe consultar el EstadoDocumento)
|-
|Documento rechazo por la DIAN
|Error
|99
|
Documento fue rechazado por la DIAN
(Debe validarse los motivos de rechazo o reglasValidacionDIAN)
|-
|Envío de Datos
|Error
|111
|
La longitud del campo Token [empresa/password] no cumple con el rango permitido.
El campo Token [empresa/password] solo debe tener números y letras
|-
|Token invalido
|Error
|101
|
El Token del Emisor es inválido.
(Debe validarse el ambiente al que corresponden los tokens utilizados y URL’s de conexión)
|-
|Error al parsear el documento
|Error
|112
|
Error al extraer la información del documento al comprobante.
(Debe enviar xml-request para su análisis)
|-
|Error validaciones incorrectas en los rangos
|Error
|117
|
Error. El rango, fecha de la factura o fecha de autorización son inválidos. / Error el número de documento es inválido.
(Debe validarse configuraciones del secuencial en el portal y ERP)
|-
|Error validación de autorización en los rangos
|Error
|118
|
Error, el número de autorización o el tipo de documento es inválido. / Error el número de documento es inválido.
(Debe validarse configuraciones del secuencial en el portal y ERP)
|-
|Error validación de Folios
|Error
|119
|
No posee folios disponibles.
Se debe contactar al nuestro equipo de facturación para adquirir un paquete de transacciones o folios.
|-
|Error validación en rango
|Error
|150
|
No existe el rango de numeración.
(Debe validarse el tipo de documento y si el rango está configurado en el portal)
|}
'''@IMPORTANTE:''' Ante un código de error diferente a los anteriores por favor enviar el '''request soap-Envelope''' del documento al alias [http://integracion_fel_co@thefactoryhka.com integracion_fel_co@thefactoryhka.com] exponiendo el caso.

==Códigos de respuesta para el Método EstadoDocumento==
{| class="wikitable" "style="text-align:center;"
|+ Método EstadoDocumento
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retornan datos de la factura
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error al extraer los datos del documento.
|}

==Códigos de respuesta para el Método EnvioCorreo==
{| class="wikitable" "style="text-align:center;"
|+ Método EnvioCorreo
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se ha enviado el email de manera correcta
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Correo inválido
|Error
|106
|Formato de correo electrónico inválido.
|}

==Códigos de respuesta para el Método DescargaPDF==
{| class="wikitable" "style="text-align:center;"
|+ Método DescargaPDF
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}

==Códigos de respuesta para el Método DescargaXML==
{| class="wikitable" "style="text-align:center;"
|+ Método DescargaXML
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}

==Códigos de respuesta para el Método GenerarContenedor==
{| class="wikitable" "style="text-align:center;"
|+ Método GenerarContenedor
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna el archivo solicitado
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|-
|Error al Extraer Datos
|Error
|105
|Error, no se pudo obtener el archivo solicitado.
|}

==Códigos de respuesta para el Método FoliosRestantes==
{| class="wikitable" "style="text-align:center;"
|+ Método FoliosRestantes
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Respuesta Satisfactoria
|Procesado
|200
|Se retorna folios restantes.
|-
|Token Invalido
|Error
|101
|El Token del Emisor es inválido.
|-
|Error en Validaciones
|Error
|102
|Número de documento inválido, no existe.
|-
|Error de Ejecución
|Error
|103
|Ha ocurrido un error en la ejecución del servicio, por favor intente más tarde.
|}

==Códigos de respuesta para el Método CargarAdjuntos==
{| class="wikitable" "style="text-align:center;"
|+ Método CargarAdjuntos
! text-align:center;"|Códigos Genéricos
! text-align:center;"|Resultado
! text-align:center;"|Código de Respuesta
! text-align:center;"|Mensaje
|- valign="center"
|-
|Envío satisfactorio
|Procesado
|200
|Archivo {nombreDelArchivo}{extensión} almacenado exitosamente
|-
|Error en carga de archivo
|Error
|107
|
Se señaló previamente que para el documento {consecutivo} emitido por {NIT Emisor} ya se habían completado los adjuntos esperados
: (Quiere decir que ya la propiedad enviar fue configurada en “1” anteriormente)
|-
|Error en Validaciones
|Error
|109
|
: [Sección del Error]El campo {nombre del campo} debe tener un valor del catálogo.
: [Sección del Error]El campo {nombre del campo} es requerido.
: [Sección del Error]El campo {nombre del campo} debe ser un {tipo de datos} de {tamaño} {numérico/alfanumérico}.
|}

Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa

2020-09-01T19:12:04Z

Fpinto:

<includeonly>=</includeonly>==Tablas de códigos de propiedades para emisión de documentos==<includeonly>=</includeonly>
==Tabla 1==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Documentos
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.1.3. Tipo de Documento: cbc:InvoiceTypeCode y cbc:CreditnoteTypeCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Significado
! style="color:white;background:#2F5496; text-align:center;"|Uso
|- valign="center"
|-
|01
|Factura electrónica de Venta
|rowspan="4"|Tipos de factura
|-
|02
|Factura electrónica de Venta - exportación
|-
|03
|Documento electrónico de transmisión - tipo 03
|-
|04
|Factura electrónica de Venta - tipo 04
|-
|91
|Nota Crédito
|rowspan="4"|Exclusivo en referencias a documentos (elementos DocumentReference)
|-
|92
|Nota Débito
|}
|}
==Tabla 2==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Operación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.1.5. Tipos de operación
Para Facturas:
{| 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;"|Valor
|- valign="center"
|-
|10
|Estandar*
|-
|09
|AIU
|-
|11
|Mandatos
|}
Nota: (*) Valor por default
Operación Salud
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código
|- valign="center"
|-
|SS-CUFE
|-
|SS-CUDE
|-
|SS-POS
|-
|SS-SNum
|-
|SS-Recaudo
|}
Nota: La explicación y vigencia de los tipos de operación para el sector salud se informará en http://url.minsalud.gov.co/facturacion-electronica una vez que el Ministerio de Salud informe a todos los actores regulados por ellos.
Para Notas Crédito:
{| 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;"|Valor
|- valign="center"
|-
|20
|Nota Crédito que referencia una factura electrónica*
|-
|22
|Nota Crédito sin referencia a facturas*.
|-
|23
|Nota Crédito para facturación electrónica V1 (Decreto 2242).
|}
Nota: (*) Preferible para uso de notas rebate o de descuentos condicionados.
Para Notas Débito:
{| 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;"|Valor
|- valign="center"
|-
|30
|Nota Débito que referencia una factura electrónica*
|-
|32
|Nota Débito sin referencia a facturas*.
|-
|33
|Nota Débito para facturación electrónica V1 (Decreto 2242).
|}
Nota: (*) Preferible para uso de notas rebate o de descuentos condicionados.
|}
'''@IMPORTANTE:''' Las notas tipo 22, 23, 32 y 33 no tienen validación de rechazo. (Objeto de control Posterior).

==Tabla 3==
{| class="wikitable" style="width: 100%;"
|+ Tipos de identificación
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.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
|-
|50
|NIT de otro país
|-
|91
|NUIP*
|}
|}
'''@IMPORTANTE:''' (*) Deberá utilizarse solamente para el adquirente, debido a que este tipo de documento no pertenece a los tipos de documento en la base de datos del RUT.
==Tabla 4==
{| class="wikitable" style="width: 100%;"
|+ Código de descuento
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.7. Códigos de descuento
{| 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"
|-
|00
|Descuento por impuesto asumido
|-
|01
|Pague uno lleve otro
|-
|02
|Descuentos contractuales
|-
|03
|Descuento por pronto pago
|-
|04
|Envío gratis
|-
|05
|Descuentos específicos por inventarios
|-
|06
|Descuento por monto de compras
|-
|07
|Descuento de temporada
|-
|08
|Descuento por actualización de productos/servicios
|-
|09
|Descuento general
|-
|10
|Descuento por volumen
|-
|11
|Otro descuento
|}
|}
==Tabla 5==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Persona
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| 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
|-
|2
|Persona Natural
|}
|}
==Tabla 6==
{| class="wikitable" style="width: 100%;"
|+ Unidades de Medida
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.5.1. Unidades de Cantidad: @unitCode
{| class="wikitable" style="width: 100%;"
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|04
|spray pequeño
|BIL
|trillón de dólares
|HUR
|hora
|-
|05
|levantar
|BJ
|cangilón
|HY
|cien yardas
|-
|08
|Lote calor
|BK
|cesta
|IA
|pulgada libra
|-
|10
|grupo
|BL
|bala
|IC
|contar por pulgada
|-
|11
|equipar
|BLD
|barril seco
|IE
|persona
|-
|13
|ración
|BLL
|barril (EE.UU.)(petróleo, etc.)
|IF
|pulgadas de agua
|-
|14
|disparo
|BO
|botella
|II
|columna pulgada
|-
|15
|palo
|BP
|cien pies de tabla
|IL
|pulgada por minuto
|-
|16
|tambor de ciento quince kg
|BQL
|becquerel
|IM
|impresión
|-
|17
|tambor de cien libras
|BR
|bar
|INH
|pulgada
|}
|}
'''@IMPORTANTE:''' Esta catalogo es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.
==Tabla 7==
{| class="wikitable" style="width: 100%;"
|+ Códigos para precios de referencia
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| 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"
|-
|01
|Valor comercial
|-
|02
|Valor en inventarios
|-
|03
|Otro valor
|}
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo '''codigoTipoPrecio'''
|}
==Tabla 8==
{| class="wikitable" style="width: 100%;"
|+ Códigos para productos y servicios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.3. Tipo de organización jurídica (Personas): cbc:AdditionalAccountID
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|@schemeID
! style="color:white;background:#2F5496; text-align:center;"|@schemeName
! style="color:white;background:#2F5496; text-align:center;"|schemeAgencyID
! style="color:white;background:#2F5496; text-align:center;"|Utilizar
|- valign="center"
|-
|001
|UNSPSC
|10
|style="text-align:left;"|Colombia Compra Eficiente: utilizar contenido de la columna "Código"
* Ver 8.1
|-
|010
|GTIN
|9
|style="text-align:left;"|Números Globales de Identificación de Productos - GTIN
* Ver 8.2
* Cuando hay menos de 14 números en una estructura de datos (por ejemplo, GTIN8), los números se deben justificar a la derecha en un campo de 14 dígitos rellenado con cerros en las posiciones ubicadas más a la izquierda.
|-
|020
|Partida Arancelarias
|195
|style="text-align:left;"|Partida arancelaria
|-
|999
|Estándar de adopción del contribuyente
|
|style="text-align:left;"|
* El valor en el atributo @schemeName no será validado
* El atributo @schemeAgencyID no debe ser utilizado
|}
Nota: Para muestras comerciales o regalos debe enviarse ‘01’ el campo '''codigoTipoPrecio'''
|}
'''@IMPORTANTE:''' Para mayor información del código para productos y servicios hacer referencia a la sección del Anexo correspondiente.
==Tabla 9==
{| class="wikitable" style="width: 100%;"
|+ Motivos de Nota de crédito
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.5. Concepto de Corrección para Notas crédito: cac:DiscrepancyResponse/cbc:ResponseCode
{| 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"
|-
|1
|style="text-align:left;"|Devolución de parte de los bienes; no aceptación de parte del servicio
|-
|2
|style="text-align:left;"|Anulación de factura electrónica
|-
|3
|style="text-align:left;"|Rebaja total aplicada
|-
|4
|style="text-align:left;"|Descuento total aplicado
|-
|5
|style="text-align:left;"|Rescisión: nulidad por falta de requisitos
|-
|6
|style="text-align:left;"|Otros
|}
|}
==Tabla 10==
{| class="wikitable" style="width: 100%;"
|+ Motivos de Nota de débito
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.6. Concepto de Corrección para Notas débito: cac:DiscrepancyResponse/cbc:ResponseCode
{| 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"
|-
|1
|style="text-align:left;"|Intereses
|-
|2
|style="text-align:left;"|Gastos por cobrar
|-
|3
|style="text-align:left;"|Cambio del valor
|-
|4
|style="text-align:left;"|Otros
|}
|}
==Tabla 11==
{| class="wikitable" style="width: 100%;"
|+ Tipos de Impuesto
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|01
|IVA
|style="text-align:left;"|Impuesto de Valor Agregado
|-
|02
|IC
|style="text-align:left;"|Impuesto al Consumo
|-
|03
|ICA
|style="text-align:left;"|Impuesto de Industria, Comercio y Aviso
|-
|04
|INC
|style="text-align:left;"|Impuesto Nacional al Consumo
|-
|05
|ReteIVA
|style="text-align:left;"|Retención sobre el IVA
|-
|06
|ReteFuente
|style="text-align:left;"|Retención sobre Renta
|-
|07
|ReteICA
|style="text-align:left;"|Retención sobre el ICA
|-
|20
|FtoHorticultura
|style="text-align:left;"|Cuota de Fomento Hortifrutícula
|-
|21
|Timbre
|style="text-align:left;"|Impuesto de Timbre
|-
|22
|Bolsas
|style="text-align:left;"|Impuesto al Consumo de Bolsa Plástica
|-
|23
|INCarbono
|style="text-align:left;"|Impuesto Nacional al Carbono
|-
|24
|INCombustibles
|style="text-align:left;"|Impuesto Nacional a los Combustibles
|-
|25
|Sobretasa Combustibles
|style="text-align:left;"|Sobretasa a los combustibles
|-
|26
|Sordicom
|style="text-align:left;"|Contribución minoristas (Combustibles)
|-
|ZY
|No causa
|style="text-align:left;"|No responsable de tributo
|-
|ZZ
|Nombre de la figura tributaria
|style="text-align:left;"|Otros tributos, tasas, contribuciones, y similares
|}
|}
==Tabla 12==
{| class="wikitable" style="width: 100%;"
|+ Tarifas por Impuesto
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.8. Tablas de tarifas por Impuesto
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Impuesto que reporta
! style="color:white;background:#2F5496; text-align:center;"|Valores posibles para el campo cbc:Percent
la tarifa a informar dependerá del aspecto tributario del impuesto reportado
|- valign="center"
|-
|IVA
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
| style="width:50px;|Tarifa
| 
|-
| Concepto|| (cbc:Percent)||  
|-
| Excluido ||   || Cuando el item sea "excluido" del IVA, no se debe reportar el IVA en el grupo de impuestos.
|-
| Excento|| 0.00 ||  |
|-
| Bienes/Servicios al 5|| 5.00 ||  |
|-
| Contratos firmados con el estado antes de ley 1819|| 16.00 ||  
|-
| Tarifa general|| 19.00 ||  
|}
|-
|INC
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|Tarifa
| 
|-
| Concepto           || (cbc:Percent)||  
|-
| Tarifa especial|| 2.00 ||  
|-
| Tarifa especial|| 4.00 ||  |
|-
| Tarifa especial|| 8.00 ||  |
|-
| Tarifa especial|| 16.00 ||  |
|}
|-
|ReteIVA
|style="text-align:left;"|
15.00 
100.00
|-
|ReteFuente
|style="text-align:left;"|
{|
|-
| style="width:700px;| 
|Tarifa
| 
|-
| Conceptos|| (cbc:Percent)||  
|-
| Compras generales (declarantes)|| 2.50 ||  
|-
| Compras generales (no declarantes)|| 3.50 ||  
|-
| Compras con tarjeta débito o crédito|| 1.50 ||  
|-
| Compras de bienes o productos agrícolas o pecuarios sin procesamiento industrial|| 1.50 ||  
|-
| Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial (declarantes)|| 2.50 ||  
|-
| Compras de bienes o productos agrícolas o pecuarios con procesamiento industrial (no declarantes)|| 3.50 ||  
|-
| Compras de café pergamino o cereza|| 0.50 ||  
|-
| Compras de combustibles derivados del petróleo|| 0.10 ||  
|}
|}
|}
@IMPORTANTE: Este catálogo '''tarifas por Impuesto''' es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.

==Tabla 13==
{| class="wikitable" style="width: 100%;"
|+ Medios de Pago
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.4.2. Medios de Pago: cbc:PaymentMeansCode
{| 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;"|Medio
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Medio
|- valign="center"
|-
|1
|Instrumento no definido
|39
|Crédito Negocio Intercambio Corporativo (CTX)
|-
|2
|Crédito ACH
|40
|Débito Negocio Intercambio Corporativo (CTX)
|-
|3
|Débito ACH
|41
|Concentración efectivo/Desembolso Crédito plus (CCD+)
|-
|4
|Reversión débito de demanda ACH
|42
|Consiganción bancaria
|-
|5
|Reversión crédito de demanda ACH
|43
|Concentración efectivo / Desembolso Débito plus (CCD+)
|-
|6
|Crédito de demanda ACH
|44
|Nota cambiaria
|-
|7
|Débito de demanda ACH
|45
|Transferencia Crédito Bancario
|-
|8
|Mantener
|46
|Transferencia Débito Interbancario
|-
|9
|Clearing Nacional o Regional
|47
|Transferencia Débito Bancaria
|-
|10
|Efectivo
|48
|Tarjeta Crédito
|-
|11
|Reversión Crédito Ahorro
|49
|Tarjeta Débito
|-
|12
|Reversión Débito Ahorro
|50
|Postgiro
|-
|13
|Crédito Ahorro
|51
|Telex estándar bancario francés
|-
|14
|Débito Ahorro
|52
|Pago comercial urgente
|-
|15
|Bookentry Crédito
|53
|Pago Tesorería Urgente
|-
|16
|Bookentry Débito
|60
|Nota promisoria
|-
|17
|Concentración de la demanda en efectivo/Desembolso Crédito (CCD)
|61
|Nota promisoria firmada por el acreedor
|-
|18
|Concentración de la demanda en efectivo /Desembolso (CCD) débito
|62
|Nota promisoria firmada por el acreedor, avalada por elbanco
|-
|19
|Crédito Pago negocio corporativo (CTP)
|63
|Nota promisoria firmada por el acreedor, avalada por untercero
|-
|20
|Cheque
|64
|Nota promisoria firmada pro el banco
|-
|21
|Poyecto bancario
|65
|Nota promisoria firmada por un banco avalada por otrobanco
|-
|22
|Proyecto bancario certificado
|66
|Nota promisoria firmada
|-
|23
|Cheque bancario
|67
|Nota promisoria firmada por un tercero avalada por unbanco
|-
|24
|Nota cambiaria esperando aceptación
|70
|Retiro de nota por el por el acreedor
|-
|25
|Cheque certificado
|71
|Bonos
|-
|26
|Cheque Local
|72
|Vales
|-
|27
|Débito Pago Neogcio Corporativo (CTP)
|74
|Retiro de nota por el por el acreedor sobre un banco
|-
|28
|Crédito Negocio Intercambio Corporativo (CTX)
|75
|Retiro de nota por el acreedor, avalada por otro banco
|-
|29
|Débito Negocio Intercambio Corporativo (CTX)
|76
|Retiro de nota por el acreedor, sobre un banco avalada porun tercero
|-
|30
|Transferecia Crédito
|77
|Retiro de una nota por el acreedor sobre un tercero
|-
|31
|Transferencia Débito
|78
|Retiro de una nota por el acreedor sobre un terceroavalada por un banco
|-
|32
|Concentración Efectivo / Desembolso Crédito plus(CCD+)
|91
|Nota bancaria tranferible
|-
|33
|Concentración Efectivo / Desembolso Débito plus(CCD+)
|92
|Cheque local traferible
|-
|34
|Pago y depósito pre acordado (PPD)
|93
|Giro referenciado
|-
|35
|Concentración efectivo ahorros / Desembolso Crédito(CCD)
|94
|Giro urgente
|-
|36
|Concentración efectivo ahorros / Desembolso Drédito(CCD)
|95
|Giro formato abierto
|-
|37
|Pago Negocio Corporativo Ahorros Crédito (CTP)
|96
|Método de pago solicitado no usuado
|-
|38
|Pago Neogcio Corporativo Ahorros Débito (CTP)
|97
|Clearing entre partners
|-
|
|
|ZZZ
|Acuerdo mutuo
|}
|}
==Tabla 14==
{| class="wikitable" style="width: 100%;"
|+ Forma ó Metodo de Pago
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.4.1. Formas de Pago: cbc:PaymentMeans/ID
{| 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
|Contado
|-
|2
|Crédito
|}
|}
==Tabla 15==
{| class="wikitable" style="width: 100%;"
|+ Condiciones de entrega (INCOTERMS)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.3.6. Condiciones de entrega (INCOTERMS): …/cbc:LossRiskResponsibilityCode
{| 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"
|-
|CFR
|Costo y flete
|-
|CIF
|Costo, flete y seguro
|-
|CIP
|Transporte y Seguro Pagados hasta
|-
|CPT
|Transporte Pagado Hasta
|-
|DAP
|Entregado en un Lugar
|-
|DAT
|Entregado en Terminal
|-
|DDP
|Entregado con Pago de Derechos
|-
|EXW
|En Fábrica
|-
|FAS
|Franco al costado del buque
|-
|FCA
|Franco transportista
|-
|FOB
|Franco a bordo
|}
|}
==Tabla 16==
{| class="wikitable" style="width: 100%;"
|+ Departamentos (ISO 3166-2:CO)
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.4.2. Departamentos (ISO 3166-2:CO): cbc:CountrySubentity, cbc:CountrySubentityCode
{| 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;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Código ISO
! style="color:white;background:#2F5496; text-align:center;"|Código
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Código ISO
|- valign="center"
|-
|91
|Amazonas
|AMA
|41
|Huila
|HUI
|-
|05
|Antioquia
|ANT
|44
|La Guajira
|LAG
|-
|81
|Arauca
|ARA
|47
|Magdalena
|MAG
|-
|08
|Atlántico
|ATL
|50
|Meta
|MET
|-
|11
|Bogotá
|DC
|52
|Nariño
|NAR
|-
|13
|Bolívar
|BOL
|54
|Norte de Santander
|NSA
|-
|15
|Boyacá
|BOY
|86
|Putumayo
|PUT
|-
|17
|Caldas
|CAL
|63
|Quindío
|QUI
|-
|18
|Caquetá
|CAQ
|66
|Risaralda
|RIS
|-
|85
|Casanare
|CAS
|88
|San Andrés y Providencia
|SAP
|-
|19
|Cauca
|CAU
|68
|Santander
|SAN
|-
|20
|Cesar
|CES
|70
|Sucre
|SUC
|-
|27
|Chocó
|CHO
|73
|Tolima
|TOL
|-
|23
|Córdoba
|COR
|76
|Valle del Cauca
|VAC
|-
|25
|Cundinamarca
|CUN
|97
|Vaupés
|VAU
|-
|94
|Guainía
|GUA
|99
|Vichada
|VID
|-
|95
|Guaviare
|GUV
|
|
|
|}
|}
==Tabla 17==
{| class="wikitable" style="width: 100%;"
|+ Responsabilidades fiscales
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.7. Responsabilidades fiscales: cbc:TaxLevelCode
{| 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"
|-
|0-13
|Gran contribuyente
|-
|0-15
|Autorretenedor
|-
|0-23
|Agente de retención en el impuesto sobre las ventas
|-
|0-47
|Régimen Simple de Tributación – SIMPLE
|-
|R-99-PN
|No responsable
|}
|}
==Tabla 18==
{| class="wikitable" style="width: 100%;"
|+ Detalles tributarios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.2.2. Tributos: cac:TaxScheme/ID, cac:TaxScheme/Name
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Identificador
! style="color:white;background:#2F5496; text-align:center;"|Nombre
! style="color:white;background:#2F5496; text-align:center;"|Descripción
|- valign="center"
|-
|01
|IVA
|Impuesto de Valor Agregado
|-
|02
|IC
|Impuesto al Consumo
|-
|03
|ICA
|Impuesto de Industria, Comercio y Aviso
|-
|04
|INC
|Impuesto Nacional al Consumo
|-
|05
|ReteIVA
|Retención sobre el IVA
|-
|06
|ReteFuente
|Retención sobre Renta
|-
|07
|ReteICA
|Retención sobre el ICA
|-
|20
|FtoHorticultura
|Cuota de Fomento Hortifrutícula
|-
|21
|Timbre
|Impuesto de Timbre
|-
|22
|Bolsas
|Impuesto al Consumo de Bolsa Plástica
|-
|23
|INCarbono
|Impuesto Nacional al Carbono
|-
|24
|INCombustibles
|Impuesto Nacional a los Combustibles
|-
|25
|Sobretasa Combustibles
|Sobretasa a los combustibles
|-
|26
|Sordicom
|Contribución minoristas (Combustibles)
|-
|ZY
|No causa
|No responsable de tributo
|-
|ZZ
|Nombre de la figura tributaria
|Otros tributos, tasas, contribuciones, y similares
|}
|}
==Tabla 19==
{| class="wikitable" style="width: 100%;"
|+ Municipios
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7-2020 - 6.4.3. Municipios: cbc:CityName
{| class="wikitable" style="width: 100%;" style="margin: auto;"
! style="color:white;background:#2F5496; text-align:center;"|Código Departamento
! style="color:white;background:#2F5496; text-align:center;"|Código Municipio
! style="color:white;background:#2F5496; text-align:center;"|Nombre Departamento
! style="color:white;background:#2F5496; text-align:center;"|Nombre Municipio
|- valign="center"
|-
|05
|05044
|Antioquia
|ANZÁ
|-
|05
|05045
|Antioquia
|APARTADÓ
|-
|05
|05051
|Antioquia
|ARBOLETES
|-
|05
|05055
|Antioquia
|ARGELIA
|-
|05
|05059
|Antioquia
|ARMENIA
|-
|05
|05079
|Antioquia
|BARBOSA
|-
|05
|05086
|Antioquia
|BELMIRA
|-
|05
|05088
|Antioquia
|BELLO
|-
|05
|05091
|Antioquia
|BETANIA
|-
|05
|05093
|Antioquia
|BETULIA
|-
|05
|05101
|Antioquia
|CIUDAD BOLÍVAR
|-
|05
|05107
|Antioquia
|BRICEÑO
|-
|05
|05113
|Antioquia
|BURITICÁ
|-
|05
|05120
|Antioquia
|CÁCERES
|-
|05
|05125
|Antioquia
|CAICEDO
|-
|05
|05129
|Antioquia
|CALDAS
|-
|05
|05134
|Antioquia
|CAMPAMENTO
|-
|05
|05138
|Antioquia
|CAÑASGORDAS
|-
|05
|05142
|Antioquia
|CARACOLÍ
|-
|05
|05145
|Antioquia
|CARAMANTA
|-
|05
|05147
|Antioquia
|CAREPA
|-
|05
|05148
|Antioquia
|EL CARMEN DE VIBORAL
|-
|05
|05150
|Antioquia
|CAROLINA
|-
|05
|05154
|Antioquia
|CAUCASIA
|-
|05
|05172
|Antioquia
|CHIGORODÓ
|}
|}
'''@IMPORTANTE:''' Este catálogo '''municipios''' es más extenso, para mayor información hacer referencia a la sección del Anexo correspondiente.
==Tabla 20==
{| class="wikitable" style="width: 100%;"
|+ Zona Postal
|- valign="center"
|colspan="2"|Anexo 1.7-2020 - 6.4.4. Código Postal cbc:PostalZone 
En Colombia el código postal consta de 6 dígitos (ejemplo: 578986) que señalan inicialmente la posición geográfica, seguida por la de encaminamiento y finalmente la que nos ubica dentro del área postal, así:

'''Departamentos Nacionales''' 
Los dos primeros dígitos representan a los departamentos nacionales, utilizando la codificación vigente Dane. Los códigos menores de 10 deben iniciar con un cero a la izquierda.

'''Zonas postales departamentales de encaminamiento''' 
La tercera y cuarta posición definen las zonas postales de encaminamiento para facilitar la clasificación a través del Código Postal: El 00 queda reservado para la capital del departamento. Del 01 al 89 permite dividir cada departamento hasta en 89 zonas de encaminamiento postal.

'''Distrito postales por municipio o localidad''' 
Las dos últimas posiciones del Código Postal Nacional permiten asignar cien distritos postales a cada una de las diez zonas postales creadas en cada departamento. Es decir, se pueden asignar hasta mil distritos distintos en cada departamento, para un total de treinta y tres mil a nivel nacional.
|}
@IMPORTANTE: Link de consulta para códigos de Zona Postal: http://visor.codigopostal.gov.co/472/visor/
==Tabla 21==
{| class="wikitable" style="width: 100%;"
|+ Referencia a otros documentos
|- valign="center"
|-style="text-align:center;"
|colspan="2"|Anexo 1.7 - 6.1.4. Referencia a documentos no tributarios: cbc:DocumentTypeCode
{| 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"
|-
|AAJ
|Orden de Entrega (remisión)
|-
|R1
|Referencias internas
|-
|R2
|Referencias internas
|}
|}
@IMPORTANTE: Estos documentos representan acciones comerciales y mercantiles que amparan o soportan transacciones relacionadas con este documento electrónico. Al tratar se una orden de entrega se debe utilizar el grupo de elemento OrderReference, al informar mas de una se debe disponer del grupo AdditionalDocumentReference.