Notas da Versão

Fiscal Flow Client

Para a versão 1.0.52.1 do Fiscal Flow Client, foram realizadas as implementações das NTs 2020.006 e 2020.007, além criação de novo parâmetro para limpeza do banco de dados, que poderá ser customizada a partir da necessidade do cliente. Por fim, foram realizadas correções de bugs para melhor experiência do cliente.

Versão

Release: 1.0.52.1

Data Release:  

Melhorias


Foi Implementado novo parâmetro no ambiente EVO e Mid-e Central, que será interpretado pelo Client a partir desta versão.

Esse parâmetro tem como objetivo atender aos clientes que têm muitas emissões diárias e o parâmetro padrão não atende à volumetria, pois há um crescimento acelerado do banco de dados do client. Logo, em alguns clientes o banco de dados estava sendo corrompido.

Ações de limpeza realizadas pelo Client:

  • O client passa a aceitar parâmetro a partir dos ambientes EVO e MID-e Central, que antes era fixa no código.
  • Os documentos que já foram transacionados e que possuem status final serão removidos do banco, a partir do prazo determinado no parâmetro atual.
  • Dados obsoletos serão removidos do banco.

Regras de limpeza atuais:

TabelaTempo no Banco do client
comunicacoesHist 2 dias
json para retorno de SAT com erro2 dias
json para autorizados/cancelados7 dias
historicoJson para retorno de SAT com erro2 dias
historicoJson para autorizados/cancelados7 dias
autorizacoesPendentes

2 dias após enviado ao Central/Evo

requisicaoSAT 2 dias
notaProcessoIncompleto7 dias após enviado ao Central/Evo
notassolicitadas7 dias após enviado ao Central/Evo
RetornoAutorizacoes7 dias após enviado ao Central/Evo
RetornoConsulta7 dias após enviado ao Central/Evo
RetornoTempoMedio7 dias
IntegracaoSAP7 dias após enviado ao SAP

Importante

Caso seja necessário alterar a regra atual para o cliente, será necessário solicitar via TP Workflow para o nosso suporte e será atendido dentro do SLA pré-determinado.

Issue: https://jira.linx.com.br/browse/CROSS-6965

Foi implementado o grupo para atender à NT 2020.006 - Indicativo de Intermediador/Marketplace, que contempla os documentos NF-e e NFC-e (modelos 55 e 65), para envio na autorização via Json, passando a interpretar as novas tags enviadas conforme a estrutura abaixo:

Itens abordados na NT:

Data obrigatoriedade:

  • Ambiente de Homologação -  - **Disponível para testes no ambiente Fiscal Flow para a UF RS, apenas.
  • Ambiente de Homologação (SV-AN; SP; GO e MG) -  - **O ambiente de homologação das demais UFs estarão liberados a partir desta data, no Fiscal Flow.

  • Ambiente de Produção -  


Documento Fiscal afetado:
  • NF-e (Modelo 55)
  • NFC-e (Modelo 65)

INDICATIVO DE INTERMEDIADOR/MARKETPLACE

Campo xml: ID: B25c <indIntermed>

Local no JSON: {

Grupo Json: indIntermed

Regra: A apresentação desta tag será obrigatória sempre que a tag ID.: B25b <indPres > (Indicador de Presença do Comprador) for preenchida com:

1=Operação presencial

2=Operação não presencial, pela Internet;

3=Operação não presencial, Tele atendimento;

4=NFC-e em operação com entrega a domicílio; ou

9=Operação não presencial, outros.

O campo pode receber os valores:

0=Operação sem intermediador (em site ou plataforma própria)*

1=Operação em site ou plataforma de terceiros (intermediários/marketplace)**

*Considera-se site/plataforma própria as vendas que não foram intermediadas por Marketplace, como venda em site próprio e teleatendimento. 

**É considerado Intermediador/Marketplace quando os prestadores de serviços e de negócios referentes às transações comerciais ou prestação de serviços intermediadas, realizadas por pessoas jurídicas (CNPJ) ou pessoas físicas (CPF), ainda que não estejam inscritas no cadastro de contribuintes do ICMS.

Exemplo no JSON:

Indicativo de Intermediador/Marketplace
"indIntermed": "0"

ou

"indIntermed": "1"


INCLUSÃO DE NOVAS OPÇÕES DE PAGAMENTO

Campo xml: ID: YA02 <tPag>

Local no JSON: <pag>

Grupo Json: tpag

Regra: Alteração no grupo YA (Meio de Pagamento):

Foram incluídas as novas opções de pagamento para interpretação do Client:

16=Depósito Bancário

17=Pagamento Instantâneo (PIX)

18=Transferência bancária, Carteira Digital

19=Programa de fidelidade, Cashback, Crédito Virtual.

Exemplo no JSON:

Novas opções de pagamento
"PagNFCeList": [
{
"tPag": "17",
"vPag": 20.5,
"CardNFCeList": [
{
"tpIntegra": "1",
"CNPJ": "12345678901234",
"tBand": "99",
"cAut": "bb12345"
}
]


IDENTIFICADOR DE INTERMEDIADOR OU MARKTPLACE

Campo xml: ID: YB02 <infIntermed>

Local no JSON: {

Grupo Json: InfIntermed

Regra: Criado o novo grupo para incluir as informações do Intermediador de transação, contendo apenas 2 campos. São eles:

CNPJ = CNPJ do intermediador da Transação

idCadIntTran = Identificador Cadastro Intermediador

Exemplo no JSON:

Identificação de Intermediador ou Marketplace
"infIntermed": {
"CNPJ": "12345678901234",
"idCadIntTran": "string"
}

Foi implementada a NT 2020.007 - que aborda a Identificação do Transportador da mercadoria. Dentre os itens apresentados nesta NT destaca-se a possibilidade deste transportador ser identificado a qualquer momento. Não se restringindo ao momento da emissão do documento fiscal. Desta forma, o Emitente do "Documento Fiscal" poderá a qualquer momento permitir ao Transportador a ter acesso ao XML da NF-e no Ambiente Nacional.


Itens abordados na NT:

Data obrigatoriedade:

    • Ambiente de Homologação -  
    • Ambiente de Produção -  

Documento Fiscal afetado

    • NF-e (Modelo 55)

NFE ENTRADA E SAÍDA

API NFe Saída: api/NFWebApi/AtorInteressado

API NFe Entrada: NFEntrada/AtorInteressado

Regra: Implementadas as tags de validação para envio no payload de evento:

Tags:

#

Campo

Ele

Pai

Tipo

Ocor

Tam

descrição/observação

Comentário ICT

P21tpAutorEP17N1-11Informar uma das opções abaixo:
1=Geração do Evento pelo Emitente;
2=Geração do Evento pelo Destinatário;
3=Geração do Evento pelo Transportador Contratado;
Valores: 1=Empresa Emitente, 2=Empresa Destinatária; 3=Empresa Transportadora
Identifica qual a participação da Pessoa que esta enviando o evento na Operação. O envio deste evento pode ser realizado por qualquer um dos participantes na operação identificados anteriormente.
Ex.: Digamos que na emissão da NF-e tenhamos o preenchimento do Grupo X. Logo, esta transportadora poderá realizar o envio deste evento identificando uma outra transportadora. Devendo para isto preencher o campo com "3".
P23CNPJCEP23N1-13-14CNPJ autorizado

CNPJ da pessoa que esta sendo identificada como transportadora da mercadoria, e que terá acesso ao XML no Ambiente Nacional.

Pelo Leiaute não é necessário informar todo o CNPJ da empresa, poderia por exemplo ser apresentado apenas a Raiz do CNPJ, neste caso, nas situações em que a transportadora possui filiais qualquer uma destas poderá acessar ao XML desta Nf-e caso informado apenas a raiz do CNPJ.

P25CPFCEP23N1-13-11CPF autorizado

CFP da pessoa que esta sendo identificada como transportadora da mercadoria, e que terá acesso ao XML no Ambiente Nacional.

É do entendimento de ICT que no caso do CPF o Sistema preencha com o CFP completo por questões de segurança dos participantes da operação.

P26tpAutorizacaoEP17N0-110 - Não permite;
1- Permite o transportador autorizado pelo emitente ou destinatário autorizar outros transportadores para ter acesso ao download da NF-e
Se permite ou não ter acesso as informações no portal.
P27xCondUsoEP17C0-1-Condição de uso do tipo de autorização para o transportador: "O emitente ou destinatário da NF-e, declara que permite o transportador declarado no campo CNPJ/CPF deste evento a autorizar os transportadores subcontratados ou redespachados a terem acesso ao download da NF-e".

Termo por escrito autorizando o acesso as informações da NF-e no portal.

Conforme leitura desta NT, é do entendimento do time de ICT que a tag <xCondUso> poderá ser preenchido com a frase: "O emitente ou destinatário da NF-e, declara que permite o transportador declarado no campo CNPJ/CPF deste evento a autorizar os transportadores subcontratados ou redespachados a terem acesso ao download da NF-e".


Exemplo no payload NFE Saída:

Evento NFe Saída
{
"chNFe": "43210154517628001593553100000000641034098619",
"dhEvento": "2021-02-03T14:53:39-02:00",
"tpAutor": "1",
"tpAutorizacao": 0,
"tpEvento": 110150,
"autXML": {
"CPF": "35802707020"
}
}

Exemplo payload NFe Entrada

Evento NFe Entrada
{
"chNFe": "43210154517628001593553100000000641034098619",
"dhEvento": "2021-02-03T14:53:39-02:00",
"tpAutor": "1",
"tpAutorizacao": 0,
"tpEvento": 110150,
"autXML": {
"CPF": "35802707020"
},
"CNPJDest":"54517628001593"
}

Correções

Foram realizados ajustes ou validações de como as tags devem ser enviadas no Json, para evitar rejeições como 786 - NFC-e de entrega a domicílio sem dados do Transportador, por exemplo, que estava como obrigatória no Fiscal Flow ou estava considerando campos enviados de forma incorreta no Json de autorização. Logo, para montar a tag referente à transportadora, será considerado o valor informado na tag modFrete e quando não for enviado nenhum valor na tag modFrete, o ambiente assumirá modFrete=9 - Sem frete.


Considerações sobre a issue, especificamente, analisando todo o Json enviado:

A nível de informação, seguem considerações para utilização correta do envio de informações via Json:

Exemplo Json para envio correto das informações de autXMLList:

Caso não seja enviado nesse formato, só será processado 1 CNPJ e sempre será aceito apenas o último (esta regra é determinada pelo Json e não pode conter tags duplicadas. Importante saber que não é uma regra criada pelo Fiscal Flow, mas pelo Json).

Grupo autXMLList
ERRADO

"autXMLList":[
{ "CNPJ":"07615950000170", "CNPJ":"24833002000120" }],


------------------------------------------------------------------

CORRETO

"autXMLList":[
{ "CNPJ":"07615950000170" }
,
{ "CNPJ":"24833002000120" }
],


Além disso, durante o desenvolvimento, foi identificado o envio incorreto de informações em campos do tipo numérico e sinalizado para o envio correto:

Exemplo Json para envio correto das informações de tPag:

Importante: Campos com aspas (") não devem ser enviados com o dígito zero na frente.

Grupo NFCePagList
ERRADO


"PagNFCeList":[
{
"indPag":null,
"tPag":01,
"vPag":20.00
}
]


------------------------------------------------------------------


CORRETO


"PagNFCeList":[
{
"indPag":null,
"tPag":1,
"vPag":20.00
}
]

Foram implementados as descrições para atender todos os tipos de pagamento, inclusive os novos tipos de pagamentos criados a partir da NT 2020.006.

Tipos de pagamento que foram implementados:

13=Vale Combustível
15=Boleto Bancário
16=Depósito Bancário
17=Pagamento Instantâneo (PIX)
18=Transferência bancária, Carteira Digital
19=Programa de fidelidade, Cashback, Crédito Virtual
90=Sem pagamento

Foi ajustada a implementação da tag ISUF, referente à Suframa.

Alterado regra de validação para que a tag correspondente ao telefone <fone> passe a ser considerada como opcional, evitando a Rejeição 225 - Falha no Schema XML: O elemento fone é inválido.

O mid-e client estava considerando a TAG CNPJ/CPF do transportador como obrigatória, no entanto o correto é ser opcional, realizado este ajuste, agora será opcional.

Implementado a tag suframa para preenchimento correto de acordo com manual da sefaz quando o PDV realizar o envio no Json.

Implementado tipos de pagamento abaixo para serem impressos na danfe de acordo com o enviado na nota fiscal:

13=Vale Combustível
15=Boleto Bancário
16=Depósito Bancário
17=Pagamento Instantâneo (PIX)
18=Transferência bancária, Carteira Digital
19=Programa de fidelidade, Cashback, Crédito Virtual
90=Sem pagamento

Realizado atualização de DLLs dos fabricantes SAT/MFE, desta forma quando o MID-e client for instalado já virá no setup com as versões atualizadas, abaixo versões de fabricantes que foram atualizadas:

  • Bematech RB1000
  • Bematech RB2000
  • Bematech SATGO
  • Dimep DSAT
  • Epson SAT A10
  • Gertec GERSAT
  • Kryptus EASYSAT
  • Nitere NSAT4200
  • SatId CONTROLID
  • Tanca TS1000