API

NFS-e em Salvador/BA (CTISS) e Provedor Tinus (Nordeste): Como Integrar via API REST JSON

Guia técnico sobre as particularidades da emissão de NFS-e em Salvador/BA (Nota Salvador, código CTISS e ABRASF) e em municípios do provedor Tinus (Recife/PE, Jaboatão, Caruaru, Olinda, Campina Grande e Natal) via API REST JSON.

Fábio Magalhães CostaAtualizado em 22/11/2026
Integração automatizada de NFS-e em Salvador/BA (CTISS) e municípios do provedor Tinus via API REST

Integração automatizada de NFS-e em Salvador/BA (CTISS) e municípios do provedor Tinus via API REST

Quem constrói um ERP ou SaaS no Brasil descobre rápido que o Sudeste é só metade da batalha da NFS-e. Assim que chegam os primeiros clientes da Bahia e de Pernambuco / Paraíba / Rio Grande do Norte, dois padrões municipais clássicos aparecem no radar da engenharia: Salvador/BA (Nota Salvador / código CTISS) e o provedor Tinus (muito presente em polos do Nordeste).

Enquanto o Padrão Nacional (SNNFSE) cobre 100% dos MEIs e milhares de cidades conveniadas, empresas do Simples Nacional e Regime Normal em municípios que mantêm webservice próprio precisam respeitar as regras locais de código tributário, numeração de RPS e envelope SOAP — ou abstrair tudo em um contrato JSON único.


1. NFS-e em Salvador/BA (Nota Salvador): O que é o código CTISS

O maior erro de quem tenta emitir NFS-e em Salvador (IBGE 2927408) pela primeira vez é enviar apenas o item da LC 116/2003 (01.05 ou 01.07) e ignorar o CTISS (Código de Tributação do ISS de Salvador).

⚡ Regras Essenciais da Nota Salvador (SEFAZ Salvador):

  • Código Tributação Município (CTISS): Salvador utiliza um código próprio de 9 dígitos (ex.: 010500100 ou conforme tabela vigente da SEFAZ Salvador) que amarra o item da LC 116 à alíquota de ISS e à atividade CNAE cadastrada no alvará da empresa.
  • Validação de CNAE × Atividade: Se o CTISS enviado no RPS não corresponder a um CNAE ativo na Inscrição Municipal (CGA) do prestador em Salvador, o webservice rejeita o lote imediatamente.
  • Inscrição Municipal (CGA): Em Salvador, a Inscrição Municipal é chamada de CGA (Cadastro Geral de Atividades) e deve ser enviada exatamente com os dígitos registrados na prefeitura.
  • Cancelamento: Possui janela restrita vinculada ao fechamento da competência mensal do ISS; após o prazo, exige processo administrativo junto à SEFAZ municipal.

2. Provedor Tinus (Nordeste): Particularidades de Integração

O provedor Tinus opera webservices municipais baseados em variações do padrão ABRASF 1.0 em dezenas de cidades importantes do Nordeste (como Jaboatão dos Guararapes/PE, Olinda/PE, Cabo de Santo Agostinho/PE, Garanhuns/PE, Petrolina/PE, entre outros polos regionais — além de municípios que vêm migrando gradualmente para o SNNFSE).

Na prática de integração direta com o Tinus, três detalhes costumam travar backends:

  1. Envelope SOAP e Namespaces específicos: Diferente de provedores ABRASF 2.04 mais recentes, instâncias Tinus exigem namespaces exatos por prefeitura e validação estrita de assinatura XMLDSig tanto no InfRps quanto no LoteRps.
  2. Processamento assíncrono por Protocolo: O envio de lote retorna um número de protocolo, exigindo consulta posterior (ConsultarLoteRps) com tratamento de backoff para evitar bloqueio por polling agressivo.
  3. Código de Tributação Municipal: Assim como Salvador, municípios Tinus frequentemente exigem o CodigoTributacaoMunicipio além do ItemListaServico, e divergem quanto à formatação do ponto no item (01.07 vs 0107).

Como abstrair Salvador (CTISS), Tinus e +4.830 cidades em 1 único JSON

Em vez de manter adaptadores SOAP separados para Salvador, Tinus, Pronim/SpeedGov/ISSNet, GovDigital/Conam/PublicSoft e SNNFSE, na Notaas você consulta a engine ativa do município programaticamente (GET /api/v1/cobertura/cidades?ibge=2927408) e dispara o mesmo payload REST JSON para POST /api/v1/emitir:

{
  "tipo": "nfse",
  "ambiente": "homologacao",
  "externalId": "ssa_fatura_2026_3091",
  "prestador": {
    "cnpj": "03167121000110",
    "inscricaoMunicipal": "123456001"
  },
  "tomador": {
    "cpfCnpj": "11222333000181",
    "razaoSocial": "Cliente Bahia Comercio Ltda",
    "email": "fiscal@clientebahia.com.br",
    "endereco": {
      "logradouro": "Av. Paralela",
      "numero": "3100",
      "bairro": "Imbui",
      "codigoMunicipio": "2927408",
      "uf": "BA",
      "cep": "41720000"
    }
  },
  "servico": {
    "codigo": "01.05",
    "codigoTributacaoMunicipio": "010500100",
    "descricao": "Licenciamento de plataforma SaaS - Competencia Novembro/2026",
    "valor": 1200.00,
    "aliquota": 3.00
  }
}

Consulta em tempo real da cobertura da sua cidade

Antes de cadastrar um cliente no seu ERP, você pode verificar via API se o município opera via Padrão Nacional (snnfse) ou engine municipal dedicada:

curl -s "https://platform.notaas.com.br/api/v1/cobertura/cidades?ibge=2927408" | jq .

Para conferir os detalhes das 4.836 cidades ativas em produção e como nosso roteamento híbrido acompanha automaticamente municípios que migram para o SNNFSE, leia: API de NFS-e com Cobertura Nacional: 4.836 Cidades Atendidas.


Escale sua operação fiscal no Nordeste e em todo o Brasil

Crie sua conta gratuita na Notaas e teste a emissão de NFS-e em 4.836 municípios ativos, com 20 notas fiscais gratuitas por mês em produção real (1 CNPJ) + até 5 CNPJs em homologação via Org API, webhooks assinados com HMAC-SHA256 e DANFSe v2.0 gerado localmente.

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em API

Guias Pilares de Integração Fiscal