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
Entrada
servicocnpjreferencia - 2
Fonte oficial
- 3
Saída
JSON e PDF da GRU
- 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órioO código do serviço na lista do DER/PR, como 001 (serviços administrativos) ou 011 (laboratório, concreto).
cnpjobrigatórioQuem paga. A carta de serviço aceita também o registro no DER/PR.
referenciaopcionalO que a guia paga, quando o serviço pede descrição ou quantidade.
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.
Campos retornados

Os dados de quem paga vêm na tela seguinte.
{"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
verdeNada consta na fonte.
Atenção
amareloHá registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.
Com apontamentos
vermelhoConsta débito, sanção ou processo. O documento vem junto.
Sem resposta
cinzaA 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
| 001 | Serviços administrativos e outros (DER) |
|---|---|
| 002 | Serviços administrativos e outros (S.T.C.) |
| 008 a 012 | Laboratório: agregados, material e mistura betuminosa, concreto e solo |
| 022 | Convênio nº 024/2000 DER/DETRAN |
| 037 | Guias 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.
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.
