Funciones

stackin concentra el ciclo de vida de los documentos fiscales brasileños en una única plataforma: emisión, consulta y cancelación de NF-e y NFS-e, con comunicación directa con los autorizadores — SEFAZ para NF-e y la infraestructura nacional de NFS-e.

No existe una implementación simulada para homologation. Las solicitudes se transmiten a los entornos de prueba ofrecidos por los propios autorizadores, manteniendo el flujo de integración cercano al usado en production.

Cada solicitud pertenece a una empresa registrada en stackin. La información del emisor — dirección, municipio, estado y certificado digital — es resuelta por la plataforma. Tu aplicación envía principalmente los datos de la operación — destinatario, ítems, montos y demás información fiscal necesaria — sin repetir la configuración del emisor en cada documento.

En NF-e, la plataforma estructura y calcula los grupos tributarios aplicables, incluyendo ICMS, IPI, PIS y COFINS, a partir de la información fiscal proporcionada. En NFS-e, la estructura es propia para prestación de servicios, siguiendo el modelo nacional y los campos exigidos para ese tipo de documento.

Sigue todo el ciclo del documento

El dashboard registra el historial de cada documento y permite seguir su estado desde el envío hasta el resultado final. Los documentos pueden verse como autorizados, rechazados o cancelados, junto a los eventos ocurridos durante el procesamiento — cuando una solicitud es rechazada, la respuesta del autorizador queda disponible en el propio historial, facilitando el diagnóstico sin tener que buscar manualmente el error en el XML. El mismo historial puede seguirse por la API, permitiendo que tu aplicación maneje cada estado de forma programática.

Consulta directo en el autorizador

La consulta permite verificar el estado actual de un documento por su clave de acceso directamente en el autorizador, sin depender solo de la información almacenada por stackin — útil cuando tu aplicación necesita confirmar el estado fiscal de un documento antes de continuar otro proceso, por ejemplo liberar un pedido, iniciar una rutina contable o ejecutar una automatización después de la autorización.

Cancelación

La cancelación sigue las reglas definidas por el autorizador de cada documento. Para NF-e, por ejemplo, la justificación debe tener al menos 15 caracteres, según la exigencia del campo xJust — la solicitud se transmite al autorizador y el resultado pasa a formar parte del historial del documento. La cancelación no devuelve la cuota utilizada en la emisión original, ya que la transmisión del documento al autorizador ya ocurrió.

Una cuenta para todo

NF-e y NFS-e son productos distintos, con schemas, campos fiscales y autorizadores diferentes, pero comparten la misma infraestructura dentro de stackin — una empresa registrada puede usar los distintos productos con el mismo conjunto de credenciales y la misma configuración de cuenta. Si tu operación emite documentos de productos y de servicios, no necesitas mantener dos integraciones, dos conjuntos de API keys ni dos entornos independientes.

Una API consistente

Los endpoints de listado siguen el mismo patrón de paginación, y los errores usan códigos HTTP compatibles con el resultado de la operación, en vez de respuestas 200 con errores escondidos en el cuerpo. Las API keys siguen un único modelo de autenticación — un token Bearer — pero cada clave lleva un context (sdk o api) que define en qué host es válida: una clave api autentica en api.stackin.io, una sdk en sdk.stackin.io, y usar la clave en el host equivocado devuelve 401. Ver API REST para detalles sobre autenticación, paginación, respuestas y códigos de error.

¿REST o SDK?

Todos los recursos pueden accederse directamente por la API REST o por los SDKs oficiales. Usa la API REST cuando quieras trabajar directamente con HTTP o ya tengas tu propia capa de integración; usa un SDK cuando quieras modelos tipados, validaciones, manejo de errores y menos código de infraestructura. En ambos casos, el destino es el mismo: la misma API, los mismos documentos y el mismo comportamiento.

Para conocer los flujos específicos de cada producto, ver Emisión de NFe y Emisión de NFSe.