Buscar declarações PER/DCOMP por CNPJ

GET

/perdcomp/v1/search

Consulta de Declarações PER/DCOMP

Retorna todas as declarações de compensação (DCOMP) e pedidos de restituição (PER)
de uma empresa através do seu CNPJ.

O que são PER/DCOMP?

PER (Pedido Eletrônico de Restituição): Pedido de restituição de tributos pagos indevidamente

DCOMP (Declaração de Compensação): Declaração de compensação de créditos tributários

Informações Retornadas

Para cada declaração:

Número do documento

Tipo de documento (Declaração de Compensação ou PER)

Tipo de crédito (Pagamento Indevido, Saldo Negativo, etc.)

Data de transmissão

Situação atual (Em análise, Deferido, Indeferido, etc.)

Descrição detalhada da situação

Exemplo de Uso

Custo

Consulte preços atualizados em platform.kipflow.io/pricing.

Limites de Taxa

5 requisições por segundo

Limites adicionais conforme seu plano

Requisição

Authorization

API Key

Adicionar parâmetro em header

X-API-Key

Exemplo:

X-API-Key: ********************

Parâmetros de Consulta

Respostas

🟢200

application/json

Declarações PER/DCOMP encontradas

Body

🟠400

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.kipflow.io/perdcomp/v1/search?cnpj' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Exemplo 1

{
    "success": true,
    "data": {
        "cnpj": 35965725000107,
        "razao_social": "DRIVA TECNOLOGIA LTDA",
        "perdcomp": [
            {
                "numero_perdcomp": "355878335516122513047010",
                "tipo_documento": "Declaração de Compensação",
                "tipo_credito": "Pagamento Indevido ou a Maior",
                "data_transmissao": "2025-12-16T15:39:12+00:00",
                "situacao": "Em análise",
                "descricao_situacao": "Recepcionado em procedimento de análise."
            }
        ]
    },
    "cost": 0.73,
    "cost_formatted": "R$ 0,73",
    "error": {
        "code": "INVALID_CNPJ",
        "message": "O CNPJ informado é inválido"
    }
}