Diferencia entre revisiones de «Caracteristicas adicionales - Indice Manual Integración Directa»

De tfhkacolwiki
Ir a la navegación Ir a la búsqueda
 
(No se muestran 10 ediciones intermedias de 2 usuarios)
Línea 70: Línea 70:
 
|
 
|
 
             <ser:Extras>
 
             <ser:Extras>
                  <ser:controlInterno1>LISTA DE PRECIOS</ser:controlInterno1>
+
                <ser:controlInterno1>LISTA DE PRECIOS</ser:controlInterno1>
 
                 <ser:controlInterno2</ser:controlInterno2>
 
                 <ser:controlInterno2</ser:controlInterno2>
 
                 <ser:nombre>1</ser:nombre>
 
                 <ser:nombre>1</ser:nombre>
Línea 85: Línea 85:
  
 
<includeonly>=</includeonly>==<font color="blue">Uso de campos extras para manejo de descripción del impuesto ZZ</font> ==<includeonly>=</includeonly>
 
<includeonly>=</includeonly>==<font color="blue">Uso de campos extras para manejo de descripción del impuesto ZZ</font> ==<includeonly>=</includeonly>
En este escenario se contempla el manejo de extensible para reporte y  definición  del impuesto ZZ el cual brinda la posibilidad de enviar un impuesto que no se encuentre en la lista definida en el Anexo Técnico de Factura Electrónica de Venta – Versión 1.8 Tabla Tributos 13.2.2 con posibilidad de enviar nominal o porcentual, lo que permitirá que los clientes de ERP puedan enviar en un campo extra el nombre del impuesto ZZ que requieran según su modelo de facturación, y así el servicio tomara este valor y lo colocaría en el atributo que le corresponde en el XML:
+
En este escenario se contempla el manejo de extensible para definir el nombre del impuesto ZZ el cual tambien brinda la posibilidad de enviar un impuesto que no se encuentre en la lista definida en el '''Anexo Técnico de Factura Electrónica de Venta – Versión 1.8 - 13.2.2. Tributos ''' con posibilidad de enviarlo nominal o porcentual, lo que permitirá que los clientes de ERP puedan enviar en un campo extra el nombre del impuesto ZZ que requieran según su modelo de facturación, teniendo en cuenta que su reporte y valor se envían e ilustran en el atributo corresponde en el XML para el impuesto:
 
 
<center>'''Anexo Técnico de Factura Electrónica de Venta – Versión 1.8 - 13.2.2. Tributos '''</center>
 
[[Archivo:TributosZZ.png|800px|sinmarco|centro|Tributos ZZ]]
 
 
 
 
 
 
 
  
 +
[[Archivo:ExtraTributosZZ.png|800px|sinmarco|centro|Extra Tributos ZZ]]
  
 +
{| class="wikitable" style="width: 100%;"
 +
! style="background:#f2f2f2; text-align:center;"|Ejemplo de uso de Campos Extensible para manejo de descripción del impuesto ZZ
 +
|- valign="center"
 +
|
 +
              <ser:Extras>
 +
                  <ser:controlInterno1>ZZ</ser:controlInterno1>
 +
                  <ser:controlInterno2></ser:controlInterno2>
 +
                  <ser:nombre>ZZ</ser:nombre>
 +
                  <ser:pdf>1</ser:pdf>
 +
                  <ser:valor>IBUA</ser:valor>
 +
                  <ser:xml>1</ser:xml>
 +
              </ser:Extras>
 +
|-
 +
! style="background:#f2f2f2; text-align:center;"|Campo Insertado en el PDF
 +
|- valign="center"
 +
|
 +
[[Archivo:PDFZZ.png|800px|sinmarco|centro|CampoExtensibleZZ]]
 +
|-
 +
! style="background:#f2f2f2; text-align:center;"|Campo Insertado en el UBL FISCAL
 +
|- valign="center"
 +
|
 +
[[Archivo:TaxCategory-ZZ.png|800px|sinmarco|centro|TaxCategory-ZZ]]
 +
|}
  
 
<includeonly>=</includeonly>==<font color="blue">Tabla de códigos para campos extras</font> ==<includeonly>=</includeonly>
 
<includeonly>=</includeonly>==<font color="blue">Tabla de códigos para campos extras</font> ==<includeonly>=</includeonly>
Línea 462: Línea 480:
 
#:a. <u>''Afectando a una factura electrónica:''</u> Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
 
#:a. <u>''Afectando a una factura electrónica:''</u> Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
 
#:b. <u>''Afectando a una factura de contingencia:''</u> Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
 
#:b. <u>''Afectando a una factura de contingencia:''</u> Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
 +
<br>
 +
===Contingencia tipo 04===
 +
 +
<b>¿Qué es la Contingencia tipo 04?</b>
 +
 +
Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.
 +
 +
<br>
 +
 +
<b>¿Qué ocurre en una contingencia tipo 04?</b>
 +
 +
Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04  (inconvenientes tecnológicos por parte de la DIAN).
 +
En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como <b> Factura Electrónica de Venta Tipo 04.</b>
  
<includeonly>=</includeonly>==<font color="blue">Radicar documentos electrónicos en plataformas de recepción</font> ==<includeonly>=</includeonly>
+
En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:
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'''.
+
<ul>
 +
<li><b>Código</b>: 207 </li>
 +
<br>
 +
<li><b>Mensaje</b>: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."</li>
 +
<br>
 +
<li>Contendrá CUFE</li>
 +
<br>
 +
<li><b>EsvalidoDIAN</b>: false</li>
 +
</ul>
  
[[Archivo:RadicarAttachedDocument (Contenedor de Documentos).png|800px|sinmarco|centro|Radicar AttachedDocument (Contenedor de Documentos)]]
+
<br>
 +
[[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]]
 +
<br>
  
[[Archivo:RadicarAttachedDocument (Contenedor de Documentos)UBL.png|800px|sinmarco|centro|Radicar AttachedDocument (Contenedor de Documentos) UBL]]
+
<b> Representación Gráfica de contingencia</b>
  
<includeonly>=</includeonly>==<font color="blue">Estándar del nombre de los documentos electrónicos XML</font> ==<includeonly>=</includeonly>
+
Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará <b> Factura Electrónica de Venta Tipo 04 </b> . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.
La DIAN establece en el Anexo técnico la nomenclatura que deben poseer los documentos electrónicos.
+
<br>
 +
[[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]]
 +
<br>
  
<span style="color:#FFFF; background:#FF0000"><b>@IMPORTANTE:</b></span> A través del Response del método Enviar pueden capturar el nombre del documento y posteriormente utilizar esta propiedad, a través del método GenerarContenedor descargar el AttachedDocument y realizar el reemplazo de las dos primeras iniciales por “ad”.
+
<b>Nota importante</b>: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada <b>Factura Electrónica de Venta Tipo 04</b>, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.
 +
<br>
 +
<br>
 +
<b>¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?</b>
 +
<br>
  
[[Archivo:nomenclaturaDIANdocumentoselectrónicos.png|800px|sinmarco|centro|nomenclaturaDIANdocumentoselectrónicos]]
+
No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.
  
 
===<font color="blue">Ambiente de habilitación</font>===
 
===<font color="blue">Ambiente de habilitación</font>===

Revisión actual del 20:15 19 mar 2024

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
CampoExtensibleVendedor

@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
Uso de Campos Libres para insertar identificadores y valores genéricos

Uso de campos extras para manejo de descripción del impuesto ZZ

En este escenario se contempla el manejo de extensible para definir el nombre del impuesto ZZ el cual tambien brinda la posibilidad de enviar un impuesto que no se encuentre en la lista definida en el Anexo Técnico de Factura Electrónica de Venta – Versión 1.8 - 13.2.2. Tributos con posibilidad de enviarlo nominal o porcentual, lo que permitirá que los clientes de ERP puedan enviar en un campo extra el nombre del impuesto ZZ que requieran según su modelo de facturación, teniendo en cuenta que su reporte y valor se envían e ilustran en el atributo corresponde en el XML para el impuesto:

Extra Tributos ZZ
Ejemplo de uso de Campos Extensible para manejo de descripción del impuesto ZZ
              <ser:Extras>
                 <ser:controlInterno1>ZZ</ser:controlInterno1>
                 <ser:controlInterno2></ser:controlInterno2>
                 <ser:nombre>ZZ</ser:nombre>
                 <ser:pdf>1</ser:pdf>
                 <ser:valor>IBUA</ser:valor>
                 <ser:xml>1</ser:xml>
              </ser:Extras>
Campo Insertado en el PDF
CampoExtensibleZZ
Campo Insertado en el UBL FISCAL
TaxCategory-ZZ

Tabla de códigos para campos extras

En este momento los códigos ó propiedad Extras.nombre para campos extras reservados por TFHKA (cualquier otro código utilizado es considerado como libre) son los siguientes:

CAMPOS EXTENSIBLES RESERVADOS POR TFHKA
Código Etiqueta PDF Descripción Etiqueta PDF Observaciones
122333 Aceptación Física Aceptación Física 100
100200 Pie de página Pie de página 100
5170000 Total Base Excluida Total Base Excluida Formato Libre Para totales el R.G
5170001 TOTAL Descuento Detalle TOTAL Descuento Detalle Formato Libre Para totales el R.G
5170002 TOTAL Retenciones TOTAL Retenciones Formato Libre Para totales el R.G
5170003 TOTAL a Pagar TOTAL a Pagar Formato Libre Para totales el R.G
5170004 TOTAL A PAGAR en Letras TOTAL A PAGAR en Letras Formato Libre Para totales el R.G
CamposExtrasReservados
EtiquetasRG

@IMPORTANTE: El campo Aceptación Física se puede aplicar en dos escenarios. El primer escenario, en donde la factura es aceptada tácitamente y solo el XML es generado (el archivo PDF no se genera en nuestra plataforma), asumiendo que la entrega de la representación gráfica es responsabilidad del usuario. El segundo escenario, en el cual la factura es aceptado tácitamente y se genera el XML y el PDF en nuestra plataforma, los cuales serán enviados vía correo electrónico si el campo “notificar” se encuentra seteado en “SI”. Para este último escenario, es necesario que el campo “controlInterno2” se encuentre en “1”.

ADVERTENCIA: Si utiliza la opción controlInterno2 = "", nuestra plataforma no generará representación estándar HKA, por lo tanto no se aloja PDF en la misma y no se podrá visualizar la representación gráfica desde el portal, en el correo del adquiriente (sección visualizar documento), realizar la descarga a través del método DescargaPDF del servicio ni reenviar la misma a través del método EnvioCorreo.
Ejemplo del uso del campo extensible 122333 en el XML
     <ser:Extras>
                 <ser:controlInterno1/>
                 <ser:controlInterno2>1<ser:controlInterno2>
                 <ser:nombre>122333</ser:nombre>
                 <ser:pdf>0</ser:pdf>
                 <ser:valor>1</ser:valor>
                 <ser:xml>0</ser:xml>
     </ser:Extras>

Correo electrónico personalizado

El arreglo “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”.

@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 el valor ‘1’

@IMPORTANTE: Se recomienda que la propiedad Extras.pdf se coloque con el valor ‘0’, con el fin de que la información indicada no se visualice en la representación gráfica estándar. 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 extras.

Campos Extensibles para Correo Electrónico Personalizado
Código Etiqueta PDF Descripción Formato de valor Observaciones
11 Cuerpo del Correo Electrónico Cuerpo del Correo Electrónico AN | 1000 String que contiene el código html del cuerpo del email.
13 Asunto del Correo Electrónico Asunto del Correo Electrónico AN | 100 Definido en el Anexo Técnico V1.7-2020 de la DIAN**
14 Responder a Responder a AN | 100 Debe colocarse una única dirección de email
1700 Linea de Negocio Linea de Negocio AN|100 (Opcional) Inclusión de línea de negocio en el asunto del correo

** El asunto debe cumplir con el siguiente formato:

NIT del Facturador Electrónico; Nombre del Facturador Electrónico; Número del Documento Electrónico; Código del tipo de documento según Tabla 1; Nombre comercial del facturador; Linea de negocio (este ultimo opcional, acuerdo comercial entre las partes).
Ejemplo de uso de Campos Extensibles 11,13 y 14 para personalizar el Correo Electrónico
           <ser:extras>
              <ser:Extras>
                 <ser:controlInterno1>Cuerpo del Correo Electrónico</ser:controlInterno1>
                 <ser:controlInterno2></ser:controlInterno2>
                 <ser:nombre>11</ser:nombre>
                 <ser:pdf>0</ser:pdf>
                 <ser:valor>String de prueba Cuerpo del correo electronico
                            @email.documento.urlAcuseRecibo</ser:valor>
                 <ser:xml>0</ser:xml>
              </ser:Extras>         
              <ser:Extras>
                 <ser:controlInterno1>Asunto del Correo Electrónico</ser:controlInterno1>
                 <ser:controlInterno2></ser:controlInterno2>
                 <ser:nombre>13</ser:nombre>
                 <ser:pdf>0</ser:pdf>
                 <ser:valor>@email.emisor.razonSocial le ha enviado la                       
                            @email.documento.tipoDocumento @email.documento.numeroDocumento
                 </ser:valor>
                 <ser:xml>0</ser:xml>
              </ser:Extras>                              
              <ser:Extras>
                 <ser:controlInterno1>Responder a</ser:controlInterno1>
                 <ser:controlInterno2></ser:controlInterno2>
                 <ser:nombre>14</ser:nombre>
                 <ser:pdf>0</ser:pdf>
                 <ser:valor>notificaciones@thefactoryhka.com</ser:valor>
                 <ser:xml>0</ser:xml>
              </ser:Extras>

Para que el correo electrónico tenga la capacidad de adoptar los datos propios de la transacción, se plantea un juego de variables de código, las cuales serán sustituidas en la plataforma por el valor propio generado en la misma. A continuación se exponen estas variables:

Campos Extensibles para Correo Electrónico Personalizado
Sección Descriptor Valor Referencial Tipo Ubicación
Datos Factura Número de Documento Electrónico @email.documento.numeroDocumento Único Asunto/Cuerpo
CUFE @email.documento.cufe Único Asunto/Cuerpo
Fecha Emisión @email.documento.fechaEmision Único Asunto/Cuerpo
Hora de Emisión @email.documento.horaEmision Único Asunto/Cuerpo
Tipo de Documento Electrónico @email.documento.tipoDocumento Único Asunto/Cuerpo
Tipo de Factura @email.documento.tipoFactura Único Asunto/Cuerpo
Responder A @email.documento.responderA Único Cuerpo
Emisor Tipo Contribuyente @email.emisor.tipoContribuyente Único Asunto/Cuerpo
Tipo de Documento de Identidad @email.emisor.tipoIdentidad Único Asunto/Cuerpo
Número de Documento de Identidad @email.emisor.numeroIdentidad Único Asunto/Cuerpo
Razón Social @email.emisor.razonSocial Único Asunto/Cuerpo
Logo @email.emisor.logo Único Cuerpo
Adquiriente Tipo Contribuyente @email.receptor.tipoContribuyente Único Asunto/Cuerpo
Tipo de Documento de Identidad @email.receptor.tipoIdentidad Único Asunto/Cuerpo
Número de Documento de Identidad @email.receptor.numeroIdentidad Único Asunto/Cuerpo
Razón Social @email.receptor.razonSocial Único Asunto/Cuerpo
Acuse Acuse de Recibo @email.documento.urlAcuseRecibo Único Cuerpo
Ejemplo de String para Cuerpo de correo electrónico en html

<p>Estimado @email.receptor.razonSocial, ha recibido un DOCUMENTO ELECTRÓNICO por parte de @email.emisor.razonSocial; envío que se efectúa mediante el Proveedor Tecnológico The Factory HKA Colombia SAS</p><div style="text-align:center;"><a style=" background-color: #154380; border: 1px solid #ffffff; border-radius: 20px; color: #ffffff; display: inline-block; font-family: sans-serif; font-size: 25px; font-weight: bold; line-height: 60px; text-align: center; text-decoration: none; width: 300px; -webkit-text-size-adjust: none;" class="btn btn-block btn-info" href="@email.documento.urlAcuseRecibo" target="_blank">Acuse de Recibo</a><br></div><br>Por favor revise el documento electrónico e ingrese en el botón de Acuse<br><b>Este E-mail ha sido enviado automáticamente, no responder a esta cuenta. </b><b>@email.advertencia</b><p>La información contenida en este E-mail es confidencial. Si por error recibe este mensaje, favor reenviarlo y borrar</p></div>

@IMPORTANTE: Para que el servicio tome la configuración dinámica del campo “Cuerpo del Correo Electrónico”, el atributo @email.documento.urlAcuseRecibo deberá estar presente.

TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)

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 electrónico deberá generar una carta declarando el inconveniente tegnológico o superación del misma, la cual debe ir firmada por el representante legal de la compañía y remitirla al correo electrónico contingencia.facturadorvp@dian.gov.co con lo siguiente: o Asunto: Nit de la empresa separado con un guion el digito de verificación; Nombre de la empresa.
    • Adjunto: PDF de la carta donde se declaren en contingencia con la firma del representante legal.
    • Cuerpo del correo: Datos de contacto (Nombres, teléfono/Celular de contacto).
      • Nota: Este correo únicamente será para la recepción de correos de los facturadores electrónicos para informar la contingencia o superación de los inconvenientes tecnológicos.
      • Nota: Adicionalmente, si quieren entregar estas constancias por escrito lo pueden realizar a través de radicados, el cual deberá remitirse a la DIAN - nivel central - factura electrónica.
  • El facturador tendrá 48 horas 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 ’.
Tipos de documentos de soporte del proceso de facturación por contingencias atribuibles al facturador electrónico
Código Descripción
FTC Factura Talonario Contingencia
FTP Factura Talonario Papel

¿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.

Generación de código QR de respuesta rápida para facturas de contingencia

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:

Detalle
NumFac: [NUMERO_FACTURA]
FecFac: [FECHA_FACTURA]
HorFac: [HORA_FACTURA(con GMT)]
NitFac: [NIT FACTURADOR]
DocAdq: [NUMERO_ID_ADQUIRIENTE]
ValFac: [VALOR_FACTURA]
ValIva: [VALOR_IVA]
ValOtroIm: [VALOR_OTROS_IMPUESTOS]
ValTolFac: [VALOR_TOTAL_FACTURA]
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
Ejemplo SOAP Request de Factura de Contingencia Tipo 03:
Ejemplo SOAP Request de Factura de Contingencia Tipo 03

@IMPORTANTE: No es requerido que se notifique a los adquiriente 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:

Ejemplo SOAP Request de Factura de Contingencia Tipo 03 sin notificar

Notas a Documentos en Contingencia

Como se mencionó anteriormente, las notas de crédito o débito no tienen esquema de contingencia, por lo tanto las mismas se deben generar en la operación normal. Partiendo de este principio, surgen los siguientes escenarios:

  1. Si la nota a emitir se expide electrónicamente:
    a. Afectando a una factura electrónica: Se realiza la emisión de la nota en operación normal de facturación, tomando en cuenta informar la referencia a documentos en el atributo documentosReferenciados del objeto FacturaGeneral, enviando dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
    i. Objeto 1 (para generar DiscrepancyResponse): los campos codigoEstatusDocumento; codigoInterno=‘4’ y cufeDocReferenciado.
    ii. Objeto 2 (para generar Billingreference): los campos codigoInterno=‘5’; cufeDocReferenciado; fecha; tipoCUFE y numeroDocumento.
    b. Afectando a una factura de contingencia: La emisión de la nota en este escenario dependerá de:
    i. Factura de Contingencia se encuentra transmitida a la DIAN: Se realiza la emisión de la nota en operación normal de facturación, tomando en cuenta informar la referencia a documentos en el atributo documentosReferenciados del objeto FacturaGeneral, enviando dos objetos de tipo DocumentosReferenciados indicando lo siguiente:
    Objeto 1 (para generar DiscrepancyResponse): los campos codigoEstatusDocumento; codigoInterno=‘4’ y cufeDocReferenciado=’CUDE del documento’.
    Objeto 2 (para generar Billingreference): los campos codigoInterno=‘5’; cufeDocReferenciado=’CUDE del documento’; fecha; tipoCUFE y numeroDocumento.
    ii. Factura de contingencia no se ha transmitido a la DIAN: Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
  2. Si la nota a emitir se expide “en contingencia”:
    a. Afectando a una factura electrónica: Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.
    b. Afectando a una factura de contingencia: Se realiza la emisión de la nota “en contingencia” (indicando consecutivo y fecha de expedición de la factura afectada), con compromiso de entrega posterior a la DIAN, sincronizada con la radicación de la factura de contingencia ante el ente.


Contingencia tipo 04

¿Qué es la Contingencia tipo 04?

Se activa en los casos en que el sistema de Factura Electrónica con validación previa de la DIAN queda fuera de línea, por lo tanto, en ese momento no puede validar las Facturas Electrónicas.


¿Qué ocurre en una contingencia tipo 04?

Para no afectar la operación de nuestros clientes, The Factory HKA Colombia activa la facturación por contingencia tipo 04 (inconvenientes tecnológicos por parte de la DIAN). En estos escenarios el cliente no debe realizar ningún tipo de ajuste, debe enviar las facturas tal cual como lo hace habitualmente, usando los consecutivos de facturación electrónica de venta, las facturas quedarán en “estatus pendiente en envío a la DIAN” código de respuesta 207 y y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo. Otro punto muy importante, la representación gráfica de la factura en formato digital o impreso saldrá identificada como Factura Electrónica de Venta Tipo 04.

En el caso de las integraciones para controlar adecuadamente la respuesta del servicio en estos escenarios, se detalla a continuación la información que contendrá el response:

  • Código: 207

  • Mensaje: "El documento se generó como Documento Electrónico de Contingencia Tipo 04, estamos a la espera de que termine la contingencia en la DIAN para entregarlo."

  • Contendrá CUFE

  • EsvalidoDIAN: false


Ejemplo


Representación Gráfica de contingencia

Para los clientes que usan representación gráfica estándar de The Factory HKA Colombia esta se generará automáticamente y cumpliendo con lo establecido en la normativa se denominará Factura Electrónica de Venta Tipo 04 . También contendrán todos los requisitos establecidos en normativa para las representaciones gráficas en formato digital o impreso.

Representacion grafica


Nota importante: En los casos que se genere representación gráfica desde el ERP como adjuntos en 11 esta debe cumplir con la normativa y debe estar denominada Factura Electrónica de Venta Tipo 04, quienes generen este tipo de representaciones gráficas deben garantizar lo antes mencionado.

¿Qué debo hacer con una Factura Electrónica de Venta Tipo 04 (Factura de Contingencia Tipo 04)?

No se debe hacer nada porque las Facturas Electrónicas de Venta Tipo 04 son documentos legales y válidos y y The Factory HKA Colombia tendrá 48 horas para transmitirlas a la DIAN, contadas a partir de que se detecte que el servicio de la DIAN esté activo.

Ambiente de habilitación

El ambiente de pruebas liberado (ambiente demo) corresponde a un entorno de pruebas propio del proveedor tecnológico (The Factory HKA) con el objetivo de que los desarrolladores y Casas de Software puedan realizar pruebas de los ajustes realizados a los ERP bajo el modelo de facturación con validación previa.

La etapa de habilitación, en la cual las pruebas realizadas por los clientes son enviadas al web service de pruebas de la DIAN, se realizará en ambiente productivo del servicio de TFHKA. Culminadas satisfactoriamente estas pruebas, la DIAN los habilitará como facturadores electrónicos.

Posteriormente, podrán iniciar las emisiones de documentos electrónicos en operación normal.

Transmisión de Documentos de prueba a la DIAN en ambiente DEMO

Al momento de dar inicio con el proceso de la integración podrá realizar la emisión de documentos de pruebas en el (ambiente DEMO) directamente contra la DIAN, es decir, poder realizar pruebas 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 HKA Factura DEMO:

URL Portal HKA Factura DEMO:
https://demofactura.thefactoryhka.com.co/auth/login


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:
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):


Configurar Resolución

@IMPORTANTE: El secuencial debe estar configurado con tipo de ambiente Producción2.1, por lo tanto no se deberá ingresar el campo setTestID. Se recomienda indicar un Rango Inicial a partir de un millón (1000000), esto con el fin de contar con un rango amplio para pruebas contra la DIAN sin afectar el rango a usar en las emisiones correspondientes al Set de Habilitación a realizarse en el ambiente productivo.


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.

@NOTA: Las emisiones realizadas en ambiente de pruebas con el secuencial de habilitación no afectarán las emisiones correspondientes al set de habilitación en el ambiente productivo. Adicionalmente, estas emisiones no se consideran parte del set de habilitación.