Histórico da Página
...
2.22 Transmisión Electrónica en el guardado de los Documentos.
Producto |
| |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Línea de producto: |
| |||||||||||
Segmento: |
| |||||||||||
Módulo: | SIGAFAT - Facturación | |||||||||||
Función: |
|
| ||||||||||
País: | Colombia (pacote 014357) | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
Ticket: | No aplica (Pacote: 014412) | |||||||||
Requisito/Story/Issue (informe el requisito vinculado): | DMINA-23953 |
SITUACIÓN/REQUISITO
Al finalizar la inclusión de una Factura de Venta (NF), Nota de Crédito de Cliente (NCC), Nota de Débito de Cliente (NDC), Documento Soporte (NF), Nota de Ajuste de Crédito (NCP) y Nota de Ajuste de Débito (NDP), se debe permitir la tranmisión electrónica de los documentos.
...
Para la funcionalidad del parámetro MV_CFDUSO, se tienen las siguientes reglas:
Valor | Comportamiento |
---|---|
1 | Preguntará si se quiere transmitir el documento una vez finalizado el registro, si es afirmativa la respuesta, también preguntará si se realizará el envío por mail. |
2 | Preguntará si se quiere transmitir el documento una vez finalizado el registro, y si no hubo errores, enviará por mail el documento sin preguntar. |
3 | No preguntará si se quiere transmitir el documento una vez finalizado el registro, lo transmitirá y realizará el envío por mail del documento sin preguntar. |
Aviso | ||
---|---|---|
| ||
Si el parámetro MV_CFDUSO, contiene un valor diferente de 1, 2, 3, vacio o no existe, no se realizará el proceso de transmisión electrónica al guardar los documentos de tipo Factura de Venta (NF), Nota de Crédito de Cliente (NCC), Nota de Débito de Cliente (NDC), Documento Soporte (NF), Nota de Ajuste de Crédito (NCP) o Nota de Ajuste de Débito (NDP). Las Facturas de Venta (NF), generadas a partir del Pedido de Venta desde la rutina de Generación de Notas (MATA468N), deben ser transmitidas desde la rutina de Documentos Electrónico (MATA486). |
2.22.1 Configuraciones previas
En la sección [XXX INVOICE_FIN] del archivo FATECOL.INI agregar la siguiente línea:
Configurar el siguiente parámetro:
Nombre de la Variable | MV_CFDUSO |
Tipo | C - Caracter |
Descripción | Indica modo de trans. electrónica al guardar doc., 1-Confirma trans. y envío,2-Confirma trans. y envío automático, 3-trans. y envío automático. |
Valor Estándar | 0 |
2.22.2 Ejemplo de utilización
a) Parámetro MV_CFDUSO igual a 1
...
- Configurar el parámetro MV_CFDUSO con el valor 1.
- En el módulo Facturación (SIGAFAT), menú Actualizaciones | Facturación | Facturaciones (MATA467N).
- Incluir una Factura de Venta (NF).
- Informar los datos del Encabezado e ítems.
- Presionar el botón Grabar, para realizar el grabado de la Factura.
- Confirmar la transmisión del documento:
Informações title Información Si el usuario selecciona la opción No en la confirmación de la Transmisión Eletrónica, no se realiza la validación para la transmisión, generación del XML, transmisión del documento electrónico, y no se visualiza la pregunta de confirmación de envío por email.
Confirmar el envío por mail del documento electrónico.
Informações title Información Si el usuario selecciona la opción No en la confirmación del envío por email, no se realiza el proceso de envío de email una vez finalizado el proceso de transmisión.
El envío de email, es un proceso que es realizado por el Proveedor Tecnológico denominado The Factory HKA, durante el proceso de transmisión electrónica.
- Una vez que se realizó la validación, generación del XML y transmisión del documento electrónico, se visualiza el aviso que informa que la Factura de Venta Electrónica fue Autorizada.
b) Parámetro MV_CFDUSO igual a 2
...
- Configurar el parámetro MV_CFDUSO con el valor 2.
- En el módulo Facturación (SIGAFAT), menú Actualizaciones | Facturación | Facturaciones (MATA467N).
- Incluir una Factura de Venta (NF).
- Informar los datos del Encabezado e ítems.
- Presionar el botón Grabar, para realizar el grabado de la Factura.
Confirmar la transmisión del documento:
Informações title Información Cuando el parámetro MV_CFDUSO está configurado con el valor 2, no se visualiza pregunta para confirmar el envío de mail ya que este proceso se realiza en automático, enviando el documento autorizado al correo que fue informado en el campo E-Mail (A1_EMAIL) del Cliente.
El envío de email, es un proceso que es realizado por el Proveedor Tecnológico denominado The Factory HKA, durante el proceso de transmisión electrónica.
- Una vez que se realizó la validación, generación del XML y transmisión del documento electrónico, se visualiza el aviso que informa que la Factura de Venta Electrónica fue Autorizada.
c) Parámetro MV_CFDUSO igual a 3
...
- Configurar el parámetro MV_CFDUSO con el valor 3.
- En el módulo Facturación (SIGAFAT), menú Actualizaciones | Facturación | Facturaciones (MATA467N).
- Incluir una Factura de Venta (NF).
- Informar los datos del Encabezado e ítems.
Presionar el botón Grabar, para realizar el grabado de la Factura.
Informações title Información Cuando el parámetro MV_CFDUSO está configurado con el valor 3, se realiza en automático el proceso de transmisión electrónica y envío de email.
El envío de email, es un proceso que es realizado por el Proveedor Tecnológico denominado The Factory HKA, durante el proceso de transmisión electrónica.
- Una vez que se realizó la validación, generación del XML y transmisión del documento electrónico, se visualiza el aviso que informa que la Factura de Venta Electrónica fue Autorizada.
2.23 Tag Obligatorias en XML de Factura por mandato(Tipo operación 11 - Mandato)
Producto | TOTVS Backoffice | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Línea de producto: | Línea Protheus | ||||||||||||||||||
Segmento: | Backoffice | ||||||||||||||||||
Módulo: | SIGAFAT - Facturación | ||||||||||||||||||
Función: |
| ||||||||||||||||||
País: | COL (pacote 014724) | ||||||||||||||||||
Ticket: | 21140115 | ||||||||||||||||||
Requisito/Story/Issue (informe el requisito vinculado): | DMICNS-21549 |
SITUACIÓN/REQUISITO
Se realiza la generación de una factura de venta desde la rutina de Facturaciones (MATA467N), informando el campo Tipo Oper. (F2_TIPOPE) con el valor "11" para indicar que se trata de una factura de venta por mandato.
Se identifica que al realizar la transmisión de la factura, ya sea desde la rutina Transmitir Factura electrónica (MATA486) o directamente desde la rutina Facturaciones (MATA467N), el SOAP-REQUEST generado por el sistema no contiene todos los tags que indica the factory para la transmisión de este documento.
De acuerdo con la documentación proporcionada por The Factory, las etiquetas obligatorias para este tipo de documento con operaciones por mandato a nivel detalle de la factura son las siguientes:
- idEsquema
- mandatorioNumeroIdentificacion
- mandatorioNumeroIdentificacionDV
- mandatorioTipoIdentificacion
Informações | ||
---|---|---|
| ||
Para más información puede consultar la siguiente documentación proporcionada por The Factory: |
SOLUCION
Dentro de la rutina de Carga de catálogos(FISA814), se realizan los siguientes ajustes:
- En la función encargada de crear los catálogos para país Colombia (f814CatCol), se realiza la creación de la estructura y la carga de datos de la nueva tabla "S022 - Mandatorios", para que el usuario pueda informar los datos que serán presentados en las etiquetas mandatorioNumeroIdentificacion, mandatorioNumeroIdentificacionDV y mandatorioTipoIdentificacion del SOAP-REQUEST.
Dentro de la rutina Funciones Documentos Fiscales(LOCXCOL), se realizan los siguientes ajustes:
- Se crean la nueva función aVldMdCol, la cual está encargada de validar que los productos tengan informado el campo Cod. Mandato (B1_CODMAN) con un código de la nueva tabla "S022 - Mandatorios" cuando el tipo de operación informada en el encabezado del pedido de venta (C5_TIPOPE) o en el encabezado de la factura de venta (F2_TIPOPE) sea igual a "11". En caso de que existan productos no cuenten con Cod. Mandato(B1_CODMAN) informando, se manda un mensaje al usuario para que confirme o no el proceso de guardado.
- Se crea la nueva función a410TudOkCol, la cual se encargara de realizar las validaciones específicas para Colombia al momento de guardar o editar algún pedido de venta.
- Dentro de la nueva función a410TudOkCol y en la función NfTudOkCol, se realiza el llamado a la nueva función aVldMdCol cuando el campo Tipo Oper.(C5_TIPOPE | F2_TIPOPE) es igual a "11 - Mandato".
Dentro de la rutina Funciones genéricas para Pedidos de Venta (MATV410A), se realizan los siguientes ajustes:
- Se realiza el llamado a la nueva función a410TudOkCol para el país Colombia.
Dentro del archivo Estructura del XML de Documentos de Salida(FATSCOL), se realiza los siguientes ajustes:
- Se agrega una nueva etiqueta llamada cbc:IDMandatory a nivel detalle de factura, la cual toma el valor del campo Cód Mandato (B1_CODMAN) y solo se mostrará cuando el campo Cód Mandato (B1_CODMAN) exista y no este vacío.
Dentro de la rutina Funciones Genéricas de Facturación Electrónica de Colombia(M486XFUNCO), se realizan los siguientes ajustes:
- En la función para Llenado de oWSdetalleDeFactura solicitado por TheFactory HKA(M486DETDOC), se realiza el ajuste para generar las tags idEsquema, mandatorioNumeroIdentificacion, mandatorioNumeroIdentificacionDV y mandatorioTipoIdentificacion tomando en cuenta el código informando de la etiqueta cbc:IDMandatory del XML generado por el archivo FATSCOL.INI para buscar la información en el nuevo catálogo S022 - Mandatorios.
2.23.1 Configuraciones previas
a) Configuraciones de diccionario y archivo FATSCOL.INI:
Archivo FATSCOL.INI:
Se requiere editar el script actual de generación de archivo XML, actualizando las secciones de acuerdo al siguiente modelo, en donde se agregaron o fueron modificadas líneas para integrar esta nueva funcionalidad.
Informações | ||
---|---|---|
| ||
En el apartado de [XXX INICIALIZACION] agregar la validación para comprobar si existe el nuevo campo B1_CODMAN : (PRE) _aTotal[034] := IIF(SB1->(ColumnPos("B1_CODMAN")) > 0, .T., .F.) En el apartado de [SD2 INVOICE], agregar la referencia al nuevo campo B1_CODMAN para que cuando exista y no este vacio se genere la nueva tag cbc:IDMandatory: (PREREG) (_aTotal[001] += IIF( _aTotal[034] .And. !Empty(SB1->B1_CODMAN),' <cbc:IDMandatory>'+AllTrim(SB1->B1_CODMAN)+'</cbc:IDMandatory>' + ( chr(13)+chr(10) ),""),.T.) |
Creación de campos en el archivo SX3 - Campos:
Campo | B1_CODMAN |
---|---|
Tipo | C - Caracter |
Tamaño | 3 |
Decimal | 0 |
Picture | @! |
Título | Cód Mandato |
Descripción | Código Mandatorio |
Val Sistema | Vazio() .Or. ValidF3I("S022", M->B1_CODMAN,1,3) |
Utilizado | Si |
Obligatorio | No |
Browse | No |
Help | Indica el código de mandatorio de la tabla S022 - Mandatorios al que pertenece el producto. Para las facturas por mandato es necesario informar este campo para generar las tags idEsquema, mandatorioNumeroIdentificacion, mandatorioNumeroIdentificacionDV y mandatorioTipoIdentificacion |
Creación de consulta COL022 en el archivo SBX - Consultas:
Alias | Tipo | Secuencia | Columna | Descripción | Contenido |
COL022 | 1 | 01 | RE | Mandatorios | F3I |
COL022 | 2 | 01 | 01 | Mandatorios | F812SXB("S022","Codigo") |
COL022 | 5 | 01 | VAR_IXB |
b) Pre-condiciones
Aplicar el parche correspondiente al issueDMICNS-21549
- Validar que las rutinas actualizadas correspondan a las indicadas en la sección Función del punto 01. DATOS GENERALES
- Realizar un respaldo del archivo FATSCOL.INI que se encuentra en la ruta configurada en el parámetro MV_CFDFTS.
- Tener los ajustes necesarios para poder realizar la transmisión de documentos electrónicos: Facturación Electrónica
- En el módulo Facturación(SIGAFAT), ir al menú Actualizaciones | Archivos | Clientes.
- Configurar un Cliente con los valores estandar.
- En el módulo Facturación(SIGAFAT):
- Ir al menú Actualizaciones | Archivos | Definición de Catálogos
- Al entrar a la rutina se creará de forma automatica el nuevo catálogo S022 - Mandatorios como se muestra en la siguiente imágen:
- Ir al menú Actualizaciones | Archivos | Mantenimiento de Catálogos
- Ingresar los datos en el nuevo catálogo
- En el módulo de Facturación(SIGAFAT), ir al menú Actualizaciones | Archivos | Productos
- Configurar para los productos a utilizar el campo Cód Mandato(B1_CODMAN) con un código de mandatorio del nuevo catálogo S022 - Mandatorios.
2.23.2 Ejemplo de utilización
En el módulo Facturación (SIGAFAT):
- Ir al menú Actualizaciones | Facturación | Facturaciones (MATA467N).
- Incluir una nueva Factura de Venta (NF).
- Informar en el encabezado Cliente configurado previamente.
- Informar en el encabezado el campo Tip Oper.(F2_TIPOPE) con valor igual a "11 - Mandatos".
- Informar en el detalle el o los Productos configurados previamente.
- Grabar la factura.
- Ir al menú Actualizaciones | Facturación | Transmisión Electrónica (MATA486).
- Realizar la transmisión de la Factura de Venta
- Validar que en el SOAP-REQUEST las nuevas etiquetas idEsquema, mandatorioNumeroIdentificacion, mandatorioNumeroIdentificacionDV y mandatorioTipoIdentificacion se muestren correctamente a nivel detalle de factura y que la transmisión sea exitosa.
3. PROBLEMAS COMUNES
3.1 Facturas de Venta
...