NFCe por API
Índice
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:
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
.