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.

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.

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.