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

Produto

Producto:

Microsiga Protheus®

Ambiente

Entorno:

Faturamento

Facturación (SIGAFAT)

Ocorrência
Ocurrencia:
Configurações e Parametrizações do
Configuraciones y parametrizaciones del JOB para
Cancelamento
anulación de
NFe
la e
/ou NFSe
-Fact y/o e-FactS (FATJOBNFE)
Passo

Paso a

passo

paso:

O JOB FATJOBNFE foi disponibilizado no ambiente SIGAFAT, com o objetivo de efetivar o cancelamento de Notas Fiscais (NFe - Modelo 55 ou NFSe ), através da autorização da SEFAZ/Prefeitura.

Quando a NFe receber a autorização de cancelamento, o JOB irá permitir a exclusão do Documento de Saída, através da rotina MATA521. 

Desta forma é possível evitar que Documentos de Saída sejam excluídos do ERP, sem a devida autorização para cancelamento emitida pela SEFAZ/Prefeitura. 

Aviso
titleObservação

O suporte não orienta em implementação.

Este material é unicamente objeto de apoio, e orientamos firmemente que seja solicitado analista in - loco para implementar a ferramenta e homologar o uso em produção.

A implementação deve ser realizada primeiramente em ambiente de homologação padrão atualizado e, posteriormente em Produção respeitando os devidos backups preventivos.

Material de Apoio para Implementar o JOB:NFE0002_JOB_para_Cancelamento_de NFe_e/ou_NFSe_(JOB FatJobNFe)

Deck of Cards
startHiddenfalse
effectDuration0.5
idFATJOB
effectTypehorizontal
loopCardstrue
Card
defaulttrue
idFATJOB
labelConfigurações Gerais

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

Para ativar o Job, caso possua apenas uma empresa e uma filial; 

1° Configure o parâmetro MV_CANCNFE ou MV_CANNFSE ( para notas de serviços) = .T.

ParâmetroConfiguração

MV_CANCNFE

.T. para habilitar

o

el FatJobNFe (

Quando

Cuando .F. permite

a exclusão sem utilizar o

borrar sin utilizar el JOB)

MV_CANNFSE

Utilizado

Se utiliza para

notas

facturas de

serviços

servicios: .T. para habilitar

o

el FatJobNFe (

Quando

Cuando .F. permite

a exclusão sem utilizar o

borrar sin utilizar el JOB)

MV_INFXJUSS caso deseje informar manualmente o motivo do cancelamento no momento da exclusão (necessário que a justificativa contenha mais de 15 dígitos)

2° Configure o Job no appeserver.ini do Protheus para a execução do processo de cancelamento que foram emitidos por NFe ou NFSe.

Aviso
titleObservação

São as mesmas tags para nota de serviço, o que diferencia é o parâmetro  MV_CANNFSE que deve estar habilitado.

Verifique se a prefeitura dispõe de serviço de cancelamento. Caso contrario, indiferente do configurado no parâmetro de sistema MV_CANNFSE não irá existir a transmissão para o cancelamento. 

O fonte UpdFATNFE.PRX somente era necessário para o uso da versão 11, a partir da versão 12, não é mais necessário bastando apenas efetuar a configuração do ambiente.

Dica
titleImportante
  • O Job é registrado no INI do Server Protheus e não no INI do TSS
  • Caso possua um ambiente com balanceamento de cargas, ou seja, APPSERVER Master e Slaves (Balanceamento de carga) é necessário registrar o JOB no INI de cada serviço, e não no Master.

Abra o arquivo INI do Server Protheus e adicione a seção [FatJobNFe_<EMPRESA><FILIAL>] conforme o exemplo abaixo:

Bloco de código
titleConfiguração
[ONSTART] JOBS=FatJobNFe_<empresa><filial> [FatJobNFe_<empresa><filial>]  MAIN=FatJobNFe ENVIRONMENT=<ambiente de trabalho> nParms=2 parm1=<Empresa> parm2=<Filial>


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

Observações sobre as chaves:

ChaveDetalhamentoENVIRONMENTAmbiente de trabalho ao qual o Job pertence.nParmsDeve permanecer 2.parm1Código da empresa.parm2Código da filial.START_TIME Horário inicial que deve ser considerado para a execução.FINISH_TIME Horário final que deve ser considerado para a execução.INTERVALIntervalo de minutos entre as execuções (deve ser maior ou igual a 5).ACTIVATEIndica se está ativo.
Aviso
titleImportante
  • Veja que na configuração os sinais de menor (<) e maior (>) devem ser substituídos pela informação:
    Exemplo: FatJobNFe_<empresa><filial>  => FatJobNFe_9901 (Empresa 99 e Filial 01)
  • Caso tenha mais de uma filial ou Gestão de empresas, além do parâmetro ativado,  veja como deve ser configurado o JOB no appserver.ini. Siga as orientações do tópico ao lado:  Configurações para mais de uma filial/ Gestão de empresas 
Card
defaulttrue
idFATJOB
labelConfigurações para mais de uma filial/ Gestão de empresas

Caso possua mais de uma filial para configurar o JOB, é necessário configurar uma seção do job para cada filial, exemplo:

Bloco de código
titleMultifilial
[ONSTART]
JOBS=FatJobNFe_<empresa><filial>
[FatJobNFe_<empresa><filial>]

nParms=2
parm1=<Empresa>
PARM2=<Filial> [Exemplo: 01]

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

nParms=2
parm1=<Empresa>
PARM2=<Filial> [Exemplo: 02]
Aviso
titleImportante
  • Caso possua mais de um empresa para configuração, é necessário que efetue a configuração em cada empresa de forma separada, não há centralizadora por empresa.
  • Caso possua ambiente com Gestão de empresa, é necessário registrar no INI uma sessão para cada Filial, onde os parâmetros devem receber por exemplo:
    parm1=T1 (Grupo de empresa)
    parm2=D MG 01 (D=Empresa, MG=Unidade, 01=Filial)










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 Added


Image Added



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

0 = e-Fact no recibida. El evento de transmisión no se envía al Fisco. En caso de dudas, entrar en contacto con el equipo de SPED.

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 Added


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 Added

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

Image Added

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

Image Added


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 Added


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.

Card
defaulttrue
idFATJOB
labelConfiguração via Schedule

O Schedule Protheus permite que rotinas do sistema sejam agendadas para que possam ser executadas posteriormente, em um período determinado pelo usuário. 

Deve-se configurar o schedule para a execução do processo de cancelamento (estorno dos documentos) que foram emitidos por NFe e NFSe:

1. No Configurador (SIGACFG), acesse Ambiente/ Schedule/ Schedule.
2. Dê um duplo clique em Agendamentos.
3. Clique em Cadastro.
4. Clique em Incluir.
5. Preencha os campos obrigatórios.
6. Preencha o campo Rotina (XX1_ROTINA) com FATJOBNFE().
7. Clique OK.
8. Clique em Confirmar.

Caso seja necessário executar o procedimento diversas vezes, configure por meio do botão Recorrência.

Material sobre a configuração do Schedule : Schedule - Como agendar a execução de rotinas

Aviso
titleObservação

Recomendamos o uso do schedule, essa funcionalidade garante a exclusão das notas que estão em processamento para serem canceladas. Exemplo: Se excluiu uma nota, porem houve falha de comunicação com a Sefaz, e a nota ainda consta no sistema, o Schedule sempre reprocessa de forma automática e exclui assim que houver a comunicação com a Sefaz. 

Está funcionalidade é apenas para notas que estão com o status : Aguardando cancelamento, legenda laranja.

Importante ressaltar que a configuração do Schedule tem o consumo de licenças.  

Card
defaulttrue
idFATJOBNFE
labelProcesso
Emitir nota de Saída utilizando TES, Cliente e Produto que movimente as Tabelas SF3 e SFT e que esteja apta à ser Autorizada pelo SEFAZ (não retorne rejeição).
Para transmitir: Rotina NFESEFAZ > Outras Ações > Transmissão
Para Monitorar: Rotina NFESEFAZ > Outras Ações > Monitor > Faixa
Para excluir: Acessar rotina MATA521A – Exclusão de Documento de Saída > Selecionar a nota > Outras Ações: Excluir.
Rotina MATA521A – Exclusão de Documento de Saída > Outra ações: Refresh.
A funcionalidade Refresh tem a finalidade de reprocessar a comunicação com TSS para transmissão de cancelamento, 
e consequente exclusão, de Notas que, por algum motivo, não tiveram efetividade no retorno do Sefaz / Prefeitura no momento da primeira tentativa de exclusão. Ao ocorrer o reprocessamento através do Refresh, a Nota pode ser cancelada e excluída, ou ter seu status alterado indicando, por exemplo, uma rejeição.
Obs: o botão refresh é destinado ao reprocessamento em lote de todas as notas (independente de apresentar em filtro de browser, ou de estar flegada). Caso não seja a intenção, deve-se selecionar a(s) Nota(s) desejada e realizar novamente a tentativa de exclusão para que a Nota em questão seja reprocessada.
IMPORTANTE: É categoricamente recomendado o uso do Schedule, abordado nesta documentação. O schedule, quando devidamente configurado, terá o mesmo comportamento do "Refresh", reprocessando periodicamente as Notas, porém, de forma automática, evitando assim falha humana, visto que não depende de ação do usuário para reprocessar.

Card
defaulttrue
idFATJOB
labelProcessamento FATJOBNFE

Comportamento

Obtido com rotina MATA521: P11 igual ou superior a 15/02/17 / P12 igual ou superior a 14/02/17  Image Removed

Image Removed

(Clique aqui para visualizar / baixar o arquivo em Planilha)

Dica
titleImportante

O FATJOBNFE se baseia no conteúdo do campo F2_FIMP (Flag de impressão)para seu processamento; e, alimenta o campo F2_STATUS (status de Cancelamento da NFE) com o resultado da operação.

A informação do cancelamento é gravado na tabela SPED050 do TSS nos seguintes campo:

  • memo XML_SIGCAN;
  • Status
  • Statuscanc

Veja nas tabelas abaixo os tipos de retorno desses campos. 

  • Campo F2_STATUS – Status Canc. NFe (registrado apenas quando se faz uso do FATJOBNFE)
    “  ” - Não houve tentativa de cancelamento com uso do FATJOBNFE
    015 - Cancelamento Autorizado
    025 - Cancelamento não transmitido (Aguardando retorno do SEFAZ)
    026 - Cancelamento não autorizado
    030 - Inutilização de numeração autorizada
    036 - Cancelamento autorizado fora do prazo
  • Campo STATUS Tabela SPED050 - Status da NFe:
     1 = NFe Recebida.
     2 = NFe Assinada.
     3 = NFe com falha no schema XML.
     4 = NFe transmitida.
     5 = NFe com problemas.
     6 = NFe autorizada.
     7 = Cancelamento
  • Campo STATUSCANC Tabela SPED050 -  Status Cancelamento/inutilização ():
     1 = NFe Recebida.
     2 = NFe Cancelada.
     3 = NFe com falha de cancelamento/inutilização.

Tabelas de Serviço/Prefeitura

  • Campo STATUS Tabela SPED051 - Status NFSE

STATUS= 1 "Nfse recebida pelo TSS"STATUS= 2 "Nfse assinada"
STATUS= 3 "Nfse com erro de schema"
STATUS= 4 "Nfse transmitida"
STATUS= 5 "Nfse rejeitada"
STATUS= 6 "Nfse autorizada"
STATUS= 7 + STATUSCANC=2 "Nfse cancelada"

Tabelas para transmissão do Totvs Colaboração

Tabela CKO -  Grava o Status do cancelamento/inutilizado

Tabela CKA - Grava os Lotes X Nota Fiscal Eletrônica

Status da Sefaz:

Definição dos Cenários (Detalhes, consultar Manual do contribuinte da SEFAZ no link: http://www.nfe.fazenda.gov.br/portal/exibirArquivo.aspx?conteudo=URCYvjVMIzI

  • Não assinada: TSS identifica falha no schema e não envia para o SEFAZ
    Código TSS: 002 / 029
  • Inutilizada: Numeração não existe para SEFAZ – Não poderá mais ser utilizada. Na necessidade de efetivar a operação, é necessário reemitir o Documento para transmitir com nova numeração.
    Código Sefaz: 102 - Inutilização de número homologado
    Código TSS: 030
  • Denegada: Existe algum problema geralmente do Emissor ou do Destinatário com o Fisco do SEFAZ (Ex: Situação cadastral) que impede o Faturamento. A numeração também não poderá mais ser utilizada.
    Códigos SEFAZ:
    110 – Uso denegado
    301 - Uso Denegado: Irregularidade fiscal do emitente
    302 - Rejeição: Irregularidade fiscal do destinatário
    303 - Uso Denegado: Destinatário não habilitado a operar na UF
    205 - NF-e está denegada na base de dados da SEFAZ
    Código TSS: 013
  • Rejeitada: “N” motivos de erro no documento - Na necessidade de efetivar a operação, é necessário corrigir a causa da Rejeição e retransmitir.
    Obs: Há correções, para as quais, se faz necessário também excluir o documento de saída e emitir novamente para que a correção seja efetiva, como por exemplo, problemas de cálculos de impostos, visto que os dados precisam ser corrigidos primeiramente nas tabelas do ERP para então enviar correto ao SEFAZ.
    Códigos SEFAZ: “N” retornos (consultar Manual do contribuinte da SEFAZ)
  • Autorizada: Faturamento Homologado
    Código SEFAZ: 100 - Autorizado o uso da NF-e
    Código TSS: 001
Cancelamento autorizado:
Código SEFAZ: 101 - Cancelamento autorizado
Código TSS: 015
Código SEFAZ: 155 - Cancelamento homologado fora de prazo (extemporâneo). Comumente acarreta cobrança ao Emissor.
Código TSS: 036
  • Cancelamento Rejeitado:
    Códigos SEFAZ:
    252 - Rejeição: Tipo do Ambiente difere do ambiente do Web Service
    578 - Rejeição: A data do evento não pode ser maior que a data do processamento
    577 - Rejeição: A data do evento não pode ser menor que a data de emissão da NF-e
    579 - Rejeição: A data do evento não pode ser menor que a data de autorização para NF-e não emitida em contingência
    220 - Rejeição: Prazo de Cancelamento Superior ao Previsto na Legislação
    501 - Rejeição: Pedido de Cancelamento intempestivo (superior a 7 dias)
    690 - Rejeição: Pedido de Cancelamento para NF-e com CT-e ou MDF-e
    Código TSS: 017 ou 026
Card
defaulttrue
idFATJOB
labelComplemento
  • FATJOBNFE e MV_SPEDEXC
    O processo de validação de exclusão via Job foi criado, pois apenas a configuração do parâmetro MV_SPEDEXC não atendia as reais necessidades do processo, já que em casos de rejeição da exclusão por parte do SEFAZ a nota já estaria excluída do sistema. O Job FatJobNFe foi desenvolvido com perspectiva a substituir a tratativa anterior; logo ao habilitar este processo, o sistema deixa de validar o parâmetro MV_SPEDEXC. Isso ocorre pois, se ambas validações estivessem ativas, o parâmetro iria barrar definitivamente exclusões de notas que por sua vez, poderiam ter o cancelamento aceito pelo órgão responsável. Não se deve barrar efetivamente a exclusão fora do prazo, pois existe possibilidade de tal operação (como em casos de cancelamento extemporâneo). Ou seja, o Job funciona como uma validação do comportamento Sefaz no ERP. Se o SEFAZ permite o cancelamento, o Job permite a exclusão.
  • FATJOBNFE x TOTVS TRANSMITE

A configuração do FATJOBNFE não sofre alterações com a chegada do produto TOTVS Transmite , as validações do TSS para o uso do JOB são as mesmas utilizadas para validar no ERP. O TOTVS Transmite é um sistema on-line, integrado ao ERP Totvs, que facilita a administração dos documentos fiscais eletrônicos, a manifestação do destinatário e sua armazenagem com total segurança.

Dúvidas relacionadas ao Totvs Transmite, contate nossa equipe SPED.

Saiba maisIntegração TSS x TOTVS Transmite.

  • Validar demais Regras antes de permitir a Exclusão da Nota
    Caso deseje validar demais particularidades para permitir ou não a exclusão do documento de saída, deve-se utilizar Ponto de Entrada para determinar suas próprias condições / regras relevantes.
    P.E. sugerido: MS520VLD - http://tdn.totvs.com/display/public/PROT/MS520VLD
    Obs: Havendo necessidade de maiores informações ou suporte em relação a ponto de entrada, contatar suporte AdvPL do Protheus.
  • SEFAZ X TSS x SPED   
  1. SEFAZ (Secretaria de Estado da Fazenda) : é o órgão vinculado ao Ministério da Fazenda responsável pelo controle e padronização das regras relativas à receitas e despesas de cada Estado.
  2.  TSS (TOTVS Service SOA): é a aplicação utilizada pelo Protheus para comunicação com o SEFAZ. Detalhes em: TSS0006_Manual_de_ConfiguraçãoO objetivo principal é prover os serviços de emissão e manutenção de documentos fiscais eletrônicos como: Nota Fiscal Eletrônica (NFe), Conhecimento de Transporte Eletrônico (CTe), Nota Fiscal de Serviço Eletrônica (NFSe), Capa de Lote eletrônica (Seu), Manifesto de Documentos Fiscais Eletrônicos (MDFe), Nota Fiscal Eletrônica para Consumidor Final (NFCe), Manifesto do destinatário (MDe).
  3. SPED (Sistema Público de Escrituração Digital): é a solução tecnológica da Receita Federal que oficializa a relação entre o Fisco e os contribuintes, por meio de arquivos digitais de escrituração fiscal e contábil, pelos sistemas empresariais dentro de um formato específico e padronizado.
  • Códigos TSS (genéricos) e Códigos de retorno SEFAZ
    Ao consultar a rotina NFESEFAZ > Outras Ações > Monitor > Faixa é exibido o conteúdo do TSS. Obs: Para Nota de Serviços (Prefeitura) rotina FISA022 > Outras Ações > Monitor.
    O retorno detalhado do SEFAZ pode ser consultado: No botão “Mensagens” dentro da rotina; ou, na Tabela SPED054; ou, no log _nfesbra_monitorfaixa_out gerado na pasta wslogxml de sua estrutura do servidor TSS. Obs: Para Notas de Serviços (Prefeitura) Tabela SPED055.
  • O processo de validação da exclusão efetuado pelo FATJOBNFE não contempla o cancelamento ou a inutilização do CTe, sua finalidade é impedir a exclusão indevida da nota fiscal de saída que por ventura, possa conter o CTe associado a ela.  Caso utilize o módulo TMS, contate a equipe para os procedimentos de cancelamento ou inutilização de Cte. Caso não utilize o módulo TMS, contate a equipe SPED para maiores orientações.
Card
defaulttrue
idFATJOB
labelLegenda

Quando ativamos o MV_CANCNFE, a legenda fica da seguinte maneira:

Laranja: Aguardando o retorno da Sefaz, sobre o cancelamento;

Branco: nenhuma ação tomada;

Verde: Cancelamento autorizado e com pendencias, avalie o status dos campos F2_FIMP e F2_STATUS.

Vermelho: Cancelamento não autorizado, verifique o Campo STATUS Tabela SPED050

Image Removed

Pode lhe interessar: