Consulta de Histórico de Alíquota

Método: GET

Endpoint: https://api.emitix.com.br/nfse/historico-aliquota

Descrição Geral

Permite consultar as variações passadas (histórico) que a alíquota municipal de um determinado serviço sofreu na cidade consultada.

Função da Rota

• Analisar a linha do tempo e a vigência das alíquotas de um serviço em um município ao longo do tempo.

Situações de Uso

• Preenchimento de declarações e obrigações acessórias referentes a períodos variados e passados.
• Contestações fiscais ou emissão de notas de substituição em meses retroativos, onde as alíquotas podiam ser diferentes da atual.

Campos da Requisição (Payload)

Campo	Tipo	Obrigatório	Descrição
cMun	string	✅	Código do Município (IBGE, 7 dígitos). Ex: '1234567'.
cServ	string	✅	Código do serviço a ser verificado (exatamente 6 dígitos). Ex: '010101'.
cnpj	string	⚙️ Opcional*	CNPJ do prestador (obrigatório se CPF não for informado).
cpf	string	⚙️ Opcional*	CPF do prestador (obrigatório se CNPJ não for informado).
certificate	string	⚙️ Opcional	Certificado digital A1 em base64. Se não enviado, utiliza-se o cadastrado no sistema.
pass_certificate	string	⚙️ Opcional	Senha do certificado digital A1.

Observação: Deve ser informado obrigatoriamente apenas um dos identificadores do prestador: cnpj ou cpf.

Autenticação

A rota exige autenticação dupla através dos cabeçalhos:

• Bearer Token
  • Authorization: Bearer <seu_token_de_acesso>
• API Key
  • api-key: <sua_api_key>

Exemplo de Payload

{
  "cMun": "3550308",
  "cServ": "010101",
  "cnpj": "12345678000199"
}

Exemplo de Requisição Completa

curl -X GET https://api.emitix.com.br/nfse/historico-aliquota \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -H "api-key: <api_key>" \
  -d '{
    "cMun": "3550308",
    "cServ": "010101",
    "cnpj": "12345678000199"
  }'

Exemplo de Resposta

{
  "success": true,
  "message": "Histórico de aliquota municipal consultado com sucesso",
  "statusCode": 200,
  "data": {
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><retConsHistoricoAliquota>...</retConsHistoricoAliquota>",
    "response": {
      "cMun": "3550308",
      "cServ": "010101",
      "historico": [
        {
          "dataInicio": "2020-01-01",
          "dataFim": "2023-12-31",
          "aliquota": 3.50
        },
        {
          "dataInicio": "2024-01-01",
          "aliquota": 5.00
        }
      ]
    }
  }
}