stackinSDK de PHP
Una clase, cuatro métodos — issue, consult, cancel — tipados con enums y named arguments de PHP 8.1.
El SDK oficial de PHP (composer require stackin-io/stackin-php-sdk) 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 Stackin\Br\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.
Requiere PHP 8.1+ para usar DocumentType como un enum real (NFE/NFSE) en lugar de una cadena libre — un typo se convierte en error de importación, no en un 422 de la API. La construcción y cada llamada a método usan named arguments (new Invoice(apiKey: '...'), new Product(description: '...', amount: 112.44, ncm: '...', cfop: '...')), así que el orden de los campos nunca importa.
Los errores aparecen como tres tipos distintos de excepción en vez de una falla genérica: Stackin\Errors\ApiError lleva el código de estado y el detalle del propio autorizador, Stackin\Errors\ConnectionFailedError cubre fallos de red/DNS/timeout antes de que llegue cualquier respuesta, y Stackin\Errors\InvoiceError detecta problemas de validación del lado cliente — ítems vacío, o ncm/cfop faltante en un ítem de NFE — antes de que la solicitud siquiera se envíe.
El SDK está construido sobre la misma configuración .code_quality/ (phpcs/PSR-12, PHPStan nivel 6) y forma de CI que cualquier otro SDK oficial de stackin, y el mismo contrato universal de API, así que una integración en PHP se lee igual a la de Python o Go en cuanto conoces una de ellas.
Consulta la sección SDKs de la referencia de la API para comandos de instalación, o el código en GitHub.