Exibir código-fonte para NFCe por API

==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.

<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==
===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==
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





.