NFCe por API

De Office System
Ir para navegação Ir para pesquisar

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:

regsvr32 msxml5.dll



.