Início rápido

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.

• Uma API key com contexto api e ambiente homologation.
• Uma empresa cadastrada com o certificado digital enviado.
• A URL base https://api.stackin.io/api/v1.

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.

curl -X POST https://api.stackin.io/api/v1/invoices \
  -H "Authorization: Bearer $STACKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "nfe",
    "client_name": "Buyer Company Ltd",
    "tax_id": "11222333000181",
    "items": [
      {
        "description": "Rosa Holambra Vermelha",
        "unit_price": "112.44",
        "product": { "br": { "ncm": "06031100", "cfop": "5102" } }
      }
    ],
    "recipient_address": {
      "street": "Rua das Flores",
      "number": "1200",
      "neighborhood": "Centro",
      "city": "Joinville",
      "state": "SC",
      "zip_code": "89201100",
      "city_code": "4209102"
    }
  }'

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.