Documentação da API

Kontiq REST API

Integre análise fiscal de NF-e e NFS-e diretamente no seu ERP, sistema contábil ou fluxo de trabalho. A API aceita XML em base64 e retorna erros, alertas e oportunidades de crédito tributário.

Base URL:https://kontiq.com.br/api/v1

Autenticação

Todas as requisições devem incluir um header Authorization com uma API Key gerada em Configurações → Chaves de API.

Authorization: Bearer ktq_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Nunca exponha sua API Key no frontend. Use sempre server-side.

Endpoints

POST/api/v1/analisesAnalisar NF-e em base64

GET/api/v1/analisesListar análises recentes

GET/api/v1/analises/:idResultado de uma análise

GET/api/v1/clientesListar clientes

GET/api/v1/clientes/:cnpj/analisesAnálises por CNPJ

GET/api/v1/metricasUso e métricas do escritório

POST /api/v1/analises

Envie o XML da NF-e ou NFS-e em base64 para análise fiscal com IA.

Request

{
  "xml": "PD94bWwgdmVyc2lvbj0iMS4wIi...",  // base64 do XML
  "cliente_cnpj": "12.345.678/0001-90",     // opcional
  "webhook_url": "https://seusite.com/cb"   // opcional
}

Response 201

{
  "id": "uuid-da-analise",
  "status": "correto" | "alerta" | "erro",
  "numero_nf": "NF-e 180",
  "emitente": { "nome": "Empresa XYZ", "cnpj": "..." },
  "valor_total": 85000.00,
  "total_erros": 0,
  "total_alertas": 2,
  "valor_recuperavel": 1230.50,
  "resumo": "A NF-e está correta. Identificamos..."
}

Verificação de webhook

Cada webhook enviado inclui um header X-Kontiq-Signature. Verifique a autenticidade computando HMAC-SHA256 do payload com o secret gerado na criação.

// Node.js
const crypto = require('crypto');

function verificarAssinatura(secret, payload, signature) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

// Payload de exemplo enviado pelo Kontiq:
{
  "evento": "analise.concluida",
  "data": {
    "analise_id": "uuid",
    "numero_nfe": "180",
    "status": "alerta",
    "total_erros": 0,
    "valor_recuperavel": 1230.50
  },
  "timestamp": "2026-05-14T12:00:00Z"
}

Rate limits

Gratuito100 req/hora

Starter / Básico500 req/hora

Pro / Gestão1.000 req/hora

Enterprise / CorporativoIlimitado

As respostas incluem X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.

Gerar minha API Key →