Mudanças entre as edições de "NFCe por API"

De Office System
Ir para navegação Ir para pesquisar
 
(24 revisões intermediárias por 2 usuários não estão sendo mostradas)
Linha 2: Linha 2:
 
É uma nova forma de emitir NFC-e pelo Master Key e Master Key PDV. Não utilizando mais o software Master NF-e.
 
É uma nova forma de emitir NFC-e pelo Master Key e Master Key PDV. Não utilizando mais o software Master NF-e.
  
−
==Como funciona==
+
==Como funciona?==
 
Ao gerar NFC-e pelo Master Key ou pelo PDV, o arquivo xml será gerado, assinado e enviado diretamente para a nossa api (dfe.officesystem.com.br).
 
Ao gerar NFC-e pelo Master Key ou pelo PDV, o arquivo xml será gerado, assinado e enviado diretamente para a nossa api (dfe.officesystem.com.br).
 +
 
A API fará o resto da transmissão utilizando o certificado digital do cliente.
 
A API fará o resto da transmissão utilizando o certificado digital do cliente.
  
 
==Benefícios==
 
==Benefícios==
−
- Mais rápido;
 
−
- Não necessita do Master NF-e instalado;
 
−
- Não necessita instalar o certificado digital;
 
−
- Notas são sincronizadas pelo DBSYNC, e com isso podem ser reimpressas em outras máquinas;
 
−
- Download automático de tabelas e arquivos necessários (schemas, url qrcode, url chave de acesso), facilitando quando a SEFAZ atualiza alguma coisa.
 
−
- Download automático do certificado digital, pegando do site dfe.officesystem.com.br
 
  
−
==Contingência, como funciona==
+
*Mais rápido;
 +
*Não necessita do Master NF-e instalado;
 +
*Não necessita do Microsoft .NET instalado;
 +
*Não necessita do certificado digital instalado;
 +
*Redução de erros por SSL/TLS, .NET, Cadeia de certificados, permissão de arquivos, etc...
 +
*Notas são sincronizadas pelo DBSYNC, e com isso podem ser reimpressas em outras máquinas;
 +
*Possibilidade de download de todas as NFC-e pelo site, através da opção: ''Vendas e Devoluções > Opções > NFC-e por API > Download''
 +
*Atualização automática de tabelas e arquivos necessários (schemas, url qrcode, url chave de acesso), facilitando quando a SEFAZ atualiza alguma coisa;
 +
*Atualização automática do certificado digital, pegando do site dfe.officesystem.com.br;
 +
 
 +
==Contingência, como funciona?==
 
Ao ativar o modo de contingência, as notas são assinadas, impressas e armazenadas (sem transmissão). O status da venda fica como "Impressa em Contingência".
 
Ao ativar o modo de contingência, as notas são assinadas, impressas e armazenadas (sem transmissão). O status da venda fica como "Impressa em Contingência".
 +
  
 
A cada 30 minutos, o sistema automaticamente tentará transmitir as notas armazenadas como contingência e que ainda não foram transmitidas.
 
A cada 30 minutos, o sistema automaticamente tentará transmitir as notas armazenadas como contingência e que ainda não foram transmitidas.
 +
 
Para evitar duplicidade nesse processo, cada USUARIO/SISTEMA pega automaticamente as notas que emitiu para transmitir.
 
Para evitar duplicidade nesse processo, cada USUARIO/SISTEMA pega automaticamente as notas que emitiu para transmitir.
 +
 
E caso hajam notas armazenadas há mais de 3 dias pendentes de transmissão, qualquer usuário tentará transmiti-las, para evitar que fiquem "penduradas" caso algum usuário não faça mais o login.
 
E caso hajam notas armazenadas há mais de 3 dias pendentes de transmissão, qualquer usuário tentará transmiti-las, para evitar que fiquem "penduradas" caso algum usuário não faça mais o login.
  
 
==Requisitos==
 
==Requisitos==
−
Master Key versão 4.04.155 ou superior
+
Master Key versão 4.04.155 ou superior.
−
<b>Atenção: No momento, a API funciona somente para NFC-e modelo 65. Modelo 55 continua funcionando com o Master NF-e.</b>
+
 
 +
<b>Atenção: No momento, a API funciona somente para NFC-e modelo 65. Modelo 55 continua funcionando pelo Master NF-e.</b>
  
 
==Como configurar==
 
==Como configurar==
−
asdasdas
+
===Parâmetros Específicos===
 +
ALÉM das configurações já existentes para emissão de NFC-e (Que continuam sendo necessárias), precisa ser configurado algumas informações obrigatórias para a API, conforme imagem abaixo:
 +
[[Arquivo:Config nfce api.png|alt=|commoldura|centro]]
 +
 
 +
 
 +
'''1) Utilizar NFC-e por API''': Habilitar
 +
 
 +
'''2) Token API''': Informar o token, que pode ser obtido no ''OfficeAtendimentos > Softwares dos Cliente > Master Key,'' conforme imagem ao final.
 +
 
 +
'''3) Configurar''': Ao clicar irá abrir o site dfe.officesystem.com.br para ser configurado o ambiente e o certificado digital.
 +
 
 +
'''4) Carregar''': Irá carregar as configurações realizadas no passo anterior.
 +
 
 +
'''5) Id Token e Token''': Informar ambos
 +
 
 +
 
 +
Token API no Office Atendimentos:
 +
[[Arquivo:Token_api.png|alt=|centro|commoldura]]
 +
 
 +
===Usuário===
 +
 
 +
O usuário deve estar com "NFC-e por API" habilitado e com uma impressora configurada, conforme imagem abaixo:
 +
[[Arquivo:Usuario nfe api.png|centro|commoldura]]
 +
 
  
 
==Erros comuns==
 
==Erros comuns==
−
Fiquem livres para acrescentar aqui
+
1) Mesagem de Token API invalido ou Não informado. Verificar token e CNPJ da Empresa.
 +
 
 +
 
 +
2) Falha ao validar configuções nos parametros do Master Key.:
 +
 
 +
- URL do QrCode da NFCe não informado !
 +
 
 +
- URL da Chave de Acessso da NFCe não informado !
 +
 
 +
- Schemas nao Encontrado !
 +
 
 +
Aguardar um pouco.. sair do sistema e acessar novamente.. pois não deu tempo de baixar as informações do site.
 +
 
 +
 
 +
3) Ao enviar NFCe --> Classe Nao Registrada, ClassID --> Erro na dll msxml5. Registrar a DLL que está na pasta do MK4 com o comando no CMD como ADMINISTRADOR:
 +
 
 +
regsvr32 "C:\Sistema\MK4\msxml5.dll"
 +
 
 +
 
 +
 
 +
 
 +
 
 +
.

Edição atual tal como às 14h11min de 29 de maio de 2025

O que é?

É uma nova forma de emitir NFC-e pelo Master Key e Master Key PDV. Não utilizando mais o software Master NF-e.

Como funciona?

Ao gerar NFC-e pelo Master Key ou pelo PDV, o arquivo xml será gerado, assinado e enviado diretamente para a nossa api (dfe.officesystem.com.br).

A API fará o resto da transmissão utilizando o certificado digital do cliente.

Benefícios

  • Mais rápido;
  • Não necessita do Master NF-e instalado;
  • Não necessita do Microsoft .NET instalado;
  • Não necessita do certificado digital instalado;
  • Redução de erros por SSL/TLS, .NET, Cadeia de certificados, permissão de arquivos, etc...
  • Notas são sincronizadas pelo DBSYNC, e com isso podem ser reimpressas em outras máquinas;
  • Possibilidade de download de todas as NFC-e pelo site, através da opção: Vendas e Devoluções > Opções > NFC-e por API > Download
  • Atualização automática de tabelas e arquivos necessários (schemas, url qrcode, url chave de acesso), facilitando quando a SEFAZ atualiza alguma coisa;
  • Atualização automática do certificado digital, pegando do site dfe.officesystem.com.br;

Contingência, como funciona?

Ao ativar o modo de contingência, as notas são assinadas, impressas e armazenadas (sem transmissão). O status da venda fica como "Impressa em Contingência".


A cada 30 minutos, o sistema automaticamente tentará transmitir as notas armazenadas como contingência e que ainda não foram transmitidas.

Para evitar duplicidade nesse processo, cada USUARIO/SISTEMA pega automaticamente as notas que emitiu para transmitir.

E caso hajam notas armazenadas há mais de 3 dias pendentes de transmissão, qualquer usuário tentará transmiti-las, para evitar que fiquem "penduradas" caso algum usuário não faça mais o login.

Requisitos

Master Key versão 4.04.155 ou superior.

Atenção: No momento, a API funciona somente para NFC-e modelo 65. Modelo 55 continua funcionando pelo Master NF-e.

Como configurar

Parâmetros Específicos

ALÉM das configurações já existentes para emissão de NFC-e (Que continuam sendo necessárias), precisa ser configurado algumas informações obrigatórias para a API, conforme imagem abaixo:


1) Utilizar NFC-e por API: Habilitar

2) Token API: Informar o token, que pode ser obtido no OfficeAtendimentos > Softwares dos Cliente > Master Key, conforme imagem ao final.

3) Configurar: Ao clicar irá abrir o site dfe.officesystem.com.br para ser configurado o ambiente e o certificado digital.

4) Carregar: Irá carregar as configurações realizadas no passo anterior.

5) Id Token e Token: Informar ambos


Token API no Office Atendimentos:

Usuário

O usuário deve estar com "NFC-e por API" habilitado e com uma impressora configurada, conforme imagem abaixo:

Usuario nfe api.png


Erros comuns

1) Mesagem de Token API invalido ou Não informado. Verificar token e CNPJ da Empresa.


2) Falha ao validar configuções nos parametros do Master Key.:

- URL do QrCode da NFCe não informado !

- URL da Chave de Acessso da NFCe não informado !

- Schemas nao Encontrado !

Aguardar um pouco.. sair do sistema e acessar novamente.. pois não deu tempo de baixar as informações do site.


3) Ao enviar NFCe --> Classe Nao Registrada, ClassID --> Erro na dll msxml5. Registrar a DLL que está na pasta do MK4 com o comando no CMD como ADMINISTRADOR:

regsvr32 "C:\Sistema\MK4\msxml5.dll"



.

Disponível em “https://wiki.officesystem.com.br/index.php?title=NFCe_por_API&oldid=2274”