Mudanças entre as edições de "NFCe por API"
| (20 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). | ||
| Linha 11: | Linha 11: | ||
*Mais rápido; | *Mais rápido; | ||
*Não necessita do Master NF-e instalado; | *Não necessita do Master NF-e instalado; | ||
| − | *Não necessita | + | *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; | *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 | + | *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== | + | ==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". | ||
| Linha 33: | Linha 35: | ||
==Como configurar== | ==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: | 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| | + | [[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 no CMD como ADMINISTRADOR: | |
| + | |||
| + | regsvr32 "C:\Sistema\MK4\msxml5.dll" | ||
| − | |||
| − | + | . | |
| − | |||
Edição atual tal como às 14h11min de 29 de maio de 2025
Í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 no CMD como ADMINISTRADOR:
regsvr32 "C:\Sistema\MK4\msxml5.dll"
.
