API de consultaSob demanda

API DER/PR GRU: a guia de recolhimento do departamento

Diga o serviço do DER/PR e envie o CNPJ (ou o registro no departamento); a Hath preenche a Guia de Recolhimento Única e devolve a GRU em PDF, com código de barras, pronta para pagar.

Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026

  1. 1

    Entrada

    servicocnpjreferencia
  2. 2
  3. 3

    Saída

    JSON e PDF da GRU

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Serviço, valor e código de barras fictícios.

Parâmetros

  • servicoobrigatório

    O código do serviço na lista do DER/PR, como 001 (serviços administrativos) ou 011 (laboratório, concreto).

  • cnpjobrigatório

    Quem paga. A carta de serviço aceita também o registro no DER/PR.

  • referenciaopcional

    O que a guia paga, quando o serviço pede descrição ou quantidade.

Campos retornados

status
concluida quando o órgão respondeu; em_andamento enquanto a fonte não libera (o resultado chega por webhook); fonte_indisponivel quando o portal está fora do ar, que nunca vira "nada consta".
resultado.servico
O serviço da lista do DER/PR a que a guia se refere.
resultado.codigo_barras
A numeração para pagar no banco.
resultado.situacao
negativa, positiva, positiva_com_efeito_de_negativa ou nao_emitida: o mesmo vocabulário em todas as fontes.
resultado.numero_certidao
O número ou código de controle impresso no documento, para validar no próprio órgão.
resultado.emissao
Data e hora da emissão, como o documento registra.
resultado.valida_ate
A validade lida no documento; null quando o órgão não fixa prazo.
resultado.texto_completo
O texto integral do documento, extraído do PDF, para guardar e pesquisar sem abrir o arquivo.
pdf_url
A GRU como o sistema do DER/PR emite.
Tela de serviços da GRU on-line do DER/PR, com a lista de serviços e o botão Avançar

Os dados de quem paga vêm na tela seguinte.

RespostaJSON
{"protocolo": "a1b2c3d4","status": "concluida","consulta": "der_pr_gru","orgao": "DER/PR","servico": "011","cnpj": "00000000000100","resultado": {"situacao": "negativa","numero_certidao": "000000/2026","emissao": "2026-10-27T10:15:00-03:00","valida_ate": "2026-11-26","servico": "011 - Laboratório - Concreto","vencimento": "2026-11-10","valor": 0,"codigo_barras": "000000000000000000000000000000000000000000000000","texto_completo": "Texto integral do documento, lido do PDF emitido pelo órgão (exemplo)."},"pdf_url": "https://…/documento.pdf"}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

  • Regular

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Ficha técnica

001Serviços administrativos e outros (DER)
002Serviços administrativos e outros (S.T.C.)
008 a 012Laboratório: agregados, material e mistura betuminosa, concreto e solo
022Convênio nº 024/2000 DER/DETRAN
037Guias de pagamento de diárias de veículos retidos

Perguntas frequentes

Para que serve a GRU do DER/PR?

Para pagar serviços e taxas do departamento, como ensaios de laboratório e serviços administrativos.

A emissão é paga?

Não. O DER/PR informa que a emissão da guia é gratuita e imediata; paga-se o valor do serviço.

E para pagar um débito apontado na certidão?

O portal de certidões do DER/PR emite a guia dos débitos junto com a situação da empresa.

API DER/PR Guia de Recolhimento (GRU) na sua integração

Sob demanda. Acesso no mesmo dia, com crédito para testar.

Emitir GRUs do DER/PR pela API

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.