Comprou o componente de nota fiscal? O que ainda falta para a nota sair de verdade

A proposta comercial diz que o componente emite NF-e, NFC-e e documentos de cupom fiscal. O gerente lê, liga para o cliente e promete: "semana que vem a loja já está emitindo". Na segunda-feira, falta o certificado digital, o cadastro dos produtos não tem NCM, ninguém sabe o que fazer quando a Sefaz rejeita e o ambiente de homologação nunca foi testado. O componente é uma peça; a integração é um processo que continua sendo seu. A resposta curta: liste o que o fornecedor entrega, o que você entrega e o que o cliente entrega, e só prometa prazo depois de uma nota de teste autorizada de ponta a ponta.

Este guia é sobre o lado de gestão: como ler a proposta, dividir responsabilidades e montar o plano. A parte de código e de obrigação fiscal está no guia sobre biblioteca de nota fiscal e o papel do contador.

Por que a proposta parece resolver mais do que resolve

Componentes fiscais comerciais fazem um trabalho difícil e valioso: montam o XML no leiaute vigente, assinam com o certificado, conversam com os web services da Sefaz e devolvem o resultado. Isso economiza meses. Mas a proposta é escrita para vender a capacidade da peça, e "emite NF-e" é verdade no sentido de que a peça sabe emitir.

O que a frase não diz é que a nota depende de dados que só o seu sistema tem: emitente, destinatário, produtos, tributação, numeração. Depende de um certificado que só o cliente pode comprar. Depende de decisões que só quem entende o negócio pode tomar: o que acontece com o pedido quando a nota é rejeitada, quem é avisado, como se cancela. O componente não sabe nada disso.

O resultado é um desencontro clássico. O fornecedor entregou o que vendeu. O cliente esperava o que entendeu. E o integrador ficou no meio com o prazo que não deveria ter dado.

Como separar o que é de quem

O exemplo que segue é de uma software house fictícia, a Pratika, que vende um sistema de gestão para lojas de material de construção. Ela comprou um componente fiscal para emitir NF-e e NFC-e e vai implantar no primeiro cliente, a Casa do Tijolo.

A matriz de responsabilidades

Antes de qualquer prazo, a Pratika montou uma lista simples. Vale um documento compartilhado ou uma página no repositório:

FORNECEDOR DO COMPONENTE
  - geração do XML no leiaute vigente
  - assinatura digital com o certificado informado
  - comunicação com os web services da Sefaz
  - atualização do componente quando o leiaute mudar (conforme contrato)
  - suporte técnico ao componente (canal e prazo de resposta do contrato)

PRATIKA (INTEGRADOR)
  - mapear pedido do sistema para os campos da nota
  - numeração e série, sem pular e sem repetir
  - tratar rejeição: mensagem clara, pedido não fica como "faturado"
  - guardar XML autorizado e protocolo, com backup
  - cancelamento e carta de correção pela tela do sistema
  - ambiente de homologação configurado e testado
  - treinamento do operador

CASA DO TIJOLO (CLIENTE)
  - comprar e instalar o certificado digital e controlar a validade
  - credenciamento na Sefaz do seu estado para emitir
  - cadastro fiscal dos produtos (NCM, CFOP, tributação) validado
    pelo contador
  - CSC para NFC-e, obtido no portal da Sefaz
  - definir quem opera e quem é avisado em caso de erro

Só de olhar a terceira lista, o gerente percebe que a "semana que vem" depende de coisas fora do controle da Pratika. O cadastro de 4.000 produtos com tributação revisada pelo contador, sozinho, pode levar semanas.

O plano até a primeira nota de verdade

1. Leia o contrato, não o folheto. Procure o que está escrito sobre atualização de leiaute, suporte, licença por CNPJ ou por máquina e o que acontece se o contrato acabar. O que vale é o combinado assinado.
2. Faça a primeira nota em homologação com dados fictícios. No ambiente de homologação, a Sefaz processa a nota sem valor fiscal. O objetivo é chegar ao protocolo de autorização. Se não chegou, nada mais importa ainda.
3. Force as rejeições. Mande de propósito uma nota com NCM inválido, uma com destinatário sem inscrição correta, uma duplicada. Veja o que o sistema mostra para o operador e em que estado fica o pedido.
4. Teste cancelamento e contingência. Cancele uma nota autorizada. Desligue a internet e veja o que acontece com a NFC-e no caixa. Esses fluxos aparecem no primeiro dia de produção.
5. Confira a guarda do XML. Feche o sistema, abra outro computador e recupere o XML de uma nota de ontem. Se depende da máquina do caixa, não está guardado.
6. Repita com dados reais do cliente em homologação. Use o certificado e o cadastro da Casa do Tijolo, ainda sem valor fiscal. É aqui que aparecem os erros de tributação.
7. Só então marque a data de produção. E faça as primeiras notas reais acompanhando junto, com o contador disponível.

A diferença entre homologação e produção tem mais armadilhas do que parece. O guia sobre homologação que não é produção com outro endereço detalha o que muda.

Como falar de prazo com o cliente

Em vez de "semana que vem a loja está emitindo", a Pratika passou a dizer: "Nossa parte fica pronta em duas semanas. A data de produção depende do certificado instalado e do cadastro fiscal validado pelo seu contador. Assim que tivermos uma nota autorizada em homologação com seus dados, marcamos o dia". Isso parece menos vendedor e evita a ligação irritada da segunda-feira.

Coloque essas dependências por escrito na proposta da implantação. Quando o cliente atrasa o cadastro, a conversa é sobre um item da lista, não sobre a sua competência.

Erros comuns

• Prometer prazo pelo tempo de "ligar a DLL". Referenciar o componente leva uma tarde. O cadastro, o certificado e os testes levam semanas, e o prazo estoura na frente do cliente.
• Misturar o marketing do fornecedor com o contrato. O folheto diz "suporte completo"; o contrato pode dizer horário comercial e só para o componente. Na hora do problema, vale o contrato.
• Testar só o caminho feliz. A primeira rejeição em produção trava o caixa porque ninguém sabia em que estado o pedido ficava.
• Deixar a guarda do XML para depois. O XML autorizado é o documento fiscal. Se ele mora só na pasta do computador do caixa, uma formatação apaga o que deveria ser guardado.
• Assumir o cadastro fiscal sem o contador. NCM e tributação errados geram nota autorizada com imposto errado. O problema aparece meses depois, numa fiscalização.
• Esquecer a validade do certificado. Ele vence, e a emissão para no dia. Sem alguém responsável pelo calendário, a loja descobre no balcão.

Checklist

• Existe uma lista escrita do que é do fornecedor, do integrador e do cliente.
• Você leu no contrato o que cobre atualização de leiaute e suporte.
• Uma nota de homologação chegou ao protocolo de autorização.
• Pelo menos três rejeições forçadas mostram mensagem clara e pedido no estado certo.
• Cancelamento e contingência foram testados antes da produção.
• O XML autorizado é recuperável de fora da máquina que emitiu.
• O cadastro fiscal dos produtos foi validado pelo contador do cliente.
• A validade do certificado está num calendário com responsável.

Olhe o projeto fiscal que você tem em andamento agora: existe uma nota de homologação autorizada de ponta a ponta, ou só o componente referenciado no projeto?