Emitir NFS-e

NFS-e (Nota Fiscal de Serviços Eletrônica) é a nota fiscal de serviços. Diferente da NF-e, um serviço não tem código de classificação fiscal — um item de NFS-e só precisa de descrição e valor.

O stackin emite pelo sistema nacional de NFS-e (ADN), então a mesma integração funciona independente do município onde o emissor está cadastrado — sem webservice por cidade pra integrar separadamente.

Cancelamento, consulta e histórico funcionam igual à NF-e: uma chave de acesso, um dashboard, uma linha do tempo de envio.

Essa camada nacional é o motivo pelo qual integrações de NFS-e costumam ser mais difíceis de construir que as de NF-e: historicamente, cada cidade rodava seu próprio webservice, seu próprio schema de XML e suas próprias peculiaridades, o que significava que uma empresa vendendo serviços em nível nacional precisava de uma integração separada por município em que operava.

O trabalho da stackin é absorver essa variância por completo — a requisição que você envia não muda com base na cidade do emissor, e o formato da resposta é idêntico ao da NF-e sempre que possível, então um time já integrado com notas de produto pode adicionar notas de serviço sem aprender um segundo modelo mental.

O imposto sobre serviço (ISS) é municipal, não federal, e diferente dos grupos de imposto da NF-e, costuma ser retido ou declarado fora da própria chamada de emissão — por isso um item de NFS-e permanece intencionalmente mínimo, em vez de carregar o mesmo peso de classificação fiscal que um item de produto.

Assim como na NF-e, o certificado digital e os dados de cadastro do emissor são resolvidos a partir da configuração da empresa, não passados na chamada — a única decisão por item é qual foi o serviço e quanto custou.

Veja Emissão de NFSe pra como essa superfície da API se encaixa no resto da Stackin.