Ajuda e perguntas frequentes

Comece por aqui

O BastidorIA Notas emite a NFS-e no padrão nacional (Sefin Nacional). O caminho, na ordem:

1. Conexão: informe o endereço do emissor e a chave de API (como).
2. Certificado digital A1 da empresa, instalado no servidor pelo administrador (detalhes).
3. Empresa: cadastre e valide a empresa que emite (passo a passo).
4. Emitir: preencha o cliente e o serviço e emita (passo a passo).
5. Baixe e guarde o XML por 5 anos. O PDF é só a versão para impressão.

Criar conta e escolher plano

Tela Criar conta, em 4 passos:

1. Seus dados: nome, e-mail, senha com 10 ou mais caracteres, CPF/CNPJ, telefone e empresa (os dois últimos são opcionais). Marque o aceite dos Termos e da Privacidade.
2. Plano: escolha mensal ou anual (anual = 10 mensalidades por 12 meses). Planos EM BREVE não são vendidos: apenas registram interesse, sem cobrança.
3. Forma de pagamento: Pix, boleto ou cartão (o cartão é digitado no ambiente seguro do provedor, nunca aqui).
4. Confirmação: anote o número da assinatura: o suporte vai pedir.

Problemas comuns: cadastro fechado · paguei e não ativou · esqueci a senha · e-mail já cadastrado · muitas tentativas.

Conexão com o emissor

No painel "Conexão" da tela Emitir:

1. Endereço do emissor: o endereço completo, começando com https://, que o administrador informou.
2. Chave de API: digite a chave recebida do administrador. Ela fica só na aba aberta e some ao fechar.
3. A faixa colorida confirma: verde, conectado; amarela, aviso (leia); vermelha, sem conexão.
4. Para emitir de verdade, desmarque o modo demonstração: a nota gerada nele não tem validade.

Se não conectar: Emissor não encontrado · Chave inválida · Modo demonstração.

Certificado digital

A nota é assinada com o certificado A1 e-CNPJ (arquivo .pfx/.p12) da empresa emitente. Ele é configurado no servidor pelo administrador; você não o envia por esta tela.

Certificado A3 (token/cartão) não é aceito. Veja que certificado preciso.

Cadastro da empresa

Tela Empresa. O cadastro evita a maior parte das rejeições, porque confere os dados antes de emitir.

1. Digite o CNPJ e use Consultar na Receita: razão social, endereço, município (código IBGE) e regime são preenchidos.
2. Município de emissão: o do endereço do CNPJ, salvo orientação da prefeitura.
3. Inscrição municipal: tente primeiro sem. Preencha só se a Sefin pedir (E0116); apague se recusar (E0120). Veja a regra completa.
4. Regime: deixe "Conforme a Receita". Se ME/EPP, informe o percentual aproximado de tributos (E0712).
5. Serviços permitidos: use a caixa Buscar serviço e escolha na lista nacional (a descrição vem preenchida). A tela avisa se um código não existe. Cadastre os mesmos serviços que o portal mostra para a sua empresa (por quê).
6. Salve e leia o resultado da validação: erro (vermelho) bloqueia, atenção (amarelo) merece conferência, info só informa.

Status: validada, pendente, divergente, inativa. Dúvidas: código IBGE · código de tributação · serviço "não confirmado" · regime diverge.

Emitir uma nota

Tela Emitir:

1. Prestador: vem do cadastro da empresa; confira o nome mostrado.
2. Cliente (tomador): digite o CPF ou CNPJ. O sistema valida o dígito e busca primeiro no seu cadastro de clientes; CNPJ novo vem da Receita; CPF novo exige digitar o nome (por quê).
3. Serviço: escolha da lista do cadastro, descreva, informe valor e alíquota. ISS retido só se for o caso (atenção).
4. Clique em Conferir antes de emitir: o BastidorIA Notas confere empresa, certificado, cliente, serviço, valores e assinatura sem enviar nada e mostra o que está certo (OK), o que merece atenção e o que impede a emissão (Erro). Dá para baixar o PDF da conferência (não é nota fiscal) e emitir direto dali (como funciona).
5. Se preferir, Ver XML antes de enviar mostra só o XML assinado.
6. Clique em Emitir nota uma vez e aguarde. Não clique de novo mesmo que demore (por quê).
7. No resultado: chave de acesso, série e número, Baixar XML e Abrir DANFSe (PDF) (abre numa nova aba, onde dá para imprimir ou salvar).

Se aparecer uma lista vermelha: "Corrija os dados" significa que o sistema barrou antes de enviar (nada foi numerado); "A Sefin Nacional rejeitou" traz códigos E0xxx (veja a lista). Nos dois casos corrigir e emitir de novo é seguro.

Cancelar uma nota

1. Na tela Emitir, vá em "Cancelar uma nota". A chave da última nota emitida já vem preenchida.
2. Informe a chave de acesso (50 números), o motivo (1 erro na emissão, 2 serviço não prestado, 9 outros) e a justificativa (15 a 255 caracteres).
3. Confirme. A ação não pode ser desfeita.

O prazo de cancelamento depende do município: veja prazos e cancelar × substituir.

Quando algo dá erro

1. Leia a mensagem inteira: ela diz o campo ou o código.
2. Procure a mensagem ou o código na busca acima, ou nas listas abaixo.
3. Corrija o que for indicado e tente de novo. Se for erro de conexão, não emita de novo na hora: veja se a nota já saiu.
4. Se persistir, fale com o suporte levando as informações de esta seção.

Mensagens do sistema

Mensagens que o próprio BastidorIA Notas mostra, com a causa e a solução.

Códigos de erro da Sefin Nacional

Quando a Sefin rejeita a nota, ela devolve um código E0xxx e um texto oficial. Aqui estão os mais comuns, com a solução. Digite qualquer código na caixa abaixo para ver o texto oficial completo (são 466 no Anexo I da Sefin).

Os mais comuns

Perguntas frequentes

Para desenvolvedores

Autentique todas as rotas /v1/* com Authorization: Bearer <chave>. Rotas principais:

Veja as respostas HTTP em códigos HTTP, a idempotência em referência e os webhooks em assinatura. O detalhamento completo está no README do projeto.

Nome técnico → campo na tela

As listas de erro usam o nome do campo da API. Esta tabela traduz.

Glossário

Falar com o suporte

Para agilizar o atendimento, envie sempre:

• O texto completo da mensagem de erro e o código (E0xxx), se houver.
• A chave de acesso da nota (50 números), quando existir.
• O CNPJ do prestador e o ambiente (homologação ou produção).
• A data e hora aproximadas do problema.
• O número da assinatura, se o assunto for plano ou pagamento.
• Nunca envie a chave de API, a senha do certificado ou sua senha: o suporte jamais pede.