Emissão de NFe

Emissão de NF-e é uma das duas superfícies de documento do stackin (a outra é NFS-e). É acessível pela mesma API key, mesma base URL e mesmo dashboard de tudo mais — emitir uma nota de serviço amanhã não significa uma integração nova.

Como superfície de produto, emissão de NF-e é uma chamada: POST /invoices com document_type: "nfe". A resposta volta de forma síncrona assim que o autorizador responde — emitida com chave de acesso, ou rejeitada com o motivo do próprio autorizador — não há um passo separado de polling pro caso comum.

Todo documento cai em um de três estados — emitida, rejeitada ou cancelada — visível no dashboard junto com o payload cru enviado e a resposta crua do autorizador, o que importa quando uma rejeição precisa ser entregue a quem cuida da conformidade fiscal da empresa, em vez de ser debugada às cegas.

Cota é contada por emissão bem-sucedida, não por tentativa — um envio rejeitado (NCM errado, campo obrigatório faltando) não consome volume do plano, já que nada foi de fato transmitido e autorizado pela SEFAZ.

O mesmo endpoint, chave e formato de resposta funcionam em homologação e produção; a única coisa que muda entre os ambientes é contra qual deles a API key foi criada, o que é fixo pra vida daquela chave.

Veja a referência da API pro formato exato de requisição/resposta, e Emitir NF-e pros campos fiscais que a NF-e especificamente exige.