01. DATOS GENERALES
| Producto | |
|---|
| Línea de producto: | |
|---|
| Segmento: | |
|---|
| Módulo: | SIGAFAT - Facturación |
|---|
| Función: | | Rutina | Nombre | Fecha |
|---|
| MATA486 | Documentos Electrónicos | 26/11/2024 | | autoCOLNfeTrans | Transmisión Electrónica automática de documentos Colombia | 14/11/2024 | | LOCXCOL | Documentos Fiscales Colombia | 26/11/2024 | | WSNFECol | Cliente de servicio web - The Factory | 14/11/2024 |
|
|---|
| País: | COL |
|---|
| Ticket: | NA |
|---|
| Requisito/Story/Issue (informe el requisito vinculado): | DMICNS-21518 |
|---|
02. SITUACIÓN/REQUISITO
Se requiere disponibilizar un JOB, en cual el cliente pueda configurar la trasmisión electrónica de 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) conforme a su regla de negocio.
03. SOLUCIÓN
En la rutina de Documentos Fiscales - Colombia (LOCXCOL):
Dentro de la función LxTraCOL, se agregan validaciones para cuando se realiza la ejecución del JOB, se realice correctamente la transmisión de los documentos electrónicos.
En la rutina de Documentos Electrónicos (MATA486):
Dentro de las funciones "Realiza Pre-validación de Datos para Transmisión (M486VLDDOC)" y "Genera el Log de transmisión electrónica (M486GENLOG)", se agrega un parámetro que reciben recibe dichas funciones para saber cuando se esta ejecutando el JOB. Se agregan bifurcaciones para que el proceso se ejecute correctamente al validar los datos de transmisión y generar el log del proceso cuando se esta ejecutando la transmisión electrónica desde JOB.
Se crea la nueva rutina Transmisión Electrónica automática de documentos Colombia (autoCOLNfeTrans), la cual permite la ejecución de la transmisión electrónica de Colombia por medio del nuevo Schedule.
En dicha rutina se manda llamar la función LxTraCOL para cada serie y especie informada en el nuevo grupo de preguntas y que este configurada en la tabla SFP - Control de Formularios.
| Totvs custom tabs box |
|---|
| tabs | Pre-condiciones,Configuración Rutina Schedule,Configuración Schedule,Ejecución Schedule |
|---|
| ids | Pre-condiciones,Configuración Rutina Schedule,Configuración Schedule,Ejecución Schedule |
|---|
|
| Totvs custom tabs box items |
|---|
| default | yes |
|---|
| referencia | Pre-condiciones |
|---|
| - Realizar un respaldo del repositorio del ambiente (archivo RPO).
- Realizar un respaldo del archivo de configuración del servidor (appserver.ini)
- Aplicar el parche correspondiente al issue DMICNS-21518.
- Validar que las rutinas actualizadas correspondan a las indicadas en la sección Función del punto 01. DATOS GENERALES
- Tener las configuraciones indicadas en la sección 04. INFORMACIÓN ADICIONAL
- En el archivo de configuración del servidor(appserver.ini), agregar la siguiente información:
- Tener los ajustes necesarios para poder realizar la transmisión de documentos electrónicos: Facturación Electrónica
- En el módulo Libros Fiscales(SIGAFIS), ir al menú Actualizaciones | Archivos | Contr. Formularios
Para la ejecución del proceso por medio del nuevo Schedule, se requiere contar con una rutina compilada en el repositorio como la que muestra a continuación: | Bloco de código |
|---|
| | #INCLUDE 'rwmake.ch'
#INCLUDE 'PROTHEUS.CH'
/*/{Protheus.doc} WFPRUEBA3
Función principal que se debe informar en el Schedule
/*/
Function WFPRUEBA3(aPar)
If IsBlind()
BatchProcess("Teste","Teste",,{ || TSTExec3() })
EndIf
Return Nil
/*/{Protheus.doc} TSTExec3
Función informanda en la función BatchProcess, la cual se ejecutará
conforme a la periodicidad informada en el Schedule.
/*/
Function TSTExec3()
Local cPerg := "MATA486K"
If !Pergunte(cPerg,.T.)
Return .F.
Else
MakeSqlExpr(cPerg)
DSVFAT1(MV_PAR01,MV_PAR02)
Endif
Return
/*/{Protheus.doc} SchedDef
Función requerida para ejecución en el Schedule.
/*/
Static Function SchedDef(- Contar con las series correctamente configuradas para los documentos a transmitir: 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)
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | Configuración Rutina Schedule |
|---|
| - )
Local aParam := {}
aParam := { "P",; //Tipo R para relatorio P para processo
"MATA486K",; //Pergunte do relatorio, caso nao use passar ParamDef
,; //Alias
,; //Array de ordens
""} //Titulo - "Calculo de Depreciacao e Correcao Monetaria"
Return aParam
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | Configuración Schedule |
|---|
| En el módulo Configurador (SIGACFG): Ir al menú menú Entorno| Schedule| Schedule En la nueva pantalla, seleccionar la opción "Agenda":  Image Removed Image Added
Dar clic en "Nuevo", posteriormente informar el nombre de la rutina WFAUTOTRAN que se va a ejecutar:  Image Removed Image Added
A continuación se debe confirmar la periodicidad con la que se va a ejecutar la rutina: - Unica Única - Solo se ejecutará el día y la hora ingresados en los campos Día y Hora.
- Tarifa diaria
- Opción de frecuencia: Si se marca como sí, se debe ingresar una frecuencia de ejecución en horas o minutos, y debe haber una hora de inicio y finalización para esta ejecución. Si se marca como no, solo debe ingresar una hora para ejecutar el cronograma.
- Opción Recurrente: Si se marca como sí, considera los parámetros de frecuencia para su ejecución. Si se marca como no, solo considera los parámetros de la primera ejecución.
- Semanal
- Opción de frecuencia: Si se marca como sí, se debe ingresar una frecuencia de ejecución en horas o minutos, y debe haber una hora de inicio y finalización. Si marca como no, solo deberá ingresar una única vez. Para ambas opciones se deberá informar los días de la semana de ejecución.
- Opción Recurrente: Si se marca como sí, considera los parámetros de frecuencia para su ejecución. Si se marca como no, solo considera los parámetros de la primera ejecución.
- Mensual
- Opción de frecuencia: Si se marca como sí, se debe ingresar una frecuencia de ejecución en días, horas o minutos, y debe haber una hora de inicio y finalización y un día de inicio y finalización. Si se marca como no, sólo se deberá indicar el día y hora de ejecución.
- Opción Recurrente: Si se marca como sí, considera los parámetros de frecuencia para su ejecución. Si se marca como no, solo considera los parámetros de la primera ejecución.
 Image Removed Image Added
Al elegir la opción "Tarifa diaria", se mostrará la siguiente información:  Image Removed Image Added
Posteriormente, se requiere informar los datos de la Empresa, Sucursal, Módulo y Usuario.. | Informações |
|---|
| Si se requiere que el JOB se ejecute para varias Empresas y Sucursales, es necesario Incluir una agenda para cada sucursal por separado. |
 Image Added Image Removed
Al dar clic en "Edite parámetros", se mostrará una ventana con las preguntas para informar las especies y las series que serán consideradas al momento de ejecutar el proceso de transmisión electrónica, - ¿Tipo Documento? - Especies de los documentos a ser transmitidos. El número de especie y descripción se obtiene de la tabla genérica 00 - 1E Especies de documentos Transmisión Electrónica.
- ¿ Serie? - Serie de los documentos a ser transmitidos.
NOTA: Importante borrar el contenido de cada pregunta antes de informar la especie y serie usando la consulta estándar. 
 
Al finalizar se mostrará la información de ejecución:  Image Removed Image Added
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | Ejecución Schedule |
|---|
| Al ejecutarse el proceso de transmisión electrónica por medio del Schedule, se generará un Log en la carpeta estándar "system\transmision_auto_log\" con el resumen del proceso como se muestra a continuación: 
|
|
04. INFORMACIÓN ADICIONAL
.
Tablas Genéricas en el archivo SX5 – Tablas Genéricas:
Crear una nueva tabla genérica con las especies de documentos que son transmitidos:
Tabla | 00 |
Clave
| 1E |
Descripción | Especies de documentos Transmisión Electrónica |
Crear nuevos nuevos registros en la tabla 00 - 1E Especies de documentos Transmisión Electrónica
CLAVE | Descripción |
|---|
| 1 | FACTURA/DOCUMENTO SOPORTE |
| 2 | NOTA DE CRÉDITO CLIENTE |
| 3 | NOTA DE DÉBITO CLIENTE |
| 8 | NOTA DE CRÉDITO AJUSTE |
| 9 | NOTA DE DÉBITO AJUSTE |
Consulta Estándar en el archivo SXB – Consulta Estándar:
| Alias | Tipo | Secuencia | Columna | Descripción | Contenido |
| ESPDOC | 1 | 01 | DB | Especie Transm Elect | SX5 |
| ESPDOC | 2 | 01 | 01 | Codigo |
|
| ESPDOC | 4 | 01 | 01 | Codigo | X5_CHAVE |
| ESPDOC | 4 | 01 | 02 | Descripcion | X5_DESCRI |
| ESPDOC | 5 | 01 |
|
| Alltrim(X5_CHAVE) |
| ESPDOC | 6 | 01 |
|
| 1E |
Creación de Preguntas en el archivo SX1 – Archivo de Preguntas:
Grupo: MATA486K
Orden | 01 | 02 |
Pregunta | ¿Tipo de Documento? | ¿Serie? |
Tipo | C | C |
Tamaño | 12 | 50 |
Variable | MV_PAR01 | MV_PAR02 |
Validación |
|
|
Objeto | R -Rango | R -Rango |
Consulta Estándar | ESPDOC | SERNF |
Contenido | FP_ESPECIE | FP_SERIE |
| Informações |
|---|
| title | Pacote Diccionario (uso exclusivo interno) |
|---|
|
Código: 014812
Pacote: MI - DMICNS-21518 - COL TRANSMISIÓN AUTO |
| Informações |
|---|
| title | Configuración Punto de Entrada |
|---|
|
| Si el usuario lo requiere se puede realizar una personalización en la transmisión de documentos por medio del punto de entrada MAUTOTRAN |
| Card documentos |
|---|
| Informacao | La presente solución aplica para versión 12.1.2210 con garantía extendida o superior. |
|---|
| Titulo | ¡IMPORTANTE! |
|---|
|
05. ASUNTOS RELACIONADOS
