Pular para o conteúdo

Pré-emissão

Veja o erro antes da prefeitura

A pré-emissão faz tudo o que a emissão faz, menos transmitir. Você descobre o que está faltando, por que e como resolver, sem gastar uma tentativa nem um número de nota.

Resposta curta: A pré-emissão do SendNF monta a nota, confere empresa, certificado, cidade, código de serviço e NBS, e valida no XSD oficial ou no provedor da prefeitura. Cada problema volta com o guia para corrigir.

Rejeição de nota quase sempre é cadastro: o código de serviço que a cidade não aceita, a inscrição municipal que faltou, o certificado de outro CNPJ. O problema é que você só descobre depois de transmitir, e a mensagem do órgão nem sempre ajuda.

A pré-emissão inverte a ordem. Ela responde em segundos, e cada problema traz:

  • o código do problema, para o seu sistema tratar
  • a mensagem em português claro
  • o campo que precisa mudar
  • o guia com o passo a passo para conseguir o dado
POST /v1/nfse/preview
{
  "ok": false,
  "route": { "system": "municipal", "provider": "ISSSaoPaulo" },
  "validated": null,
  "problems": [{
    "code": "no_municipal_service_code",
    "message": "A prefeitura da empresa usa sistema próprio: cadastre o código de serviço municipal.",
    "guide": {
      "title": "Código de serviço municipal",
      "steps": ["Abra uma nota antiga emitida pela empresa no site da prefeitura…", "…"]
    }
  }]
}

O que é conferido

Oito checagens antes de transmitir

Empresa e certificado

Certificado A1 enviado, dentro da validade e do mesmo CNPJ da empresa.

Ver o guia

Sistema da cidade

Se a prefeitura usa o Sistema Nacional da NFS-e ou um sistema próprio, e qual provedor. MEI sempre vai pelo nacional.

Código de serviço

Se o código de tributação nacional existe na lista oficial e se ele foi informado (na nota ou como padrão da empresa).

Ver o guia

NBS e reforma tributária

Se o NBS exigido pela reforma está presente ou pode ser descoberto pela tabela oficial de correlação.

Ver o guia

Exigências da prefeitura

Inscrição municipal e código de serviço municipal para cidades com sistema próprio.

Ver o guia

Layout oficial

Com certificado, a nota é assinada e validada no XSD do Sistema Nacional, ou validada pelo provedor da prefeitura, sem ser transmitida.

Tomador e valores

CPF ou CNPJ válido, total maior que zero, desconto que não passa do item, competência que não está no futuro.

NFC-e

Inscrição estadual, CSC, NCM com 8 dígitos, CFOP de operação interna, CSOSN suportado e tributos aproximados (IBPT).

Ver o guia

Níveis de validação

Até onde a pré-emissão foi

validatedSignifica
schemaA DPS foi assinada e passou no XSD oficial do Sistema Nacional da NFS-e.
municipalO provedor da prefeitura gerou o lote sem erros (cidades com sistema próprio).
localO XML foi montado e os dados conferidos; a validação oficial não rodou (sem certificado ou serviço indisponível).
nullHá problemas que impedem montar a nota; veja a lista problems.

Os erros que só o órgão detecta continuam possíveis. Veja os mais comuns em rejeições da NFS-e e como resolver.

Perguntas sobre a pré-emissão

O que é pré-emissão de nota fiscal?

É uma simulação completa da nota sem transmiti-la ao órgão fiscal. O SendNF monta o XML como na emissão real, confere os dados e valida no layout oficial, e devolve o que impediria a autorização.

A pré-emissão garante que a nota será autorizada?

Ela elimina os erros de cadastro e de layout mais comuns, mas não tudo: algumas regras só a prefeitura ou a Receita checam na hora (por exemplo, se a cidade aceita aquele código de serviço naquela data). Quando isso acontece, a rejeição vem explicada em português.

A pré-emissão conta como nota no plano?

Não. Pré-emissões são ilimitadas e não contam como nota.

Preciso de certificado para pré-emitir?

Não para as checagens de cadastro e de dados. Para a validação no layout oficial (assinatura e XSD, ou provedor da prefeitura) o certificado é necessário, porque a nota precisa ser assinada como na emissão real.

Como uso a pré-emissão na minha tela?

Chame POST /v1/nfse/preview (ou /v1/nfce/preview) com o mesmo corpo da emissão. A resposta traz ok, problems e warnings com mensagem, campo e guia, prontos para mostrar ao seu usuário.

Pré-emita a sua primeira nota

Pré-emissões são ilimitadas e não contam no plano. Crie a conta grátis e teste com o seu CNPJ.

Criar conta grátisVer a API