API de consultaSob demanda

API Comgás 2ª via: a conta de gás de cada imóvel

Envie o CNPJ do titular e o código de usuário de cada imóvel; a Hath entra no Comgás Virtual e devolve a conta em PDF, com vencimento, valor e mês de referência.

Baixar contas da Comgás pela API Ver todas as consultas

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

1
Entrada
cnpjcodigo_usuariomes_referencia
2
Fonte oficial
ComgásComgás Virtual, 2ª via e consultar débitos
3
Saída
JSON e PDF da conta
CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Código de usuário, valores e datas fictícios.

Parâmetros

cnpjobrigatório
O CNPJ titular da conta, como no login de Cliente Comgás.
codigo_usuarioobrigatório
O cadastro do imóvel na Comgás, impresso na conta. Um por unidade.
mes_referenciaopcional
Para uma conta específica; sem ele, voltam as contas que o portal lista.

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.contas[].mes_referencia: O mês da conta, ligado ao consumo de gás do período impresso nela.
resultado.contas[].vencimento: A data limite para pagar sem juros ou multa.
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 conta baixada do Comgás Virtual, sem edição.

RespostaJSON

{"protocolo": "a1b2c3d4","status": "concluida","consulta": "comgas_segunda_via","orgao": "Comgás","cnpj": "00000000000100","codigo_usuario": "00000000","resultado": {"situacao": "negativa","numero_certidao": "000000/2026","emissao": "2026-10-27T10:15:00-03:00","valida_ate": "2026-11-26","contas": [{"mes_referencia": "2026-10","vencimento": "2026-11-10","valor": 0,"tipo_conta": "segunda_via"}],"texto_completo": "Texto integral do documento, lido do PDF emitido pelo órgão (exemplo)."},"pdf_url": "https://…/conta.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.

Na fonte oficial

Tela de login do Comgás Virtual: campos de CNPJ e código de usuário e botão Entrar — Sem login. A 2ª via sai em "2º via e consultar débitos", no botão Baixar conta.
Fontes oficiais
Comgás: Comgás Virtual, login de Cliente Comgás
Comgás: Entenda sua fatura
Comgás: Consulte faturas em aberto

Ficha técnica

Código de usuário	O cadastro do imóvel na Comgás
Tipo de conta	Se é a primeira ou a segunda via
Dias de consumo	Os dias entre a leitura anterior e a atual
Vencimento e valor	A data limite sem juros ou multa e o total a pagar
Fornecimento	Os serviços cobrados: gás, equipamentos, multas e juros

Perguntas frequentes

Onde acho o código de usuário?

Na própria conta de gás. É o cadastro do imóvel na Comgás; a tela de login tem a opção "Esqueceu seu código de usuário?".

Uma empresa com vários imóveis precisa de um código por imóvel?

Sim. O código identifica o imóvel, então cada unidade tem o seu. A Hath recebe a lista e baixa uma conta por código.

Dá para ver só se há conta em aberto?

Sim. O Comgás Virtual tem a consulta de faturas em aberto, que pede só o CNPJ.

API Comgás 2ª via de conta na sua integração

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

Baixar contas da Comgás 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.