01. DATOS GENERALES
| Producto | |
|---|
| Línea de producto: | |
|---|
| Segmento: | |
|---|
| Módulo: | SIGAFAT - Facturación |
|---|
| Función: | | Rutinas | Nombre Técnico | Fecha |
|---|
| MATA486 | Documentos Electrónicos | 29/07/2022 | | M486XFUN | Funciones genéricas para generación de XML para país Colombia | 29/07/2022 | | M486PDFCOL | Impresión de Representación Impresa Facturación Electrónica Colombia | 29/07/2022 |
|
|---|
| País: | Colombia (COL) / Pacote atusx: 010898 |
|---|
| Ticket: | 14200456 |
|---|
| Requisito/Story/Issue (informe el requisito vinculado): | DMINA-15818 |
|---|
02. SITUACIÓN/REQUISITO
En la rutina de Documentos Electrónicos (MATA486), se solicita la funcionalidad en el proceso estándar de Transmisión Electrónica para realizar el envío automático de los archivos en formato XML y PDF vía Email.
03. SOLUCIÓN
En la rutina de Documentos Electrónicos (MATA486):
- Se cambia el nombre la acción "Imprimir PDF" para que se visualice como "Imprimir PDF / Envío por Email".
- Se realizó ajuste en la función que Genera log de la transmisión electrónica (M486GENLOG), para que al realizarse la transmisión electrónica si se activa la funcionalidad del envío de mail mediante el nuevo parámetro ¿Envío de Email? con opción Si, si el cliente no tiene configurado el email en el campo Email (A1_EMAIL) o el campo Email Recep. (AI0_RECE) se informe al Cliente que no se envío el email en el log de la transmisión.
En la rutina de Funciones genéricas para generación de XML para país Colombia (M486XFUNCO):
- Se modificó la Función para llenado del objeto oWSfactura solicitado por TheFactory HKA, con datos obtenidos del XML (M486XMLHKA) para que si existe el parámetro ¿Envío de Email? (MV_PAR06) y está informado con la opción Si, se envíen los siguientes atributos al web services de The Factory HKA:
En la clase Destinatarios:
El atributo canalDeEntrega sea informado con valor 0 (para opción de envío por Email)
El atributo email, donde si existe el campo Email Recep. (AI0_RECE) en los Complementos del Cliente se tome de ahí el para el envío, en caso de no existir o que se encuentre vacío se toma como opción de email de envío el valor configurado en el campo Email (A1_EMAIL).
En la clase Clientes:
El atributo notificar se informa con el valor SI.
En la rutina de Impresión de Representación Impresa Facturación Electrónica Colombia (M486PDFCOL):
- Se modificó la función que Obtiene los valores para envío de Email (ObtEmail), para que en la rutina de Documentos Electrónicos (MATA486), al ejecutar la acción Imprimir PDF / Envío de Email e indicar el parámetro ¿Formato? con la opción E-mail, si existe el campo Email Recep. (AI0_RECE) en los Complementos del Cliente se tome de ahí el para el envío, en caso de no existir o que se encuentre vacío se toma como opción de email de envío el valor configurado en el campo Email (A1_EMAIL).
- Se agregó validación para indicarle al usuario cuando el Cliente de algún documento no está informado cuando se realizará el envío de documentos electrónicos vía Email.
- Realizar un respaldo del repositorio del ambiente (archivo .rpo).
- Aplicar el parche que fue generado para la issue DMINA-15818.
- Validar que las rutinas incluidas en el parche coincidan con las mencionadas en la sección "Función" del encabezado del presente Documento Técnico, así como las fechas.
- Contar con la funcionalidad correspondiente para Facturación Electrónica de Colombia Validación Previa (ver documento técnico de la sección 05. ASUNTOS RELACIONADOS)
- En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Archivos | Productos.
- Incluir uno o varios Productos para la generación de una Factura de Venta (NF).
- En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Archivos | Tipos de Entrada y Salida.
- Incluir el Tipo de Salida (TES) para cálculo de impuestos de la Factura de Venta (NF)
- En el módulo Facturación (SIGAFAT) ir al menú Actualizaciones | Archivos | Clientes.
Configurar el Cliente para la generación de la Factura de Venta (NF). Configurar el Email al cual se realizará el envío al momento de realizar la transmisión electrónica, donde, si desea utilizar el campo Email (A1_EMAIL) del cliente, se debe dejar vacío el campo Email Recep. (AI0_RECE) o no existir dicho campo, ya que en caso contrario será tomado el mail del campo Email Recep. (AI0_RECE). |
|
- Ingresar al módulo Facturación (SIGAFAT) e ir a la menú "Actualización | Facturación | Facturación Electrónica" (MATA486).
- Informar los parámetros:
- ¿Tipo de Documento?: Factura
- ¿Serie?: <Serie de la factura creada en las "Pre-condiciones">
- ¿Estatus?: 0 - No trasmitida
- ¿Fecha Inicial?: <Fecha de inclusión de la factura creada en las "Pre-condiciones">
- ¿Fecha Final?: <Fecha de inclusión de la factura creada en las "Pre-condiciones">
- ¿Envío a Email: Si
- Dar clic en el botón "Trasmitir".
- Informar los parámetros:
- ¿Serie de la Factura?: <Serie de la factura creada en las "Pre-condiciones">
- ¿Factura Inicial?: <Número de Documento de la factura creada en las "Pre-condiciones">
- ¿Factura Final?: <Número de Documento de la factura creada en las "Pre-condiciones">
- Dar clic en "Ok".
- Revisar la bandeja del email configurado para el envío automático, validando que se haya recibido un email que contiene adjuntos en un archivo .zip el XML y PDF del documentos electrónico.
|
- Ingresar al módulo Facturación (SIGAFAT) e ir a la menú "Actualización | Facturación | Facturación Electrónica" (MATA486).
- Informar los parámetros:
- ¿Tipo de Documento?: Factura
- ¿Serie?: <Serie de la factura creada en las "Pre-condiciones">
- ¿Estatus?: 0 - No trasmitida
- ¿Fecha Inicial?: <Fecha de inclusión de la factura creada en las "Pre-condiciones">
- ¿Fecha Final?: <Fecha de inclusión de la factura creada en las "Pre-condiciones">
- ¿Envío a Email: Si
- Dar clic en el botón "Trasmitir".
- Informar los parámetros:
- ¿Serie de la Factura?: <Serie de la factura creada en las "Pre-condiciones">
- ¿Factura Inicial?: <Número de Documento de la factura creada en las "Pre-condiciones">
- ¿Factura Final?: <Número de Documento de la factura creada en las "Pre-condiciones">
- Dar clic en "Ok".
- Revisar la bandeja del email configurado para el envío automático, validando que se haya recibido un email que contiene adjuntos en un archivo .zip el XML y PDF del documentos electrónico.
|
|
04. INFORMACIÓN ADICIONAL
En el grupo de preguntas MATA486:
Orden | 01 | 02 | 03 | 04 | 05 | 06 |
Pregunta
| ¿Tipo de Documento?
| ¿Serie?
| ¿Estatus | ¿Fecha Inicial? | ¿Fecha Final? | ¿Envío a Email? |
Tipo | N
| C | C | D | D | N |
Tamaño | 1 | 3 | 1 | 8 | 8 | 1 |
| Var01 | MV_PAR01 | MV_PAR02 | MV_PAR03 | MV_PAR04 | MV_PAR05 | MV_PAR06 |
Validación |
|
|
|
|
|
|
Objeto | C-Combo | G-Get | G-Get | G-Get | G-Get | C-Combo |
| Consulta Estándar |
| SERNF |
|
|
|
|
| Preselección | 1 |
|
|
|
|
|
| Opciones | Factura
Nota de Debito
Nota de Credito |
|
|
|
| Si No |
Creación de campos en el archivo SX3 – Campos:
Tabla AI0 - Complementos de Clientes.
Campo | AI0_RECE |
Tipo | C |
Tamaño | 30 |
Decimal | 0 |
Formato |
|
Título | Email Recep. |
Descripción | Email para Recepción FE |
Nivel | 1 |
Utilizado | Si |
Obrigatório | No |
Browse | No |
Help | Indica el Email de Recepción (Buzón Tributario de la DIAN), en caso de que no sea el mismo al informado en el campos Email (A1_EMAIL) del Cliente, y será utilizado para el envío automático al transmitir o al realizar el envío desde la opción Imprimir PDF / Envío de Email. |
Envío de Email
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 conexión 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. |
05. ASUNTOS RELACIONADOS