Recursos

O stackin concentra o ciclo de vida de documentos fiscais brasileiros em uma única plataforma: emissão, consulta e cancelamento de NF-e e NFS-e, com comunicação direta com os autorizadores — SEFAZ para NF-e e a infraestrutura nacional da NFS-e.

Não existe uma implementação simulada para homologação. As requisições são transmitidas aos ambientes de teste disponibilizados pelos próprios autorizadores, mantendo o fluxo de integração próximo ao utilizado em produção.

Cada requisição pertence a uma empresa cadastrada no stackin. Informações do emitente, como endereço, município, UF e certificado digital, são resolvidas pela plataforma. Sua aplicação envia principalmente os dados da operação — destinatário, itens, valores e demais informações fiscais necessárias — sem precisar repetir a configuração do emissor em cada documento.

Na NF-e, a plataforma estrutura e calcula os grupos tributários aplicáveis, incluindo ICMS, IPI, PIS e COFINS, a partir das informações fiscais fornecidas. Na NFS-e, a estrutura é própria para prestação de serviços, seguindo o modelo nacional e os campos exigidos para esse tipo de documento.

Acompanhe todo o ciclo do documento

O dashboard registra o histórico de cada documento e permite acompanhar seu estado desde o envio até o resultado final. Documentos podem ser visualizados como autorizados, rejeitados ou cancelados, junto aos eventos ocorridos durante o processamento — quando uma requisição é rejeitada, a resposta do autorizador fica disponível no próprio histórico, facilitando o diagnóstico sem exigir que você procure manualmente pelo erro no XML. O mesmo histórico pode ser acompanhado pela API, permitindo que sua aplicação trate cada estado de forma programática.

Consulta direto no autorizador

A consulta permite verificar o estado atual de um documento pela chave de acesso diretamente no autorizador, sem depender apenas das informações armazenadas pelo stackin — útil quando sua aplicação precisa confirmar o estado fiscal de um documento antes de continuar outro processo, por exemplo liberar um pedido, iniciar uma rotina contábil ou executar uma automação após a autorização.

Cancelamento

O cancelamento segue as regras definidas pelo autorizador de cada documento. Para NF-e, por exemplo, a justificativa deve possuir pelo menos 15 caracteres, conforme a exigência do campo xJust — a solicitação é transmitida ao autorizador e o resultado passa a fazer parte do histórico do documento. O cancelamento não devolve a cota utilizada na emissão original, já que a transmissão do documento ao autorizador já ocorreu.

Uma conta para tudo

NF-e e NFS-e são produtos distintos, com schemas, campos fiscais e autorizadores diferentes, mas compartilham a mesma infraestrutura dentro do stackin — uma empresa cadastrada pode utilizar os diferentes produtos com o mesmo conjunto de credenciais e a mesma configuração de conta. Se sua operação emite documentos de produtos e de serviços, não é necessário manter duas integrações, dois conjuntos de API keys ou dois ambientes independentes.

Uma API consistente

Os endpoints de listagem seguem o mesmo padrão de paginação, e erros utilizam códigos HTTP compatíveis com o resultado da operação, em vez de respostas 200 contendo erros escondidos no corpo. As API keys seguem um único modelo de autenticação — um token Bearer — mas cada chave carrega um context (sdk ou api) que define em qual host ela vale: uma chave api autentica em api.stackin.io, uma sdk em sdk.stackin.io, e usar a chave no host errado retorna 401. Veja API REST pra detalhes sobre autenticação, paginação, respostas e códigos de erro.

REST ou SDK?

Todos os recursos podem ser acessados diretamente pela API REST ou pelos SDKs oficiais. Use a API REST quando quiser trabalhar diretamente com HTTP ou já tiver sua própria camada de integração; use um SDK quando quiser modelos tipados, validações, tratamento de erros e menos código de infraestrutura. Nos dois casos, o destino é o mesmo: a mesma API, os mesmos documentos e o mesmo comportamento.

Pra conhecer os fluxos específicos de cada produto, veja Emissão de NFe e Emissão de NFSe.