stackin
Voltar ao blog
Comece a criar

Início rápido

Do cadastro à primeira nota autorizada numa requisição, usando uma API key contra homologação.

Isso assume que você já tem uma API key com contexto api e ambiente homologation — veja Crie uma conta se ainda não tem. Homologação é grátis, sem limite de volume, e exercita a mesma validação do autorizador que produção, só marcada como transmissão de teste.

Toda requisição carrega a key como token Bearer — não existe campo separado de company_id ou environment pra preencher, a key já resolve os dois. A URL base é https://api.stackin.io/api/v1.

Pra emitir uma NF-e, faça POST /invoices com document_type igual a nfe, nome e CNPJ/CPF do comprador, um ou mais itens, e — só pra nfe — items[].product.br com código de classificação fiscal ncm e cfop (NFS-e pula isso completamente, já que serviço não tem esse código). Veja a referência da API pro exemplo completo de requisição e resposta em cURL, Python, Go ou PHP.

Uma chamada bem-sucedida retorna 201 com access_key, status, e o número de protocolo do governo — esse access_key é o que toda consulta futura (consultar, cancelar) usa como chave, então guarde ele junto do seu próprio registro do documento.

A mesma chamada funciona pra nfse — só troque document_type e tire o bloco product.br, já que não se aplica. Depois que funcionar em homologação, trocar pra produção é só questão de autenticar com uma key diferente; nada no formato da requisição muda.