Histórico da Página

ÍNDICE

1. Visión general
   
2. Ejemplo de utilización
   
3. Pantalla Facturación Electrónica
   
   1. Otras acciones / Acciones relacionadas
   2. Impresión de documentos electrónicos (PDF)
   3. Envío de documentos electrónicos (Correo Electrónico)¹
4. Tablas
5. Diccionario de Datos

01. VISIÓN GENERAL

Realizar la transmisión de documentos electrónicos en el modelo de Facturación Electrónica con Validación Previa a la Dirección de Impuestos y Aduana Nacionales (DIAN), consumiendo los web services del proveedor tecnológico The Factory HKA.

El sustento legal y toda la información referente a Factura Electrónica se encuentra en el sitio de la DIAN.

NOTA: Para la implantación del proceso de validación previa, se deberá de contar con las configuraciones del modelo de validación posterior descrito en el documento técnico DMINA-2487_DT_Factura_Electronica_Fac-e_v2_COL

Documentos a transmitir:

• Factura de Venta
• Nota de Débito
• Nota de Crédito
• Facturas de Venta/Nota de Débito/Nota de Crédito de Exportación

PROCEDIMIENTO DE IMPLANTACIÓN

1.- Se recomienda realizar un respaldo del repositorio de objetos (RPO) antes de aplicar el paquete de actualización (patch).

2.- Aplicar el paquete de actualización (patch) del presente issue, el cual contiene las siguientes rutinas:

• FISA814.PRW
• FISA827.PRW
• LOCXNF.PRW
• LOCXNF2.RW
• M486XFUN.PRW
• M486XFUNCO.PRW
• MATA468N.PRX
• MATA486.PRW
• MATN030.PRX
• WSNFECOL.PRW
• FATSCOL.INI
• FATECOL.INI
• FATSECOL.INI

3.- Realizar las actualizaciones al diccionario de datos de acuerdo a la sección 05, Diccionario de datos, del presente documento técnico.

4.- En el módulo Configurador (SIGACFG) acceda a Actualizaciones | Diccionario de Datos | Parámetros.

• Configurar el parámetro MV_TIPOFE con valor 1 para que la transmisión electrónica sea por modelo de validación previa.
• Configurar el parámetro MV_PATH814 con la ruta donde se encuentran los archivos con formato .csv para la carga de catálogos de la DIAN.
• Configurar el parámetro MV_WSRTSS con la URL de los web services de The Factory HKA para el modelo de validación previa. (Se debe informar la URL de acuerdo al ambiente en el que se esté realizando la transmisión electrónica; pruebas o producción, dicha URL es proporcionada por el proveedor tecnológico).

5.- En la ruta configurada en el parámetro MV_PATH814 actualizar los archivos 05ImpuestosFE.csv, 10TiposRegimen.csv y 14TiposObligacionesResp.csv, y agregar el nuevo archivo 17TiposOperacion.csv.

Importante: Las actualizaciones a los catálogos deberán de ser de acuerdo al anexo Estructura UBL y Validaciones Factura Electrónica 2.1 Versión 2, y se deberán borrar en las tablas F3I y F3H los registros de los catálogos S005, S010 y S014.

Tasa de Cambio

Para la generación documentos en moneda diferente de pesos colombianos (COP) en el XML se deberá tenerse creado el nodo cac:PaymentExchangeRate, para lo cual se deberán agregar las siguientes líneas en los archivos con extensión .INI:

En la sección de XXX INICIALIZACION agregar la línea:

(PRE) _aTotal[109] := Posicione("CTO",1,xFilial("CTO")+Strzero(SF2→F2_MOEDA,2),"CTO_MOESAT")

En la sección XXX RECEPTOR agregar las siguientes líneas después de la finalización del nodo PaymentTerms:

(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cac:PaymentExchangeRate>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cbc:SourceCurrencyCode>' + Alltrim( Posicione("CTO",1,xFilial("CTO")+Strzero(SF2->F2_MOEDA,2),"CTO_MOESAT") ) + '</cbc:SourceCurrencyCode>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cbc:SourceCurrencyBaseRate>1.00</cbc:SourceCurrencyBaseRate>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cbc:TargetCurrencyCode>' + "COP" + '</cbc:TargetCurrencyCode>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cbc:TargetCurrencyBaseRate>1.00</cbc:TargetCurrencyBaseRate>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cbc:CalculationRate>' + Alltrim(Str(SF2->F2_TXMOEDA,11,2)) + '</cbc:CalculationRate>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' <cbc:Date>' + _aTotal[095] + '</cbc:Date>' + ( chr(13)+chr(10) ) , "" )
(PRE) _aTotal[001] += IIf( _aTotal[109] <> "COP" , ' </cac:PaymentExchangeRate>' + ( chr(13)+chr(10) ) , "" )

Documento Referenciado

Para la generación del nodo AdditionalDocumentReference, en el script de generación del archivo XML, FATSCOL.INI, deben existir las siguientes líneas de tal manera que el nodo se genere en la raíz del nodo fe:Invoice : 

//Documentos referenciados (solo facturas)
(PRE) _aTotal[001] += IIf(SF2->(ColumnPos("F2_UUIDREL")) > 0 .And. AllTrim(SF2->F2_ESPECIE)=="NF",M486DRCOL(SF2->F2_UUIDREL,1),"")

Ejemplo del nodo:

<cac:AdditionalDocumentReference>

<cbc:ID>60</cbc:ID>

<cbc:DocumentTypeCode>AIJ</cbc:DocumentTypeCode> (Debe corresponder a valores de la tabla S018 - REFERENCIA A OTROS DOCUMENTOS)

<cbc:IssueDate>2020-02-05</cbc:IssueDate>

</cac:AdditionalDocumentReference>

Donde :

Importante: Los documentos referenciados son tomados del campo Docs Relacs (F2_UUIDREL), el formato de captura debe ser:

t/n/aaaa-mm-dd

En donde:

t = Tipo de documento

n = Número de documento

aaaaa-mm-dd = Fecha del documento (año-mes-día)

Por ejemplo AIJ/60/2020-02-05, si es necesario registrar más de una referencia, cada documento debe ir en una línea,

Los diferentes Tipos de Documento deben registrarse en el catálogo S018 - REFERENCIA A OTROS DOCUMENTOS, en la rutina Mantenimiento de Catálogos (Verificar la estructura de que debe contener el archivo 18CodigoReferenciaDocs.csv).

Orden de Compra

Para la generación del nodo OrderReference, en el script de generación del archivo XML, FATSCOL.INI, deben existir las siguientes líneas de tal manera que el nodo se genere en la raíz del nodo fe:Invoice:

// Orden de Compra
(PRE) _aTotal[001] += IIf(SF2->(ColumnPos("F2_UUIDREL")) > 0 .And. AllTrim(SF2->F2_ESPECIE)=="NF",M486DRCOL(SF2→F2_UUIDREL,2),"")

Ejemplo del nodo:

<cac:OrderReference>

<cbc:ID>156</cbc:ID>

<cbc:IssueDate>2020-02-05</cbc:IssueDate>

</cac:OrderReference>

Importante:  El dato es tomado del campo Docs Relacs (F2_UUIDREL), el formato de captura debe ser:

ORDC/n/aaaa-mm-dd

En donde:

ORDC = Acrónimo de Orden de Compra (valor fijo)

n = Número de documento

aaaaa-mm-dd = Fecha del documento (año-mes-día)

Por ejemplo ORDC/156/2020-02-05. Solo se permite informar una orden de compra de referencia por factura.

7.- Para el nodo de actividadEconomicaCIIU se deberá configurar el campo C.Actividad (A1_ATIVIDAD) del Cliente.

El archivo 05ImpuestosFE.csv deberá tener la siguiente estructura:

Importante: En el módulo Facturación (SIGAFAT) desde Actualizaciones | Archivos | Impuestos Variables (MATA995), se deberán re-configurar para cada impuesto el campo Impuesto FE (FB_IMPSAT) con los valores definidos por la DIAN, con la última actualización de catálogo S005 - IMPUESTOS FACTURA ELECTRÓNICA.

El archivo 10TiposRegimen.csv deberá tener la siguiente estructura:

El archivo 14TiposObligacionesResp.csv deberá tener la siguiente estructura:

El archivo 17TiposOperacion.csv deberá tener la siguiente estructura:

El archivo 18CodigoReferenciaDocs.csv deberá tener la siguiente estructura:

8.- En la ruta configurada en los parámetros MV_CFDFTS, MV_CFDFTE y MV_CFDFTSE, actualizar los archivos FATSCOL.INI, FATSECOL.INI y FATECOL.INI.

02. EJEMPLO DE UTILIZACIÓN

Clientes

Nacionales, se les deben configurar los campos de Código de Departamento (A1_EST) y Código de Municipio (A1_COD_MUN)

Atributos para envió de datos del cliente:

NOTA: El departamento y municipio deben estar homologados con los códigos y descripciones de acuerdo a los puntos 6.4.2 Departamentos y 6.4.3 Municipios del anexo definido por la DIAN:

Configurar el Tipo de régimen del cliente, modificando el cliente y ejecutando desde Otras Acciones | Complementos del cliente.

Configurar las Responsabilidades tributarias del cliente, modificando el cliente y ejecutando desde Otras Acciones | Resp. Obligaciones DIAN.

Configurar los Tributos del cliente, modificando el cliente y ejecutando desde Otras Acciones | Tributos DIAN.

Para Facturas de Venta, Nota de Crédito y Nota de Débito

Desde el módulo Facturación (SIGAFAT) registrar los siguientes documentos:

• Factura de Venta/Factura de Venta de Exportación (Actualizaciones | Facturación | Facturaciones).
• Nota de Crédito (Actualizaciones | Facturación | Generac. de Notas de Crédito/Débito).
• Nota de Débito (Actualizaciones | Facturación | Generac. de Notas de Crédito/Débito).

En la captura de los documentos se debe informar el Tipo de operación (F1_TIPOPE/F2_TIPOPE).

Desde el módulo Facturación (SIGAFAT) acceder a Actualizaciones | Facturación | Facturación Electrónica (MATA486)

a) En los parámetros indicar el Tipo y Serie del documento a transmitir.

b) Ejecutar la acción Transmitir.

c) Indicar los parámetros de la serie y rango de folios a transmitir.

d) Una vez finalizado el proceso se visualizará el log donde se podrá consultar si la transmisión fue exitosa; en caso de haber inconsistencias, proceda a realizar las configuraciones necesarias e intente transmitir nuevamente.

e) Si el documento transmitido retorna código 200-Respuesta satisfactoria, el documento quedará con estatus Documento autorizado (Verde), si el código de retorno es 201 - El documento se entregó a DIAN, estamos a la espera del resultado de validación el documento quedará en estatus Pendiente de procesamiento (Amarillo) y cualquier otro código de retorno quedará con estatus No Transmitido (Gris).

f) Si los documentos transmitidos quedaron en estatus 201 - El documento se entregó a DIAN, estamos a la espera del resultado de validación, se deberá consultar mediante la acción Monitor para actualizar el estatus en Protheus de acuerdo a la respuesta de la DIAN, en caso de que el documento haya sido rechazado, mediante el botón Errores que se encuentra en la parte inferior de la pantalla Monitor se podrán visualizar las observaciones del documento.

03. PANTALLA FACTURACIÓN ELECTRÓNICA

a) Otras acciones / Acciones relacionadas 

b) Impresión de documentos electrónicos (PDF)

Importante: La impresión de documento en formato PDF obedece a la configuración del parámetro MV_PDFPRO.

Desde Otras acciones, ejecutar la acción Imprimir PDF.

Informar los parámetros del rango de documentos a imprimir.

Se imprime el documento electrónico en formato PDF.

c) Envío de documentos electrónicos (Correo Electrónico)¹

La funcionalidad de Envío de documentos electrónicos, se implementó a partir del issue DMINA-8271, para la cual se debe consideras lo siguiente:

El parche debe contener la siguiente rutina:

También se deben realizar las siguiente configuraciones:

1. Configurar los parámetros MV_RELSERV, MV_RELACNT, MV_RELPSW, MV_RELAUTH, MV_RELSSL, MV_RELTLS y MV_SRVPORT como se muestra en la sección "04 - Diccionario de Datos".
2. Configurar el Cliente como a continuación:

Importante:  El cliente debe tener informado el campo E-MAIL (A1_EMAIL) con la dirección de correo a donde se requiera mandar los documentos.

Al finalizar la configuración de pre-condiciones, realice lo siguiente para validar la funcionalidad:

Desde Otras acciones, ejecutar la acción Imprimir PDF:

Informar los parámetros del rango de documentos a enviar por E-mail:

Se espera mensaje de confirmación del envío, en donde indica la cantidad de documentos procesados:

Se confirma que se recibe el correo con la información solicitada adjunta en un archivo .ZIP:

04. TABLAS UTILIZADAS

• SF1 - Encabezado de Facturas de Entrada.
• SF2 - Encabezado de Facturas de Salida.
• SA1 - Clientes.
• SYA - Países.
• SFB - Impuestos Variables.
• SFC - Vínculo TES vs. Impuestos.
• SD1 - Ítems de Facturas de Entrada.
• SD2 - Ítems de Facturas de Salida.
• SAH - Unidades de Medida.
• SB1 - Descripción Genérica de Producto.
• SFP - Control de Formularios.
• F3H - Definición de catálogos.
• F3I - Mantenimiento de catálogos.
• SC5 - Encabezado de Pedidos de Venta.
• CTO - Monedas.
• SF4 - Tipos de Entrada/Salida (TES).
• SFC - Detalle Tipos de Entrada/Salida (impuestos).
• AIT - Responsabilidades-Tributos del cliente.

05. DICCIONARIO DE DATOS

El usuario debe realizar las siguientes actualizaciones al diccionario de datos a través del módulo Configurador de Protheus (SIGACFG):

Nota:

• Parámetros necesarios para el envío de documentos vía correo electrónico.

NOTA: Las siguientes actualizaciones fueron incorporadas en los pacotes 006386 - DMINA-7002 - FACT. ELECTRÓNICA VAL. PREVIA COL V 1 y 006600 - DMINA-7459 - FACTURACIÓN ELECTRÓNICA VAL PREV COL.

1. Creación de parámetro en el archivo SX6 - Parámetros:

Nota:

• Actualmente se tiene funcional la opción 2, para la impresión del documento electrónico en formato PDF del proveedor tecnológico The Factory HKA.

2. Creación de consulta estándar en el archivo SXB - Consulta Estándar:

3. Creación de tablas en el archivo SX2 - Tablas:

4. Creación de campos en el archivo SX3 - Campos:

5. Creación de índices en el archivo SIX - Índices:

6. Modificación de campos en el archivo SX3 - Campos:

Para la funcionalidad de Ordenes de Compra (cac:OrderReference) y Referencias adicionales (cac:AdditionalDocumentReference), se debe agregar los siguiente campo (Agregados en el pacote 006943):