Diferencia entre revisiones de «Caracteristicas adicionales - Indice Manual Integración Directa»
(No se muestran 11 ediciones intermedias de 2 usuarios) | |||
Línea 4: | Línea 4: | ||
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. | 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: | |
{| class="wikitable" style="width: 100%;" | {| class="wikitable" style="width: 100%;" | ||
Línea 70: | Línea 70: | ||
| | | | ||
<ser:Extras> | <ser:Extras> | ||
− | + | <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 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: | |
− | + | [[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 463: | 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> | ||
− | < | + | 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 | + | <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: | + | <br> |
+ | [[Archivo:contingenciatipo04.png|800px|sinmarco|center|Ejemplo]] | ||
+ | <br> | ||
− | + | <b> Representación Gráfica de contingencia</b> | |
− | < | + | 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. |
− | + | <br> | |
+ | [[Archivo:rgcontingenciatipo04.png|800px|sinmarco|center|Representacion grafica]] | ||
+ | <br> | ||
− | < | + | <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> | ||
− | + | 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
Sumario
- 1 Uso de campos extras
- 2 Uso de campos extras para manejo de descripción del impuesto ZZ
- 3 Tabla de códigos para campos extras
- 4 Correo electrónico personalizado
- 5 TRANSMISIÓN DE DOCUMENTOS DE CONTINGENCIA TIPO 03 (ATRIBUIBLE AL EMISOR)
- 5.1 ¿Cómo transmitir un documento de contingencia Tipo 03?
- 5.2 ¿Cuál será el código de respuesta de transmisión exitosa que retornará el WS de TFHKA?
- 5.3 ¿Cuándo puedo consultar el resultado de la transmisión del documento hacia la DIAN?
- 5.4 Generación de código QR de respuesta rápida para facturas de contingencia
- 5.5 Notas a Documentos en Contingencia
- 5.6 Contingencia tipo 04
- 5.7 Ambiente de habilitación
- 5.8 Transmisión de Documentos de prueba a la DIAN en ambiente DEMO
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) | ||
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 |
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:
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 |
Campo Insertado en el UBL FISCAL |
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
|
@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:
@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:
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:
- 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.
- 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:
- 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:
- 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
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.
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:
- 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):
@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.