stackinSDK de Python
Una clase, cuatro métodos — emitir, consultar, cancelar — tipados y validados.
El SDK oficial de Python (pip install stackin-python-sdk, import stackin) envuelve la API REST uno a uno: una clase Invoice con issue(), consult() y cancel() — nada más que instanciar. Cada ítem de línea es un Product tipado, con campos fiscales específicos de Brasil (NCM/CFOP/CEST...) exigidos solo donde el autorizador realmente los necesita.
Autentica de la misma forma que la API cruda — una única API key — así que cambiar entre SDK y llamadas HTTP directas después no cambia cómo está configurada tu cuenta o entorno.
Los errores aparecen como tres tipos distintos en vez de una falla genérica: APIError lleva el código de estado y el detalle del propio autorizador, ConnectionFailedError cubre fallos de red/DNS/timeout antes de que llegue cualquier respuesta, y un ValueError común detecta problemas de validación del lado cliente — ítems vacío, o ncm/cfop faltante en un ítem de NF-e — antes de que la solicitud siquiera se envíe. APIError y ConnectionFailedError heredan de InvoiceError, así que puedes capturar ambas de una vez.
El SDK está construido sobre la misma configuración .code_quality/ y forma de CI que cualquier otro SDK oficial de stackin, y el mismo contrato universal de API, así que una integración en Python se lee igual a la de Go en cuanto conoces una de las dos.
Consulta la sección SDKs de la referencia de la API para comandos de instalación, o el código en GitHub.