Inicio rápido

Esto asume que ya tienes una API key con contexto api y entorno homologation — ve Crea una cuenta si no la tienes. Homologation es gratis, sin límite de volumen, y ejercita la misma validación del autorizador que production, solo marcada como transmisión de prueba.

• Una API key con contexto api y entorno homologation.
• Una empresa registrada con su certificado digital cargado.
• La URL base https://api.stackin.io/api/v1.

Cada solicitud lleva la key como token Bearer — no hay campo separado de company_id o environment que llenar, la key ya resuelve ambos. La URL base es https://api.stackin.io/api/v1.

Para emitir una NF-e, haz POST a /invoices con document_type igual a nfe, nombre e identificación fiscal del comprador, uno o más items, y — solo para nfe — items[].product.br con código de clasificación fiscal ncm y cfop (NFS-e omite esto por completo, ya que un servicio no tiene ese código). Consulta la referencia de la API para el ejemplo completo de solicitud y respuesta en cURL, Python, Go o 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"
    }
  }'

Una llamada exitosa devuelve 201 con access_key, status, y el número de protocolo del gobierno — ese access_key es lo que usa toda consulta posterior (consultar, cancelar) como clave, así que guárdalo junto a tu propio registro del documento.

La misma llamada funciona para nfse — solo cambia document_type y quita el bloque product.br, ya que no aplica. Una vez que funcione en homologation, cambiar a production es solo cuestión de autenticar con una key diferente; nada en la forma de la solicitud cambia.