01. DATOS GENERALES
| Producto | TOTVS Backoffice | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Línea de producto: | Línea Protheus | |||||||||
| Segmento: | Backoffice | |||||||||
| Módulo: | SIGAFAT - Facturación | |||||||||
| Función: |
| |||||||||
| País: | Colombia (COL) | |||||||||
| Ticket: | No aplica | |||||||||
| Requisito/Story/Issue (informe el requisito vinculado): | DMINA-19333 |
02. SITUACIÓN/REQUISITO
En el proceso de Transmisión Electrónica de Documentos para el país Colombia, a través del Proveedor Tecnológico denominado The Factory HKA, se solicitan los siguientes Puntos de Entrada:
Un Punto de Entrada, que permita modificar el atributo Adjuntos, que es informado al realizar la transmisión de documentos y que actualmente se envía con el valor fijo "0", que corresponde a la opción de No se admiten adjuntos.
Un Punto de Entrada, que permita agregar nuevas opciones de Leyendas para la pantalla de Documentos Electrónicos (MATA486).
Un Punto de Entrada, que permita visualizar las nuevas Leyendas en el Browse de la pantalla de Documentos Electrónicos (MATA486).
03. SOLUCIÓN
En la rutina de Documentos Electrónicos (MATA486):
- En la función que Exhibe las Leyendas del Browse (M486LEYEND), se activa el Punto de Entrada M486PELEYE para permitir agregar nuevas opciones de Leyenda al ejecutar la acción Leyendas.
- En la función que Selecciona el Color de Leyenda en el Browse (M486CORES), se activa el Punto de Entrada M486PESTA para permitir agregar nuevas condiciones para la visualización de las Leyendas en el browse.
En la rutina de Funciones Genéricas de Documentos Electrónicos - Colombia (M486XFUNCO):
- En la función que Realiza el llenado de las Clases del Web Services de The Factory (M486XMLHKA), se activa el Punto de Entrada M486PEADJU para permitir modificar el valor que se asignará al atributo Adjuntos que es enviado al momento de consumir el método "Enviar" de las clases disponibles por los Web Services de The Factory.
- Realizar un respaldo del repositorio (RPO).
- Aplicar el parche correspondiente al issue DMINA-19333.
- Validar que las rutinas actualizadas en el repositorio, coincidan con las descritas en el encabezado del presente Documento Técnico, así como las fechas.
- Compilar en el repositorio del ambiente los Puntos de Entrada M486FEADJU, M486PELEYE y M486PESTA.
- Realizar las configuraciones necesarias para la funcionalidad de Transmisión Electrónica de Colombia, para más información ver Documento Técnico de Facturación Electrónica de Validación Previa - Colombia
- En el módulo Facturación (SIGAFAT), ir al menú Actualización | Facturación | Facturaciones (MATA467N).
- Incluir una Factura de Venta (NF), informado el Encabezado y Detalle.
- En el módulo Facturación (SIGAFAT), ir al menú Actualización | Facturación | Documentos Electrónicos (MATA486).
- Informar los siguientes parámetros para el filtrado de los Documentos a transmitir:
- ¿Tipo de Documento? = Seleccionar “Factura”.
- ¿Serie? = <Serie de la Factura a transmitir>.
- ¿Estatus? = Seleccionar la opción “0”, para obtener todos los Documentos, sin realizar filtrado por estatus.
- Informar el rango de Fecha Inicial y Final para considerar el filtrado por la fecha de emisión del Documento a transmitir.
- Ejecutar la acción Transmitir.
- Informar los siguientes parámetros:
- ¿Serie de la Factura? = <Serie de la Factura a transmitir>
- ¿Factura Inicial? = <Folio Inicial de la Factura a transmitir>
- ¿Factura Final? = <Folio Final de la Factura a transmitir>
- Validar que la transmisión haya sido exitosa y que el atributo Adjuntos se haya enviado con valor diferente de "0", obedeciendo la regla de negocio definida en el Punto de Entrada M486PEADJU.
- En Otras acciones ejecutar la acción Leyendas.
- Validar que se visualicen nuevas leyendas que hayas sido agregadas a partir del Punto de Entrada M486PELEYE.
- Validar que en las leyendas mostradas en el Browse de la pantalla de Documentos Electrónicos, se muestren los colores de las condiciones agregadas en el Punto de Entrada M486PESTA.
04. INFORMACIÓN ADICIONAL
Colores disponibles:
| Valor | Color |
|---|---|
| BR_BRANCO | Blanco |
| BR_CINZA | Gris |
| BR_LARANJA | Anaranjado |
| BR_MARROM | Marrón |
| BR_PINK | Rosa |
| BR_PRETO | Negro |
| BR_VIOLETA | Violeta |
| BR_VERDE_ESCURO | Verde Oscuro |
| BR_AZUL_CLARO | Azul Claro |
Ejemplo del Punto de Entrada M486PEADJU:
User Function M486PEADJU()
Local cSerieDoc := PARAMIXB[1] //Serie
Local cNumDoc := PARAMIXB[2] //Numero de Documento
Local cCodCli := PARAMIXB[3] //Código de Cliente
Local cCodLoj := PARAMIXB[4] //Código de la Tienda
Local cPrefijo := PARAMIXB[5] //f-Factura, c-Nota de Crédito, d-Nota de Débito y n - Nota de Ajuste
Local cAdjunto := "0"
cAdjunto := "1"
Return cAdjunto
El Punto de Entrada M486PEADJU recibe como parámetros Serie, Folio, Cliente, Loja y Prefijo (f - Factura, c - Nota de Crédito, d - Nota de Débito y n - Nota de Ajuste) del Documento a transmitir, y debe retornar un valor de tipo String con las opciones permitidas para el atributo Adjuntos, de acuerdo a lo definido por parte del Proveedor Tecnológico denominado The Factory HKA.
Se recomienda inicializar la variable de retorno con el valor "0", para que en caso de no cumplirse la Regla de Negocio, el atributo Adjuntos sea informado como No se admiten adjuntos.
Ejemplo del Punto de Entrada M486PELEYE:
User Function M486PELEYE()
Local aColorPE := {}
aAdd(aColorPE, {"BR_PINK",OemToAnsi("En espera de adjunto")})
Return aColorPE
El Punto de Entrada M486PELEYE, debe retornar un arreglo con 2 posiciones para incluir nuevas Leyendas, donde la primera posición indica el Código del Color y la segunda posición el Texto con el que se visualizará la leyenda.
Ejemplo del Punto de Entrada M486PESTA:
User Function M486PESTA()
Local nTipoD := PARAMIXB //1 = SF2, 2 = SF1 y 3 = SFE
Local aEstatus := {}
If nTipoD == 1
aAdd(aEstatus, {"F2_FLFTEX=='2' .AND. F2_CODMUN =='05001'","BR_PINK"})
ElseIf nTipoD == 2
aAdd(aEstatus, {"F1_FLFTEX=='2' .AND. F1_CODMUN =='05001'","BR_PINK"})
EndIf
Return aEstatus
El Punto de Entrada M486PESTA:
Recibe como parámetro un valor numérico con los valores 1 para utilizar campos de la tabla SF2, 2 para utilizar campos de la tabla SF1 y 3 para utilizar campos de la tabla SFE.
Debe retornar un arreglo con 2 posiciones para condicionar los colores de Leyendas nuevas, donde la primera posición indica el Condición y la segunda posición el Color de la Leyenda.
La presente solución aplica para versión 12.1.33 o superior, y es necesario tener activa la funcionalidad de Transmisión Electrónica a la DIAN a través del Proveedor Tecnológico The Factory.
¡IMPORTANTE!
05. ASUNTOS RELACIONADOS
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas