Notas de lançamento

Toda vez que a API do exoconexo muda, publicamos uma nota de lançamento. Ela conta, em poucas palavras, o que mudou, o que isso significa para o seu sistema e o que fazer, passo a passo. Os detalhes técnicos ficam no fim de cada versão, para quem programa a integração.

Ir para Como ler o número da versão Versão 1.0.0, de 11/11/2026 Antes da 1.0.0 (0.x, de 2026-11-07 a 2026-11-10)

Como ler o número da versão

Cada versão tem três números separados por ponto, como 1.0.0. Pense neles como o endereço de uma casa, do mais importante para o menos importante.

• O primeiro número (MAIOR) muda quando o formato dos pedidos muda de um jeito que exige adaptação do seu sistema. É raro, e a versão anterior continua aceita por um prazo combinado com você. Ele é igual à versão do contrato, o campo versao que vai em cada pedido.
• O segundo número (MENOR) muda quando chega algo novo que não quebra nada, como uma rota nova ou um campo opcional. Também muda quando uma regra passa a ser conferida antes, e nesse caso o manual explica o que fazer.
• O terceiro número (CORREÇÃO) muda quando corrigimos algo sem mudar a forma de usar a API.

Para saber qual versão está no ar, veja o cabeçalho Exoconexo-Versao de qualquer resposta do exoconexo ou chame GET /health.

Se o seu sistema está algumas versões atrás, leia o manual de adequação de cada versão entre a sua e a atual, na ordem.

Versão 1.0.0, de 11/11/2026

O conexus passa a se chamar exoconexo, ganha endereço próprio e passa a ter número de versão. O formato dos pedidos e das respostas continua o mesmo.

Em poucas palavras

O produto mudou de nome e de endereço. Quem já usava o conexus só precisa trocar o endereço da API e conferir duas regras que passaram a ser verificadas antes de a nota ir para a Sefin Nacional (a NFS-e).

O que muda para você

• Novo endereço da API https://api.exoconexo.com.br. O endereço antigo, conexus.invector.com.br, foi desligado.
• Versão visível em toda resposta do exoconexo, para você saber com qual versão está falando.
• Notas de lançamento como esta, a cada mudança, com o que fazer.
• Conferência antecipada de duas regras da NFS-e. O que a Sefin Nacional recusaria agora é recusado pelo exoconexo antes, com uma mensagem clara.

Manual de adequação

1. Troque o endereço da API para https://api.exoconexo.com.br. Use o mesmo endereço como audiência ao gerar o token de acesso (a audiência diz para qual serviço o token vale).
2. Se o seu sistema ainda não tem acesso ao serviço novo, peça à equipe da Invector pelo e-mail contato@invector.com.br. O acesso ao serviço antigo não passou para o novo.
3. Se você usa o assistente para agentes de IA (MCP), peça à equipe a versão nova, o exoconexo-mcp, e use a mesma versão do serviço no ar.
4. Na NFS-e do Simples (ME e EPP), envie sempre o regime de apuração (regimeApuracaoSimples).
5. Na NFS-e de quem não é do Simples, não envie a alíquota do ISS quando o imposto é devido ao município do próprio prestador, que é o caso da maioria dos serviços, mesmo com o atendimento em outra cidade.
6. Para conferir, chame GET /health com o seu token. A resposta deve trazer "versao":"1.0.0" e "contrato":1.

Detalhes técnicos

Novidades

• O produto se chama exoconexo, ferramenta de integração headless (sem tela própria, só por API) de XaaS da Invector Tecnologia.
• A API fica em https://api.exoconexo.com.br, que também é a audiência do token de identidade. O site público fica em https://www.exoconexo.com.br.
• A versão no ar aparece no cabeçalho Exoconexo-Versao de toda resposta do exoconexo e no GET /health (versao e contrato). As respostas dadas pela plataforma antes do serviço (403 sem token, 429, 503) não trazem o cabeçalho.
• As notas de versão estão no recurso exoconexo://notas-de-versao do MCP, na versão publicada no GitHub e nesta página.

Correções

• Segurança. O serviço e o MCP passam a ser compilados com o Go 1.27.4, que corrige a vulnerabilidade GO-2026-6859 do net/http.

Mudanças de comportamento desde a 0.x

• NFS-e do Simples ME/EPP. regimeApuracaoSimples passou a ser obrigatório (de 1 a 3 no CRT 1; 2 ou 3 no CRT 2). Sem ele, a Sefin recusava a nota (E0166), e agora o exoconexo recusa antes, com 400.
• NFS-e fora do Simples. A aliquotaIssqn é recusada (400) quando o ISS é devido ao município do emitente (E0617, E0635), pela tabela oficial de incidência.
• Contrato v1. Campos, rotas e respostas não mudaram. O consumidor.endereco da NFC-e continua recusado (400), agora com um motivo claro.

Antes da 1.0.0 (0.x, de 2026-11-07 a 2026-11-10)

Antes da 1.0.0 o serviço não tinha número de versão por atualização. O histórico abaixo resume o que entrou em cada etapa.

• 2026-11-07 e 2026-11-08. Contrato v1, emissão de NFC-e (Simples, MEI e regime normal com ICMS e IBS/CBS), acesso fechado e publicação automática.
• 2026-11-10. Consulta, cancelamento e inutilização da NFC-e.
• 2026-11-10. NFS-e Nacional, com emissão, consulta e cancelamento.
• 2026-11-10. NFC-e em contingência offline, transmissão posterior e cancelamento por substituição.
• 2026-11-10. O assistente local para agentes de IA (MCP), com guia, exemplos, validação e explicação de respostas.
• 2026-11-10. NFS-e do regime normal e do Simples com excesso de sublimite, com IBS/CBS.
• 2026-11-10. NFS-e com atendimento no endereço do cliente, PIS/COFINS próprios e retenções federais.
• 2026-11-10. Montagem da NFC-e antes do envio (POST /v1/montar), para o sistema guardar o documento antes de transmitir.