Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DATOS GENERALES


Producto

Solucoes_espanhol
SolucaoTOTVS Backoffice

Línea de producto: 

Linhas_totvs_espanhol
LinhaLínea Protheus

Segmento:

Segmentos_totvs_espanhol
SegmentoBackoffice

Módulo:

SIGAFAT - Facturación

Función:
RutinaNombre TécnicoFecha
MATA486Documentos Electrónicos17/04/2023
M486XFUNCOFunciones Genéricas de Documentos Electrónicos (Colombia)17/04/2023
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.

Image Added

Un Punto de Entrada, que permita agregar nuevas opciones de Leyendas para la pantalla de Documentos Electrónicos (MATA486).

Image Added

Un Punto de Entrada, que permita visualizar las nuevas Leyendas en el Browse de la pantalla de Documentos Electrónicos (MATA486).

Image Added


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.


Totvs custom tabs box
tabsPaso 01, Paso 02Pre-condiciones, Procedimiento, Paso 03, Paso 04
idspaso1,paso2
Totvs custom tabs box items
defaultyes
referenciapaso1
  1. Realizar un respaldo del repositorio (RPO).
  2. Aplicar el parche correspondiente al issue DMINA-19333.
  3. Validar que las rutinas actualizadas en el repositorio, coincidan con las descritas en el encabezado del presente Documento Técnico, así como las fechas.
  4. Compilar en el repositorio del ambiente los Puntos de Entrada M486FEADJU, M486PELEYE y M486PESTA.
  5. 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
  6. En el módulo Facturación (SIGAFAT), ir al menú Actualización | Facturación | Facturaciones (MATA467N).
  7. Incluir una Factura de Venta (NF), informado el Encabezado y Detalle.
Totvs custom tabs box items
defaultno
referenciapaso2
  1. En el módulo Facturación (SIGAFAT), ir al menú Actualización | Facturación | Documentos Electrónicos (MATA486).
  2. 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.
  3. Ejecutar la acción Transmitir.
  4. 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>
  5. 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.
  6. En Otras acciones ejecutar la acción Leyendas.
  7. Validar que se visualicen nuevas leyendas que hayas sido agregadas a partir del Punto de Entrada M486PELEYE.
  8. 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_BRANCOBlanco
BR_CINZAGris
BR_LARANJAAnaranjado
BR_MARROMMarrón
BR_PINKRosa
BR_PRETONegro
BR_VIOLETAVioleta
BR_VERDE_ESCUROVerde Oscuro
BR_AZUL_CLAROAzul Claro


Ejemplo del Punto de Entrada M486PEADJU:

Bloco de código
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
Informações

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:

Bloco de código
User Function M486PELEYE()
	Local aColorPE := {}

	aAdd(aColorPE, {"BR_PINK",OemToAnsi("En espera de adjunto")})

Return aColorPE
Informações

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:

Bloco de código
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
Informações

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.



Card documentos
InformacaoUtilice este box para resaltar información relevante y/o de destaqueLa 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.
Titulo¡IMPORTANTE!


05. ASUNTOS RELACIONADOS