NFCe por API

De Office System
Revisão de 20h53min de 9 de janeiro de 2025 por Jonas (discussão | contribs)
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 instalar o certificado digital;
  • 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 (Vendas e Devoluções > Opções > Download NFC-e);
  • 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

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

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:


Erros comuns

Fiquem livres para acrescentar aqui