# Cadastro de Contribuintes

O Cadastro Centralizado de Contribuintes (CCC) contém as informações dos contribuintes de ICMS de todos os estados, e seu objetivo principal é viabilizar a denegação interestadual.

Cada estado é responsável pela manutenção dos seus contribuintes inscritos no CCC.

Esta consulta recebe como entrada o CNPJ e uma ou mais UFs, retornando as Inscrições Estaduais (IEs) correspondentes.

Para cada IE, será dado:

  • Número de registro
  • Unidade federativa
  • Se habilitada ou não como contribuinte

As IEs são registros ao nível de Estabelecimento, ou seja, CNPJs diferentes nunca compartilharão um registro mesmo que façam parte da mesma Empresa (ex. Matriz e Filial).


# Consulta CCC

GET /ccc

Query

Parâmetro Descrição
taxId
Obrigatório
CNPJ sem pontuação
states
Obrigatório
UFs de consulta separadas por vírgula, exemplos:
BR : Todos os estados brasileiros
AC,AP,AM,PA,RO,RR,TO : Região Norte
AL,BA,CE,MA,PB,PI,PE,RN,SE : Região Nordeste
DF,GO,MT,MS : Região Centro-Oeste
ES,MG,RJ,SP : Região Sudeste
PR,RS,SC : Região Sul
AM : Apenas o Amazonas
strategy Ver Estratégias de Cache
maxAge Ver Estratégias de Cache
maxStale Ver Estratégias de Cache

# Exemplos

O retorno será sempre vazio independente da propriedade states:

/ccc?taxId=37335118000180&states=BR
{
  "updated": "2021-06-26T18:29:23Z",
  "taxId": "37335118000180",
  "registrations": []
}

Restringindo o estado a SP e RJ:

/ccc?taxId=04337168000148&states=SP,RJ
{
  "updated": "2021-06-26T18:31:43Z",
  "taxId": "04337168000148",
  "registrations": [
    {
      "number": "91010453",
      "state": "RJ",
      "enabled": true
    },
    {
      "number": "804000067116",
      "state": "SP",
      "enabled": true
    }
  ]
}

Sem restrição de UF, utilizando BR:

/ccc?taxId=04337168000148&states=BR
{
  "updated": "2021-06-26T18:26:04Z",
  "taxId": "04337168000148",
  "registrations": [
    {
      "number": "0100198400108",
      "state": "AC",
      "enabled": true
    },
    {
      "number": "245000240",
      "state": "AL",
      "enabled": true
    },
    {
      "number": "041533704",
      "state": "AM",
      "enabled": true
    },
    {
      "number": "041568176",
      "state": "AM",
      "enabled": true
    },
    {
      "number": "047200243",
      "state": "AM",
      "enabled": false
    },
    {
      "number": "062002562",
      "state": "AM",
      "enabled": true
    },
    {
      "number": "063002280",
      "state": "AM",
      "enabled": false
    },
    {
      "number": "063009382",
      "state": "AM",
      "enabled": true
    },
    {
      "number": "070002207",
      "state": "AM",
      "enabled": true
    },
    {
      "number": "030099000",
      "state": "AP",
      "enabled": false
    },
    {
      "number": "038091748",
      "state": "BA",
      "enabled": true
    },
    {
      "number": "069995435",
      "state": "CE",
      "enabled": true
    },
    {
      "number": "0733166800156",
      "state": "DF",
      "enabled": true
    },
    {
      "number": "000011010",
      "state": "ES",
      "enabled": true
    },
    {
      "number": "102639230",
      "state": "GO",
      "enabled": true
    },
    {
      "number": "126002371",
      "state": "MA",
      "enabled": true
    },
    {
      "number": "0358458700047",
      "state": "MG",
      "enabled": true
    },
    {
      "number": "282365931",
      "state": "MS",
      "enabled": true
    },
    {
      "number": "00131429833",
      "state": "MT",
      "enabled": true
    },
    {
      "number": "151739536",
      "state": "PA",
      "enabled": true
    },
    {
      "number": "169993817",
      "state": "PB",
      "enabled": false
    },
    {
      "number": "019314906",
      "state": "PE",
      "enabled": true
    },
    {
      "number": "194266508",
      "state": "PI",
      "enabled": true
    },
    {
      "number": "0990042403",
      "state": "PR",
      "enabled": true
    },
    {
      "number": "91010453",
      "state": "RJ",
      "enabled": true
    },
    {
      "number": "203000986",
      "state": "RN",
      "enabled": true
    },
    {
      "number": "00000000459445",
      "state": "RO",
      "enabled": true
    },
    {
      "number": "240035786",
      "state": "RR",
      "enabled": true
    },
    {
      "number": "0962368253",
      "state": "RS",
      "enabled": false
    },
    {
      "number": "9000000390",
      "state": "RS",
      "enabled": true
    },
    {
      "number": "252789261",
      "state": "SC",
      "enabled": true
    },
    {
      "number": "270850953",
      "state": "SE",
      "enabled": true
    },
    {
      "number": "270981691",
      "state": "SE",
      "enabled": false
    },
    {
      "number": "270981705",
      "state": "SE",
      "enabled": false
    },
    {
      "number": "804000067116",
      "state": "SP",
      "enabled": true
    },
    {
      "number": "299992276",
      "state": "TO",
      "enabled": true
    }
  ]
}

# Tipagem

Propriedade Tipo Descrição
updated string CData de atualização em formato ISO
taxId string CNPJ consultado
registrations Registration[] Inscrições estaduais