# 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