ÍNDICE

Índice

1. REQUERIMIENTOS

Características del Requisito

Âncora

	inicio
	inicio

Línea de Producto:

Microsiga Protheus.

Segmento:

Servicios- Mercado Internacional.

Módulo:

SIGAFAT- Facturación.

Rutina:

Rutina	Nombre Técnico
LOCXFUNA.PRX	Funciones Genéricas de Localizaciones
LOCXNF.PRW	Control de Notas Fiscales
LOCXNF2.PRW	Cálculos en Notas Fiscales
MATA486.PRW	Factura Electrónica
M486PDFCOL.PRW	Impresión de Representación Impresa Facturación Electrónica Colombia
M486XFUN.PRW	Funciones de Factura Electrónica
FISA812.PRW	Definición de Catálogos
FISA813.PRW	Mantenimiento de Catálogos
FISA814.PRW	Carga de Catálogos
UPDFATMI.PRW	Actualización al Diccionario de Datos
FATSCOL.INI	Script de generación de archivos XML; NF y NDC nacional
FATECOL.INI	Script de generación de archivos XML; NCC nacional y exportación
FATSECOL.INI	Script de generación de archivos XML; NF y NDC de exportación
MATA468N.PRX	Generación Notas Fiscales
WSNFECOL.PRW	Cliente de servicio web - Ambiente de homologación
WSNFECOLPROD.PRW	Cliente de servicio web - Ambiente productivo
MATXFUNC.PRX	Funciones generales internas

Rutina(s) Involucrada(s)	Nombre Técnico
UPDMODMI.PRW	Actualización al Diccionario de Datos
MATXFUNB.PRX	Funciones genéricas

Issue:

DMINA-2487, DMINA-2753, DMINA-2978, DMINA-3107, DMINA-3222, DMINA-3693, DMINA-4582, DMINA-5100 (v 12.1.17), DMINA-5175 (v 12.1.17), DMINA-6420, DMINA-5484, DMINA-8877, DMINA-8799

País(es):

Colombia.

Base(s) de Datos:

Todas.

Sistema(s) operativo(s):

Todos.

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.
SE4 - Condiciones de pago.

Descripción

La Factura Electrónica es el documento que soporta transacciones de venta de bienes y/o servicios, y que operativamente tiene lugar a través de sistemas computacionales y/o soluciones informáticas que permiten el cumplimiento de las características y condiciones que se establecen en el Decreto 2242 de 2015, compilado en el Decreto Único Reglamentario 1625 de 2016, relativas a la expedición, recibo, rechazo y conservación. La expedición de la factura electrónica comprende la generación por el facturador electrónico y su entrega al adquirente. El facturador electrónico tiene obligaciones registradas en el Registro Único Tributario, y en el decreto se denomina como Obligado a Facturar Electrónicamente.

Para lograr la generación de la factura electrónica debe el sistema de software permitir que tan pronto haya cerrado el registro de la información de la operación de venta, y de que haya almacenado la información de esta operación en forma adecuada, construya el formato XML de acuerdo con las especificaciones técnicas, calcule el CUFE, y aplique el método de firma electrónica avanzada apropiado para su modelo de negocio, y lo almacene en un formato convertible en un archivo de datos de tipo UTF-8.

Características de la Factura Electrónica

Utiliza el formato electrónico de generación XML estándar establecido por la DIAN.
Lleva la numeración consecutiva autorizada por la DIAN.
Cumple los requisitos del 617 ET y discrimina el impuesto al consumo cuando es el caso.
Incluye la firma digital o electrónica para garantizar autenticidad e integridad y no repudio de la factura electrónica, de acuerdo con la política de firma adoptada por la DIAN.
Incluye el Código Único de Factura Electrónica CUFE.

Para dar cumplimiento a la legislación mencionada y de acuerdo a las especificaciones del Anexo Técnico 001 Formatos de los Documentos XML de Facturación Electrónica – Versión 2, en el presente documento se detalla la configuración que se debe realizar para la generación de la factura electrónica.

(Solo para Microsiga Protheus, versiones anteriores a la 12)

Antes de ejecutar el compatibilizador UPDMODMI, es imprescindible:

Realizar la copia de seguridad de la base de datos del producto que ejecutará el compatibilizador (directorio PROTHEUS_DATA\DATA) y de los diccionarios de datos SX (directorio PROTHEUS_DATA\SYSTEM).
Los directorios mencionados anteriormente corresponden a la instalación estándar del Protheus, por lo tanto, deben modificarse de acuerdo con el producto instalado en la empresa.
Esta rutina debe ejecutarse de modo exclusivo, es decir, ningún usuario debe estar utilizando el sistema.
Si los diccionarios de datos tienen índices personalizables (creados por el usuario), antes de ejecutar el compatibilizador, asegúrese de que están identificados por el nickname. Si el compatibilizador necesita crear índices, los agregará a partir del orden original instalado por el Protheus, lo que podrá ocasionar la superposición de índices personalizados, si no están identificados por el nickname.
El compatibilizador debe ejecutarse con la Integridad referencial desactivada*.

Atención

¡El siguiente procedimiento debe realizarlo un profesional calificado como Administrador de base de datos (DBA) o su equivalente!

La activación indebida de la integridad referencial puede modificar drásticamente la relación entre tablas en la base de datos. Por lo tanto, antes de utilizarla, observe atentamente el siguiente procedimiento:

1. En el Configurador (SIGACFG), verifique si la empresa utiliza Integridad referencial, seleccionando la opción Integridad/Verificación (APCFG60A).

2. Si no hay Integridad referencial activa, se listan en una nueva ventana todas las empresas y sucursales registradas en el sistema y ninguna de estas estará seleccionada. SOLAMENTE en este caso no es necesario ningún otro procedimiento de activación o desactivación de integridad, basta finalizar la verificación y aplicar normalmente el compatibilizador, de acuerdo con las instrucciones.

3. Si la Integridad referencial está activa en todas las empresas y sucursales, se muestra un mensaje en la ventana Verificación de vínculo entre tablas. Confirme el mensaje para que se concluya la verificación, o;

4. Si existe Integridad referencial activa en una o más empresas, que no representan la totalidad, se listan en una nueva ventana todas las empresas y sucursales registradas en el sistema y solamente se seleccionarán las que tienen integridad. Anote las empresas y/o sucursales que tienen la integridad activada y reserve esta anotación para posterior consulta en la reactivación (o incluso, entre en contacto con nuestro Help Desk Framework para informarse sobre los archivos que contienen esta información).

5. En los casos descritos en los ítems “iii” o “iv”, Y SOLO EN ESTOS CASOS, es necesario desactivar dicha integridad, seleccionando la opción Integridad/ Desactivar (APCFG60D).

6. Al desactivar la Integridad referencial, ejecute el compatibilizador, de acuerdo con las instrucciones.

7. Después de aplicar el compatibilizador, la Integridad referencial debe reactivarse, SOLAMENTE CUANDO se haya desactivado, por medio de la opción Integridad/Activar (APCFG60). Para ello, tenga a disposición la información de la(s) empresa(s) y/o sucursal(es) que tenía(n) activación de la integridad, selecciónela(s) nuevamente y confirme la activación.

¡EN CASO DE DUDAS, entre en contacto con el Help Desk Framework!

En Microsiga Protheus TOTVS Smart Client, digite UPDMODMI en el campo Programa Inicial. Importante: Para que se actualice correctamente el diccionario de datos, asegúrese de que la fecha del compatibilizador sea igual o superior al 18/04/2018.
Haga clic en OK para continuar.
Después de confirmar, aparece una pantalla para seleccionar la empresa en la cual se modificará el diccionario de datos o aparece la ventana para seleccionar el compatibilizador. Deberá seleccionar el módulo “SIGAFAT – Facturación” y posteriormente el actualizador “03 - Factura Electrónica v2”.
Al confirmar, se muestra un mensaje de advertencia sobre la copia de seguridad y la necesidad de su ejecución de modo exclusivo.

1. Haga clic en Procesar para iniciar el procesamiento. El primer paso de la ejecución es la preparación de los archivos.

1. Se muestra un mensaje explicativo en la pantalla.
2. A continuación, se muestra la ventana Actualización concluida con el historial (log) de todas las actualizaciones procesadas. En este log de actualización se muestran únicamente los campos actualizados por el programa. El compatibilizador crea los campos que aún no existen en el diccionario de datos.
3. Haga clic en Grabar para guardar el historial (log) mostrado.
4. Haga clic en OK para finalizar el procesamiento.

1.1 Procedimientos de Implantación

El sistema se actualiza inmediatamente después de aplicar el paquete de actualizaciones (Patch) de este issue.

Aplique el patch del issue y ejecute una vez la rutina UPDMODMI (este proceso sólo aplica para versión 11.8). Es importante respaldar el repositorio de objetos (RPO) antes de aplicar la actualización.
En el módulo Configurador (SIGACFG), acceda a Actualizaciones | Diccionario de datos | Parámetros y configure el siguiente parámetro con la ruta donde se encuentran archivos .csv para carga de catálogos:

Nombre de la Variable:	MV_PATH814
Tipo:	C
Descripción:	Ruta local donde se encuentran los archivos en formato .csv.
Valor Estándar:

El paquete de solución del issue contiene:

Patch de actualización al RPO con rutinas actualizadas.

Scripts ejemplo de generación de archivos XML (Factura Electrónica):
FATSCOL.INI - Facturas y notas de débito nacionales.
FATSECOL.INI - Facturas y notas de débito de exportación.
FATECOL.INI - Notas de crédito nacionales y de exportación.
Debe crear una estructura de carpetas dentro de la ruta del ambiente (protheus_data\system) en donde deben ser copiados estos archivos. En el mismo árbol de carpetas se alojarán las facturas electrónicas generadas por el sistema así como los documentos autorizados. Los nombres de cada carpeta deben ser configurados en los parámetros MV_CFDDOCS, MV_CFDANUL, MV_CFDFTS, MV_CFDFTSE y MV_CFDFTE, consulte la sección 7. Creación o modificación de Parámetros. Se sugiere la siguiente estructura y nombres de carpetas:

Carpeta	Uso/descripción	Parámetro relacionado
cfd	Carpeta principal de comprobantes fiscales digitales.
cfd\facturas	Almacén de documentos electrónicos generados por el sistema.	MV_CFDDOCS
cfd\facturas\autorizados	Almacén de documentos autorizados por la DIAN.
cfd\anuladas	Almacén de documentos anulados.	MV_CFDANUL
cfd\inicfd	Scripts de generación de archivos xml.	MV_CFDFTS, MV_CFDFTSE y MV_CFDFTE

Archivos tipo .CSV que corresponden a los catálogos definidos por la DIAN para la Factura Electrónica. Debe copiar estos archivos a la ruta establecida en el parámetro MV_PATH814, descrito más adelante en este documento. Descargar archivo catalogosDIAN.zip

En el caso de que haya actualizaciones a esos catálogos, publicados en el Anexo Técnico 001 Formatos de los Documentos XML de Facturación Electrónica – Versión 2, disponible en el portal de la DIAN, realice los siguientes pasos para actualizar las tablas del sistema:

Exporte o transcriba las tablas, una por una, hacia una planilla de cálculo en msExcel. en donde la Columna A=Código, Columna B=Descripción, sin encabezados y asegurando que los códigos que comienzan con uno o más 0 (cero) conserven esa característica (columna o celda tipo texto).

Grabe la planilla en un archivo tipo .CSV (delimitado por comas) con campos separados por el carácter pipe (|), es posible que deba cambiar la configuración regional del sistema operativo. El nombre de los archivos debe corresponder con la lista siguiente de acuerdo a la enumeración de los catálogos en el anexo mencionado previamente:

Nombre de archivo	Descripción del catálogo
01TiposFactura.csv	Tipos de factura.
02TiposDocIdentidad.csv	Tipos de documentos de identidad.
03ConceptoNotasCredito.csv	Concepto de notas de crédito.
04ConceptoNotasDebito.csv	Concepto de notas de débito.
05ImpuestosFE.csv	Impuestos registrados en la factura electrónica.
06MediosPago.csv	Medios de pago.
07Monedas.csv	Monedas.
08Paises.csv	Países.
09TiposOrganizacionJuridica.csv	Tipos de organización jurídica; Tipos de adquiriente.
10TiposRegimenIVA.csv	Tipos de régimen IVA.
11Incoterms.csv	Inconterms.
12TiposPago.csv	Tipos de pago.
13TiposRepresentacion.csv	Tipos de representación.
14TiposObligacionesResp.csv	Tipos de obligaciones-responsabilidades.
15TiposUsuariosAduaneros.csv	Tipos de usuarios aduaneros.
16TiposEstablecimientos.csv	Tipos de establecimientos.

Coloque los archivos en la ruta informada en el parámetro del sistema MV_PATH814, descrito más adelante en este documento.

1.2 Actualizaciones del compatibilizador

(Solamente para Microsiga Protheus, versiones anteriores a la versión 12).

1. Creación de Preguntas en el archivo SX1 – Archivo de Preguntas:

Grupo: MATA486

Orden	01	02
Pregunta	¿Tipo de Documento?	¿Serie?
Tipo	N	C
Tamaño	1	3
Validación
Objeto	C	G
Consulta Estándar		SERNF
Preselección	1
Opciones	Factura Nota de Debito Nota de Credito

Grupo: MATA486A

Orden	01	02	03
Pregunta	¿Serie de la Factura?	¿Factura Inicial?	¿Factura Final?
Tipo	C	C	C
Tamaño	3	13	13
Validación			!Empty(MV_PAR03) .And. MV_PAR02<=MV_PAR03
Objeto	G	G	G
Consulta Estándar	SERNF
Preselección
Opciones

Grupo: MATA486B

Orden	01	02	03
Pregunta	¿Serie de la Nota de Debito?	¿Nota de Debito Inicial?	¿Nota de Debito Final?
Tipo	C	C	C
Tamaño	3	13	13
Validación			!Empty(MV_PAR03) .And. MV_PAR02<=MV_PAR03
Objeto	G	G	G
Consulta Estándar	SERNF
Preselección
Opciones

Grupo: MATA486C

Orden	01	02	03
Pregunta	¿Serie de la Nota de Credito?	¿Nota de Debito Credito?	¿Nota de Debito Credito?
Tipo	C	C	C
Tamaño	3	13	13
Validación			!Empty(MV_PAR03) .And. MV_PAR02<=MV_PAR03
Objeto	G	G	G
Consulta Estándar	SERNF
Preselección
Opciones

Grupo: M486PDF

Orden	01	02	03	04
Pregunta	¿Serie del Documento?	¿Documento inicial?	¿Documento final?	¿Formato?
Tipo	C	C	C	N
Tamaño	3	13	13	1
Objeto	G	G	G	C
Preselección	0	0	0	1
Opciones				PDF/E-mail

2. Creación de tablas en el archivo SX2– Tablas:

Clave	Nombre	Modo	PYME
F3H	Configuración de Catálogos	C	S
F3I	Información de Catálogos	C	S

3. Creación o modificación de Tablas Genéricas en el archivo SX5 – Tablas Genéricas:

N/A

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

Tabla F3H - Configuración de Catálogos.

Campo	F3H_FILIAL
Tipo	C
Tamaño	2
Decimal	0
Formato
Título	Sucursal
Descripción	Sucursal
Nivel	1
Utilizado	No
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Digite el código de la sucursal.

Campo	F3H_CODIGO
Tipo	C
Tamaño	4
Decimal	0
Formato	@!
Título	Código
Descripción	Código del parámetro
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Opciones
When
Relación
Val. Sistema	NaoVazio() .and. ExistChav("F3H", M->F3H_CODIGO,1) .and. FreeForUse("F3H",M->F3H_CODIGO)
Help	Código del parámetro.

Campo	F3H_DESC
Tipo	C
Tamaño	30
Decimal	0
Formato	@!
Título	Descripción
Descripción	Descripción del parámetro
Nivel
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Opciones
When
Relación
Val. Sistema	NAOVAZIO()
Help	Descripción del parámetro.

Campo	F3H_ORDEM
Tipo	C
Tamaño	2
Decimal	0
Formato	99
Título	Orden
Descripción	Orden del Parámetro
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Orden del parámetro.

Campo	F3H_CAMPOS
Tipo	C
Tamaño	10
Decimal	0
Formato	AXXXXXXXXX
Título	Campos
Descripción	Nombre del Campo
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones
When
Relación
Val. Sistema	NaoVazio() .and. f812VerChav("F3H",M->F3H_CAMPOS)
Help	Incluir el nombre del campo.

Campo	F3H_DESCPO
Tipo	C
Tamaño	25
Decimal
Formato	@!
Título	Desc.Campo
Descripción	Descripción del Campo
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Incluir la descripción del campo.

Campo	F3H_TIPO
Tipo	C
Tamaño	1
Decimal
Formato	@!
Título	Tipo
Descripción	Tipo
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones	N=Numérico;C=Carácter;D=Fecha
When	F812Valid()
Relación
Val. Sistema	NaoVazio() .and. Pertence("NCD") .and. f812ChkTipo(M->F3H_TIPO)
Help	Incluya el tipo de campo. C = Carácter, D = Fecha, N = Numérico.

Campo	F3H_TAMAN
Tipo	N
Tamaño	3
Decimal
Formato	999
Título	Tamaño
Descripción	Tamaño del Campo
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones
When	F812Valid()
Relación
Val. Sistema	NaoVazio() .and. F812ChkTaman(M->F3H_TAMAN)
Help	Incluir el tamaño del campo. Obs: si el campo fuera tipo D=Fecha, el tamaño debe ser igual a 8.

Campo	F3H_DECIMA
Tipo	N
Tamaño	2
Decimal
Formato	99
Título	Decimal
Descripción	Decimal
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When	F812Valid()
Relación
Val. Sistema	f812ChkDec(M->F3H_DECIMA)
Help	Incluir el número de decimales que tendrá el campo. Campos tipo: Fecha y Carácter No tiene decimales

Campo	F3H_PICTUR
Tipo	C
Tamaño	45
Decimal	0
Formato	@!
Título	Formato
Descripción	Formato
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Digite la máscara para la exhibición del campo. Ej.: "@E 999,99

Campo	F3H_VALID
Tipo	C
Tamaño	120
Decimal	0
Formato	@!
Título	Validación
Descripción	Validación del Usuario
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Agregar una validación del campo si es necesario. Ej,: Entre("01","10",M-> F3H_TAMAN,.T.) En el caso que la función utilizada sea "PERTENECE", deberá informarse el campo como segundo parámetro. Ej.: Pertence("12",cCampo)

Campo	F3H_PADRAO
Tipo	C
Tamaño	6
Decimal
Formato	@!
Título	Cons.Estand.
Descripción	Consulta Estandar
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema	f812ConsPad()
Help	Digite una consulta estándar para la tabla.

Campo	F3H_VERSAO
Tipo	C
Tamaño	3
Decimal
Formato	@!
Título	Versión
Descripción	Versión
Nivel	1
Utilizado	No
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Versión del catálogo.

Campo	F3H_PESQ
Tipo	C
Tamaño	1
Decimal
Formato	@!
Título	¿Usado Busq?
Descripción	¿Usado en la Busqueda?
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones	1=Si;2=No
When
Relación
Val. Sistema
Help	¿Usado en la Búsqueda de la Consulta Estándar (SXB)? Informar Si para utilizar este campo como clave simples de búsqueda.

Tabla F3I - Información de Catálogos.

Campo	F3I_FILIAL
Tipo	C
Tamaño	2
Decimal	0
Formato
Título	Sucursal
Descripción	Sucursal
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Informe el código de la sucursal.

Campo	F3I_CODIGO
Tipo	C
Tamaño	4
Decimal	0
Formato	@!
Título	Código
Descripción	Código del parámetro
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema	EXISTCPO("F31")
Help	Informe el contenido de identificación del ítem de la lista. Por ejemplo, si la lista de modificación es la lista de países, este campo corresponde al código de identificación del país.

Campo	F3I_SEQUEN
Tipo	C
Tamaño	5
Decimal
Formato	99999
Título	Secuencia
Descripción	Secuencia
Nivel
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Secuencia.

Campo	F3I_CONTEU
Tipo	C
Tamaño	250
Decimal
Formato	@!
Título	Contenido
Descripción	Contenido de tabla
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Relación
Val. Sistema
Help	Informe el contenido.

Tabla CTO - Monedas.

Campo	CTO_MOESAT
Tipo	C
Tamaño	3
Decimal
Formato	@!
Título	Moneda DIAN
Descripción	Moneda DIAN
Nivel	1
Utilizado	Sí
Obrigatório	Si
Browse	Sí
Opciones
When
Consulta	COL007
Val. Sistema	Vazio() .or. ValidF3I("S007", M->CTO_MOESAT,1,3)
Help	Clave de moneda de acuerdo al catálogo de la DIAN.

Tabla SFB - Impuestos Variables.

Campo	FB_IMPSAT
Tipo	C
Tamaño	3
Decimal
Formato	@!
Título	Impuesto FE
Descripción	Impuesto factura electr.
Nivel	1
Utilizado	Sí
Obrigatório	Si
Browse	Sí
Opciones
When
Consulta	COL005
Val. Sistema	Vazio() .or. ValidF3I("S005", M->FB_IMPSAT,1,3)
Help	Clave de impuesto registrado en la factura electrónica.

Campo	FB_RIMPSAT
Tipo	C
Tamaño	1
Decimal
Formato	@!
Título	Régimen IVA
Descripción	Tipo de régimen IVA.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta	COL010
Val. Sistema	Vazio() .or. ValidF3I("S010", M->FB_RIMPSAT,1,1)
Help	Tipo de régimen IVA.

Campo	FB_CLASSE
Tipo	C
Tamaño	1
Decimal	0
Formato	@!
Título	Clase Imp
Descripción	Clase Impuesto
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones	I=Impuesto;P=Percepcion;R=Retencion
Val. Sistema	PERTENCE("IPR")
Help	Tipo de clase de impuesto: Impuesto/Percepción/Retención.

Tabla SFP - Control de Formularios.

Campo	FP_CAI
Tipo	C
Tamaño	16
Decimal	0
Título	Nº Aprob.
Descripción	Nº aprob. de paginas
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Help	Número autorización: Número o código de la resolución otorgada para la numeración.

Campo	FP_SERIE2
Tipo	C
Tamaño	4
Decimal	0
Formato	@!
Título	Serie 2
Descripción	Serie 2
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Val. Sistema	NaoVazio()
Help	Serie a 4 dígitos que será informada a la DIAN.

Campo	FP_DTRESOL
Tipo	D
Tamaño	8
Decimal	0
Título	Fch Resoluc.
Descripción	Fecha de Resolución
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Help	Fecha Autorización: Fecha Autorización de la numeración.

Campo	FP_NRCERT
Tipo	C
Tamaño	38
Decimal	0
Título	Clave Tecnic
Descripción	Clave Técnica
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Help	Clave técnica del rango de facturación.

Tabla SA1 - Clientes.

Campo	A1_TIPDOC
Tipo	C
Tamaño	7
Decimal
Formato	@!
Título	Tipo Doc.
Descripción	Tipo Documento Identidad
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL002
Val. Sistema	Vazio() .or. ValidF3I("S002", M->A1_TIPDOC,1,7)
Help	Tipo de documento de identidad.

Tabla SC5 - Pedidos de venta.

Campo	C5_INCOTER
Tipo	C
Tamaño	3
Decimal
Formato	@!
Título	Incoterm
Descripción	Clave del INCOTERM de la factura.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL011
Val. Sistema	Vazio() .or. ValidF3I("S011", M->C5_INCOTER,1,3)
Help	Clave del INCOTERM aplicable a la factura.

Campo	C5_TIPOPE
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	Tipo Oblig.
Descripción	Tipo de oblig.-resp.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta	COL014
Val. Sistema	Vazio() .or. ValidF3I("S014", M->C5_TIPOPE,1,4)
Help	Tipo de obligaciones-responsabilidades.

Campo	C5_CVEPED
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	Usua. Aduan.
Descripción	Tipo de usuario aduanero
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta	COL015
Val. Sistema	Vazio() .or. ValidF3I("S015", M->C5_CVEPED,1,4)
Help	Tipo de usuario aduanero.

Campo	C5_TRASLA
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	T.Establecim
Descripción	Tipo establecimiento
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL016
Val. Sistema	Vazio() .or. ValidF3I("S016", M->C5_TRASLA,1,4)
Help	Tipo de establecimiento.

Tabla SF2 - Facturas de venta / Notas de débito cliente.

Campo	F2_DOC
Tipo	C
Tamaño	13
Decimal	0
Formato	@!
Título	Num. Doc.
Descripción	Número de Documento
Nivel	1
Utilizado	Si
Obrigatório	Si
Browse	Sí
Val. Sistema	ExistChav("SF2",M->F2_DOC+M->F2_SERIE) .and. CtrFolios(xFilial("SF2"),M->F2_SERIE,M->F2_ESPECIE,M->F2_DOC) .AND. LXEXSER2()
Help	Número de la Factura.

Campo	F2_SERIE
Tipo	C
Tamaño	3
Decimal	0
Formato	@!
Título	Serie Doc.
Descripción	Serie del Documento
Nivel	1
Utilizado	Si
Obrigatório	No
Browse	Sí
Val. Sistema	MAFISREF("NF_SERIENF","MT100",M->F2_SERIE) .and. LxExSer2()
Help	Serie de la Factura.

Campo	F2_SERIE2
Tipo	C
Tamaño	4
Decimal	0
Formato	@!
Título	Serie-2 Doc.
Descripción	Serie 2 del Documento
Nivel	1
Utilizado	Si
Obrigatório	No
Browse	No
Val. Sistema
When	!(funname() $ 'MATA467N/MATA462N/MATA465N')
Help	Serie 2 de la Factura.

Campo	F2_INCOTER
Tipo	C
Tamaño	3
Decimal
Formato	@!
Título	Incoterm
Descripción	Clave del INCOTERM de la factura.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta	COL011
Val. Sistema	Vazio() .or. ValidF3I("S011", M->F2_INCOTER,1,3)
Help	Clave del INCOTERM aplicable a la factura.

Campo	F2_TIPOPE
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	Tipo Oblig.
Descripción	Tipo de oblig.-resp.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta	COL014
Val. Sistema	Vazio() .or. ValidF3I("S014", M->F2_TIPOPE,1,4)
Help	Tipo de obligaciones-responsabilidades.

Campo	F2_UUID
Tipo	C
Tamaño	40
Decimal	0
Formato	@!
Título	Folio Fiscal
Descripción	Folio Fiscal
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Help	Folio fiscal de timbrado CUFE.

Campo	F2_TIPREF
Tipo	C
Tamaño	1
Decimal	0
Formato	@!
Título	Tipo Nota D
Descripción	Tipo de nota de débito
Nivel	1
Utilizado	Sí
Obrigatório	SÍ
Browse	No
Consulta	COL004
Val. Sistema	Vazio() .or. ValidF3I("S004", M->F2_TIPREF,1,1)
Help	Catálogo 8.4. Concepto de Notas débito conforme definición de la DIAN.

Campo	F2_MOTIVO
Tipo	M
Tamaño	100
Decimal	0
Formato	@!
Título	Motivo
Descripción	Motivo
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Help	Motivo por el cuál se emite el documento.

Campo	F2_CVEPED
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	Usua. Aduan.
Descripción	Tipo de usuario aduanero
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta	COL015
Val. Sistema	Vazio() .or. ValidF3I("S015", M->F2_CVEPED,1,4)
Help	Tipo de usuario aduanero.

Campo	F2_TRASLA
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	T.Establecim
Descripción	Tipo establecimiento
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL016
Val. Sistema	Vazio() .or. ValidF3I("S016", M->F2_TRASLA,1,4)
Help	Tipo de establecimiento.

Campo	F2_FLFTEX
Tipo	C
Tamaño	1
Decimal
Formato	@!
Título	Status Trans
Descripción	Estatus transmision elec
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones	0=No Enviado;1=Enviado a Proveedor ;4=Esperando procesamiento;5=Rechazado;6=Autorizado
When
Consulta
Val. Sistema
Help	Indica el estatus del documento una vez que ha sido enviado al Proveedor.

Campo	F2_HORA
Tipo	C
Tamaño	8
Decimal	0
Formato	@!
Título	Hora
Descripción	Hora
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No

Campo	F2_URI
Tipo	C
Tamaño	45
Decimal
Formato	@!
Título	Cons URI
Descripción	URI para consulta
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta
Val. Sistema
Help	Uri para consulta.

Tabla SF1 - Notas de crédito cliente.

Campo	F1_DOC
Tipo	C
Tamaño	13
Decimal	0
Formato	@!
Título	Num. Doc.
Descripción	Número de Documento
Nivel	1
Utilizado	Si
Obrigatório	Si
Browse	Sí
Val. Sistema	fValSerDoc()
Help	Número de la Factura del proveedor.

Campo	F1_SERIE
Tipo	C
Tamaño	3
Decimal	0
Formato	@!
Título	Serie Doc.
Descripción	Serie del Documento
Nivel	1
Utilizado	Si
Obrigatório	No
Browse	Sí
Val. Sistema	MAFISREF("NF_SERIENF","MT100",M->F1_SERIE) .And. fValSerDoc()
Help	Serie de la Factura.

Campo	F1_SERIE2
Tipo	C
Tamaño	4
Decimal	0
Formato	@!
Título	Serie-2 Doc.
Descripción	Serie 2 del Documento
Nivel	1
Utilizado	Si
Obrigatório	No
Browse	No
When	!(funname() $ 'MATA467N/MATA462N/MATA465N')
Help	Serie 2 de la Factura de acuerdo a la DIAN.

Campo	F1_INCOTER
Tipo	C
Tamaño	3
Decimal
Formato	@!
Título	Incoterm
Descripción	Clave del INCOTERM de la factura.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL011
Val. Sistema	Vazio() .or. ValidF3I("S011", M->F1_INCOTER,1,3)
Help	Clave del INCOTERM aplicable a la factura.

Campo	F1_TIPOPE
Tipo	C
Tamaño	4
Decimal	0
Formato	@!
Título	Tipo Oblig.
Descripción	Tipo de oblig.-resp.
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL014
Val. Sistema	Vazio() .or. ValidF3I("S014", M->F1_TIPOPE,1,4)
Help	Tipo de obligaciones-responsabilidades.

Campo	F1_TIPREF
Tipo	C
Tamaño	1
Decimal
Formato	@!
Título	Tipo Nota Cr
Descripción	Tipo de nota de Credito
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Consulta	COL003
Val. Sistema	Vazio() .or. ValidF3I("S003", M->F1_TIPREF,1,1)
Help	Catálogo 8.4. Concepto de Notas Crédito conforme definición de la DIAN.

Campo	F1_MOTIVO
Tipo	M
Tamaño	100
Decimal	0
Formato	@!
Título	Motivo NCC
Descripción	Motivo de nota de crédito
Nivel	1
Utilizado	Sí
Obrigatório	Sí
Browse	No
Opciones
When
Consulta
Val. Sistema
Help	Motivo por el cuál se emite el documento

Campo	F1_CVEPED
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	Usua. Aduan.
Descripción	Tipo de usuario aduanero
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL015
Val. Sistema	Vazio() .or. ValidF3I("S015", M->F1_CVEPED,1,4)
Help	Tipo de usuario aduanero.

Campo	F1_TRASLA
Tipo	C
Tamaño	4
Decimal
Formato	@!
Título	T.Establecim
Descripción	Tipo establecimiento
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	Sí
Opciones
When
Consulta	COL016
Val. Sistema	Vazio() .or. ValidF3I("S016", M->F1_TRASLA,1,4)
Help	Tipo de establecimiento.

Campo	F1_FLFTEX
Tipo	C
Tamaño	1
Decimal
Formato	@!
Título	Status Trans
Descripción	Estatus transmision elec
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones	0=No Enviado;1=Enviado a Proveedor;4=Esperando procesamiento;5=Rechazado;6=Autorizado
When
Consulta
Val. Sistema
Help	Indica el estatus del documento una vez que ha sido enviado al Proveedor.

Campo	F1_URI
Tipo	C
Tamaño	45
Decimal
Formato	@!
Título	Cons URI
Descripción	URI para consulta
Nivel	1
Utilizado	Sí
Obrigatório	No
Browse	No
Opciones
When
Consulta
Val. Sistema
Help	Uri para consulta.

Tabla SYA - Países.

Campo	YA_CCEDIAN
Tipo	C
Tamaño	2
Decimal	0
Formato	@!
Título	Pais DIAN
Descripción	Clave del Pais de la DIAN
Nivel	0
Utilizado	Sí
Obrigatório	Sí
Browse	Sí
Consulta	COL008
Val. Sistema	Vazio() .or. ValidF3I("S008", M->YA_CCEDIAN,1,2)
Help	Código de país de acuerdo a catálogo de la DIAN.

Importante:

El tamaño de los campos que disponen de grupo puede variar de acuerdo con el entorno en uso.

5. Creación o modificación de Consulta Estándar en el archivo SXB – Consulta Estándar:

Búsqueda COL001:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL001	1	01	RE	Tipos de Factura	F3I
COL001	2	01	01	Tipos de Factura	F812SXB("S001","Codigo")
COL001	5	01			VAR_IXB

Búsqueda COL002:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL002	1	01	RE	Tipos de Docs de Identidad	F3I
COL002	2	01	01	Tipos de Docs de Identidad	F812SXB("S002","Codigo")
COL002	5	01			VAR_IXB

Búsqueda COL003:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL003	1	01	RE	Conceptos de Notas de Crédito	F3I
COL003	2	01	01	Conceptos de Notas de Crédito	F812SXB("S003","Codigo")
COL003	5	01			VAR_IXB

Búsqueda COL004:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL004	1	01	RE	Conceptos de Notas de Débito	F3I
COL004	2	01	01	Conceptos de Notas de Débito	F812SXB("S004","Codigo")
COL004	5	01			VAR_IXB

Búsqueda COL005:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL005	1	01	RE	Impuestos Factura Electrónica	F3I
COL005	2	01	01	Impuestos Factura Electrónica	F812SXB("S005","Codigo")
COL005	5	01			VAR_IXB

Búsqueda COL006:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL006	1	01	RE	Medios de Pago	F3I
COL006	2	01	01	Medios de Pago	F812SXB("S006","Codigo")
COL006	5	01			VAR_IXB

Búsqueda COL007:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL007	1	01	RE	Monedas	F3I
COL007	2	01	01	Monedas	F812SXB("S007","Codigo")
COL007	5	01			VAR_IXB

Búsqueda COL008:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL008	1	01	RE	Países	F3I
COL008	2	01	01	Países	F812SXB("S008","Codigo")
COL008	5	01			VAR_IXB

Búsqueda COL009:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL009	1	01	RE	Tipos de Org Jurídica; Adquir.	F3I
COL009	2	01	01	Tipos de Org Jurídica; Adquir.	F812SXB("S009","Codigo")
COL009	5	01			VAR_IXB

Búsqueda COL010:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL010	1	01	RE	Tipos de Régimen IVA	F3I
COL010	2	01	01	Tipos de Régimen IVA	F812SXB("S010","Codigo")
COL010	5	01			VAR_IXB

Búsqueda COL011:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL011	1	01	RE	Incoterms	F3I
COL011	2	01	01	Incoterms	F812SXB("S011","Codigo")
COL011	5	01			VAR_IXB

Búsqueda COL012:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL012	1	01	RE	Tipos de Pago	F3I
COL012	2	01	01	Tipos de Pago	F812SXB("S012","Codigo")
COL012	5	01			VAR_IXB

Búsqueda COL013:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL013	1	01	RE	Tipos de Representación	F3I
COL013	2	01	01	Tipos de Representación	F812SXB("S013","Codigo")
COL013	5	01			VAR_IXB

Búsqueda COL014:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL014	1	01	RE	Tipos de Obligaciones-Respon.	F3I
COL014	2	01	01	Tipos de Obligaciones-Respon.	F812SXB("S014","Codigo")
COL014	5	01			VAR_IXB

Búsqueda COL015:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL015	1	01	RE	Tipos de Usuarios Aduaneros	F3I
COL015	2	01	01	Tipos de Usuarios Aduaneros	F812SXB("S015","Codigo")
COL015	5	01			VAR_IXB

Búsqueda COL016:

Alias	Tipo	Secuencia	Columna	Descripción	Contém
COL016	1	01	RE	Tipos de Establecimientos	F3I
COL016	2	01	01	Tipos de Establecimientos	F812SXB("S016","Codigo")
COL016	5	01			VAR_IXB

6. Creación de Índices en el archivo SIX – Índices:

Índice	F3H
Orden	1
Clave	F3H_FILIAL+F3H_CODIGO
Descripción	Código
Propietario	S

Índice	F3H
Orden	2
Clave	F3H_FILIAL+F3H_DESC
Descripción	Descripción
Propietario	S

Índice	F3H
Orden	3
Clave	F3H_FILIAL+F3H_CAMPOS+F3H_CODIGO
Descripción	Campos + Código
Propietario	S

Índice	F3I
Orden	1
Clave	F3I_FILIAL+F3I_CODIGO+F3I_SEQUEN
Descripción	Código + Secuencia
Propietario	S

7. Creación o modificación de Parámetros en el archivo SX6 – Parámetros:

Nombre de la Variable	MV_F3HNUM
Tipo	C
Descripción	Almacena el último número del código del parámetro.
Valor Estándar	U000

Nombre de la Variable	MV_PATH814
Tipo	C
Descripción	Ruta donde se encuentran los catálogos de la DIAN; archivos en formato csv. Ejemplo: C:\CATALOGOSDIAN
Valor Estándar

Nombre de la Variable	MV_CFDFTE
Tipo	C
Descripción	Indica el directorio y archivo con la estructura para la generación de factura electrónica para doc. de entrada (NCC).
Valor Estándar	GetSrvProfString('startpath','')+'\cfd\inicfd\fatecol.ini

Nombre de la Variable	MV_CFDFTS
Tipo	C
Descripción	Indica el directorio y archivo con la estructura para la generación de factura electrónica para doc. de salida (NF/NDC).
Valor Estándar	GetSrvProfString('startpath','')+'\cfd\inicfd\fatscol.ini

Nombre de la Variable	MV_CFDFTSE
Tipo	C
Descripción	Indica el directorio donde se encuentra el archivo con la estructura para la generación de factura electrónica de Exportación para doc. de salida (NF/NDC).
Valor Estándar

Nombre de la Variable	MV_CFDDOCS
Tipo	C
Descripción	Directorio donde se grabarán las facturas electrónicas.
Valor Estándar	GetSrvProfString('startpath','')+'\cfd\facturas\

Nombre de la Variable	MV_CFDANUL
Tipo	C
Descripción	Directorio donde se grabarán las facturas electrónicas anuladas.
Valor Estándar

Nombre de la Variable	MV_CFDIAMB
Tipo	C
Descripción	Ambiente de trabajo de certificación de factura electrónica:1=Producción, 2=Homologación.
Valor Estándar

Nombre de la Variable	MV_PROVFE
Tipo	C
Descripción	Identifica el Facturador Electrónico o el Proveedor Tecnológico de servicios de certificación de factura electrónica. Indicar: DFACTURA
Valor Estándar

Nombre de la Variable	MV_TPRESOB
Tipo	C
Descripción	Tipo de obligaciones y responsabilidades.
Valor Estándar

De acuerdo a la tabla Tipos de obligaciones-responsabilidades publicada en el Anexo Técnico 001. Formatos de los Documentos XML de Fac-e V2 y descrito ampliamente en el Anexo Técnico 003. Mecanismos Sistema Tecnico de Control V2 disponibles en el sitio de la DIAN.

Nombre de la Variable	MV_NCCONL
Tipo	C
Descripción	Indica el tipo de compensación OnLine para documentos de tipo Notas de Crédito, con opciones: 1 - Usa Factura Electrónica y compensa en línea. 2 - Usa Factura Electrónica y no compensa en línea (existe tiempo de espera en retorno de estatus de timbrado). 3 - No usa Factura Electrónica y compensa en línea.
Valor Estándar

NOTA: Si el parámetro MV_NCCONL no existe o se encuentra vacío la funcionalidad se comporta de la siguiente manera:

Para México: opción 1.
Para Chile, Colombia, Ecuador y Perú: opción 2.
Para todos los países que no pertenecen a los anteriores: opción 3. Si el país utiliza Facturación Electrónica pero el ambiente no está configurado para esta funcionalidad el parámetro deberá contener esta opción para permitir compensación Online.

En los siguientes parámetros (MV_RETF05?) se deben registrar los códigos fiscales aplicables a cada concepto que se indica en la descripción. Si para un concepto aplica más de un código fiscal, se deben separar por el caracter “|” (pipe). Todos los impuestos variables de retención en la fuente deben configurarse con el código “05” correspondiente a la tabla S005 - Impuestos Factura Electrónica (rutina Actualizaciones | Archivos | Mantenimiento Catálogos).

Nombre de la Variable	MV_RETF053
Tipo	C
Descripción	Códigos fiscales de compras.
Valor Estándar

Nombre de la Variable	MV_RETF055
Tipo	C
Descripción	Códigos fiscales de honorarios.
Valor Estándar

Nombre de la Variable	MV_RETF056
Tipo	C
Descripción	Códigos fiscales de servicios generales.
Valor Estándar

Nombre de la Variable	MV_RETF057
Tipo	C
Descripción	Códigos fiscales de transporte de carga.
Valor Estándar

Importante:

Los siguientes parámetros aplican si en la implementación se utilizará el servicio web Dfactura del Proveedor Tecnológico The Factory HKA para la certificación de los comprobantes fiscales:

Nombre de la Variable	MV_ID_PWD
Tipo	C
Descripción	Password de la habilitación como software para la emisión de facturas.
Valor Estándar

Importante:

Nombre de la Variable	MV_TKN_EMP
Tipo	C
Descripción	Token Empresa - The Factory HKA.
Valor Estándar

Nombre de la Variable	MV_TKN_PAS
Tipo	C
Descripción	Token Password - The Factory HKA.
Valor Estándar

CONFIGURACIÓN DE PARÁMETROS

En el Configurador (SIGACFG), acceda a Entornos/Archivos/Parámetros (CFGX017). Configure los parámetros a continuación:

Ítems/Carpetas	Descripción
Nombre:	MV_PATH814
Tipo:	C
Contenido:
Descripción:	Ruta local (computadora cliente) donde se encuentran los catálogos de la DIAN; archivos en formato csv. Por ejemplo: C:\CATALOGOSDIAN

Nombre:	MV_CFDDOCS
Tipo:	C
Contenido:
Descripción:	Directorio donde se grabarán las facturas electrónicas.

Nombre:	MV_CFDANUL
Tipo:	C
Contenido:
Descripción:	Directorio donde se grabarán las facturas electrónicas anuladas.

Nombre:	MV_CFDFTS
Tipo:	C
Contenido:
Descripción:	Indica el directorio donde se encuentra el archivo con la estructura para la generación de factura electrónica para doc. de salida (NF/NDC).

Nombre:	MV_CFDFTSE
Tipo:	C
Contenido:
Descripción:	Indica el directorio donde se encuentra el archivo con la estructura para la generación de factura electrónica exportación para doc. de salida (NF/NDC).

Nombre:	MV_CFDFTE
Tipo:	C
Contenido:
Descripción:	Indica el directorio donde se encuentra el archivo con la estructura para la generación de factura electrónica para doc. de entrada (NCC).

Nombre:	MV_CFDIAMB
Tipo:	C
Contenido:
Descripción:	Indica el ambiente de trabajo de certificación de factura electrónica:1=Producción, 2=Homologación.

Nombre:	MV_PROVFE
Tipo:	C
Contenido:
Descripción:	Identifica el Facturador Electrónico o el Proveedor Tecnológico de servicios de certificación de factura electrónica. Por ejemplo: DFACTURA

Configure los siguientes parámetros si se utilizará el servicio web Dfactura del Proveedor Tecnológico The Factory HKA para la certificación de los comprobantes fiscales:

Nombre:	MV_TKN_EMP
Tipo:	C
Contenido:
Descripción:	Token Empresa - The Factory HKA.

Nombre:	MV_TKN_PAS
Tipo:	C
Contenido:
Descripción:	Token Password - The Factory HKA.

Para la funcionalidad de envío de la factura electrónica (archivos xml y pdf) por e-mail a clientes, es necesario configurar los siguientes parámetros:

Nombre:	MV_RELSERV
Tipo:	C
Contenido:
Descripción:	Servidor de envío de e-mail.

Nombre:	MV_RELACNT
Tipo:	C
Contenido:
Descripción:	Cuenta a ser utilizada en el envío de e-mail.

Nombre:	MV_RELPSW
Tipo:	C
Contenido:
Descripción:	Contraseña de la cuenta de e-mail.

En caso de que el servidor de correo requiera autenticación, se deben configurar los siguientes parámetros:

Nombre:	MV_RELATH
Tipo:	L
Contenido:	.T.
Descripción:	Servidor de email requiere autenticación. .F. = No .T. = Sí

Nombre:	MV_RELSSL
Tipo:	L
Contenido:
Descripción:	Habilita el SSL en el envío y recepción de emails. .F. = No .T. = Sí

Nombre:	MV_RELTLS
Tipo:	L
Contenido:
Descripción:	El servidor de SMTP tiene conexion del tipo segura ( SSL/TLS ). .F. = No .T. = Sí

Nombre:	MV_SRVPORT
Tipo:	N
Contenido:
Descripción:	Puerto de salida del servidor de envío.

Si no se define este parámetro, el sistema usa el puerto estándar 25, en este caso es importante no incluir el puerto en la identificación del servidor de correo, parámetro MV_RELSERV.

Nombre:	MV_RELAUSR
Tipo:	C
Contenido:
Descripción:	Usuario para autenticación en el servidor de correo.

Nombre:	MV_RELAPSW
Tipo:	C
Contenido:
Descripción:	Contraseña para autenticación en servidor de email.

CONFIGURACIÓN DE MENÚS.

2. En el Configurador (SIGACFG), acceda a Entornos/Archivo/Menú (CFGX013). Informe la nueva opción de menú del informe el módulo SIGAFAT, conforme las instrucciones a continuación:

Menú	Actualizaciones.
Submenú	Archivos.
Nombre de la Rutina	Definición de Catálogos.
Programa	FISA812
Módulo	Facturación.
Tipo	Función Protheus.

Menú	Actualizaciones.
Submenú	Archivos.
Nombre de la Rutina	Mantenimiento de Catálogos.
Programa	FISA813
Módulo	Facturación.
Tipo	Función Protheus.

Menú	Actualizaciones.
Submenú	Facturación.
Nombre de la Rutina	Transmitir Factura Electron.
Programa	MATA486
Módulo	Facturación.
Tipo	Función Protheus.

1.3 Procedimiento de Utilización

1. Ingrese a la rutina de definición de catálogos (Facturación SIGAFAT | Actualizaciones | Archivos | Definición de catálogos) para crear automáticamente los catálogos de Factura Electrónica a partir de los archivos .CSV.

2. En la rutina de mantenimiento de catálogos (Facturación SIGAFAT | Actualizaciones | Archivos | Mantenimiento de catálogos) se puede verificar el contenido de los catálogos creados.

En caso de que la certificación de los comprobantes fiscales se vaya a realizar a través del servicio web Dfactura de The Factory HKA, debe modificar el catálogo S005 - Impuestos Factura Electrónica, de acuerdo al listado que el Proveedor Tecnológico maneja:

Tabla 4 Tipos de Impuesto

Código		Descripción
01		IVA
02		ICA
03		ICO
04		Contribuciones
05	Subcódigo	Retención en la fuente por renta
	3	Compras
	5	Honorarios
	6	Servicios Generales
	7	Transporte de Carga
06		Retención en la fuente por ICA
07		Retención en la fuente por IVA

Adicionalmente, configure uno o varios códigos especiales para autorretenciones. Las claves no deben estar en uso por el Proveedor Tecnológico ni por la DIAN y deben ser alfanuméricos. Por ejemplo: 0A.

3. Configure la relación entre las tablas del sistema y los catálogos publicados por la DIAN en el documento:

Anexo Técnico 001. Formatos de los Documentos XML de Fac-e V2 .Por ejemplo:

Monedas (Contabilidad de Gestión (SIGACTB) | Actualizaciones | Archivos | Monedas Contables): Defina el código DIAN (estándar ISO 4217), conforme al inciso 8.7 del documento mencionado.
Impuestos variables (Libros Fiscales (SIGAFIS) | Actualizaciones | Archivos | Impuestos Variab.): Defina el código de impuesto y régimen de IVA de la DIAN, conforme a los incisos 8.5 y 8.10 respectivamente. Ver nota del punto 2.
También configure la clase de impuesto: I-Impuesto, P-Percepción, R-Recepción (o Retención). Para autorretenciones como es el caso del CREE, tenga en cuenta vincular el impuesto correspondiente con los códigos especiales descritos en el inciso
Países (Easy Import Control (SIGAEIC) | Actualizaciones | Archivos | Países): Defina los códigos de la DIAN (estándar ISO 3166-1), conforme al inciso 8.8.
Unidades de medida (Facturación (SIGAFAT) | Actualizaciones | Archivos | Unidades Medida): También, registre los códigos en relación a los definidos para el comercio internacional de acuerdo a la recomendación de la UNECE.

4. En la tabla de Control de folios (Libros Fiscales (SIGAFIS) | Actualizaciones | Archivos | Impuestos Variab.) registre los datos para cada serie y especie:

Folios: Folios inicial y final autorizados.
Número autorización: Número o código de la resolución otorgada para la numeración.
Fecha Resolución: Fecha de autorización de la numeración.
Fecha de validez: Fecha de vencimiento de la autorización.
Serie 2: Serie a 4 dígitos que será informada a la DIAN.
Clave técnica: Número de serie del rango de facturación.

Adicionalmente, en la rutina de tablas genéricas (Configurador Protheus (SIGACFG) | Entorno | Archivos | Tablas), acceda a la tabla 01 - Series de Facturas y registre los consecutivos de las series correspondientes.

5. En el catálogo de clientes (Facturación (SIGAFAT) | Actualizaciones | Archivos | Clientes) registre la información requerida para la factura electrónica. Los datos requeridos para incluir en la factura electrónica son:

Persona física/jurídica (A1_PESSOA).
Nombre (A1_NOME).
Dirección (A1_END).
Barrio/Colonia (A1_BAIRRO).
Municipio (A1_MUN).
Estado/Provincia/Región (A1_EST) y su correspondiente descripción en la tabla genérica "12" (SX5).
País (A1_PAIS) y su correspondiente descripción en la tabla de países (SYA).
Tipo de documento (A1_TIPDOC).
NIT (A1_CGC) o RG para persona fisica, Tarjeta de Ciudadania, Tarjeta de Extranjero o Tarjeta de Identidad del Cliente (A1_PFISICA).
Tipo de persona/régimen tributario (A1_TPESSOA).
Cuenta de correo electrónico (A1_EMAIL) - Opcional.

Opcionalmente, puede configurar estos campos como obligatorios a través del configurador de Protheus (SIGACFG | Base de Datos | Base de Datos), contacte al administrador del sistema para realizar estas configuraciones.

7. Registre notas de débito (Facturación (SIGAFAT) | Actualizaciones | Facturación | Notas de Cred./Deb.) por conceptos de intereses y gastos por cobrar. A continuación realice la transmisión electrónica, podrá imprimir los comprobantes en PDF y/o enviarlos por email.

8. Registre notas de crédito (Facturación (SIGAFAT) | Actualizaciones | Facturación | Notas de Cred./Deb.) por devolución, anulación y descuentos. A continuación realice la transmisión electrónica, podrá imprimir los comprobantes en PDF y/o enviarlos por email.

9. Realice el mismo procedimiento para generar facturas de venta, notas de débito y notas crédito de exportación, ejecute la transmisión electrónica.

La representación impresa de un comprobante electrónico (PDF) consta de los elementos necesarios indicados por la autoridad, entre los cuales se destaca:

Nombre, NIT y dirección del emisor
Nombre, NIT y dirección del receptor
Serie, consecutivo y fecha del comprobante
Conceptos de la operación (productos)
IVA, total de impuestos, total de retenciones, total de descuentos
Importe en letra
Para el caso de facturas de venta el CUFE
Código de barras QR-Code formado de acuerdo a las especificaciones de la DIAN; para documentos tipo NF
De manera similar, también se imprime código QR-Code para documentos tipo NDC y NCC, sin CUFE
La autorretenciones se muestran de manera informativa al pie del documento
Si por cualquier circunstancia, la impresión estándar de los documentos no se ajusta al formato de la empresa, se debe utilizar el punto de entrada M486PDFGEN para personalizar la representación gráfica de cada tipo de documento.

Al transmitir un documento, si obtiene como resultado el mensaje "Se encontraron inconsistencias", proceda a imprimir el log de errores en el cual se informa el motivo de rechazo. Generalmente se tratará de un dato incorrecto o sin definir en la tabla de:

Control de folios.
Clientes.
Impuestos variables.
Unidades de medida.

Si la transmisión es "exitosa", de acuerdo al método de certificación, eso indica:

Proveedor Tecnológico (Por ejemplo The Factory HKA): La factura electrónica fue validada y aceptada, se envió a la DIAN.

2. BITÁCORA DE CAMBIOS

2.1 FACTURA ELECTRÓNICA VALIDACIÓN PREVIA

2.1.1 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 inciso 1.REQUERIMIENTOS

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

Nota: La actualizaciones presentadas a continuación son compatibles con versiones mayor o igual a 12.1.17

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:

Rutinas	Fecha Actualización
FISA814.PRW	08/08/2019
FISA827.PRW	08/08/2019
LOCXNF.PRW	19/082019
LOCXNF2.RW	19/082019
M486XFUN.PRW	08/08/2019
M486XFUNCO.PRW	19/082019
MATA468N.PRX	16/08/2019
MATA486.PRW	19/082019
WSNFECOL.PRW	08/08/2019
FATSCOL.INI	08/08/2019
FATECOL.INI	08/08/2019
FATSECOL.INI	20/08/2019
MATN030.PRX	16/08/2019

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 :

Atributo	Tamaño	Path
numeroDocumento	20	fe:Invoice/cac:AdditionalDocumentReference/cbc:ID
fecha	10	fe:Invoice/cac:AdditionalDocumentReference/cbc:IssueDate
tipoDocumentoCodigo	20	fe:Invoice/cac:AdditionalDocumentReference/cbc:DocumentTypeCode
codigoInterno	1	"1"

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>

Atributo	Tamaño	Path
numeroDocumento	20	fe:Invoice/cac:OrderReference/cbc:ID
fecha	10	fe:Invoice/cac:OrderReference/cbc:IssueDate

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.

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

Atributo	Tamaño	Path
telefono	20	fe:Invoice/fe:AccountingCustomerParty/cac:Party/cac:Contact/cbc:Telephone
email	1000	fe:Invoice/fe:AccountingCustomerParty/cac:Party/cbc:ElectronicMail

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.

a) Pantalla de factura electrónica

b) Otras Acciones / Acciones relacionadas

Acción	Descripción
Monitor	Permite realizar la consulta del estatus de los documentos ante la DIAN.
Recupera XML	Permite descargar una copia de la factura electrónica (archivos XML y PDF) desde el sitio del proveedor tecnológico.
Imprimir PDF	Permite descargar e imprimir la factura electrónica (archivo PDF) desde el sitio del proveedor tecnológico.
Visualizar	Presenta visualización del documento fiscal.
Leyenda	Muestra descripción de los estatus de documentos en el browse.

c) Impresión de documentos electrónicos

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.

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

Rutina	Nombre Técnico	Fechas del Parche
M486PDFCOL.PRX	Impresión de Representación Impresa Facturación Electrónica Colombia	19/02/2020

También se deben realizar las siguiente configuraciones:

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".
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:

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

Nombre de la variable	MV_RELSERV
Tipo	Carácter
Descripción	Nombre de Servidor de Envío de E-mail utilizado en los informes.
Valor Estándar	SMTP.Office365.com

Nombre de la variable	MV_RELACNT
Tipo	Carácter
Descripción	Cuenta a ser utilizada en el envio de E-Mail para lo informes.
Valor Estándar	Correo electrónico emisor

Nombre de la variable	MV_RELPSW
Tipo	Carácter
Descripción	Contraseña de cta. de E-mail para enviar informes
Valor Estándar	Contraseña del correo emisor

Nombre de la variable	MV_RELAUTH
Tipo	Lógico
Descripción	Determina si el servidor requiere Autenticacion.
Valor Estándar	.T.

Nombre de la variable	MV_RELSSL
Tipo	Lógico
Descripción	Define si debe habilitarse el SSL en el envio y recepcion de e-mails
Valor Estándar	.T.

Nombre de la variable	MV_RELTLS
Tipo	Lógico
Descripción	Informe si el servidor de SMTP tiene conexion del tipo segura ( SSL/TLS ).
Valor Estándar	.T.

Nombre de la variable	MV_SRVPORT
Tipo	Númerico
Descripción	Puerto de conexión del servidor de E-mail.
Valor Estándar	587

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:

Nombre de la variable	MV_TIPOFE
Tipo	Carácter
Descripción	Modelo de transmisión electrónica: 0 o vacío = Val. Posterior, 1 = Val. Previa.
Valor Estándar	1

Nombre de la variable	MV_PDFPRO
Tipo	Carácter
Descripción	Habilita la impresión de documentos electrónicos en formato PDF de Protheus: 1 = Sí, 2 = No.
Valor Estándar	2

Nombre de la variable	MV_IMPMILL
Tipo	Carácter
Descripción	Contiene los códigos de impuestos que son calculados al millar, separados por "\|" (Por ejemplo ICA).
Valor Estándar

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:

Alias	Tipo	Secuencia	Columna	Descripción	Contenido
COL017	2	01	RE	Tipo Operación	F3I
COL017	2	01	01	Tipo Operación	F812SXB("S017","Codigo",{\|\|Substr(F3I_CONTEU,85,3)==cEspecie})
COL017	5	01			VAR_IXB

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

Clave	Nombre	Modo	Modo Unidade	Modo Empresa
AIT	Responsabilidades-Tributos Clie	Compartido	Exclusivo	Exclusivo

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

Campo	AIT_FILIAL
Orden	01
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Sucursal
Descripción	Sucursal del sistema
Nivel	1
Utilizado	No
Obligatorio	No
Browse	No
Val. Sistema	No aplica
Grp. Campos	033
Help	Código que identifica la sucursal de la empresa usuaria del sistema.

Campo	AIT_CODCLI
Orden	02
Tipo	Carácter
Tamaño	Debe corresponder al configurado en el grupo de campos 001.
Decimal	0
Formato	@!
Título	Cód. Cliente
Descripción	Código del cliente
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	No aplica
Grp. Campos	001
Help	Código que individualiza a cada uno de los clientes de la empresa. Se complementa con el código de la tienda.

Campo	AIT_LOJA
Orden	03
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Tienda
Descripción	Código de la tienda
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	No aplica
Grp. Campos	002
Help	Código que identifica la tienda del cliente. Permite que haya un control de las operaciones por tienda.

Campo	AIT_CODRES
Orden	04
Tipo	Carácter
Tamaño	4
Decimal	0
Formato	@!
Título	Cód. Resp.
Descripción	Código resp. fiscal
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	Vazio() .Or. ValidF3I("S014", M->AIT_CODRES,1,4)
Consulta	COL014
Help	Código de la obligación o responsabilidad fiscal del cliente de acuerdo al RUT del adquirente.

Campo	AIT_CODTRI
Orden	05
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Cód. Tributo
Descripción	Código del tributo.
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	Vazio() .Or. ValidF3I("S005", M->AIT_CODTRI,1,3)
Consulta	COL005
Help	Código de identificador del tributo (acuerdo al numeral 6.2.2 de la DIAN).

Campo	AIT_TIPO
Orden	06
Tipo	Carácter
Tamaño	1
Decimal	0
Formato	@!
Título	Tipo
Descripción	Tipo de información
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	No aplica
Help	Indica la opción del tipo de registro, teniendo las opciones R=Responsabilidades o T=Tributo.

Campo	AI0_TPREG
Orden	18
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Tipo Régimen
Descripción	Tipo de Régimen
Nivel	1
Utilizado	Si
Obligatorio	Obligatorio
Browse	No
Val. Sistema	Vazio() .Or. ValidF3I("S010", M->AI0_TPREG,1,2)
Consulta	COL010
Help	Indica el régimen al que pertenece el adquirente, lista las opciones del catálogo S010 - Tipo de régimen (Facturación electrónica).

Campo	F1_UUID
Orden	ZZ
Tipo	Carácter
Tamaño	96
Decimal	0
Formato	@!
Título	CUFE
Descripción	Cód. Único de Fact. Elect
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema
Consulta
Help	Contiene el código único de facturación electrónica (CUFE).

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

Índice	AIT
Orden	1
Clave	AIT_FILIAL+AIT_CODCLI+AIT_LOJA+AIT_TIPO
Descripción	Sucursal + Cód. Cliente + Tienda + Tipo
Propietario	S

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

Campo	F1_TIPOPE
Orden	ZZ
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Tipo Oper.
Descripción	Tipo de operación
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	Vazio() .or. ValidF3I("S017", M->F1_TIPOPE,1,2)
Consulta	COL017
Help	Indica el tipo de operación del documento, de acuerdo al punto 6.1.5 de códigos relacionados con documentos definida por la DIAN.

Campo	F2_TIPOPE
Orden	ZZ
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Tipo Oper.
Descripción	Tipo de operación
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	Vazio() .or. ValidF3I("S017", M->F2_TIPOPE,1,2)
Consulta	COL017
Help	Indica el tipo de operación del documento, de acuerdo al punto 6.1.5 de códigos relacionados con documentos definida por la DIAN.

Campo	F2_UUID
Orden	ZZ
Tipo	Carácter
Tamaño	96
Decimal	0
Formato	@!
Título	CUFE
Descripción	Cód. Único de Fact. Elect
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema
Consulta
Help	Contiene el código única de facturación electrónica.

Campo	C5_TIPOPE
Orden	ZZ
Tipo	Carácter
Tamaño	2
Decimal	0
Formato	@!
Título	Tipo Oper.
Descripción	Tipo de operación
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Val. Sistema	Vazio() .or. ValidF3I("S017", M->C5_TIPOPE,1,2)
Consulta	COL017
Help	Indica el tipo de operación del documento, de acuerdo al punto 6.1.5 de códigos relacionados con documentos definida por la DIAN.

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

Campo	C5_UUIDREL
Orden	ZZ
Tipo	Memo
Tamaño	10
Decimal	0
Formato	@!
Título	Docs Relacs
Descripción	Documentos relacionados
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Help	Indica el Documento Relacionado, separar cada documento a relacionar con un salto de línea, y cada uno de los documentos informados deberá tener la nomenclatura: Código de Referencia a otros documentos definido por la DIAN + diagonal("/") + Número de folio del documento, por ejemplo AIJ/CTG16, para ordenes de compra utilizar el código ORDC.

Campo	F2_UUIDREL
Orden	ZZ
Tipo	Memo
Tamaño	10
Decimal	0
Formato	@!
Título	Docs Relacs
Descripción	Documentos relacionados
Nivel	1
Utilizado	Si
Obligatorio	No
Browse	No
Condición	M486VLDDR(M->F2_UUIDREL,.T.)
Help	Indica el Documento Relacionado, separar cada documento a relacionar con un salto de línea, y cada uno de los documentos informados deberá tener la nomenclatura: Código de Referencia a otros documentos definido por la DIAN + diagonal("/") + Número de folio del documento, por ejemplo AIJ/CTG16, para ordenes de compra utilizar el código ORDC.

2.2 PUNTO DE ENTRADA ADICIÓN DE CAMPOS A XML
Âncora
PE01
PE01

2.2.1 Visión general

Con la finalidad de proporcionar al usuario un medio para agregar datos adicionales a la factura electrónica, se crea el punto de entrada M486CEXT para la incorporación de Campos Extensibles al documento electrónico XML/PDF (Resolución N° 000019 24-02-2016 DIAN) que genera el proveedor tecnológico The Factory HKA (TFHKA). Los datos adicionales pueden ser por ejemplo campos de los registros de clientes: Teléfono, Teléfono 2, Dirección, etc.

2.2.2 Ejemplo de utilización

Creación del PE M486CEXT

El usuario creará el código y compilará la función de usuario M486CEXT con las estructuras de los campos extensibles a integrar en el XML/PDF que genera TFHKA, el Punto de Entrada constará de:

Parámetros recibidos, el nombre ParamIXB y tipo (arreglo) son fijos:

- ParamIXB[1,1] = Serie de documento
- ParamIXB[1,2] = Número de documento
- ParamIXB[1,3] = Código de cliente
- ParamIXB[1,4] = Tienda de cliente
- ParamIXB[1,5] = Fecha de emisión
- ParamIXB[1,6] = Filial (SF2/SF1)
- ParamIXB[2] = Tipo de documento: NF, NDC, NCC

Cada campo se debe definir en un arreglo de 6 elementos, donde:

- 1 = Descripción del campo para título en el PDF (controlInterno1).
- 2 = Consecutivo de campo (controlInterno2).
- 3 = Clave de campo (nombre).
- 4 = Incluir en PDF? 0=No, 1=Sí (pdf).
- 5 = Contenido del campo (valor).
- 6 = Incluir en XML? 1=Sí, siempre (xml).
  Los textos entre paréntesis hacen referencia a identificadores del Servicio Web de TFHKA. Las descripciones y características de cada identificador, así como los códigos de campos posibles de utilizar (3° elemento), están descritos en el documento “Manual de Integración Directa - Emisión - V7.5.pdf” de TFHKA, sección Uso de Campos Extensibles y en la Tabla 11 respectivamente.
  Importante:
- Para los campos que no les corresponda alguno de los códigos considerados en la TABLA 11, denominados LIBRE, deberá informarse una clave única para cada campo, además, esas claves no deben estar asignadas en el catálogo indicado; se pueden utilizar por ejemplo “1”, "2", "3", etc.
- El indicador XML siempre deberá ser "1", el establecer "0" no tendría utilidad ya que no incluirá el campo en el documento electrónico y por lo tanto tampoco podría imprimirse en la representación gráfica.

Retorno:

- Matriz de arreglos de los campos extensibles.

Procedimiento de Implantación

Nota: La actualizaciones presentadas a continuación son compatibles con versiones mayor o igual a 11.0

Rutinas	Fecha Actualización
MATA486.PRW	19/02/2019

Registrar una factura de venta; SIGAFAT | Actualizaciones | Facturación | Facturaciones.
Transmitir la factura capturada; SIGAFAT | Actualizaciones | Facturación | Documentos Electrónicos.
Visualizar el archivo XML recibido del servicio web de TFHKA, si el campo extensible tiene un código que corresponda a la "Tabla de códigos para campos extensibles", ese campo estará incluido en el nodo que le corresponda (receptor, encabezado, detalle, etc). Por otra parte, si es un campo "libre", éste se incorpora en el nodo ExtensionContent en la raíz del archivo XML.

a) Ejemplo de Punto de Entrada M486CEXT

#Include "Protheus.ch"

#Include "rwmake.ch"

User Function M486CEXT()

Local aArea := getArea()

Local aAreaSA1 := SA1->(GetArea())

Local aCampos := {}

Local cSerie := ParamIXB[1,1]

Local cFactura := ParamIXB[1,2]

Local cCliente := ParamIXB[1,3]

Local cLoja := ParamIXB[1,4]

Local cEspecie := ParamIXB[2]

dbSelectArea("SA1")

dbSetOrder(1) //A1_FILIAL+A1_COD+A1_LOJA

dbSeek(xFilial("SA1")+cCliente+cLoja)

If !Empty(SA1->A1_CONTATO)

aAdd( aCampos , {"Destinatario", "", "48", "1", Alltrim(SA1->A1_CONTATO), "1"} )

EndIf

If !Empty(SA1->A1_HPAGE)

aAdd( aCampos , {"Pagina web", "", "1", "1", Alltrim(SA1->A1_HPAGE), "1"} )

EndIf

SA1->(RestArea(aAreaSA1))

RestArea(aArea)

Return aCampos

b) Ejemplo de documento electrónico generado por TFHKA con campos extensibles

c) Ejemplo de documento electrónico en PDF generado por TFHKA con campos extensibles

2.3 PUNTO DE ENTRADA EXPORTACIÓN CAMPOS TRM
Âncora
PE02
PE02

2.3.1 Visión General

Desarrollar funcionalidad para que al transmitir los documentos de exportación genere de forma automática los campos extensibles relacionados a TRM.

Actualmente al momento de intentar Transmitir una Factura de Exportación (Cliente con A1_EST = EX), se obtiene la respuesta "109-[Linea 02 Factura General] El campo TRM es un campo compuesto requerido para Facturas de Exportación, debe enviar los códigos 81,83,84,85".

2.3.2 Ejemplo de utilización

Nota: La actualizaciones presentadas a continuación son compatibles con versiones mayor o igual a 11.0

Rutinas	Fecha Actualización
MATA486.PRW	09/04/2019

Se debe tener un cliente extranjero; Campo de estado (A1_EST) igual a "EX".

El campo Moneda DIAN (CTO_MOESAT) de la moneda contable "01" debe ser diferente a la Moneda del documento (F2/F1_MOEDA).

Procedimiento de Implantación

Acceda a la rutina de facturación; SIGAFAT | Actualizaciones | Facturación | Facturación (MATA467N).
- Registre una Factura de Exportación.
Acceda a la rutina de transmisión; SIGAFAT | Actualizaciones | Facturación | Transmitir Factura Electrónica (MATA486).
- Seleccione la opción Otras Acciones | Transmitir.
- Especifique los parámetros del proceso y confirme.
- El sistema indicará que la transmisión fue exitosa.
- Desde la ruta de facturas autorizadas, visualice el archivo XML recibido del proveedor tecnológico. Verifique la existencia del nodo cac:PaymentExchangeRate el cual contiene los campos TRM:

a) Ejemplo de Punto de Entrada M486CEXT - Campos extensibles.

Ejemplo de generación de los campos correspondientes a TRM (81, 83, 84 y 85):

#Include "Protheus.ch"
#Include "rwmake.ch"

User Function M486CEXT()

Local aArea := getArea()
Local aAreaSA1 := SA1->(GetArea())
Local aAreaSF1 := SF1->(GetArea())
Local aAreaSF2 := SF2->(GetArea())
Local aCampos := {}
Local cSerie := ParamIXB[1,1]
Local cFactura := ParamIXB[1,2]
Local cCliente := ParamIXB[1,3]
Local cLoja := ParamIXB[1,4]
Local cEspecie := ParamIXB[2]
Local cEst := ""
Local cTxMoeda := ""

dbSelectArea("SA1")
dbSetOrder(1)
dbSeek(xFilial("SA1")+cCliente+cLoja)
If !Empty(SA1->A1_CONTATO)
aAdd( aCampos , {"Destinatario", "", "48", "1", Alltrim(SA1->A1_CONTATO), "1"} )
EndIf

If !Empty(SA1->A1_HPAGE)
aAdd( aCampos , {"Pagina web", "", "1", "1", Alltrim(SA1->A1_HPAGE), "1"} )
EndIf
SA1->(RestArea(aAreaSA1))

If Alltrim(cEspecie) $ "NF|NDC"
dbSelectArea("SF2")
dbSetOrder(1)
dbSeek(xFilial("SF2")+cFactura+cSerie)
cEst := SF2->F2_EST
cTxMoeda := Alltrim(Str(SF2->F2_TXMOEDA))
SF2->(RestArea(aAreaSF2))

Else
dbSelectArea("SF1")
dbSetOrder(1)
dbSeek(xFilial("SF1")+cFactura+cSerie)
cEst := SF1->F1_EST
cTxMoeda := Alltrim(Str(SF1->F1_TXMOEDA))
SF1->(RestArea(aAreaSF1))

EndIf

If cEst == "EX"
aAdd( aCampos , {"Tasa de Cambio" , "", "81", "1", "" , "1"} )
aAdd( aCampos , {"Moneda Origen" , "", "83", "1", "USD" , "1"} )
aAdd( aCampos , {"Moneda Final" , "", "84", "1", "COP" , "1"} )
aAdd( aCampos , {"Valor del Calculo", "", "85", "1", cTxMoeda, "1"} )
Endif

RestArea(aArea)

Return aCampos

Scripts de generación de documentos electrónicos (archivos XML).

Las modificaciones realizadas son para el correcto manejo de campos cuando el cliente es persona física. En el nodo fe:AccountingCustomerParty (datos del receptor) se incluye uno de los siguientes subnodos dependiendo del tipo de persona:

Tipo de persona	Subnodo	Atributo	Contenido	Descripción
Jurídica	fe:PartyLegalEntity	cbc:RegistrationName	A1_NOME	Razón social / Nombre completo
Física	fe:Person	cbc:FirstName	A1_NOMEPRI	Primer nombre
		cbc:MiddleName	A1_NOMEPES	Segundo nombre
		cbc:FamilyName	A1_NOMEPAT	Segundo apellido

2.4 OBLIGATORIEDAD DOCUMENTOS REFERENCIADOS (NDC/NCC)
Âncora
PE02
PE02

2.4.1 Visión General

Se solicita funcionalidad para incluir y transmitir documentos electrónicos de tipo Nota de Débito de Cliente (NDC) o Nota de Crédito de Cliente (NCC), para referenciar Facturas de Salida (NF) que hayan sido transmitidas mediante el modelo de Facturación Electrónica de validación posterior de acuerdo al Anexo técnico del Sistema Electrónico de Factura Electrónica de Venta con Validación Previa versión 1.8.

2.4.2 Configuraciones Previas

a) Actualizar la estructura del catálogo S017 - TIPOS DE OPERACIÓN, donde se agregaron los campos Tipo Doc. y Tipo Val.

b) Actualizar el contenido del catálogo S017 - TIPOS DE OPERACIÓN, en donde el archivo 17TiposOperacion.csv deberá estar en la ruta configurada en el parámetro MV_PATH814, debiendo tener la siguiente estructura:

Columna	Contenido
1	Código de Tipo de Operación DIAN
2	Descripción del Tipo de Operación DIAN
3	Especie del documento para el que aplica el Tipo de Operación, donde: NF - Para Factura de Salida. NDC - Para Notas de Débito de Cliente. NCC - Para Notas de Crédito de Cliente.
4	Indica la opción de validación que aplica para el Tipo de Operación, donde: 0 - Sin referencia a Factura de Salida. 1 - Referencia a Factura de Salida de modelo validación previa. 2 - Referencia a Factura de Salida de modelo validación posterior.

Importante: Para realizar la actualización del catálogo S017 - TIPOS DE OPERACIÓN, es necesario realizar el borrado lógico del código S017 en las tablas Configuración de Catálogos (F3H) y Mantenimiento de Catálogos (F3I) y que el archivo 17TiposOperacion.csv contenga los datos de acuerdo a la nueva estructura.

c) Actualizar la expresión de la consulta especifica COL017 para que, al desplegar la consulta desde los campos Tipo Oper. (F1/F2_TIPOPE), se realice el filtrado por especie del documento y así solo visualizar los que pertenecen al tipo de documento a generar.

Importante: Ajuste realizado en el pacote 007262 - DMINA-8101 - TIPO OPERACIÓN FE COLOMBIA 12.1.25.

2.4.3 Ejemplo de utilización

En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Facturación | Generac. de Notas de Crédito y Débito (MATA465).

Informar en los parámetros:
- ¿Formulario propio? = Si
- ¿Tipo de Factura? = Crédito
Incluir un nuevo documento e informar en el encabezado el Cliente (F1_FORNECE), Loja (F1_LOJA), Núm. Doc (F1_DOC), Serie (F1_SERIE)
Indica en el campo Tipo Oper. (F1_TIPOPE) el valor 23 - Nota de Crédito para Facturación Electrónica v1.
Informar el detalle del documento (Puede ser desde Otras Acciones ejecutando la acción Doc Orig o de forma manual)
La Factura de Salida informada en los campos Doc. Original (D1_NFORI) y Serie Orig. (D1_SERIORI), deberá cumplir con los siguientes requisitos:
- Tener estatus de Recibido (F2_FLFTEX = '1')
- El CUFE de tener una longitud de 40 caracteres.
Una vez que se han informado todos los datos presionar Grabar para confirmar el guardado del documento.

En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Facturación | Facturación Electrónica (MATA486).

Informar en los parámetros:
¿Tipo de documento? = Nota de Crédito
- ¿Serie? = Serie de la Nota de Crédito incluida anteriormente.
- ¿Estatus? = vacío o cero.
- ¿Fecha Inicial? / ¿Fecha Final? = Rango que contemple la fecha de emisión de la Nota de Crédito.
Ejecutar la acción Transmitir, e informar los parámetros:
- ¿Serie de Nota de Crédito? = Serie de la Nota de Crédito incluida anteriormente.
- ¿Nota de Crédito Inicial? / ¿Nota de Crédito Final? = Rango que contemple la fecha de emisión de la Nota de Crédito.
Validar que el proceso de transmisión sea exitoso.
Ejecutar desde otras acciones la acción Imprimir PDF y validar que se visualice en el informe la sección Documentos Referenciados.

IMPORTANTE:

Para las Notas de Débito de Cliente (NDC) y Notas de Crédito de Cliente (NCC) que no afectan a Factura deberán de usarse los siguientes tipos de operación:

22 - Nota Crédito sin referencia a facturas.
32 - Nota Débito sin referencia a facturas.

Para las Notas de Débito de Cliente (NDC) y Notas de Crédito de Cliente (NCC) que afectan a Facturas transmitidas por el método de validación Posterior deberán de usarse los siguientes tipos de operación:

23 - Nota Crédito para facturación electrónica V1.
33 - Nota Débito para facturación electrónica V1.

Para las Notas de Débito de Cliente (NDC) y Notas de Crédito de Cliente (NCC) que afectan a Facturas transmitidas por el método de validación Previa deberán de usarse los siguientes tipos de operación:

20 - Nota Crédito que referencia una factura electrónica.
30 - Nota Débito que referencia una factura electrónica.

2.5 PUNTO DE ENTRADA ANULACIÓN DE VALIDACIÓN DOC. RELACIONADO - M465DORIFE (NCC/NDC)

Se activa el Punto de Entrada M465DORIFE, mediante el cual el usuario podrá agregar reglas de negocio para excluir la validación de transmisión previa de documentos a relacionar a Notas de Crédito de Cliente (NCC) y Notas de Débito de Cliente (NDC), para verificar la funcionalidad del punto de entrada ir al documento técnico: 7275299_DMINA-7702_DT_PE_M465DORIFE_Valida_estatus_NF_relacionada_a_NCC_COL

2.6 AUTORRETENCIONES

2.6.1 Visión General

Se solicita funcionalidad para incluir y transmitir documentos electrónicos que tengan cálculo de autorretenciones.

Ticket: 8674296

2.6.2 Configuraciones Previas

Contar con las siguientes rutinas actualizadas con fecha igual o posterior:

Rutina	Nombre técnico	Fecha
M486XFUN	Funciones genéricas para generación de XML	22/04/2020
M486XFUNCO	Funciones genéricas para generación de XML para país Colombia	22/04/2020

a) En el módulo Facturación (SIGAFAT) desde Actualizaciones | Archivos | Mantenimiento de Catálogos (FISA813).

En el catálogo S005-Impuestos Factura Electrónica, agregar un nuevo código de impuesto que sea diferente a los reservados por la DIAN, por ejemplo A0.

b) En el módulo Facturación (SIGAFAT) desde Actualizaciones | Archivos | Impuestos Variables (MATA995).

Configurar el impuesto de autorretención indicando en el campo Impuesto FE (FB_IMPSAT) con el valor del código agregado en el catálogo S005-Impuestos Factura Electrónica, y el campo Clase Imp. (FB_CLASSE) con el valor R-Recepción.

2.6.3 Ejemplo de utilización

En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Facturación | Facturaciones (MATA467N).

Informar en los parámetros:
- ¿Normal/Benef? = Normal
Incluir un nuevo documento e informar en el encabezado el Cliente (F2_CLIENTE), Loja (F2_LOJA), Núm. Doc (F2_DOC), Serie (F2_SERIE)
Indica en el campo Tipo Oper. (F2_TIPOPE).
Informar el detalle del documento, utilizando un Tipo de Salida/Entrada con calculo de autorretención (Las autoretenciones no suman ni restan al valor bruto del documento).
Una vez que se han informado todos los datos presionar Grabar para confirmar el guardado del documento.

En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Facturación | Facturación Electrónica (MATA486).

Informar en los parámetros:
1. ¿Tipo de documento? = Factura
2. ¿Serie? = Serie de la Factura de Salida incluida anteriormente.
3. ¿Estatus? = vacío o cero.
4. ¿Fecha Inicial? / ¿Fecha Final? = Rango que contemple la fecha de emisión de la Factura de Salida.
Ejecutar la acción Transmitir, e informar los parámetros:
- ¿Serie de Factura? = Serie de la Factura de Salida incluida anteriormente.
- ¿Factura Inicial? / ¿Factura Final? = Rango que contemple la fecha de emisión de la Factura de Salida.
Validar que el proceso de transmisión sea exitoso.
Ejecutar desde otras acciones la acción Imprimir PDF y validar que en la sección Información adicional se visualicen los datos de la autorretención.

2.7 PUNTO DE ENTRADA PARA ATRIBUTOS OPCIONALES (M486OWSCOL)

2.7.1 Visión General

Se solicita la activación de un Punto de Entrada para poder enviar los atributos opcionales disponibles en las clases de los web services de The Factory HKA (Ticket: 8394670).

IMPORTANTE: La activación de dicho Punto de Entrada deberá ser realizado por algún analistas con conocimiento de programación, ya que será responsabilidad de este si al no definir correctamente la regla de negocio en el punto de entrada esto pudiera causar rechazo en la transmisión de Facturas de Entrada, Notas de Débito o Notas de Crédito.

2.7.2 Configuraciones Previas

Contar con las siguiente rutina actualizada con fecha igual o posterior:

Rutina	Nombre técnico	Fecha
M486XFUNCO	Funciones genéricas para generación de XML para país Colombia	28/04/2020

Compilar el punto de entrada M486OWSCOL, el cual recibo los siguientes parámetros:

Serie del documento
Folio del documento
Código del Cliente
Código de la Tienda
Objeto del XML
Opción (1=Nivel documento y 2=Nivel ítem)
Objeto con atributos del web services de The Factory HKA (Solo atributos de la clase FacturaGeneral)

Ejemplo del Punto de Entrada:

#include 'protheus.ch'

User Function M486OWSCOL()
Local cSerieDoc := PARAMIXB[1] //Serie
Local cNumDoc := PARAMIXB[2] //Número de Documento
Local cCodCli := PARAMIXB[3] //Código de Cliente
Local cCodLoj := PARAMIXB[4] //código de loja
Local oXML := PARAMIXB[5] //Nodo del XML
Local nOpc := PARAMIXB[6] //1=Nivel documento 2=Nivel detalle
Local oWS := PARAMIXB[7] //Objeto de web services

Local nItem := Val(oXML:_CBC_ID:TEXT)
Local cCodProd := ""
Local cSDITem := ""
Local cFilSD := xFilial("SD2")

If nOpc == 1 //Encabezado
//F2_FILIAL+F2_DOC+F2_SERIE+F2_CLIENTE+F2_LOJA+F2_FORMUL+F2_TIPO (Índice 1)
//Clase oWSCliente
oWS:oWSCliente:cnombreComercial := "NOMBRE COMERCIAL PE"

//Clase oWSterminosEntrega
oWS:oWSterminosEntrega := Service_TerminosDeEntrega():New()
oWS:oWSterminosEntrega:ccostoTransporte:= "18.00"
ElseIf nOpc == 2 //Detalle del documento
cCodProd := Padr(oXML:_FE_ITEM:_CAC_SELLERSITEMIDENTIFICATION:_CBC_ID:TEXT,TamSX3("D2_COD")[1],' ')
cSDITem := Padl(oXML:_CBC_ID:TEXT,TamSX3("D2_ITEM")[1],'0')
dbSelectArea("SD2")
SD2->(dbSetOrder(3)) //D2_FILIAL + D2_DOC + D2_SERIE + D2_CLIENTE + D2_LOJA + D2_COD + D2_ITEM
If SD2->(dbSeek( cFilSD + cNumDoc + cSerieDoc + cCodCli + cCodLoj + cCodProd + cSDITem))
//Clase oWSextras (Factura_Detalle)
oWS:oWSextras := Service_ArrayOfExtras():New()
oWSExtDet := Service_Extras():NEW()
oWSExtDet:ccontrolInterno1 := "NO. SERIE"
oWSExtDet:cnombre := "1"
oWSExtDet:cpdf := "1"
oWSExtDet:cvalor := SD2->D2_NUMSERI
oWSExtDet:cxml := "1"
aAdd(oWS:oWSextras:oWSextras,oWSExtDet)
EndIf
EndIf
Return Nil

En el punto de entrada de ejemplo se llenan atributos que son opcionales a nivel documento y a nivel detalle, realizando la bifurcación mediante el parámetro Opción (PARAMIXB[6]).

IMPORTANTE:

Si no se encuentran los activados los atributos de una clase, es necesario hacerlo de la siguiente manera Service_TerminosDeEntrega():New() haciendo uso del método New.
Se puede hacer uso de los nodos del XML estándar generado desde protheus recibido en el parámetro Objeto del XML (PARAMIXB[5]).
Hacer uso de la variable cEspecie para definir regla de negocio por tipo de documento (NF, NDC o NCC).

Clases disponibles:

Nombre	WSLD Data
Anticipos	Service_ArrayOfAnticipos
	Service_Anticipos
Autorizado	Service_Autorizado
Cargos/Descuentos	Service_ArrayOfCargosDescuentos
	Service_CargosDescuentos
Condición de Pago	Service_ArrayOfCondicionDePago
	Service_CondicionDePago
Documentos referenciados	Service_ArrayOfDocumentoReferenciado
	Service_DocumentoReferenciado
Extras	Service_ArrayOfExtras
	Service_Extras
Medios de Pago	Service_ArrayOfMediosDePago
	Service_MediosDePago
Tasa de cambio alternativa	Service_TasaDeCambioAlternativa
Términos de entrega	Service_TerminosDeEntrega
Entrega de mercancía	Service_Entrega
Información adicional	Service_ArrayOfLineaInformacionAdicional
	Service_LineaInformacionAdicional
Detalle Factura	Service_ArrayOfFacturaDetalle
	Service_FacturaDetalle

2.7.3 Ejemplo de utilización

En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Facturación | Facturaciones (MATA467N).

Informar en los parámetros:
- ¿Normal/Benef? = Normal
Incluir un nuevo documento e informar en el encabezado el Cliente (F2_CLIENTE), Loja (F2_LOJA), Núm. Doc (F2_DOC), Serie (F2_SERIE)
Indica en el campo Tipo Oper. (F2_TIPOPE).
Informar el detalle del documento, utilizando un Tipo de Salida/Entrada con calculo de autorretención (Las autoretenciones no suman ni restan al valor bruto del documento).
Una vez que se han informado todos los datos presionar Grabar para confirmar el guardado del documento.

En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Facturación | Facturación Electrónica (MATA486).

Informar en los parámetros:
1. ¿Tipo de documento? = Factura
2. ¿Serie? = Serie de la Factura de Salida incluida anteriormente.
3. ¿Estatus? = vacío o cero.
4. ¿Fecha Inicial? / ¿Fecha Final? = Rango que contemple la fecha de emisión de la Factura de Salida.
Ejecutar la acción Transmitir, e informar los parámetros:
- ¿Serie de Factura? = Serie de la Factura de Salida incluida anteriormente.
- ¿Factura Inicial? / ¿Factura Final? = Rango que contemple la fecha de emisión de la Factura de Salida.
Validar que el proceso de transmisión sea exitoso.
Validar que se hayan enviado los datos definidos en el punto de entrada.

IMPORTANTE: Si se requiere sean impresos en el PDF de The Factory KHA, y los datos son enviados pero no se visualizan en el formato, es un tema que deberá ser tratado directamente con el proveedor tecnológico.

Árvore de páginas

Versões comparadas

Versão antiga 180

Nova versão 181

Chave

1. REQUERIMIENTOS

1.1 Procedimientos de Implantación

1.2 Actualizaciones del compatibilizador

1.3 Procedimiento de Utilización

2. BITÁCORA DE CAMBIOS

2.1 FACTURA ELECTRÓNICA VALIDACIÓN PREVIA

2.1.1 Visión general

2.1.2 Ejemplo de utilización.

a) Pantalla de factura electrónica

b) Otras Acciones / Acciones relacionadas

c) Impresión de documentos electrónicos

2.1.3 Diccionario de datos

2.2 PUNTO DE ENTRADA ADICIÓN DE CAMPOS A XML
Âncora
PE01
PE01

2.2.1 Visión general

2.2.2 Ejemplo de utilización

a) Ejemplo de Punto de Entrada M486CEXT

b) Ejemplo de documento electrónico generado por TFHKA con campos extensibles

c) Ejemplo de documento electrónico en PDF generado por TFHKA con campos extensibles

2.3 PUNTO DE ENTRADA EXPORTACIÓN CAMPOS TRM
Âncora
PE02
PE02

2.3.1 Visión General

2.3.2 Ejemplo de utilización

a) Ejemplo de Punto de Entrada M486CEXT - Campos extensibles.

2.4 OBLIGATORIEDAD DOCUMENTOS REFERENCIADOS (NDC/NCC)
Âncora
PE02
PE02

2.4.1 Visión General

2.4.2 Configuraciones Previas

2.4.3 Ejemplo de utilización

2.5 PUNTO DE ENTRADA ANULACIÓN DE VALIDACIÓN DOC. RELACIONADO - M465DORIFE (NCC/NDC)

2.6 AUTORRETENCIONES

2.6.1 Visión General

2.6.2 Configuraciones Previas

2.6.3 Ejemplo de utilización

2.7 PUNTO DE ENTRADA PARA ATRIBUTOS OPCIONALES (M486OWSCOL)

2.7.1 Visión General

2.7.2 Configuraciones Previas

2.7.3 Ejemplo de utilización

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 180

Nova versão 181

Chave

1. REQUERIMIENTOS

1.1 Procedimientos de Implantación

1.2 Actualizaciones del compatibilizador

1.3 Procedimiento de Utilización

2. BITÁCORA DE CAMBIOS

2.1 FACTURA ELECTRÓNICA VALIDACIÓN PREVIA

2.1.1 Visión general

2.1.2 Ejemplo de utilización.

a) Pantalla de factura electrónica

b) Otras Acciones / Acciones relacionadas

c) Impresión de documentos electrónicos

2.1.3 Diccionario de datos

2.2 PUNTO DE ENTRADA ADICIÓN DE CAMPOS A XML ÂncoraPE01PE01

2.2.1 Visión general

2.2.2 Ejemplo de utilización

a) Ejemplo de Punto de Entrada M486CEXT

b) Ejemplo de documento electrónico generado por TFHKA con campos extensibles

c) Ejemplo de documento electrónico en PDF generado por TFHKA con campos extensibles

2.3 PUNTO DE ENTRADA EXPORTACIÓN CAMPOS TRM ÂncoraPE02PE02

2.3.1 Visión General

2.3.2 Ejemplo de utilización

a) Ejemplo de Punto de Entrada M486CEXT - Campos extensibles.

2.4 OBLIGATORIEDAD DOCUMENTOS REFERENCIADOS (NDC/NCC) ÂncoraPE02PE02

2.4.1 Visión General

2.4.2 Configuraciones Previas

2.4.3 Ejemplo de utilización

2.5 PUNTO DE ENTRADA ANULACIÓN DE VALIDACIÓN DOC. RELACIONADO - M465DORIFE (NCC/NDC)

2.6 AUTORRETENCIONES

2.6.1 Visión General

2.6.2 Configuraciones Previas

2.6.3 Ejemplo de utilización

2.7 PUNTO DE ENTRADA PARA ATRIBUTOS OPCIONALES (M486OWSCOL)

2.7.1 Visión General

2.7.2 Configuraciones Previas

2.7.3 Ejemplo de utilización

2.2 PUNTO DE ENTRADA ADICIÓN DE CAMPOS A XML
Âncora
PE01
PE01

2.3 PUNTO DE ENTRADA EXPORTACIÓN CAMPOS TRM
Âncora
PE02
PE02

2.4 OBLIGATORIEDAD DOCUMENTOS REFERENCIADOS (NDC/NCC)
Âncora
PE02
PE02