Paso a paso: | El JOB FATJOBNFE se puso a disposición en el entorno SIGAFAT, con el objetivo de hacer efectiva la anulación de Facturas (e-Fact - Modelo 55 o e-FactS ), por medio de la autorización del Fisco (SEFAZ)/Alcaldía. Cuando la e-Fact reciba la autorización de anulación, el JOB permitirá borrar el Documento de salida, por medio de la rutina MATA521. De esta manera es posible evitar que Documentos de salida se borren del ERP, sin la debida autorización para la anulación emitida por el Fisco (SEFAZ)/Alcaldía.
| 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. |
Material de apoyo para implementar el JOB: NFE0002_JOB_para_anulación_de e-Fact_y/o_e-FactS_(JOB FatJobNFe)
| Deck of Cards |
|---|
| startHidden | false |
|---|
| effectDuration | 0.5 |
|---|
| id | FATJOB |
|---|
| effectType | horizontal |
|---|
| loopCards | true |
|---|
| | Card |
|---|
| default | true |
|---|
| id | FATJOB |
|---|
| label | Configuraciones generales |
|---|
| | Expandir |
|---|
| title | Configuración para una sucursal |
|---|
| Cómo activar el Job, si solo tiene una empresa y una sucursal 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 | Utilizado para facturas de servicios: .T. para habilitar el FatJobNFe (Cuando .F. permite borrar sin utilizar el JOB) | MV_INFXJUS | S si desea informar manualmente el motivo de la anulación durante el borrado (es necesario que la justificación tenga más de 15 dígitos) |
2° Configure el Job en el appeserver.ini del Protheus para ejecutar el proceso de anulación que se emitió por e-Fact o e-FactS. | Aviso |
|---|
| 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 es necesario para el uso de la versión 11, a partir de la versión 12, ya no es necesario, bastando simplemente realizar la configuración del entorno. |
| Dica |
|---|
| - 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 (Balanceo de carga) es necesario registrar el JOB en el INI de cada servicio, y no en el Master.
|
Abra el archivo INI del Server Protheus y agregue la sección [FatJobNFe_<EMPRESA><FILIAL>], de acuerdo con el siguiente ejemplo: | Bloco de código |
|---|
| [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 |
Observaciones sobre las claves: Clave | Detalle | ENVIRONMENT | Entorno de trabajo al que 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. |
| Aviso |
|---|
| - 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) - Si tuviera más de una sucursal o Gestión de empresas, además del parámetro activado, vea cómo debe configurarse el JOB en el appserver.ini. Siga las orientaciones del tópico al lado: Configuraciones para más de una sucursal/ Gestión de empresas
|
|
| Card |
|---|
| default | true |
|---|
| id | FATJOB |
|---|
| label | Configuraciones para más de una sucursal/ Gestión de empresas |
|---|
| Si tuviera más de una sucursal para configurar el JOB, es necesario configurar una sección del job para cada sucursal, ejemplo:
| Bloco de código |
|---|
| [ONSTART]
JOBS=FatJobNFe_<empresa><sucursal>
[FatJobNFe_<empresa><sucursal>]
nParms=2
parm1=<Empresa>
PARM2=<Sucursal> [Ejemplo: 01]
[ONSTART]
JOBS=FatJobNFe_<empresa><sucursal>
[FatJobNFe_<empresa><sucursal>]
nParms=2
parm1=<Empresa>
PARM2=<Sucursal> [Ejemplo: 02] |
| Aviso |
|---|
| - 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 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)
|
|
|
| Card |
|---|
| default | true |
|---|
| id | FATJOB |
|---|
| label | Configuración por Schedule |
|---|
| El Schedule Protheus permite que se agenden las rutinas del sistema para que puedan ejecutarse posteriormente, en un período determinado por el usuario.
Debe configurarse el schedule para la ejecución del proceso de anulación (reversión de los documentos) que se emitieron por e-Fact y e-FactS: 1. En el Configurador (SIGACFG), acceda a Entorno/ Schedule/ Schedule.
2. Haga dos clic en Agendamientos.
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 agendar 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 inmediatamente después de que se restablece 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 |
|---|
| default | true |
|---|
| id | FATJOBNFE |
|---|
| label | Proceso |
|---|
| - Emitir una factura de salida utilizando TES, Cliente y Producto que mueva las Tablas SF3 y SFT y que esté apta para ser Autorizada por el Fisco (que no devuelva rechazo).
- Para transmitir: Rutina NFESEFAZ > Otras acciones > Transmisión
- Para monitorear: Rutina NFESEFAZ > Otras acciones > Monitor > Rango
- Para borrar: Acceder a la rutina MATA521A – Borrado de documento de salida > Seleccionar la factura > Otras acciones: Borrar.
Rutina MATA521A – Borrado de documento de salida > Otra acciones: Refresh.
La funcionalidad Refresh tiene la finalidad de reprocesar la comunicación con TSS para transmisión de anulación, y
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.
Obs: 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.
IMPORTANTE: 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.
| Expandir |
|---|
| Se creó el proceso de validación de eliminación por el Job, porque únicamente la configuración del parámetro MV_SPEDEXC no cumplía las reales necesidades del proceso, ya que en casos de rechazo de la eliminación por parte del Fisco la factura ya estaría eliminada 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 eliminar.
- 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 (Secretaría de Estado de Hacienda): es el organismo vinculado al Ministerio de Hacienda responsable por el control y estandarización de las reglas referentes a los ingresos y gastos de Estado/Provincia/Región.
- TSS (TOTVS Service SOA): es la aplicación utilizada por el Protheus para comunicación con el Fisco. Detalles en: TSS0006_Manual_de_configuración. El 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).
- 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.
|
|
| Card |
|---|
| default | true |
|---|
| id | FATJOB |
|---|
| label | Processamento do FATJOBNFE |
|---|
| KCS: Cross Segmento - TOTVS Backoffice (Linha Protheus) - SIGAFAT - Legenda de Exclusão do Documento de Saída
La leyenda en la rutina de eliminación de documento de salida (MATA521), solo ocurre cuando existe el uso del Job de validación de eliminación de la factura, FATJOBNFE, a través de la activación del parámetro MV_CANCNFE, cuando no existe el uso del Job, no existe leyenda.
Su composición es la siguiente: 
Anaranjado: Esperando la respuesta de la SEFAZ, sobre la anulación (FATJOBNFE). Blanco: ninguna acción tomada. Verde: Anulación autorizada y con asuntos pendientes, evalue el estatus de los campos F2_FIMP y F2_STATUS. Rojo: Anulación no autorizada, verifique el Campo STATUS Tabla SPED050.
OBSERVACIÓN: Si la prueba se realiza en entorno de homologación, por ser homologação, la leyenda queda "Anaranjado", valide si está en el entorno de producción. |
| Card |
|---|
| default | true |
|---|
| id | FATJOB |
|---|
| label | Procesamiento FATJOBNFE |
|---|
| Comportamiento Obtenido con la rutina MATA521: P11 igual o superior al 15/02/17 / P12 igual o superior al 14/02/17  
(Haga clic aquí para visualizar / bajar el archivo en Planilla) | Dica |
|---|
| El FATJOBNFE se basa en el contenido del campo F2_FIMP (Flag de impresión) para su procesamiento; y, alimenta el campo F2_STATUS (estatus de Anulación de la NFE) con el resultado de la operación. La información de la anulación se graba en la tabla SPED050 del TSS en los siguientes campos: - memo XML_SIGCAN;
- Estatus
- Statuscanc
Vea en las siguientes tablas los tipos de devolución de estos campos. |
- Campo F2_STATUS – Estatus Anul. e-Fact (registrado únicamente cuando se hace uso del FATJOBNFE)
“ ” - No hubo intento de anulación con el uso del 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
- Campo 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
- Campo 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.
Tablas de servicio/Alcaldía - Campo STATUS Tabla SPED051 - Estatus e-FactS
STATUS= 1 "e-Fact recibida por el TSS"STATUS= 2 "e-Fact firmada"
STATUS= 3 "e-Fact con error de schema"
STATUS= 4 "e-Fact transmitida"
STATUS= 5 "e-Fact rechazada"
STATUS= 6 "e-Fact autorizada"
STATUS= 7 + STATUSCANC=2 "e-Fact anulada" Tablas para transmisión del Totvs Colaboración Tabla CKO - Graba el estatus de la anulación/inutilización Tabla CKA - Graba los Lotes vs. Factura electrónica
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ó 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 del Fisco:
110 – Uso denegado
301 - Uso denegado: Irregularidad fiscal del emitente
302 - Rechazo: Irregularidad fiscal del destinatario
303 - Uso denegado: Destinatario no habilitado a operar en el Estado/Provincia/Región
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 del Fisco: “N” devoluciones (consultar Manual del contribuyente del Fisco)
- Autorizada: Facturación homologada
Código del Fisco: 100 - Autorizado el uso de la e-Fact
Código TSS: 001
- Anulación autorizada:
Código SEFAZ: 101 - Anulación autorizada
Código TSS: 015
Código SEFAZ: 155 - Anulación homologada fuera de plazo (extemporáneo). Comúnmente ocasiona cobranza al Emisor.
Código TSS: 036
- Anulación rechazada:
Códigos del 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
|
|
|
