Skip to main content
A SUOT publica atualizações dos SDKs com regularidade. Manter-se atualizado garante acesso a novos recursos, suporte aos schemas mais recentes do SEFAZ e da ANTT, correções de segurança e compatibilidade com as Notas Técnicas (NTs) vigentes. Esta página explica como acompanhar as novidades, realizar upgrades de forma segura e entender o comportamento dos pacotes instalados quando a licença expira.

​
Acompanhar novidades

O Developer Portal é o ponto central para acompanhar o que há de novo nos SDKs SUOT. Lá você encontra o histórico de releases, o roadmap de funcionalidades e os avisos sobre Notas Técnicas do SEFAZ e da ANTT que impactam os pacotes. Além do portal, recomendamos acompanhar o arquivo CHANGELOG.md de cada pacote instalado. Ele detalha, por versão, as mudanças de comportamento, novos recursos, correções e breaking changes.
Use composer show suot/fiscal-core (ou o pacote equivalente) para verificar qual versão está instalada no seu ambiente e compará-la com a versão mais recente disponível no packages.suot.dev.
Pacotes marcados como Early Access ou Em desenvolvimento podem conter breaking changes entre minor versions durante o período de acesso antecipado. Leia o CHANGELOG com atenção antes de atualizar esses pacotes em produção.

​
Fazer upgrade

O processo de upgrade dos SDKs SUOT segue o fluxo padrão do Composer. Para atualizar pacotes específicos sem alterar outras dependências do projeto: 
composer update suot/fiscal-core suot/fiscal-cte
Para o SUOT ANTT SDK: 
composer update suot/antt-core suot/antt-ciot
Caso utilize o Laravel Bridge, inclua-o no comando: 
composer update suot/fiscal-core suot/fiscal-cte suot/fiscal-laravel
Leia o CHANGELOG antes de atualizar em produção. Versões major (2.x → 3.x) podem introduzir breaking changes nas interfaces de Command, Handler e Result. Versões minor e patch são geralmente retrocompatíveis, mas sempre valide em homologação primeiro.
Para produção, fixe as versões no composer.json usando constraints conservadoras (ex: ^2.4) e realize upgrades de forma explícita e planejada. Evite usar * ou @latest em ambientes críticos.
{
    "require": {
        "suot/fiscal-core": "^2.4",
        "suot/fiscal-cte": "^2.4",
        "suot/fiscal-laravel": "^2.4"
    }
}
O fluxo recomendado para upgrades em produção é:
1

Leia o CHANGELOG

Revise o CHANGELOG.md do pacote para identificar breaking changes, deprecações e novos requisitos.
2

Atualize em ambiente de desenvolvimento

Execute composer update localmente e ajuste o código para quaisquer breaking changes identificados.
3

Valide em homologação

Execute seus testes e valide os fluxos principais (emissão, cancelamento, consulta) no ambiente de homologação do SEFAZ/ANTT.
4

Deploy em produção

Após validação bem-sucedida em homologação, promova a atualização para produção seguindo seu processo de deploy habitual.

​
Versões e licença

O acesso às versões dos SDKs SUOT está vinculado a uma licença ativa para a sua organização.

Licença ativa

Com licença ativa, sua organização tem acesso a todas as versões publicadas — incluindo novas releases, patches de segurança e atualizações de schema.

Licença vencida

Quando a licença vence, o acesso a novas versões é encerrado. Entretanto, os pacotes já instalados continuam funcionando normalmente.
Não há kill switch nem forçamento de upgrade. Se sua licença vencer, seu software em produção continua operando com a versão instalada. O que deixa de ser possível é instalar ou atualizar para versões mais recentes até que a licença seja renovada.
Para gerenciar licenças e renovações, acesse o Developer Portal.

​
Schemas fiscais e regulatórios

O SEFAZ e a ANTT publicam periodicamente Notas Técnicas (NTs) que alteram os schemas dos DFes (CT-e, MDF-e, etc.) ou as regras de validação dos sistemas. Essas mudanças geralmente têm prazo obrigatório de adoção. A SUOT acompanha as NTs publicadas e lança atualizações dos SDKs para suportar as novas versões de schema dentro do prazo. As atualizações relacionadas a NTs são destacadas no CHANGELOG e no Developer Portal.
Sempre verifique se há atualizações do SDK quando o SEFAZ ou a ANTT anunciar uma NT que afeta as operações do seu sistema (ex: nova versão de leiaute do CT-e). Emitir documentos em schema desatualizado pode resultar em rejeições após a data de obrigatoriedade da NT.
O processo recomendado ao identificar uma NT relevante:
1

Identifique o impacto

Leia a NT publicada pelo SEFAZ ou ANTT e identifique quais operações e documentos são afetados.
2

Verifique o Developer Portal

Acesse o Developer Portal para confirmar se já há uma atualização do SDK que suporta a NT.
3

Atualize antes da obrigatoriedade

Realize o upgrade e valide em homologação antes da data de vigência obrigatória da NT.
O SEFAZ geralmente disponibiliza um período de coexistência de schemas (ambos aceitos) antes de tornar a nova versão obrigatória. Use esse período para migrar com tranquilidade.

​
Roadmap

Novos recursos, integrações planejadas e o status de funcionalidades em desenvolvimento estão disponíveis no Developer Portal. O roadmap é atualizado conforme as prioridades do produto e o calendário de NTs do SEFAZ e da ANTT.