Da criação da conta à primeira credencial da API

Separe estes itens. Com eles em mãos, o caminho inteiro se faz numa sentada.

Ao final, você recebe um e-mail com o link para definir a senha.

O formulário pede quatro coisas e um aceite:

• E-mail. É por ele que o link de ativação chega, e é o seu login depois.
• Nome. Opcional. Sem ele, o painel mostra o seu e-mail.
• CNPJ da sua empresa. O formato alfanumérico, em vigor desde julho de 2026, é aceito.
• Razão social.
• Aceite dos Termos de Uso e da Política de Privacidade. A caixa vem desmarcada e os dois documentos abrem em aba nova para leitura.

Não há campo de senha aqui. Ela é definida no próximo passo, a partir do link do e-mail, depois que o endereço foi confirmado. Ao enviar, a tela diz Confira sua caixa de entrada e o cadastro está feito.

Ao final, o seu acesso está liberado e você pode entrar.

Abra o e-mail e clique no link. Ele leva à tela Defina sua senha, que pede a senha e a confirmação. A tela mostra ao vivo se a senha atinge o mínimo de 12 caracteres e se as duas conferem. Quem decide se a senha é aceita é o servidor, que também recusa senhas comuns demais.

Ao enviar, a tela diz Tudo pronto e oferece o botão para entrar.

Ao final, você está dentro do painel, com a conta protegida por senha e código.

Entre com o e-mail e a senha. Como você administra a conta, o painel só abre depois que o segundo fator estiver ligado, e por isso o primeiro acesso cai direto na tela de Segurança. São três passos:

1. Escaneie o QR code no seu app autenticador. Se a câmera não ajudar, digite a chave que aparece ao lado.
2. Digite o código de 6 dígitos que o app mostra, para confirmar que o pareamento funcionou.
3. Guarde os códigos de recuperação. A tela oferece o botão para baixá-los. Cada um vale uma vez e substitui o app se você perder o celular.

Depois disso, o botão Ir para o painel abre a conta. Em todo login seguinte, a tela Confirme o segundo fator pede o código do app, ou um código de recuperação.

Ao final, você sabe para onde cada item do menu leva, e quais deste guia importam agora.

O menu lateral tem doze itens. Os da tabela abaixo são os que este guia percorre. Os outros (Notas emitidas, Caixa de entrada, Manifestação, Consulta de cadastro e Exportação de XMLs) são do dia a dia, quando as notas começarem a existir.

No topo há um seletor de emitente. As telas de configuração e as listas obedecem a ele: com um emitente só, ele já vem escolhido; com vários, escolha antes de ver os dados.

Quem cria a conta entra com o papel de Proprietário, o único que enxerga e edita tudo. Os outros papéis estão no passo 10.

Ao final, a empresa que emite as notas está cadastrada, com certificado e ativa.

Um emitente é uma empresa que emite nota pela sua conta, com o próprio CNPJ, o próprio certificado e a própria numeração. Se você atende vários clientes, cada um é um emitente. O cadastro é um assistente de quatro passos, e a ordem importa: o emitente só é gravado na revisão, e o certificado só pode ser enviado depois disso.

Passo 1 de 4: Identificação da empresa

• CNPJ. Pode digitar com ou sem pontuação. A plataforma guarda só os dígitos.
• Inscrição estadual. O número, ou a palavra ISENTO.
• Razão social, conforme o cartão CNPJ, e o nome fantasia, opcional.
• Regime tributário. Simples Nacional vem marcado por padrão. As outras opções são Simples Nacional com excesso de sublimite, Regime Normal e MEI. Este campo decide como o ICMS de cada nota é classificado, então confira com o contador.
• Ambiente. Deixe em Homologação, que é o recomendado para começar. A opção Produção aparece, mas fica travada até a liberação no seu plano (passo 11).

Passo 2 de 4: Endereço fiscal

CEP, logradouro, número, bairro, município, estado e o código IBGE do município, de 7 dígitos. Esse código vai dentro de cada nota, então precisa estar certo. Ele está no cartão CNPJ e no site do IBGE.

Passo 3 de 4: Revisão

Confira tudo e conclua. Aqui o emitente é gravado, ainda como rascunho: ele aparece na lista, mas não emite até ter certificado e ser ativado.

Passo 4 de 4: Certificado A1

Escolha o arquivo .pfx ou .p12 e informe a senha dele. O servidor abre o arquivo, confere que o CNPJ do titular é o do emitente e que ele está na validade. A senha é guardada cifrada, junto com o certificado, e o certificado nunca sai da plataforma.

Com o certificado aceito, aparece o botão Ativar emitente. Clique nele. Pronto: o emitente está ativo e a lista o mostra sem a marca Inativo.

Ao final, você sabe com que parâmetros fiscais o emitente vai emitir, e de onde cada um vem.

Esta tela é uma ficha de leitura. Não há o que preencher: ela mostra os parâmetros em vigor e, em cada bloco, um selo dizendo de onde o valor vem. Os blocos são o Ambiente, os parâmetros da NFC-e, o Responsável técnico, que a plataforma já preenche, e a Reforma tributária.

A única ação da tela é Trocar ambiente, entre homologação e produção. Ela pede confirmação e fica registrada no histórico do emitente. Por enquanto, deixe como está: a troca é o passo 11.

Ao final, o emitente tem pelo menos uma série ativa, e pode receber o primeiro pedido de emissão.

Toda nota pertence a uma série, que é uma faixa de numeração. Sem a série no ambiente em que o emitente está, a API recusa o pedido de emissão. Crie uma para cada documento que o emitente vai usar. O formulário pede:

• Ambiente. Homologação ou produção. Vem marcado o ambiente em que o emitente está, que por enquanto é homologação.
• Documento. NF-e (55) ou NFC-e (65).
• Série. O número da série. Se você está começando, use 1.
• Modo. Gerenciada: a plataforma aloca o próximo número a cada emissão, e o seu sistema não manda número nenhum. Externa: o seu sistema manda o número de cada nota, e a plataforma só confere. Na dúvida, escolha Gerenciada.
• Próximo número. O primeiro número que a série vai usar. Na série de homologação, qualquer um serve. Na de produção, use 1 se o emitente nunca emitiu em produção; se ele vem de outro sistema, continue de onde a numeração de produção parou.

A série nasce ativa. A tela mostra as séries de homologação e as de produção em seções separadas, a do ambiente atual primeiro. Na lista, o interruptor de cada linha liga e desliga a série, e o botão de editar permite trocar o modo ou avançar o próximo número. Ele só aceita um número acima do maior já emitido na série.

Ao final, você tem o par Client ID e Secret que o seu sistema usa para falar com a API.

Uma credencial é o acesso do seu sistema, sem pessoa no meio. O formulário pede:

• Descrição. Algo que identifique quem usa: "ERP loja 3", "job noturno de conciliação".
• Tipo. Operacional emite por um emitente, que você escolhe em seguida. É a certa para integrar um cliente, e o Quickstart da API foi escrito para ela. Gestão administra a conta inteira, inclusive cadastrando emitentes, e só o Proprietário pode criá-la.

Ao salvar, a tela mostra o Client ID e o Secret. O Secret aparece uma única vez. Copie os dois agora e guarde num lugar seguro. Se ele se perder, o caminho é revogar a credencial e criar outra. A tela também imprime o endereço-base da API, que o seu sistema usa junto com a credencial.

Entregue ao desenvolvedor o Client ID, o Secret, o endereço-base e o link da Referência da API. O Quickstart de lá emite uma nota de homologação em três chamadas, e o exemplo de integração é um sistema pequeno, com código aberto, que percorre o ciclo inteiro: do cadastro do emitente à nota autorizada e ao aviso do webhook.

Ao final, o seu sistema recebe o resultado de cada nota no instante em que a SEFAZ responde. Este passo é opcional.

Um webhook é um endereço do seu sistema que a plataforma chama para avisar o desfecho de cada nota. Sem ele, o seu sistema pode esperar a resposta na própria chamada ou consultar depois. A aba mostra um cartão por emitente, e a configuração é uma por emitente:

• URL. Um endereço HTTPS público do seu sistema.
• Entrega ativa. O interruptor que liga e desliga os avisos sem apagar a configuração.

Ao salvar pela primeira vez, a plataforma gera um segredo, que assina cada entrega. O seu desenvolvedor usa esse segredo para conferir que a chamada veio do Flex DFe. Ele também aparece uma única vez, e o botão de rotacionar gera outro quando for preciso.

Ao final, cada pessoa da sua empresa entra com o próprio acesso e vê só o que precisa.

O convite pede o nome, o e-mail, o papel e o escopo: todos os emitentes, ou só alguns. A pessoa recebe o e-mail "Ative seu acesso", define a senha e entra. Enquanto isso, ela aparece na lista com a marca Convite pendente.

Ninguém concede um papel acima do seu. Proprietário e Gestor também precisam ligar o segundo fator no primeiro acesso, como no passo 3; Operador e Fiscal, não. Pela mesma tela, o botão Gerenciar de cada linha troca o papel e o escopo, zera o segundo fator de quem perdeu o celular e remove o acesso.

Ao final, as notas do emitente têm valor fiscal.

A homologação é gratuita, sem limite de notas e sem prazo. A produção depende do seu plano, e o painel diz isso no próprio botão: enquanto a conta não tiver produção liberada, a opção aparece desabilitada com o motivo ao lado.

1. Peça a liberação escrevendo para suporte@flexdfe.com.br, com a razão social e o CNPJ da sua conta. O próprio painel monta esse e-mail quando você clica no aviso.
2. Crie as séries de produção do emitente, como no passo 7, escolhendo Produção no campo Ambiente. A numeração de produção é separada da de teste e começa no número que você escolher.
3. Troque o ambiente em Config. DF-e. A tela avisa que as notas passam a ter valor fiscal, que as URLs do QR Code da NFC-e mudam, e que a mudança fica registrada. Se algum documento com série ativa em homologação ainda não tiver série de produção, ela diz qual e oferece um atalho para criá-la; se a série de produção existir, mas estiver inativa, ela pede para reativá-la. Confirme em Promover para produção.

Novos emitentes já podem nascer em produção, escolhendo o ambiente no passo 1 do cadastro, enquanto o plano tiver vaga.