ÍNDICE

  1. Visión general
  2. Descripción
  3. Como usar
  4. Parámetros
  5. Respuesta
  6. Otras informaciones

01. VISIÓN GENERAL

Línea de producto:

Microsiga Protheus®

Segmento:

Servicios

Módulo:

SIGAFIS - Libros fiscales

Función:

MaFisRet

Alcance:

Microsiga Protheus 12

Versiones:

Microsiga Protheus 12

Sistemas operativos:

Todos

Compatible con las Bases de datos:

Todas

Nivel de acceso:

Nivel 1 (Acceso Clientes)

Idiomas:

Todos

02. DESCRIPCIÓN

La Función MaFisIniLoad devuelve el contenido en el caso de valores de impuestos, por ejemplo devolverá los valores calculados de la referencia fiscal informada en el parámetro cCampo. Al informar referencias “IT_” y “LF_” los valores devueltos serán del ítem informado en el parámetro nItem, array interno aNFItem y referencias “NF_” devolverán contenidos del array interno aNFCab, de esta manera dispensan la información de nItem


Así se puede considerar que:

  • nItem: Es el ítem del documento, si la información fuera referente a un ítem. Si fuera una información del encabezado, no es necesario transmitir la información.
  • cCampo: Es un texto fijo que corresponde a una información de la factura.
  • aTrbGen: Es un array bidimensional que corresponde a valores de los tributos genéricos calculados por el configurador de tributos.

03. CÓMO UTILIZAR

Se utiliza prácticamente en todos los tipos de aplicación, sirve para obtener el valor de impuestos calculados por MATXFIS en el momento de la activación de la función y/o cualquier otro contenido de los array de encabezado e ítems internos de MATXFIS, también puede utilizarse para obtener valores del libro fiscal, referencia fiscal “LF_”, y obtener valores como el ‘Valor contable” y otros valores que no son propios del ítem.

Están disponibles diversas referencias válidas y para identificarlas realice los siguientes pasos:

1 - Sabiendo en qué Tabla/Campo se grabará el valor al final del procesamiento, es posible encontrar la referencia en el diccionario de datos, en el campo X3_VALID.

2 - Utilice la función: MaFisRelImp(cProg,aAlias), donde cProg es el programa en ejecución, sin embargo el parámetro puede informarse como "", y aAlias es la tabla donde se efectuará la búsqueda de las referencias, por ejemplo SD2 para el ítem del documento, y SF2 para el encabezado. La devolución será una lista con todas las referencias que se utilizan para la grabación en la tabla.

3 - Para utilizar la búsqueda de un valor del configurador de tributos, es posible llamar la MaFisRet de algumas formas:

  • Resultado genérico:
    • MaFisRet(nItem, "NF_TRIBGEN") // De esta manera, devolverá un array con todas las informaciones de encabezado de los tributos genéricos calculados por el configurador de tributos.
    • MaFisRet(nItem, "IT_TRIBGEN")  // De esta manera, devolver un array con todas las informaciones de ítem de los tributos genéricos calculados por el configurador de tributos.
  • Pude utilizarse el tercer parámetro de la función MaFisRet para devolver el valor de un tributo genérico específico:
    • Ejemplo: MafisRet(nItem,"IT_TRIBGEN",aTrbGen) 

El array aTrbGen puede tener el tamaño 1 o 2:

        • La primera posisión es la sigla del tributo que está buscando.

        • La segunda posición es la referencia del tributo que está buscando.

Ejemplo: {'ICMTEST','TG_IT_BASE'} // Devuelve la base del tributo genérico ICMTEST

Ejemplo: {'ICMTEST','TG_IT_ALIQUOTA'} // Devuelve la alícuota del tributo genérico ICMTEST

Ejemplo: {'ICMTEST','TG_IT_VALOR'} // Devuelve el valor del tributo genérico ICMTEST

Cuando solo se informa la sigla del tributo, devuelve todos los datos del tributo genérico.

          • MaFisRet(nItem, "IT_TRIBGEN", {"ICMTEST"})

Cuando se informa la sigla y la referencia del tributo, solo devuelve el valor de la referencia del tributo genérico.

          • MaFisRet(nItem, "IT_TRIBGEN", {"ICMTEST", "TG_IT_VALOR"})

04. PARÁMETROS

Orden

Parámetro

Tipo

Descripción

01

nItem

Numérico

Número del ítem del array aNfItem obligatorio para referencias “IT_” y “LF” en cCampo

02

cCampo

Carácter

Referencia del campo que desea obtener el valor o contenido de los array aNFCab y aNFItem, informar para referencias del encabezado “NF_xxxxx” y para referencias de los ítems “IT_xxxxx” y “LF_xxxxx” .

03

aTrbGen 

Array

Array bidimensional con las informaciones que desea recibir de los tributos calculados por el configurador de tributos.

05. DEVOLUCIÓN

Orden

Devolución

Tipo

Descripción

01

xContenido de la referencia buscada

Todos de acuerdo con la referencia

Contenido de la referencia Fiscal en los array internos aNFCab y aNFItem en el momento de la activación de la función

06. OTRAS INFORMACIONES

¡Importante!

La función MaFisIni() tiene que utilizarse obligatoriamente en cualquier operación que involucre a MATXFIS, siempre debe utilizarse antes de la carga de cualquier ítem.

Para utilizar esta función, vea esta documentaciónFunción MaFisIni