MANUAL DE USUARIO API IntTfhkaFel21 - V1.6

MANUAL DE USUARIO
API IntTfhkaFel21
(Integración Directa)
Junio, 2020
Versión 1.6
Documento Confidencial. Prohibida su reproducción parcial o total.

Para uso exclusivo de:
The Factory HKA Colombia SAS
Contenido
1. OBJETIVO ......................................................................................................................................... 3
2. ALCANCE........................................................................................................................................... 3
3. DEFINICIONES Y TÉRMINOS ........................................................................................................ 3
4. CONFIGURACIÓN ............................................................................................................................ 3
5. FUNCIONES DE LA LIBRERÍA....................................................................................................... 4
PARA SABER LA VERSIÓN DEL API INTFHKAFEL21, PUEDE EJECUTAR EL SIGUIENTE
COMANDO DESDE LA CONSOLA DEL SISTEMA: ............................................................................... 4
FoliosRestantes ............................................................................................................. 4
EstadoDocumento .......................................................................................................... 5
DescargarXml ................................................................................................................ 7
DescargarPDF ............................................................................................................... 8
EnvioCorreo ................................................................................................................... 9
Enviar ........................................................................................................................... 10
Envío de Adjuntos ........................................................................................................ 11
GenerarContenedor ..................................................................................................... 15
CATÁLOGO DE ERRORES DE RESPUESTA DEL SERVICIO WEB

1. OBJETIVO
El presente manual tiene como propósito dar a conocer los detalles de la interfaz de
aplicación IntTfhkaFel21 para la integración directa y la descripción de las funciones
para la generación de facturación electrónica ofrecida por The Factory HKA Colombia
SAS.
2. ALCANCE
El presente documento abarca desde la configuración del API hasta las funciones
utilizables para el consumo del Servicio Web de Integración. La librería IntTfhkaFel21
es multiplataforma, es decir, compatible con sistemas operativos Windows y Linux.
Esta librería permite consumir el servicio de integración de The Factory HKA

Colombia SAS en sistemas administrativos (ERP) que nativamente tienen limitantes
para el consumo de servicios web referenciando o importando el WSDL.
3. DEFINICIONES Y TÉRMINOS
EXE: En el ámbito de la informática .exe (de la abreviación del inglés executable,

que se traduce en ejecutable) es una extensión que se refiere a un archivo
ejecutable de código reubicable, es decir, sus direcciones de memoria son relativas.
Los sistemas operativos que utilizan de forma nativa este formato son DOS, Microsoft
Windows, OS/2 y ReactOS.
Servicio Web de Integración: Servicio Web de The Factory HKA Colombia SAS
puesto en disposición a propietarios de software administrativos o de gestión para la
generación de factura electrónica.
4. CONFIGURACIÓN
En el archivo descargado, se encontrará con las tres herramientas básicas para

realizar la integración del software administrativo con nuestra plataforma de factura
electrónica: librería de integración indirecta (IntTfhkaFel21), el presente manual y un
archivo de texto (config.txt) que contendrá los datos de acceso a la plataforma de
facturación electrónica de The Factory HKA. La estructura del archivo config.txt debe
ser la siguiente:

Donde:
 1: Corresponde a la URL para consumir el servicio de Emisión.
 2: Corresponde a la URL para consumir el servicio de Adjuntos.
 3: Corresponde a la URL para consumir el servicio de Reportes.
 4: Corresponde al token empresa (suministrado por TFHKA).
 5: Corresponde al token password (suministrado por TFHKA).
 6: Personalización de ruta y nombre del archivo Resultado.txt (OPCIONAL)
Luego de editar el archivo config.txt de acuerdo a lo descrito anteriormente, la librería

estará lista para ser utilizada desde la ventana de comandos del sistema (CMD ó
BASH).
5. FUNCIONES DE LA LIBRERÍA
version
Para saber la versión del API IntfhkaFel21, puede ejecutar el siguiente comando
desde la consola del sistema:
IntTfhkaFel.exe version (Windows)

./IntTfhkaFel version (Linux)
En el presenta manual se describen las funcionalidades disponibles del API
IntfhkaFel21 que pone a disposición del desarrollador las funciones del Servicio Web
de Integración de The Factory HKA Colombia SAS, dichas funciones se listan a
continuación:
FoliosRestantes
Permite consultar la cantidad de folios. Los valores de la consulta son almacenados
en el archivo Resultado.txt.
Comando:
IntTfhkaFel21.exe FoliosRestantes (Windows)
./IntTfhkaFel21 FoliosRestantes (Linux)

Parámetros: Ninguno
Retorno: Mensaje en ventana del sistema
 Código
 Cantidad de folios restantes
 Mensaje
 Resultado
Resultado.txt: Campos separados por el carácter pipe “|”. El campo Id hace
referencia a que el servicio consumido fue el de Emisión (01), los demás campos son
propios de la respuesta de servicio.
Id|Código|FoliosRestantes|Mensaje|Resultado
Ejemplo:
01|200|9929|Se retorna folios restantes.|Procesado
EstadoDocumento
Permite consultar el estado de un documento. Los valores de la consulta son
almacenados en el archivo Resultado.txt.
Comando:
IntTfhkaFel21.exe EstadoDocumento PRUE100 (Windows)
./IntTfhkaFel21 EstadoDocumento PRUE100 (Linux)
Parámetros: String numeroDocumento: Numero del documento a consultar
 aceptacionFisica
 acuseComentario
 acuseEstatus
 acuseResponsable
 acuseRespuesta
 ambiente
 cadenaCufe
 código

 consecutivo
 cufe
 descripcionDocumento
 descripcionEstatusDocumento
 entregaMetodoDIAN
 esValidoDIAN
 estatusDocumento
 fechaAceptacionDIAN
 fechaDocumento
 mensaje
 mensajeDocumento
 poseeAdjuntos
 poseeRepresentacionGrafica
 resultado
 tipoCufe
 tipoDocumento
 trackID
Resultado.txt: Campos separados por el carácter pipe “|”. El campo Id indica si la

información corresponde a los datos generales sobre el estado del documento
consultado (ID 01) o al historial de entregas del mismo (ID 01B)
01|aceptacionFisica|ambiente|cadenaCufe|código|consecutivo|cufe|descripcionDocum
ento|descripcionEstatusDocumento|entregaMetodoDIAN|esValidoDIAN|estatusDocum
ento|fechaDocumento|mensaje|mensajeDocumento|poseeAdjuntos|poseeRepresentaci
onGrafica|resultado|tipoCufe|tipoDocumento|trackID|acuseComentario|acuseEstatus|
acuseResponsable|acuseRespuesta|fechaAceptacionDIAN
01B|LeidoEmailIPAddress|LeidoEstatus|LeidoFecha|canalDeEntrega|email|entregaEst
atus|entregaEstatusDescripcion|entregaFecha|fechaProgramada|mensajePersonalizad
o|nitProveedorReceptor|recepcionEmailComentario|recepcionEmailEstatus|recepcion
EmailFecha|recepcionEmailIPAddress|telefono
NOTA: Se genera una línea con identificador 01B por cada email informado en el
identificador 01A al momento de la emisión del documento.

Ejemplo:
01|False|2|F7PR2352020-06-0500:00:00-
05:001003.0001190.57040.00030.001193.5790039012612345678unaclavetecnicacu
alquiera2|200|F7PR235|db2a48e3724480c071adeb455eb29f97e54814766366d80ab
4a772b2648e95d90628fa5c573dd9a9be6e5dfe339b1b81|Factura de Venta
Nacional|Procesado Correctamente|NoEnvioDIAN|True|0|2020-06-05 00:00:00-
05:00|Se retornan datos de la Factura.|Procesado
Correctamente|True|True|Exitoso|CUFE-
SHA384|01|db2a48e3724480c071adeb455eb29f97e54814766366d80ab4a772b2648
e95d90628fa5c573dd9a9be6e5dfe339b1b81||0||0|2020-06-05 21:39:35-05:00
01B||||0|email1@thefactoryhka.com|0|Send|2020-06-05 12:00:00+00:00||Mensaje de
Correo Electrónico entregado exitosamente.|12345789||0|||5555555
01B||||0|email2@thefactoryhka.com|0|Send|2020-06-05 12:00:00+00:00||Mensaje de
Correo Electrónico entregado exitosamente.|12345789||0|||5555555
@Importante: El string del código QR al consultar el estado del documento, se

almacena en el archivo string_QR.txt (en caso de que el escenario sea EXITOSO,
en caso contrario se indica mensaje de Error en la ejecución del método).
DescargarXml
Permite descargar un documento en formato XML. Los valores de la consulta son
almacenados en el archivo Resultado.txt y el archivo XML es creado en la carpeta
donde se ejecuta la librería.
Comando:
IntTfhkaFel21.exe DescargarXML PRUE100 (Windows)
./IntTfhkaFel21 DescargarXML PRUE100 (Linux)
 Código
 Cufe
 Mensaje.
 Resultado
Resultado.txt: Campos separados por el carácter porcentaje “%”. El campo Id
hace referencia a que el servicio consumido fue el de Emisión (01), los demás
campos son propios de la respuesta de servicio.
Id|Código|CUFE|Mensaje|Resultado

Ejemplo:
01|200|a6c0945bc48b7af7a08bb7e9d67525d8f2bf7281522b4a9b7ec1d4c780de5d8c
71733c3e69b89361c7716eab2c6f0ced|Archivo VALF71.xml Recuperado
Satisfactoriamente desde el path
UBL21/XML/20519221/2019/8/27/VALF71|Procesado.
DescargarPDF
Permite descargar la representación gráfica de un documento. Los valores de la
consulta son almacenados en el archivo Resultado.txt y el archivo PDF es creado en
la carpeta donde se ejecuta la librería.
Comando:
IntTfhkaFel21.exe DescargarPDF PRUE100 (Windows)
./IntTfhkaFel21 DescargarPDF PRUE100 (Linux)
 Código
 Cufe
 Mensaje.
 Resultado
referencia a que el servicio consumido fue el de Emisión (01), los demás campos
son propios de la respuesta de servicio.
Id|Código|CUFE|Mensaje|Resultado
Ejemplo:
01|200|2257bd44493a74d0a13da41700b3f95c77a83fe4|Se retorna el archivo
solicitado.|Procesado

EnvioCorreo
Permite reenviar el correo que se emite cuando se genera un documento. Si se indica
un correo, entonces reenvía el XML y la Representación Gráfica a dicha dirección.
En caso de que se desee reenviar un documento previamente emitido con adjuntos
(parámetro adjuntos del método Enviar en ‘1’ u ‘11’ al momento de la emisión de
dicho documento), se debe indicar el parámetro de adjuntos del método en ‘1’, el
envío de éste es opcional. La respuesta se almacena en Resultado.txt.
Comando:
IntTfhkaFel21.exe EnvioCorreo PRUE100,email@dominio.com (Windows)
./IntTfhkaFel21 EnvioCorreo PRUE100,email@dominio.com (Linux)
Parámetros:
String numeroDocumento: Numero del documento.
String correoElectronico: Dirección de correo a donde se desea reenviar el
documento.
String adjuntos: ‘0’ -> No reenviar los adjuntos anexos en la emisión del
documento.
‘1’ -> Reenvía los adjuntos anexos en la emisión del
documento.
Retorno: Mensaje en ventana del sistema, donde se detalla:
 Código
 Mensaje.
 Resultado
referencia a que el servicio consumido fue el de Emisión (01), los demás campos
son propios de la respuesta de servicio.
Id|Código|Mensaje|Resultado
Ejemplo:
01|200|Se ha enviado el email de manera correcta.|Procesado

Enviar
Función utilizada para la creación del documento electrónico (factura, nota de crédito
o débito). La respuesta del servicio se almacena en Resultado.txt.
Comando:
IntTfhkaFel21.exe Enviar Factura.txt
./IntTfhkaFel21 Enviar Factura.txt
Parámetros: String rutaArchivo: Nombre o ruta de acceso al documento de texto
que contiene los datos de la factura, nota de crédito o débito de acuerdo a la
estructura descrita en el Val. Previa - Layout Archivo Plano (TXT) - Emisión.
 Código
 Consecutivo del Documento
 CUFE
 Fecha Respuesta
 Fecha Aceptacion DIAN
 Mensaje
 Resultado
 EsValidoDian
 Hash
 Nombre
 Tipo CUFE
La respuesta del método Enviar adicional al identificador 01 contiene, identificadores

adicionales, los cuales son:
01A -> mensajesValidacion: Validaciones TFHKA + XSLT DIAN (Demo y

Producción)
01B -> reglasNotificacionDIAN: Notificaciones DIAN (Producción)
01C -> reglasValidacionDIAN: Rechazos DIAN (Producción)

Id|Código|Consecutivo del Documento|CUFE|Fecha
Respuesta|Mensaje|Resultado|EsValidoDian|Hash|Nombre|Tipo
CUFE|fechaAceptacionDIAN
Ejemplo de respuestas del servicio de Emisión:

-Exitoso:
01|200|F7PR253|67e4be70066fad97dc79cd2996d857f464775de10579b2ea990a980
3c71156623fa52ee5bf24c4a33a293aeacd3f4fde|2020-06-08 13:11:35-05:00|El
documento se envió
correctamente.|Procesado|True|7bdce37568845f5c64c5826fb572503931f37217|fv09
003901260162000000253.xml|CUFE-SHA384|2020-06-08 23:11:34-05:00
-Con error:
01|109|||2019-09-15 01:59:04|El documento no superó las validaciones.||False||||
01A|El campo obligaciones debe tener un valor del catálogo.

Envío de Adjuntos
Para esta funcionalidad, se envía el archivo adjunto en un archivo .txt distinto a donde
se carga la información del documento electrónico, se debe seguir la siguiente
estructura en la emisión del documento, teniendo en cuenta que el documento
emitido queda pendiente por adjuntos al enviar el Parámetro Adjuntos en “1” u
“11” Ver tabla 1.
No. Nombre Req. Tipo|Long|Formato Descripción
1 Identificador SI N|2 Valor fijo “05”
2 Parámetro Adjunto SI N|..2 Parámetro Adjunto Ver tabla 1
Luego de esto se procedería a consumir nuevamente el método Enviar, pero

consumiendo un archivo .txt solo con la siguiente estructura, la cual se puede repetir
tantas veces como archivos adjuntos se necesiten enviar:

No. Nombre Req. Tipo|Long|Formato Descripción
1 Identificador SI N|2 Valor fijo “05”
Número de la Factura
Número de
2 SI AN|..20 Electrónica a la cual se asocian
Documento
los archivos adjuntos.
Indica si envía el correo:

0- No se envía (queda a la
espera de más adjuntos)
3 Enviar SI N|1
1- Se envía el documento con los
adjuntos asociados hasta el
momento
Extensión del archivo que se

desea adjuntar. Valores
4 Formato SI AN|..4
aceptados: png bmp jpg pdf doc
docx xls xlsx ppt pptx
Nombre del documento que se

5 Nombre SI AN|..50
desea adjuntar (sin la extensión).
Indicar si el documento es
6 Tipo SI N|1 Representación gráfica:
2- Anexo
Indica los correos a los cuales se

desea realizar la entrega.
7 Email SI Array<string>
(Pueden enviarse máximo 5
correos separados por coma “,”)
Ruta del archivo que desea

8 Ruta del Archivo SI -
enviar como adjunto

Ejemplo para emitir documento con un archivo adjunto en diferentes archivos .txt de
la información del comprobante:
Archivo1.txt (correspondiente al documento a emitir)
01|Pedro|2||Perez|12345678|13|email@thefactoryhka.com|04245555555|SI|0010|The
Factory HKA Colombia|Pedro Perez||8|||||
01A|0|email1@thefactoryhka.com,email2@thefactoryhka.com|2019-08-07
00:00:00||12345789|5555555||||
01B|01||||
01C|||||||BOGOTÁ, D.C.|11||Bogotá||Calle 1|||es|11001||||CO|||||110211||||
01D|||||||BOGOTÁ, D.C.|11||Bogotá||Calle 1|||es|11001||||CO|||||110211||||
01E|00001|CONSORCIO ALIANZA SAN CRISTOBAL 4|901041710|5|123456|BC|31
01F|O-15|04||||
02|01|CONSECUTIVO|PEFIJO-DESDE|2019-09-12
00:00:00||COP|||1003.00|1193.57|2||||0.00|05||1003.00|1193.57||1
02G|1003.00|01||19.00|WSD||190.57|||||
02H|01|190.57||||
02I|TEXTO INFO ADICIONAL 1
02I|TEXTO INFO ADICIONAL 2
02J|||||10|1||0001||||||
03|P000001|Impresora
HKA80|1.00|WSD|1003.00|1003.00|90.00||1|1.00|WSD|||||999||||PHKA80||||||||0||
||1|||||||||||||||||||||||||||||||||||||||||1003.00|01||19.00|WSD||190.57||||
||||||||||||||||||||||||||01|190.57|||||||||||||||||||||||||||
04|||100200|1|123456|1
05|PARAMETROADJUNTO
Resultado.txt: Campos separados por el carácter pipe “|” y cada respuesta por
archivo adjunto separados por un salto de línea. El campo Id hace referencia a que
el servicio consumido fue el de Emisión (01), los demás campos son propios de la
respuesta de servicio, por ejemplo:
01|200|VALF162|a1a3283d31e284c3d77326a5efa2e2a05a45f2c034c2d66649371bda
7239d73703e42e8b1c9420bae6e1dae90cf88ab5|2019-09-17 12:42:52| Documento
pendiente por Adjuntos.
|Procesado|True|593b52129119d248c3b1466f5db7f8168b13c279|fv0020519221016
1900000162.xml|CUFE-SHA384

Luego, se vuelve a consumir el método Enviar con un archivo .txt configurado de la

siguiente manera:

Archivo2.txt (correspondiente al adjunto a enviar al momento de la emisión del
documento fiscal)
05|VALF1|0|pdf|Adjunto1|2|email1@thefactoryhka.com,
email2@thefactoryhka.com|Adjunto1.pdf
05|VALF1|1|pdf|Adjunto2|2|email1@thefactoryhka.com,
email2@thefactoryhka.com|Adjunto2.pdf
Resultado.txt: Campos separados por el carácter pipe “|” y cada respuesta por
archivo adjunto separados por un salto de línea. El campo Id hace referencia a que
el servicio consumido fue el de Adjuntos (02), los demás campos son propios de la
respuesta de servicio, por ejemplo:
02|200|Archivo cargado satisfactoriamente. No se considera la información

especificada en el atributo email ya que se indicó que no se desea enviar correo
alguno|Procesado - Con Advertencia
02|200|Archivo cargado satisfactoriamente|Procesado
Tabla 1 Parámetro adjunto
Código Descripción
No se admiten adjuntos.
Se genera la representación gráfica estándar por parte de la
adjuntos=0 plataforma.
Se envía el XML y la representación gráfica estándar por el canal
correspondiente al Adquiriente1 si el campo notificar está en “SI”
Se admiten adjuntos
El campo email es requerido y el campo notificar en “SI”
Se genera la representación gráfica estándar por parte de la
adjuntos=1
plataforma.
Se envía el XML, la representación gráfica estándar generada y los
demás adjuntos por el canal correspondiente al Adquiriente.
No se admiten adjuntos.
No se genera la representación gráfica estándar por parte de la
adjunto=10 plataforma.
Se envía el XML sin la representación gráfica estándar, por el canal
correspondiente al Adquiriente si el campo notificar está en “SI”.
Se admiten adjuntos.
El campo email es requerido y el campo notificar en “SI”
No se genera la representación gráfica estándar por parte de la
plataforma.
adjunto=11
Se envía el XML sin la representación gráfica estándar y los demás
adjuntos por el canal correspondiente al Adquiriente. (Uno de los
adjuntos puede ser la representación gráfica personalizada por el
ERP)

GenerarContenedor
Un contendor es un tipo de documento AttachedDocument, cuya estructura 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. Este método genera un archivo con el nombre:
AttachedDocument_NumeroConsecutivo
Comando:
IntTfhkaFel21.exe GenerarContenedor PRUE100 (Windows)
./IntTfhkaFel21 GenerarContenedor PRUE100 (Linux)
Parámetros: String numeroDocumento: Numero del documento al cual se le
generará el contenedor.
 código
 fecha
 mensaje
 resultado
Id|código|fechaDocumento|mensaje|resultado
Ejemplo:
01|200|2020-01-22 10:04:36-05:00|Documento Generado con éxito|Procesado
Nota: Las funciones descritas anteriormente fueron puestas a prueba bajo los
siguientes Sistemas Operativos:
 Windows 7 - 64bits
 Windows 10 - 64bits
 Windows XP - 32bits
 Linux CentOS 6.9 (Final) - 32bits
 Linux CentOS 7.5.1804 (Core) - 64bits
 Linux Kali 2016.1 – 32bits
 Ubuntu 18.04 LTS – 64bits

Bajo entorno Linux – 32 bits, esta librería es compatible para GCC 4.4.7 o
superior
Bajo entorno Linux – 64 bits, esta librería es compatible para GCC 4.8.5 o
superior
6. CATÁLOGO DE ERRORES DE RESPUESTA DEL

SERVICIO WEB
Método Enviar
Códigos Genéricos Resultado Código de Mensaje
Respuesta
El documento se envió correctamente
Envío Satisfactorio Procesado 200
(Síncrono).
Documento recibido, se enviará más tarde
a la DIAN (Asíncrono).
Documento de contingencia recibido, se
enviará más tarde a la DIAN (Asíncrono).
Error por Excepciones Error de Procesamiento
Error 103
generales (Debe enviar xml-request para su análisis)
Ejm: El campo {nombre del campo} es
obligatorio
Error en capa de Ejm: El campo {nombre del campo} debe
Error 109
Validaciones TFHKA ser numérico.
Ejm: El cliente No posee Folios Disponibles
(Debe enviar xml-request para su análisis)
Error por Excepciones Debe validarse el XML/UBL generado
Error 161
XSLT Local (TFHKA) (Debe enviar xml-request para su análisis)
Ejm: Fatal: [FAR08]- (R) Total de la factura
100.00 diferente de la suma de Total valor
Error en Validaciones
Error 110 bruto + Total Tributos - Anticipos (+/-)
XSLT Local (TFHKA)
Redondeos : 120.00 }
Error Factura ya
Documento emitido previamente
emitida o se encuentra Error 114
(Debe consultar el EstadoDocumento)
en TFHKA y DIAN
Documento fue rechazado por la DIAN
Documento rechazo
Error 99 (Debe validarse los motivos de rechazo o
por la DIAN
reglasValidacionDIAN)
La longitud del campo Token
[empresa/password] no cumple con el
Envío de Datos Error 111 rango permitido.
El campo Token [empresa/password] solo
debe tener números y letras

El Token del Emisor es inválido.
(Debe validarse el ambiente al que
Token invalido Error 101
corresponden los tokens utilizados y
URL’s de conexión)
Error al extraer la información del
Error al parsear el
Error 112 documento al comprobante.
documento
Error. El rango, fecha de la factura o fecha
Error validaciones de autorización son inválidos. / Error el
incorrectas en los Error 117 número de documento es inválido.
rangos (Debe validarse configuraciones del
secuencial en el portal y ERP)
Error, el número de autorización o el tipo
Error validación de de documento es inválido. / Error el
autorización en los Error 118 número de documento es inválido.
rangos (Debe validarse configuraciones del
secuencial en el portal y ERP)
No posee folios disponibles.
Error validación de Se debe contactar al nuestro equipo de
Error 119
Folios facturación para adquirir un paquete de
transacciones o folios.
No existe el rango de numeración.
Error validación en
Error 150 (Debe validarse el tipo de documento y si
rango
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
integracion_fel_co@thefactoryhka.com exponiendo el caso.
Método EstadoDocumento
Respuesta
Respuesta Satisfactoria Procesado 200 Se retornan datos de la factura
Token Invalido Error 101 El Token del Emisor es inválido.
Número de documento inválido, no
Error en Validaciones Error 102
existe.
Ha ocurrido un error en la ejecución del
Error de Ejecución Error 103
servicio, por favor intente más tarde.
Error al Extraer Datos Error 105 Error al extraer los datos del documento.

Método EnvioCorreo
Respuesta
Respuesta
Procesado 200 Se ha enviado el email de manera correcta
Satisfactoria
Error en Validaciones Error 102 Número de documento inválido, no existe.
Correo inválido Error 106 Formato de correo electrónico inválido.
Método DescargaPDF
Respuesta
Respuesta
Procesado 200 Se retorna el archivo solicitado
Satisfactoria
Error, no se pudo obtener el archivo
Error al Extraer Datos Error 105
solicitado.
Método DescargaXML
Respuesta
Respuesta
Satisfactoria
solicitado.

Método GenerarContenedor
Respuesta
Respuesta
Satisfactoria
solicitado.
Método FoliosRestantes
Respuesta
Respuesta
Procesado 200 Se retorna folios restantes.
Satisfactoria
Método CargarAdjuntos
Respuesta
Archivo {nombreDelArchivo}{extension}
Envío satifactorio Procesado 200
almacenado exitosamente
Se señaló previamente que para el
documento {consecutivo} emitido por
Error en carga de {NIT Emisor} ya se habían completado los
Error 107
archivo adjuntos esperados
(Quiere decir que ya la propiedad enviar
fuen setada en “1” anteriormente)
[Sección del Error]El campo {nombre del
campo} debe tener un valor del catálogo.
Error en Validaciones Error 109 campo} es requerido.
campo} debe ser un {tipo de datos} de
{tamaño} {numérico/alfanumérico}.

Bodega 20., Ac 80 #6970, Bogotá, Colombia
Departamento de Integración
Integracion_fel_co@thefactoryhka.com
www.thefactoryhka.com/co/facturacionElectronica/index


MANUAL DE USUARIO API IntTfhkaFel21 - V1.6

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

MANUAL DE USUARIO API IntTfhkaFel21 - V1.6

Cargado por

Copyright:

Formatos disponibles

MANUAL DE USUARIO

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

Esta librería permite consumir el servicio de integración de The Factory HKA

EXE: En el ámbito de la informática .exe (de la abreviación del inglés executable,

En el archivo descargado, se encontrará con las tres herramientas básicas para

Documento Confidencial. Prohibida su reproducción parcial o total.

Luego de editar el archivo config.txt de acuerdo a lo descrito anteriormente, la librería

IntTfhkaFel.exe version (Windows)

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

Resultado.txt: Campos separados por el carácter pipe “|”. El campo Id indica si la

Documento Confidencial. Prohibida su reproducción parcial o total.

@Importante: El string del código QR al consultar el estado del documento, se

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

La respuesta del método Enviar adicional al identificador 01 contiene, identificadores

01A -> mensajesValidacion: Validaciones TFHKA + XSLT DIAN (Demo y

Documento Confidencial. Prohibida su reproducción parcial o total.

Ejemplo de respuestas del servicio de Emisión:

@Importante: El string del código QR al consultar el estado del documento, se

No. Nombre Req. Tipo|Long|Formato Descripción

1 Identificador SI N|2 Valor fijo “05”

2 Parámetro Adjunto SI N|..2 Parámetro Adjunto Ver tabla 1

Luego de esto se procedería a consumir nuevamente el método Enviar, pero

Documento Confidencial. Prohibida su reproducción parcial o total.

1 Identificador SI N|2 Valor fijo “05”

Indica si envía el correo:

Extensión del archivo que se

Nombre del documento que se

Indica los correos a los cuales se

Ruta del archivo que desea

Documento Confidencial. Prohibida su reproducción parcial o total.

Archivo1.txt (correspondiente al documento a emitir)

@Importante: El string del código QR al consultar el estado del documento, se

Luego, se vuelve a consumir el método Enviar con un archivo .txt configurado de la

Documento Confidencial. Prohibida su reproducción parcial o total.

02|200|Archivo cargado satisfactoriamente. No se considera la información

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

6. CATÁLOGO DE ERRORES DE RESPUESTA DEL

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

Documento Confidencial. Prohibida su reproducción parcial o total.

También podría gustarte