Indice del Manual Integración Directa - Documentos Equivalentes Electrónicos

Generalidades

1. Cómo obtener soporte
2. Descripción general
   1. ¿Qué es The Factory HKA Equvalente?
   2. ¿Qué es HKA Integración?
   3. Funcionalidades

Métodos Servicio Emisión Web TFHKA

1. Método EnviarRequest
   1. Class.FacturaGeneral
2. Método DescargaXML
3. Método GenerarContenedor

Uso de campos extras

El arreglo “extras” permite incorporar campos opcionales que se insertarán en el XML-Invoice y en la representación impresa según se desee.

Los campos extras no son obligatorios por la DIAN, pero en ciertos casos son importantes y necesarios en el modelo de negocio del emisor. Estos incorporan información adicional dentro del documento, como por ejemplo, detalles del pago, la entrega, el transporte, coordenadas geográficas, lote de productos, vencimiento de la mercancía, servicios médicos, servicios aeronáuticos, información libre, entre muchos otros.

Estos campos opcionales están diseñados según parámetros establecidos en la Cámara Colombiana de Comercio Electrónico y la DIAN, con el propósito de ser interoperables (esto aún no está definido en su totalidad para el modelo de validación previa). La información a insertar en un campo extensible debe cumplir con criterios asociados al campo específico a insertar. La estructura del objeto “extras” es la siguiente:

Tipo	Identificador	Formato	Descripción
String	controlInterno1	AN|100	Etiqueta asignada para la Representación Impresa PDF.
	controlInterno2	Depende del campo	Permite asociar dos o más campos mediante un índice (si los campos son asociables)
	nombre		Código del campo extensible a referenciar (existen códigos definidos por TFHKA para información especifica y también pueden usarse códigos libres)
	pdf	N|1	Indicación de mostrar el campo en la representación gráfica PDF (“0” = No mostrar / “1” = Mostrar)
	valor	Depende del campo	Valor del campo a agregar.
	xml	N|1	Indicación de mostrar el campo en el XML (“0” = No mostrar / “1” = Mostrar)

Ejemplo de uso de Campos Extensible 443 (Vendedor)
<ser:Extras> <ser:controlInterno1>Vendedor</ser:controlInterno1> <ser:controlInterno2></ser:controlInterno2> <ser:nombre>443</ser:nombre> <ser:pdf>1</ser:pdf> <ser:valor>Pablo Marmol</ser:valor> <ser:xml>0</ser:xml> </ser:Extras>
Campo Insertado en el PDF

@IMPORTANTE: Se recomienda que la propiedad Extras.xml se coloque con el valor ‘0’, ya que The Factory HKA implementa el uso de CDATAS anidados en la estructura del XML para reflejar los campos extras, sin embargo algunas plataformas de recepción no pueden interpretar este estándar y pueden existir rechazos al momento de radicar el documento si a esta propiedad se le asignan al valor ‘1’

La etiqueta que se asigne en Extras.ControlInterno1 es de libre elección, mientras se respete el formato estipulado. Sin embargo, será necesario conocer los demás parámetros, que serán suministrados con los campos disponibles:

• El código del campo, para colocar en Extras.nombre.
• Si el campo es repetible y asociable, para colocar un índice común en Extras.ControlInterno2.
• El formato del valor del campo, para que la información que se coloque Extras.valor sea válida.

Además de los campos disponibles (códigos reservados por TFHKA), se ha contemplado el uso de campos LIBRES, para insertar identificadores y valores genéricos. Este campo es repetible.

Note el siguiente ejemplo para insertar un campo libre:

Ejemplo
<ser:Extras> <ser:controlInterno1>LISTA DE PRECIOS</ser:controlInterno1> <ser:controlInterno2</ser:controlInterno2> <ser:nombre>1</ser:nombre> <ser:pdf>1</ser:pdf> <ser:valor>MAYORISTA</ser:valor> <ser:xml>0</ser:xml> </ser:Extras>
Campo Insertado en el PDF