Versões comparadas

Chave

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

Configuración del Job de borrado del documento de salida FATJOBNFE

Producto:

Microsiga Protheus®

Entorno:

Facturación (SIGAFAT)

Ocurrencia:Configuraciones y parametrizaciones del JOB para anulación de la e-Fact y/o e-FactS (FATJOBNFE)

Paso a paso:

Concepto

La funcionalidad del FATJOB está disponible en el módulo SIGAFAT con el objetivo de hacer efectivo el borrado de las Facturas de salida (e-Fact -  Modelo 55 o e-FactS), después de la devolución de anulación autorizada delFisco/Alcaldía. De esta manera, es posible evitar que se borren Facturas si la anulación no es de Autorizado.

Consideraciones

Aviso

El soporte no orienta en la implementación.

Este material es únicamente objeto de apoyo, y orientamos firmemente que se solicite al analista in - loco para implementar la herramienta y homologar el uso en producción.

La implementación primero debe realizarse en un entorno de homologación estándar actualizado y posteriormente en Producción, respetando las debidas copias de seguridad preventivas.

Deck of Cards
idfatjob
Card
idconfig
labelConfiguración

Para configurar el job del Fatjob es necesario:

Expandir
titlePaso 1

1° Configure el parámetro MV_CANCNFE o MV_CANNFSE ( para facturas de servicios) = .T.

Parámetro

Configuración

MV_CANCNFE

.T. para habilitar el FatJobNFe (Cuando .F. permite borrar sin utilizar el JOB)

MV_CANNFSE

Se utiliza para facturas de servicios: .T. para habilitar el FatJobNFe (Cuando .F. permite borrar sin utilizar el JOB)


Expandir
titlePaso 2

2° Configure las claves del Job en el ini del Appserver del Protheus para la ejecución del proceso de anulación que se emitió por e-Fact (modelo 55) o e-FactS:

Clave

Detalle

ENVIRONMENT

Entorno de trabajo al cual pertenece el Job.

nParms

Debe permanecer 2.

parm1

Código de la empresa.

parm2

Código de la sucursal.

START_TIME 

Horario inicial que debe considerarse para la ejecución.

FINISH_TIME 

Horario final que debe considerarse para la ejecución.

INTERVAL

Intervalo de minutos entre las ejecuciones (debe ser mayor o igual a 5).

ACTIVATE

Indica si está activo.


Ejemplo de cómo agregar la sección de las claves en el Ini del AppServer Protheus:

[ONSTART]
JOBS=FatJobNFe_<empresa><sucursal>

[FatJobNFe_<empresa><sucursal>] 
MAIN=FatJobNFe
ENVIRONMENT=<entorno de trabajo>
nParms=2
parm1=<Empresa>
parm2=<Sucursal>
START_TIME=00:00:01
FINISH_TIME=23:59:59
INTERVAL=5
ACTIVATE=ON









Aviso
titleAviso

Vea que en la configuración los signos de menor (<) y mayor (>) deben sustituirse por medio de la siguiente información:
Ejemplo: FatJobNFe_<empresa><sucursal>  = FatJobNFe_9901 (Empresa 99 y Sucursal 01)

Expandir
titleConfiguración de las claves para el entorno Protheus que contenga una Empresa y una Sucursal

No es necesario configurar las claves en el archivo INI del AppServer Protheus. Basta habilitar los parámetros de acuerdo con lo descrito en el paso anterior.

Expandir
titleConfiguración de las claves para más de una sucursal

Si tiene más de una Empresa y Sucursal para configurar el JOB, es necesario configurar una sección del job para cada sucursal, por ejemplo:

[ONSTART]
JOBS=FatJobNFe_9901,FatJobNFe_9902

 

[FatJobNFe_9901] 
MAIN=FatJobNFe
ENVIRONMENT=<entorno de trabajo>
nParms=2
parm1=99
parm2=01
START_TIME=00:00:01
FINISH_TIME=23:59:59
INTERVAL=5
ACTIVATE=ON







 

[FatJobNFe_9902] 
MAIN=FatJobNFe
ENVIRONMENT=<entorno de trabajo>
nParms=2
parm1=99
parm2=02
START_TIME=00:00:01
FINISH_TIME=23:59:59
INTERVAL=5
ACTIVATE=ON







Aviso
titleImportante
    • Si tiene más de una empresa para configuración, es necesario que realice la configuración en cada empresa de forma separada, no hay una centralizadora por empresa;

    Si tiene un entorno con Gestión de empresa, es necesario registrar en el INI una sesión para cada Sucursal, donde los parámetros deben recibir por ejemplo:
    parm1=T1 (Grupo de empresa)
    parm2=D MG 01 (D=Empresa, MG=Unidad, 01=Sucursal)

Dica
titleConsideraciones
  • El Job se registra en el INI del Server Protheus y no en el INI del TSS.

  • Si tiene un entorno con balance de cargas, es decir, APPSERVER Master y Slaves (Balance de carga), es necesario registrar el JOB en el INI de cada servicio, y no en el Master.

  • Son las mismas tags para factura de servicio, lo que diferencia es el parámetro MV_CANNFSE que debe estar habilitado.

  • Verifique si la alcaldía dispone de servicio de anulación. De lo contrario, a diferencia de lo configurado en el parámetro de sistema MV_CANNFSE no existirá la transmisión para la anulación.

  • El fuente UpdFATNFE.PRX solamente era necesario para el uso de la versión 11, a partir de la versión 12, ya no es necesario, basta realizar la configuración del entorno.
Expandir
titleConfiguración del Job por el Schedule

El Schedule Protheus permite que se programen en agenda las rutinas del sistema para que puedan ejecutarse posteriormente, en un período determinado por el usuario. 

Se debe configurar el schedule para ejecutar el proceso de anulación (reversión de los documentos) que se emitieron a través del e-Fact y e-FactS:

1. En la Configuración (SIGACFG), acceda a Entorno/ Schedule/ Schedule.
2. Haga dos clic en Programaciones en agenda.
3. Haga clic en Registro.
4. Haga clic en Incluir.
5. Informe los campos obligatorios.
6. Informe el campo Rutina (XX1_ROTINA) con FATJOBNFE().
7. Haga clic en OK.
8. Haga clic en Confirmar.


Si fuera necesario ejecutar el procedimiento diversas veces, configure por medio de la opción Recurrencia.

Material sobre la configuración del Schedule : Schedule - Cómo programar en agenda la ejecución de rutinas

Aviso

Recomendamos el uso del schedule, esta funcionalidad garantiza el borrado de las facturas que están en procesamiento para anulación. Ejemplo: Si se borra una factura, pero hubo una falla de comunicación con el Fisco, y la factura aún consta en el sistema, el Schedule siempre reprocesa de forma automática y borra cuando se restablezca la comunicación con el Fisco. 

Está funcionalidad es únicamente para facturas que están con el estatus: Esperando anulación, legenda anaranjada.

Es importante resaltar que la configuración del Schedule tiene el consumo de licencias

Card
idProdFat
labelProcesamiento de FATJOBNFE

El procesamiento del Fatjob para borrar el documento de salida se iniciará con base en la información del campo F2_FIMP (Flag de impresión). A continuación, el sistema se comunicará con el TSS, y después del procesamiento, la devolución se registrará en las tablas SPED050 (para facturas del Fisco) o SPED051 (para facturas de la Alcaldía), y en el campo F2_STATUS (estatus de anulación de la NFE).

Existen escenarios mapeados que describen cómo funcionará el procesamiento, dependiendo del estatus de la factura dentro del TSS.

Image Modified


Image Modified



Nota
titleEscenario H

El escenario H de la tabla se refiere al intento de retransmitir la anulación o borrado. Por ejemplo, si se rechaza un intento de anulación, lo que corresponde al escenario G, y este rechazo puede corregirse, es necesario ajustar la causa del rechazo para obtener la devolución de anulación autorizada.



Descripción de las tablas y campos que se consultan antes del procesamiento y los tipos de devolución para cada campo:

Expandir
titleCampo F2_FIMP – Flag de impresión

“  ” - No transmitida
S - Autorizada
T - Transmitida
D - Uso denegado
N - No autorizada

Para más información https://tdn.totvs.com/x/jMBICw

Expandir
titleCampo F2_STATUS – Estatus Anul. eFact

El campo solamente se registra cuando se hace uso del FATJOBNFE

“  ” - No hubo intento de anulación utilizando el FATJOBNFE
015 - Anulación autorizada
025 - Anulación no transmitida (Esperando devolución del Fisco)
026 - Anulación no autorizada
030 - Inutilización de numeración autorizada
036 - Anulación autorizada fuera del plazo

Expandir
titleCampo STATUS Tabla SPED050 - Estatus de la e-Fact

1 = e-Fact Recibida.
2 = e-Fact Firmada.
3 = e-Fact con falla en el schema XML.
4 = e-Fact transmitida.
5 = e-Fact con problemas.
6 = e-Fact autorizada.
7 = Anulación

Expandir
titleCampo STATUSCANC Tabla SPED050 - Estatus Anulación/inutilización

1 = e-Fact Recibida.
2 = e-Fact Anulada.
3 = e-Fact con falla de anulación/inutilización.

Dica
titleComplemento

Después del procesamiento de la anulación de facturas emitidas por el Fisco, además de completar el campo STATUSCANC, también se completa el campo XML_SIGCAN.

Expandir
titleSituación del estatus del Fisco

Definición de los escenarios (Detalles, consultar Manual del contribuyente del Fisco en el enlace: http://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=URCYvjVMIzI

No firmada: TSS identifica falla en el schema y no envía al Fisco
Código TSS: 002 / 029


Inutilizada: Numeración no existe para el Fisco – Ya no podrá utilizarse. Si fuera necesario hacer efectiva la operación, es necesario emitir nuevamente el Documento para transmitir con una nueva numeración.
Código del Fisco: 102 - Inutilización de número homologado
Código TSS: 030


Denegada: Existe algún problema generalmente del Emisor o del Destinatario con el Fisco (Ej: Situación del registro) que impide la Facturación. La numeración tampoco podrá utilizarse.
Códigos Fisco:
110 – Uso denegado
301 - Uso Denegado: Irregularidad fiscal del emisor
302 - Rechazo: Irregularidad fiscal del destinatario
303 - Uso Denegado: Destinatario no habilitado a operar en el Est/Prov/Reg
205 - e-Fact está denegada en la base de datos del Fisco
Código TSS: 013







Rechazada: “N” motivos de error en el documento - Si fuera necesario hacer efectiva la operación, debe corregirse la causa del Rechazo y retransmitir.
Obs: Hay correcciones, para las cuales, también es necesario borrar el documento de salida y emitir nuevamente para que la corrección sea efectiva, como por ejemplo, problemas de cálculo de impuestos, ya que los datos deben corregirse primero en las tablas del ERP, para después enviar correctamente al Fisco.
Códigos Fisco: “N” devoluciones (consultar Manual del contribuyente del Fisco)


Autorizada: Facturación homologada
Código Fisco: 100 - Autorizado el uso de la e-Fact
Código TSS: 001


Anulación autorizada:
Código del Fisco: 101 - Anulación autorizada
Código TSS: 015

Código del Fisco: 155 - Anulación homologada fuera de plazo (extemporáneo). Comúnmente ocasiona la cobranza al Emisor.
Código TSS: 036

Anulación del rechazo:
Códigos Fisco:
252 - Rechazo: Tipo de entorno difiere del entorno del Web Service
578 - Rechazo: La fecha del evento no puede ser mayor que la fecha del procesamiento
577 - Rechazo: La fecha del evento no puede ser menor que la fecha de emisión de la e-Fact
579 - Rechazo: La fecha del evento no puede ser menor que la fecha de autorización para la e-Fact no emitida en contingencia
220 - Rechazo: Plazo de anulación superior al previsto en la legislación
501 - Rechazo: Pedido de anulación intempestivo (superior a 7 días)
690 - Rechazo: Pedido de anulación para e-Fact con e-CT o e-MDF
Código TSS: 017 o 026

Expandir
titleTablas de servicio/Alcaldía

Para Facturas de servicios NFSE, el job consulta la situación y graba la devolución de la anulación en la tabla SPED051, en el campo STATUS:

STATUS= 1 "e-FactS recibida por el TSS"
STATUS= 2 "e-FactS firmada"
STATUS= 3 "e-FactS con error de schema"
STATUS= 4 "e-FactS transmitida"
STATUS= 5 "e-FactS rechazada"
STATUS= 6 "e-FactS autorizada"
STATUS= 7 + STATUSCANC=2 "e-FactS anulada"

Expandir
titleTablas Totvs Colaboración

Para facturas emitidas por medio del Totvs Colaboración, el Fatjob consulta la situación y graba la devolución de la anulación en las tablas:

Tabla CKO -  Graba el estatus de anulación/inutilizado
Tabla CKA - Graba los Lotes X Factura electrónica


Leyendas en el borrado de los documentos de salida

La leyenda en la rutina de borrado de documentos de salida (MATA521) solamente se muestra cuando el parámetro MV_CANCNFE o MV_CANNFSE está activo, con base en el campo F2_STATUS.

mceclip0.pngImage Modified


Blanco: no se tomó ninguna acción;
Esta leyenda indica que la factura no tuvo ningún intento de borrado o anulación por parte del Fatjob.


Verde: Anulación autorizada y con asuntos pendientes de procesos.
Indica que la Anulación está Autorizada, pero existe algún asunto pendiente, en este caso, evalúe la devolución en los campos F2_FIMP, F2_STATUS y en la tabla SPED050, en los campos STATUS y STATUSCANC.


Rojo: Anulación no autorizada.
Indica que hubo un intento de borrado, pero al monitorear la anulación en el Fisco, la devolución "Anulación no autorizada". Por ello, el registro se marca en rojo.

Anaranjada: Esperando anulación
Significa que está esperando la devolución del Fisco, sobre la anulación por medio del job del FATJOBNFE). Esta leyenda ocurre cuando el sistema está intentando comunicarse con el Fisco y no obtiene la devolución.


Opción Refresh

La funcionalidad Refresh tiene la finalidad de reprocesar la comunicación con TSS para transmisión de la anulación, y 
su consecuente borrado, de Facturas que, por algún motivo, no fueron efectivas en la devolución del Fisco / Alcaldía en el primer intento de borrado. Al ocurrir el reprocesamiento por medio del Refresh, la Factura puede anularse y borrarse, o tener su estatus modificado indicando, por ejemplo, un rechazo.

Aviso
titleObservación3

La opción refresh se destina al reprocesamiento en lote de todas las facturas (independientemente de presentarse en filtro de browser, o de tener un flag). Si no fuera la intención, deben seleccionarse la(s) Factura(s) deseada(s) y realizar nuevamente el intento de borrado para que la Factura en cuestión se reprocese.

Dica
titleImportante

Es categóricamente recomendable el uso del Schedule, abordado en esta documentación. El schedule, cuando debidamente configurado, tendrá el mismo comportamiento del "Refresh", reprocesando periódicamente las Facturas, pero, de forma automática, evitando de esta manera la falla humana, ya que no depende de la acción del usuario para reprocesar.

Card
idExemp
labelEjemplo

Ejemplo del procesamiento del Fatjob, cuando la devolución del Fisco sea de Anulación no autorizada:

1- Emisión del documento de salida utilizando TES, Cliente y Producto que muevan las Tablas SF3 y SFT para que esté apta para ser Autorizada por el Fisco.

Image Modified

2- Para transmitir la Factura por medio de la rutina NFESEFAZ > Otras acciones > Transmisión:

Image Modified

3- Para borrar, acceder a la rutina MATA521A – Borrado de documento de salida > Seleccionar la factura > Otras acciones: Borrar.

Image Modified


Al activar la opción "Borrar" en la rutina, el job realiza el monitoreo en el Fisco y evalúa la devolución. En este caso, la devolución fue el código 026, que indica "Anulación no autorizada". De esta manera, la rutina Borrado de documento no permite borrar el registro del Documento de salida, y en la rutina NFESEFAZ, la factura se mantiene con el estatus "Autorizado", de acuerdo con el estatus que consta en el Fisco.

Aviso
titleObservación

El registro de la factura dentro de la rutina Borrado de documento permanecerá marcado de rojo. Esto ocurre porque, cuando el Fisco devuelve, el campo F2_STATUS se informa con el estatus "Anulación no autorizada". Esta situación no afecta otros procesos, como Contabilidad o Registro; el destaque de rojo solo sirve como un indicador que hubo un intento de anulación.


Card
idComple01
labelComplemento
  • FATJOBNFE y MV_SPEDEXC
    El proceso de validación de borrado vía Job se creó, porque solamente la configuración del parámetro MV_SPEDEXC no atendía a las reales necesidades del proceso, ya que en casos de rechazo del borrado por parte del Fisco, la factura ya estaría borrada del sistema. El Job FatJobNFe se desarrolló con la perspectiva de sustituir el tratamiento anterior, por lo tanto, al habilitar este proceso, el sistema deja de validar el parámetro MV_SPEDEXC. Esto ocurre porque, si ambas validaciones estuvieran activas, el parámetro impedirá definitivamente la eliminación de facturas que, por su parte, podrían tener la anulación aceptada por el organismo responsable. No se debe impedir efectivamente la eliminación fuera del plazo, ya que existe la posibilidad de realizar dicha operación (como en casos de anulación extemporánea). Es decir, el Job funciona como una validación del comportamiento del Fisco en el ERP. Si el Fisco permite la anulación, el Job permite el borrado.


  • FATJOBNFE vs. TOTVS TRANSMITE
    La configuración del FATJOBNFE no tiene modificaciones con la llegada del producto TOTVS Transmite, las validaciones del TSS para el uso del JOB son las mismas utilizadas para validar en el ERP. El TOTVS Transmite es un sistema on line, integrado con el ERP Totvs, que facilita la administración de los documentos fiscales electrónicos, la manifestación del destinatario y su almacenamiento con total seguridad.
    En caso de dudas  relacionadas con el Totvs Transmite, entre en contacto con nuestro equipo SPED.
    Para más información: Integración TSS vs. TOTVS Transmite.


  • Validar otras Reglas antes de permitir la eliminación de la factura
    Si desea validar otras particularidades para permitir o no la eliminación del documento de salida, debe utilizarse el punto de entrada para determinar sus propias condiciones / reglas relevantes.
    P.E. sugerido: MS520VLD - http://tdn.totvs.com/display/public/PROT/MS520VLD
    Obs: Si hubiera necesidad de más información o soporte con relación al punto de entrada, entre en contacto con el soporte AdvPL del Protheus.


  • Fisco vs. TSS vs. SPED   
  1. Fisco (Secretaria de Estado da Hacienda) : es el organismo vinculado al Ministerio de Hacienda responsable por el control y estandarización de las reglas referentes a ingresos y gastos de cada Estado/Provincia/Región.
  2.  TSS (TOTVS Service SOA): es la aplicación utilizada por el Protheus para comunicación con el Fisco. Detalles en: TSS0006_Manual_de_configuraciónEl objetivo principal es suministrar los servicios de emisión y mantenimiento de documentos fiscales electrónicos como: Factura electrónica (e-Fact), Conocimiento de transporte electrónico (e-CT), Factura de servicio electrónica (e-FactS), Portada de lote electrónica (Seu), Manifiesto de documentos fiscales electrónicos (e-MDF), Factura electrónica para consumidor final (e-FactC), Manifiesto del destinatario (e-MD).
  3. SPED (Sistema Público de Registro Digital): es la solución tecnológica del Fisco que oficializa la relación entre el Fisco y los contribuyentes, por medio de archivos digitales de registro fiscal y contable, mediante los sistemas empresariales dentro de un formato específico y estandarizado.


  • Códigos TSS (genéricos) y Códigos de devolución Fisco
    Al consultar la rutina NFESEFAZ > Otras acciones > Monitor > Rango, se muestra el contenido del TSS. Obs: Para Factura de servicios (Municipalidad) rutina FISA022 > Otras acciones > Monitor.
    La devolución detallada del Fisco puede consultarse: En la opción “Mensajes” dentro de la rutina o en la Tabla SPED054, o en el log _nfesbra_monitorfaixa_out generado en la carpeta wslogxml de su estructura del servidor TSS. Obs: Para Facturas de servicios (Alcaldía) Tabla SPED055.


  • El proceso de validación de la eliminación realizado por el FATJOBNFE no considera la anulación o la inutilización del e-CT, su finalidad es impedir a eliminación indebida de la factura de salida, que por ventura, pueda tener el e-CT vinculado a esta.  Si utiliza el módulo TMS, entre en contacto con el equipo para los procedimientos de anulación o inutilización de e-CT. Si no utiliza el módulo TMS, entre en contacto el equipo SPED para más orientaciones.


Preguntas y respuestas sobre utilización del Fatjob:

Expandir
title¿Qué hacer en la leyenda anaranjada?

La leyenda anaranjada significa problema de comunicación con el Fisco, porque el Job necesita obtener la devolución de Anulación autorizada o Anulación no autorizada, evalúe los siguientes puntos:

1- Verifique, en la rutina NFESEFAZ, en Otras acciones > e-Fact, si el entorno está configurado como Producción u Homologación del Fisco. El entorno configurado debe ser el mismo en el cual se autorizó la factura.

2- Consulte en el sitio del organismo Fisco del Estado/Provincia/Región o Alcaldía, y vea si los servicios están activos. Si no lo estuvieran, será necesario esperar por el restablecimiento de los servicios para intentar procesar el borrado nuevamente.

Nota
titleObservación

En los casos de servicios del Fisco o de la Alcaldía parados no es Totvs que responde, es necesario entrar en contacto con el organismo.


3- Revalúe la configuración del Fatjob, porque el job debe estar configurado correctamente, consulte la solapa Configuración;

4- Verifique si el servicio del TSS vs. Fisco está activo, para ello, acceda a la rutina NFESEFAZ. Si se muestra el siguiente mensaje, significa que el TSS está con el servicio parado, es necesario habilitar y procesar el borrado nuevamente:

Image Modified


5- Después de evaluar los cuatro puntos mencionados anteriormente, recomendamos que entre en contacto con el equipo del Protheus SPED, para que se evalúe la configuración de la transmisión de anulación.

Expandir
title¿Cuáles son los documentos validados por el FatJobNFe?

Los documentos validados por el Fatjob son NFE y NFESE del tipo Salida, es decir, que se genera el Documento de salida. Esto significa que, se aceptan los tipos de documentos cuya serie está configurada en el parámetro MV_ESPECIE como SPED o RPS.

Expandir
title¿Qué rutinas validan el Job?

El job del FATJOB se valida exclusivamente en la rutina Borrado de documento de salida MATA521A.

Expandir
title¿Cuál es la funcionalidad del MV_SPEDEXC? ¿Es validado por el Job?

El parámetro MV_SPEDEXC permite configurar el plazo, en horas, para borrar documentos en el sistema. Para obtener más información sobre esta funcionalidad, consulte la documentación específica.
Cross Segmentos - Backoffice Protheus - SIGAFAT - Funcionamiento del parámetro MV_SPEDEXC en la Facturación

El comportamiento del parámetro MV_SPEDEXC no se evalúa cuando el FATJOBNFE está activo (es decir, cuando MV_CANCNFE y MV_CANNFSE está definido como .T.). Esto ocurre porque, si ambas validaciones estuvieran activas, el parámetro impediría permanentemente que se borren las facturas.  Para más información, consulta la solapa Complemento.

Expandir
title¿Qué estatus permite borrar el Job? ¿Qué significan los códigos?

Para que el job procese el borrado, existe la premisa que el estatus de la factura debe constar como Autorizada en las tablas y consulta:

Tabla SF2 en el campo F2_IMP está igual S - Autorizada;
Tabla SPED050 en el campo STATUS está igual 6 - e-Fact autorizada;
Consulta del monitor> Rango en la rutina NFESEFAZ, el código TSS igual 001- Autorizado y código Fisco igual 100- Autorizado.


 El Job permitirá borrar, de acuerdo con esta devolución donde se actualiza y graban informaciones:

Actualiza en la Tabla SPED050 en el campo Status actualiza a 7 - Anulación; y graba en el campo STATUSCANC 2 - e-Fact Anulada;
Actualiza la Consulta del monitor actual>Rango en la rutina NFESEFAZ, habiendo dos tipos de devolución que van a depender del plazo:

Código del Fisco: 101 - Anulación autorizada
Código TSS: 015

Código del Fisco: 155 - Anulación homologada fuera de plazo (extemporáneo). 
Código TSS: 036

En la tabla SF2, en el campo F2_STATUS, se graba el mismo código del TSS donde se permite borrar el documento de salida en el sistema.


Dica
titlestatus2

En la solapa Procesamiento del FatJob haya una tabla que detalla posibles escenarios.