Diferencia entre revisiones de «Métodos Servicio Emisión Web TFHKA - Indice del Manual Integración Directa HKA Documentos Equivalentes Electrónicos»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
(autorizado, anticipos)
Línea 783: Línea 783:
 
: Hora del evento
 
: Hora del evento
 
: ext:ExtensionContent/PublicShowsInformation/EventInformation/TimeEvent
 
: ext:ExtensionContent/PublicShowsInformation/EventInformation/TimeEvent
 +
|}
 +
 +
====<font color="blue">Class.bolsaValores</font>====
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|consecutivo
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Número del consecutivo
 +
: ext:ExtensionContent/CustomTagGeneral/Group/AdditionalCollection/Value
 +
|-
 +
|fechaCumplimiento
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Fecha de cumplimiento
 +
: ext:ExtensionContent/CustomTagGeneral/Group/AdditionalCollection/Value
 +
|-
 +
|cantidadNominal
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Cantidad nominal
 +
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
 +
|-
 +
|precioCesionTotal
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Precio cesion total
 +
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
 +
|-
 +
|PrecioRegistro
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Precio de registro
 +
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
 +
|-
 +
|montoderendimientos
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Monto de Rendimientos
 +
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
 +
|-
 +
|valor
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor
 +
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
 +
|-
 +
|porcentajeComision
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Porcentaje de la comisión
 +
: ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
 +
|}
 +
 +
====<font color="blue">Class.CargosDescuentos</font>====
 +
{| 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)
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si es descuento y no se informa algunos de los valores en la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 4|Tabla 4]]
 +
: '''PATH''': …/cbc:AllowanceChargeReasonCode
 +
|-
 +
|descripcion
 +
|String
 +
|<nowiki>AN|10..5000</nowiki>
 +
|SI
 +
|
 +
: Texto libre para informar la razón del descuento
 +
: '''PATH''': …/cbc:AllowanceChargeReason
 +
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> : Si se informa un cargo o descuento y no se informa este elemento
 +
|-
 +
|extras
 +
|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”
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Si este elemento contiene una información diferente de “1” o “0”
 +
: '''PATH''': …/cbc:ChargeIndicator
 +
|-
 +
|monto
 +
|String
 +
|Ent: <nowiki>N|..15</nowiki>
 +
Dec: <nowiki>N|0..6</nowiki>
 +
|SI
 +
|
 +
: Valor total del cargo o descuento, si es descuento no puede ser superior al valor base
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Si  es Descuento y monto > montoBase
 +
: '''PATH''': …/cbc:Amount
 +
|-
 +
|montoBase
 +
|String
 +
|Ent: <nowiki>N|..15</nowiki>
 +
Dec: <nowiki>N|0..6</nowiki>
 +
|SI
 +
|
 +
: Valor Base para calcular el descuento o el cargo,
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si es negativo el montoBase, si es descuento no puede ser superior al valor total de la factura
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span>: Si montoBase > totalMonto
 +
: '''PATH''': …/cbc:BaseAmount
 +
|-
 +
|porcentaje
 +
|String
 +
|Ent: <nowiki>N|..6</nowiki>
 +
Dec: <nowiki>N|2</nowiki>
 +
|SI
 +
|
 +
: Porcentaje del descuento
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si este elemento > 100
 +
: '''PATH''': …/cbc:MultiplierFactorNumeric
 +
|-
 +
|secuencia
 +
|String
 +
|<nowiki>N|..3</nowiki>
 +
|SI
 +
|
 +
: Indicador de orden de secuencia
 +
: '''PATH''': …/cbc:ID
 +
|}
 +
 +
====<font color="blue">Class.CajaVenta</font>====
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|placaCaja
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor de la característica que se quiere informar (Placa de inventario de la Caja)
 +
: Corresponde a la Placa de inventario de la Caja
 +
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
 +
|-
 +
|-
 +
|ubicacionCaja
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor de la característica que se quiere informar (Ubicación de la caja ALMACEN)
 +
: Corresponde a la Ubicación de la caja ALMACEN
 +
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
 +
|-
 +
|cajero
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor de la característica que se quiere informar (nombres y apellidos del cajero o vendedor)
 +
: Corresponde a los Nombres y apellidos del cajero o vendedor
 +
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
 +
|-
 +
|tipoCaja
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor de la característica que se  quiere informar (Tipo de Caja)
 +
: Corresponse al Tipo de Caja
 +
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
 +
|-
 +
|codigoVenta
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor de la característica que se quiere informar (Código de la Venta)
 +
: Corresponde al Código de la Venta
 +
: ./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
 +
|}
 +
 +
====<font color="blue">Class.CreditoInstrumentoJuego</font>====
 +
{| class="mw-collapsible mw-collapsed wikitable"
 +
! style="background:#f2f2f2; text-align:center;"|Atributo
 +
! style="background:#f2f2f2; text-align:center;"|Tipo Dato
 +
! style="background:#f2f2f2; text-align:center;"|Formato
 +
! style="background:#f2f2f2; text-align:center;"|Requerido
 +
! style="background:#f2f2f2; text-align:center;"|Descripción
 +
|-
 +
|numeroSerie
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Número del serial de la máquina o intrumento de juego con reporte diario crédito
 +
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/GameMachineSerial
 +
|-
 +
|valorCredito
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Valor crédito de la máquina o instrumento de juego
 +
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/CreditValue
 +
|-
 +
|moneda
 +
|String
 +
| -
 +
|SI
 +
|
 +
: Código de modena
 +
: ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/CreditValue/@currencyID
 +
|}
 +
 +
====<font color="blue">Class.Cliente</font>====
 +
{| 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
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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
 +
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> Si el adquirente es responsable y no fue informada esta clase
 +
: '''PATH''': .. /cac:Party/cac:PartyTaxScheme/cac:RegistrationAddress
 +
: (ver detalle en [[#Class.Direccion|Class.Direccion]])
 +
|-
 +
|email
 +
|String
 +
|<nowiki>AN|..50</nowiki>
 +
|C/C
 +
|
 +
: Correo Electrónico del adquiriente que irá al XML/UBL fiscal
 +
: (solo se envía un correo en este campo)
 +
: '''PATH''': No aplica nodo
 +
|-
 +
|extras
 +
|Array  <Extensible>
 +
| -
 +
|NO
 +
|
 +
: Campos o información opcional para el modelo de negocio del emisor
 +
: '''PATH''': No definido
 +
: (ver detalle en [[#Class.Extensible|Class.Extensible]])
 +
|-
 +
|informacionLegalCliente
 +
|InformacionLegalCliente
 +
| -
 +
|C/C
 +
|
 +
: Información legal del cliente
 +
: <span style="color:#FFFF; background:#FF0000"><b>Notificación</b></span> : Si se informa tipoPersona = ‘1’ y el atributo no es reportado
 +
: '''PATH''': ../cac:Party/cac:PartyLegalEntity
 +
: (ver detalle en [[#Class.InformacionLegalCliente|Class.InformacionLegalCliente]])
 +
|-
 +
|nombreComercial
 +
|String
 +
|<nowiki>AN|5..450</nowiki>
 +
|C/C
 +
|
 +
: Nombre Comercial del adquiriente
 +
: '''Obligatorio''' Si en la Rep. Gráfica se mostrará el nombre comercial
 +
: '''PATH''': /cac:Party/cac:PartyName
 +
|-
 +
|nombreContacto
 +
|String
 +
|<nowiki>AN|5..450</nowiki>
 +
|NO
 +
|
 +
: Nombre de Contacto
 +
: '''PATH''': ../cac:Party/cac:Contact/cbc:Name
 +
|-
 +
|nombreRazonSocial
 +
|String
 +
|<nowiki>AN|5..450</nowiki>
 +
|SI
 +
|
 +
: Nombre o Razón Social del adquirente
 +
: '''Recomendado''': Si la persona es natural concatenar en este campo el nombre competo (nombres + apellidos)
 +
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:RegistrationName 
 +
|-
 +
|nota
 +
|String
 +
|<nowiki>AN|..450</nowiki>
 +
|NO
 +
|
 +
: Nota adicional de contacto
 +
: '''PATH''': ../cac:Party/cac:Contact/cbc:Note
 +
|-
 +
|notificar
 +
|String
 +
|<nowiki>AN|2</nowiki>
 +
|SI
 +
|
 +
: Activa el envío de email al adquirente.
 +
: Valores posibles: “SI” o “NO”
 +
: '''PATH''': No aplica
 +
|-
 +
|numeroDocumento
 +
|String
 +
|<nowiki>AN|..12</nowiki>
 +
|SI
 +
|
 +
: Número del Documento o Identificación Fiscal del adquirente
 +
: '''Obligatorio''' Si el adquirente es responsable debe informar el NIT
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si tipoIdentificacion es ‘31’ y la estructura de NIT es inválida
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> : Se genera si el valor de AdditionalAccountID = “2” y este no es mencionado.
 +
: <span style="color:#FFFF; background:#FF0000"><b>Nota</b></span> : Para identificar al consumidor final, se utiliza el siguiente documento “222222222222”
 +
: '''PATH''': …/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
 +
|-
 +
|numeroIdentificacionDV
 +
|String
 +
|<nowiki>AN|..2</nowiki>
 +
|C/C
 +
|
 +
: Digito de verificación NIT del adquiriente
 +
: '''Obligatorio''': Si tipoIndentificacion = 31, debe ser informado
 +
: '''PATH''':
 +
: ../cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeID
 +
|-
 +
|responsabilidadesRut
 +
|Array <Obligaciones>
 +
| -
 +
|SI
 +
|
 +
: Obligaciones y régimen del adquiriente
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> 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
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a uno de los valores de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 3|Tabla 3]]
 +
: <span style="color:#FFFF; background:#FF0000"><b>Nota</b></span>: Para identificar al consumidor final se utiliza el código “13”
 +
: '''PATH''': ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
 +
|-
 +
|tipoPersona
 +
|String
 +
|<nowiki>N|1</nowiki>
 +
|SI
 +
|
 +
: Identificador de tipo de persona
 +
: <span style="color:#FFFF; background:#FF0000"><b>Rechazo</b></span> Si el contenido de este atributo no corresponde a uno de los valores de la  [[Tablas de códigos de propiedades para emisión de documentos - Indice Manual Integración Directa#Tabla 5|Tabla 5]]
 +
: '''PATH''': …/cbc:AdditionalAccountID
 
|}
 
|}

Revisión del 20:19 30 may 2024

Método EnviarRequest

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

REQUEST
Parámetros a EnviarRequest
Tipo Identificador Descripción
String tokenEmpresa Suministrado por el proveedor tecnológico
tokenPassword
FacturaGeneral factura Ver el detalle del Objeto Factura más abajo
String adjuntos

Posibles valores:

“0” No se admiten adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
“1” Admite archivos adjuntos. Se genera XML y representación Gráfica estándar por The Factory HKA
“10” No se admiten adjuntos. Se genera sólo XML sin representación Gráfica estándar por The Factory HKA
“11” Admite archivos adjuntos. Se genera sólo XML sin representación gráfica estándar por The Factory HKA

Class.FacturaGeneral

Atributo Tipo Dato Formato Requerido Descripción
anticipos Array <Anticipos> - NO
Informaciones relacionadas con anticipos
PATH: /root/cac:PrepaidPayment
(ver detalle en Class.Anticipos)
autorizado Autorizado - NO
Informaciones de la persona autorizada para descargar documentos
PATH: /root/cac:TaxRepresentativeParty
(ver detalle en Class.Autorizado)
boletaIngreso Array<BoletaIngreso> - NO
Información referente a boleta de ingreso
(ver detalle en #Class.BoletaIngreso)
bolsaValores Array<BolsaValores> - NO
Información referente a bolsa de valores
(ver detalle en #Class.BolsaValores)
cajaVenta Array<CajaVenta> - NO
Información referente a caja de venta
(ver detalle en #Class.CajaVenta)
cantidadDecimales String N|1 SI
Se envía la cantidad de decimales a utilizar (mínimo 0, máximo 6)
Rechazo Si se reciben más decimales en los montos a los indicados en este campo
PATH: No aplica
cargosDescuentos Array <CargosDescuentos> - NO
Informaciones relacionadas con un cargo o un descuento a escala de factura que no afecte a la base gravable
PATH: /root/cac:AllowanceCharge
(ver detalle en Class.CargosDescuentos)
cliente Cliente - SI
Información del adquiriente
Para Documento Soporte en adquisiciones a No Obligados a Facturar se debe utiliza para registrar los datos del proveedor o del no obligado
PATH:/root/cac:AccountingCustomerParty
(ver detalle en Class.Cliente)
codigoCosto String - NO
Código de para centro de costos
PATH: ../cbc:
consecutivoDocumento String AN..14 SI
Correlativo/consecutivo del documento electrónico
Concatenación del prefijo (AN|..4) + el consecutivo DIAN,
según la configuración en portal web:
Manual con prefijo: prefijo requerido (Sin guion). Ejemplo: “PREF2147483647”
Manual sin prefijo: prefijo no requerido. Ejemplo: “2147483647”
Rechazo No se permiten caracteres adicionales como espacios o guiones
Rechazo Número de consecutivo debe ser igual o superior al valor inicial del rango de numeración otorgado por la DIAN
Rechazo Número de consecutivo debe ser igual o inferior al valor final del rango de numeración otorgado por la DIAN
PATH: /root/cbc:ID
detalleDeFactura Array <FacturaDetalle> - SI
Información de detalles o productos
PATH: /root/cac:InvoiceLine
(ver detalle en Class.FacturaDetalle)
documentosReferenciados Array <DocumentoReferenciado> - C/C
Informaciones que describen un documento referenciado
Obligatorio en facturas tipoDocumento contingencia (AdditionalDocumentReference), en facturas que afecten una nota (BillingReference), en Notas de Crédito y Débito (DiscrepancyResponse y BillingReference)
PATH: /root/cac:DiscrepancyResponse,
/root/cac:BillingReference,
/root/cac: AdditionalDocumentReference,
/root/cac: DespatchDocumentReference,
/root/cac: ReceiptDocumentReference
(ver detalle en Class.DocumentoReferenciado)
entregaMercancia Entrega - NO
Información de entrega (Delivery) de bienes
PATH: /root/cac:Delivery
(ver detalle en Class.Entrega)
extras Array <Extras> - NO
Campos o información opcional para el modelo de negocio del emisor
PATH: No definido
(ver detalle en Class.Extras)
fabricantesoftware Array<FabricanteSoftware> - SI
Código de para centro de costos
(ver detalle en #Class.fabricanteSoftware)
fechaEmision String AN|19 SI
Fecha y hora de emisión del documento, en formato: YYYY-MM-DD HH:MM:SS
Notificación Si la fecha de emisión es anterior a cinco (5) días de la fecha calendario
Rechazo Si la fecha de emisión es posterior a diez días calendario
PATH: /root/cbc:IssueDate, root/cbc:IssueTime
fechaFinPeriodoFacturacion String AN|19 NO
Fecha/Hora de fin del periodo de facturación (Intervalo de fechas a las que referencia la factura por ejemplo en servicios públicos), en formato: YYYY-MM-DD HH:MM:SS
PATH: /root/cac:InvoicePeriod/cbc:EndDate, /root/cac:InvoicePeriod/cbc:EndTime
fechaInicioPeriodoFacturacion String AN|19 NO
Fecha/Hora de inicio del periodo de facturación, en formato: YYYY-MM-DD HH:MM:SS
PATH:
/root/cac:InvoicePeriod/cbc:StartDate, /root/cac:InvoicePeriod/cbc:StartTime
fechaPagoImpuestos String AN|19 NO
Fecha de pago de impuestos, en formato: YYYY-MM-DD HH:MM:SS
PATH: root/cbc:TaxPointDate
fechaVencimiento String AN|10 NO
Fecha vencimiento de la factura, en formato: YYYY-MM-DD
PATH: /root/cbc:DueDate
impuestosGenerales Array <FacturaImpuestos> - SI
Información de impuestos generales o globales
Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
PATH: /root/cac:TaxTotal (impuestos),
/root/cac: WithholdingTaxTotal (retenciones),
(ver detalle en Class.FacturaImpuestos)
impuestosTotales Array <ImpuestosTotales> - SI
Sumatoria de los impuestos/retenciones generales por tipo de impuesto/retención
Rechazo Si el valor total del impuesto/retención indicado es diferente a la sumatoria de los reportado en el arreglo impuestosGenerales
PATH: /root/cac:TaxTotal/cbc:TaxAmount (impuestos),
/root/cac: WithholdingTaxTotal/cbc:TaxAmount (retenciones),
(ver detalle en Class.ImpuestosTotales)
informacionAdicional Array <String> AN|...10000 NO
Información adicional o texto libre relativo al documento
PATH: root/cbc:Note
informacionBeneficiosComprador Array <InformacionBeneficiosComprador> - NO
Información relacionada con beneficios del comprador
PATH: /root/cac:PaymentMeans
(ver detalle en #Class.InformacionBeneficiosComprador)
juegosLocalizados Array<juegosLocalizados> - NO
Información referente a juegos localizados
(ver detalle en #Class.juegosLocalizados)
mediosDePago Array<MediosDePago> - NO
PATH: /root/cac:PaymentMeans
(ver detalle en #Class.MediosDePago)
moneda String AN|3 SI
Moneda o divisa del documento
Usar códigos ISO 4217 (Ejemplo Pesos Colombianos “COP”)
Rechazo Si el valor no corresponde a uno de los códigos ISO 4217
PATH: /root/cbc:DocumentCurrencyCode
propina string - NO
Información relacionada a propina
ordenDeCompra Array <OrdenDeCompra> - NO
Información relacionada a la orden de compra
PATH: /root/cac:OrderReference
(ver detalle en Class.OrdenDeCompra)
rangoNumeracion String AN|20 SI
Consecutivo desde el que comienza la serie para el documento a emitir, siempre debe colocarse el prefijo (con guión) independientemente de la modalidad de secuencial.
Ejemplo: ‘PREF-1123456’
Rechazo Si el valor del campo desde (Inicio del rango) supera el valor 2.147.483.647.
PATH:
/root/ext:UBLExtensions/ext:UBLExtension/ext:ExtensionContent/
sts:DianExtensions/sts:InvoiceControl/sts:AuthorizedInvoices/(sts:Prefix, sts:From)
redondeoAplicado String Ent: N|..15

Dec: N|0..6

SI
Redondeo aplicado para llegar a totalMonto
Rechazo Si redondeo es superior al mayor valor entre 500 pesos o 0,1% del valor total de la factura
PATH: /root/cac:LegalMonetaryTotal/cbc:PayableRoundingAmount
retencionesGenerales Array <FacturaImpuestos> - SI
Información de impuestos generales o globales
Rechazo Si los impuestos/retenciones reportados en este arreglo no corresponden con lo reportado en los detalles
PATH: /root/cac:TaxTotal (impuestos),
/root/cac: WithholdingTaxTotal (retenciones),
(ver detalle en Class.FacturaImpuestos)
serviciosPublicos Array<ServiciosPublicos> - NO
Información referente a servicios publicos
(ver detalle en #Class.ServiciosPublicos)
tasaDeCambio Array<TasaDeCambio> - C/C
Información relacionada con la tasa de cambio de moneda extranjera a peso colombiano (COP)
Obligatorio Si tipoDocumento es de exportación/internacional o si la divisa base es diferente a “COP”
PATH: /root/cac:PaymentExchangeRate
(ver detalle en Class.TasaDeCambio)
tasaDeCambioAlternativa TasaDeCambioAlternativa - NO
Información utilizada como método alternativo para informar conversiones a otras divisas
PATH: /root/cac:PaymentAlternativeExchangeRate
(ver detalle en Class.TasaDeCambioAlternativa)
terminosEntrega TerminosEntrega - C/C
Información relacionada con la entrega
Obligatorio Si tipoDocumento es de exportación/internacional
PATH: /root/cac:DeliveryTerms
(ver detalle en Class.TerminosEntrega)
tipoDocumento String AN|2 SI
Tipo de documento
PATH: Invoice, CreditNote, DebitNote
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 1
tipoOperacion String AN|..4 SI
Indicador del tipo de operación
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 2
PATH: /root/cbc:CustomizationID
totalAnticipos String Ent: N|..15

Dec: N|0..6

NO
Suma de todos los pagos anticipados
Rechazo Si totalAnticipos no corresponde a la suma de los atributos Anticipos.montoPagado en el arreglo anticipos
PATH: /root/LegalMonetaryTotal/cbc:PrepaidAmount
totalBaseImponible String Ent: N|..15

Dec: N|0..6

SI
Total Valor Base Imponible: Suma de Bases imponibles para el cálculo de los tributos a nivel de factura
Rechazo Si totalBaseImponible no es igual a la suma de ocurrencias FacturaImpuestos.baseImponibleTOTALImp
PATH: /root/LegalMonetaryTotal/cbc:TaxExclusiveAmount
totalBrutoConImpuesto String Ent: N|..15

Dec: N|0..6

SI
Total del valor bruto con tributos
Rechazo Si totalBrutoConImpuesto no es igual a la suma: totalSinImpuestos + sum(ImpuestosTotales.montoTotal)
PATH: /root/LegalMonetaryTotal/cbc:TaxInclusiveAmount
totalCargosAplicados String Ent: N|..15

Dec: N|0..6

NO
Cargo Total: Suma de todos los cargos aplicados a nivel de la factura
Rechazo Si totalCargosAplicados no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “true”
PATH: /root/LegalMonetaryTotal/cbc:ChargeTotalAmount
totalDescuentos String Ent: N|..15

Dec: N|0..6

NO
Descuento Total: Suma de todos los descuentos aplicados a nivel de la factura
Rechazo Si totalDescuentos no corresponde a la suma de ocurrencias CargosDescuentos.monto cuando CargosDescuentos.indicador es “false”
PATH: /root/LegalMonetaryTotal/cbc:AllowanceTotalAmount
totalMonto String Ent: N|..15

Dec: N|0..6

SI
Valor a pagar del documento: Valor total de ítems (incluyendo cargos y descuentos a nivel de ítems) + valor de tributos + valor de cargos – valor de descuentos – valor anticipos
Rechazo Si totalMonto no es consistente con el valor total de ítems + valor de tributos + valor de cargos – valor de descuentos – valor anticipos + redondeo aplicado
PATH: /root/LegalMonetaryTotal/cbc:PayableAmount
totalProductos String AN|..5 SI
Número o cantidad de líneas de productos (renglones) presentes en el documento
Rechazo Si el valor de totalProductos es diferente al número de ocurrencias de rans en el arreglo detalleDeFactura
PATH: /root/cbc:LineCountNumeric
totalSinImpuestos String Ent: N|..15

Dec: N|0..6

SI
Total Valor Bruto antes de tributos: Suma de los valores brutos de las líneas de la factura
Rechazo Si totalSinImpuestos no corresponde a la suma de los atributos precioTotalSinImpuestos en el arreglo detalleDeFactura
PATH: /root/LegalMonetaryTotal/cbc:LineExtensionAmount

Class.Anticipos

Atributo Tipo Dato Formato Requerido 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)
fechaDeRecibido String AN|10 SI
Fecha en la cual el pago fue recibido, en formato: YYYY-MM-DD
PATH: …/cbc:ReceivedDate
fechadePago String AN|10 NO
Fecha en la cual el pago fue realizado, en formato: YYYY-MM-DD
PATH: …/cbc:PaidDate
horaDePago String AN|8 NO
Hora en la cual el pago fue realizado, en formato:HH:MM:SS
PATH: …/cbc:PaidTime
id String A|..150 SI
Identificación interno del pago
PATH: …/cbc:ID
instrucciones String AN|15..500 SI
Instrucciones relativas al pago
PATH: …/cbc:InstructionID
montoPagado String Ent: N|..15

Dec: N|0..6

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

Atributo Tipo Dato Formato Requerido Descripción
direccion Direccion - NO
Dirección
PATH: ../cac:PhysicalLocation/cac:Address
email String AN|..50 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)
nombreComercial String AN|..50 NO
Nombre Comercial
PATH: ../cac:PartyName/cbc:Name
nombreContacto String AN|..50 NO
Nombre de Contacto
PATH: ../cac:Contact/cbc:Name
nota String AN|..50 NO
Nota
PATH: ../cac:Contact/cbc:Note
numeroDocumento String AN|..12 SI
Numero de Identificación
PATH: ../cac:PartyIdentification/cbc:ID
numeroDocumentoDV String AN|..2 C/C
Digito Verificador
Obligatorio Si tipoIdentificacion es “31”
PATH: ../cac:PartyIdentification/cbc:ID@schemeID
razonSocial String AN|..50 NO
Razón Social
PATH: ../cac:PartyLegalEntity/cbc:RegistrationName
telefax String AN|..50 NO
Telefax
PATH: ../cac:Contact/cbc:Telefax
telefono String AN|..50 NO
Teléfono
PATH: ../cac:Contact/cbc:Telephone
tipoIdentificacion String AN|..2 SI
Tipo de Identificación
PATH: /cac:PartyIdentification/cbc:ID@schemeName
Ver lista de valores posibles en la Tabla 3

Class.BoletaIngreso

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

Class.bolsaValores

Atributo Tipo Dato Formato Requerido Descripción
consecutivo String - SI
Número del consecutivo
ext:ExtensionContent/CustomTagGeneral/Group/AdditionalCollection/Value
fechaCumplimiento String - SI
Fecha de cumplimiento
ext:ExtensionContent/CustomTagGeneral/Group/AdditionalCollection/Value
cantidadNominal String - SI
Cantidad nominal
ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
precioCesionTotal String - SI
Precio cesion total
ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
PrecioRegistro String - SI
Precio de registro
ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
montoderendimientos String - SI
Monto de Rendimientos
ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
valor String - SI
Valor
ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value
porcentajeComision String - SI
Porcentaje de la comisión
ext:ExtensionContent/CustomTagGeneral/Group/CollectionTotal/Value

Class.CargosDescuentos

Atributo Tipo Dato Formato Requerido Descripción
codigo String AN|2 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 Tabla 4
PATH: …/cbc:AllowanceChargeReasonCode
descripcion String AN|10..5000 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)
indicador String N|1 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: N|..15

Dec: N|0..6

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: N|..15

Dec: N|0..6

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: N|..6

Dec: N|2

SI
Porcentaje del descuento
Rechazo Si este elemento > 100
PATH: …/cbc:MultiplierFactorNumeric
secuencia String N|..3 SI
Indicador de orden de secuencia
PATH: …/cbc:ID

Class.CajaVenta

Atributo Tipo Dato Formato Requerido Descripción
placaCaja String - SI
Valor de la característica que se quiere informar (Placa de inventario de la Caja)
Corresponde a la Placa de inventario de la Caja
./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
ubicacionCaja String - SI
Valor de la característica que se quiere informar (Ubicación de la caja ALMACEN)
Corresponde a la Ubicación de la caja ALMACEN
./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
cajero String - SI
Valor de la característica que se quiere informar (nombres y apellidos del cajero o vendedor)
Corresponde a los Nombres y apellidos del cajero o vendedor
./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
tipoCaja String - SI
Valor de la característica que se quiere informar (Tipo de Caja)
Corresponse al Tipo de Caja
./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value
codigoVenta String - SI
Valor de la característica que se quiere informar (Código de la Venta)
Corresponde al Código de la Venta
./ext:UBLExtension/ext:ExtensionContent//InformacionCajaVenta/Value

Class.CreditoInstrumentoJuego

Atributo Tipo Dato Formato Requerido Descripción
numeroSerie String - SI
Número del serial de la máquina o intrumento de juego con reporte diario crédito
ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/GameMachineSerial
valorCredito String - SI
Valor crédito de la máquina o instrumento de juego
ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/CreditValue
moneda String - SI
Código de modena
ext:ExtensionContent/InfoEstablishment/CreditValueOfTheMachine/CreditValue/@currencyID

Class.Cliente

Atributo Tipo Dato Formato Requerido Descripción
actividadEconomicaCIIU String AN|…4 NO
Corresponde al código de actividad económica CIIU
PATH: .. /cac:Party/cbc:IndustryClassificationCode
apellido String AN|…50 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)
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)
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)
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)
email String AN|..50 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)
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)
nombreComercial String AN|5..450 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 AN|5..450 NO
Nombre de Contacto
PATH: ../cac:Party/cac:Contact/cbc:Name
nombreRazonSocial String AN|5..450 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 AN|..450 NO
Nota adicional de contacto
PATH: ../cac:Party/cac:Contact/cbc:Note
notificar String AN|2 SI
Activa el envío de email al adquirente.
Valores posibles: “SI” o “NO”
PATH: No aplica
numeroDocumento String AN|..12 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 AN|..2 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)
segundoNombre String AN|..50 NO
Segundo nombre del adquiriente.
PATH: No definido
telefax String N|..20 NO
Telefax
PATH: ../cac:Party/cac:Contact/cbc:Telefax
telefono String AN|..20 NO
Teléfono del adquiriente
PATH: …/cac:Party/cac:Contact/cbc:Telephone
tipoIdentificacion String N|2 SI
Tipo de Identificación del adquiriente
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 3
Nota: Para identificar al consumidor final se utiliza el código “13”
PATH: ./cac:Party/cac:PartyTaxScheme/cbc:CompanyID/@schemeName
tipoPersona String N|1 SI
Identificador de tipo de persona
Rechazo Si el contenido de este atributo no corresponde a uno de los valores de la Tabla 5
PATH: …/cbc:AdditionalAccountID
Obtenido de «http://felcowiki.thefactoryhka.com.co/index.php?title=Métodos_Servicio_Emisión_Web_TFHKA_-_Indice_del_Manual_Integración_Directa_HKA_Documentos_Equivalentes_Electrónicos&oldid=5787»