Catálogo de documentos fiscais: como transformar oito siglas em um plano de integração verificável

Quem integra emissão fiscal costuma começar pela pergunta errada: "a API emite NFS-e?". A pergunta útil é outra: emite a NFS-e que a minha operação precisa, no município do meu emitente, no provedor que atende aquele município, no ambiente em que vou testar e para o tipo de operação que vou realizar? O catálogo FoxNFe reúne NF-e, NFC-e, NFS-e, CT-e, MDF-e, NFCom, DC-e e NFGás, mas a própria fonte oficial adverte que a presença de um documento no catálogo não prova suporte a todas as variantes. A lista é o ponto de partida do escopo, não a conclusão dele.

O problema concreto que isso resolve é o retrabalho de descobrir a limitação tarde. Um time que assume suporte amplo a partir da sigla tende a modelar o domínio, montar o fluxo de emissão e só então encontrar a lacuna — quando o custo de mudar o desenho já subiu. Tratar o catálogo como inventário de documentos e a matriz de cobertura como fonte de decisão por cenário inverte essa ordem: primeiro se confirma o cenário, depois se escreve o código. A orientação da fonte é explícita: consulte a matriz de cobertura por município, provedor, ambiente e operação.

Há um limite que precisa ficar claro para não virar promessa vazia. Confirmar que um documento aparece no catálogo e que um cenário está coberto não é o mesmo que obter autorização fiscal. A fonte oficial separa as duas coisas ao afirmar que aceitação ou enfileiramento não é autorização fiscal, e que é preciso verificar resultado e protocolo do autorizador. Ou seja: cobertura de escopo responde "consigo enviar esta operação?"; o protocolo responde "o autorizador aceitou este documento?". São conferências distintas, em momentos distintos, e nenhuma delas substitui a validação fiscal feita pela empresa e por sua equipe contábil.

Na prática, o caminho é documentar o escopo antes de codificar. Para cada documento que o produto precisa emitir, registre o cenário pretendido — documento, UF, município, provedor, ambiente e operação — e confronte com a matriz de cobertura. O que estiver confirmado entra no plano de integração; o que não estiver vira pendência explícita, não suposição silenciosa. Esse registro também serve de base para a validação do cenário em homologação, um dos pré-requisitos de emissão ao lado de empresa, certificado A1 e configuração fiscal. Escopo documentado é o que permite dizer, depois, por que uma operação funcionou e outra não.

Vale reforçar o que essa abordagem não entrega. Ela não garante que toda variante de um documento esteja disponível, não dispensa a conferência da matriz a cada novo cenário e não transforma catálogo em conformidade tributária. O ganho é de método: menos suposição, mais rastreabilidade entre o que foi planejado e o que foi efetivamente coberto. Para quem integra vários documentos e opera em mais de um município, essa disciplina é o que evita descobrir limites no meio da operação.