## Contas / Comgás / Download de 2ª Via Faz download de contas de Gás mais recentes na Agência Virtual da Comgás. ### URL do site - https://virtual.comgas.com.br/portal ### Requisição URL para POST: `https://api.infosimples.com/api/v2/consultas/contas/comgas/download-seg-via` | Parâmetro | Descrição | | --------------- | -------------------------------------------------------------------------------------------------------- | | token* | Chave de autenticação da API. É com o token que a API reconhece e autoriza quem está fazendo a consulta. | | cnpj** | CNPJ da empresa a ser consultada. | | codigo_usuario* | Codigo_usuario | > * Parâmetro obrigatório. > ** Parâmetro opcional. Pode ser necessário informar algum dos parâmetros opcionais para que a consulta funcione adequadamente. ### Exemplos de respostas (OK) ```json { "code": 200, "code_message": "A requisição foi processada com sucesso.", "errors": [], "header": { "api_version": "v2", "product": "Consultas", "service": "contas/comgas/download-seg-via", "parameters": { "cnpj": "12.345.678/9012-34", "codigo_usuario": "1111111" }, "client_name": "Minha Empresa", "token_name": "Token de Produção", "billable": true, "price": "0.2", "requested_at": "2022-11-25T16:05:20.000-03:00", "elapsed_time_in_milliseconds": 632, "remote_ip": "111.111.111.111", "signature": "U2FsdGVkX19m4oSRwGsanU6XaIFsQiVOqLIA90/YAbx5VSN1ngVwcMlzli4bslPYmFlwULOBIPUJU5kZXeOGGQ==" }, "data_count": 1, "data": [ { "contas": [ { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "novembro/2021", "mes_vencimento": "novembro/2021", "status": "Paga", "valor": 34.51, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "dezembro/2021", "mes_vencimento": "dezembro/2021", "status": "Paga", "valor": 22.76, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "janeiro/2022", "mes_vencimento": "janeiro/2022", "status": "Paga", "valor": 33.79, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "fevereiro/2022", "mes_vencimento": "fevereiro/2022", "status": "Paga", "valor": 24.77, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "março/2022", "mes_vencimento": "março/2022", "status": "Paga", "valor": 24.92, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "abril/2022", "mes_vencimento": "abril/2022", "status": "Paga", "valor": 39.45, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "maio/2022", "mes_vencimento": "maio/2022", "status": "Paga", "valor": 25.11, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "junho/2022", "mes_vencimento": "junho/2022", "status": "Paga", "valor": 33.92, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "julho/2022", "mes_vencimento": "julho/2022", "status": "Paga", "valor": 34.03, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "agosto/2022", "mes_vencimento": "agosto/2022", "status": "Paga", "valor": 34.4, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "setembro/2022", "mes_vencimento": "setembro/2022", "status": "Paga", "valor": 24.95, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "outubro/2022", "mes_vencimento": "outubro/2022", "status": "Paga", "valor": 39.29, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" }, { "data_emissao": "1111-11-11", "data_vencimento": "11/11/1111", "endereco": "Avenida Paulista, 807. São Paulo. SP. Brasil.", "mes_referencia": "novembro/2022", "mes_vencimento": "novembro/2022", "status": "Paga", "valor": 12.73, "conta_pdf_url": "https://www.exemplo.com/exemplo-de-url" } ], "nome": "Exemplo de Nome", "site_receipt": "https://www.exemplo.com/exemplo-de-url" } ], "site_receipts": [ "https://www.exemplo.com/exemplo-de-url" ] } ``` ### Arquivo de visualização de consulta O arquivo de visualização de consulta (`site_receipts`) disponibilizado no retorno da API **pode ser sintetizado pela Infosimples** usando as informações originais da fonte quando o arquivo emitido pela fonte não for adequado para visualização. ### Exemplos de códigos para integração com a API #### Python ```python # Testado com: Python 3.10.19, Python 3.14.0 import requests url = 'https://api.infosimples.com/api/v2/consultas/contas/comgas/download-seg-via' args = { "cnpj": "VALOR_DO_PARAMETRO_CNPJ", "codigo_usuario": "VALOR_DO_PARAMETRO_CODIGO_USUARIO", "token": "INFORME_AQUI_O_TOKEN_DA_CHAVE_DE_ACESSO", "timeout": "300" } response = requests.post(url, args) response_json = response.json() response.close() if response_json['code'] == 200: print("Retorno com sucesso: ", response_json['data']) elif response_json['code'] in range(600, 799): mensagem = "Resultado sem sucesso. Leia para saber mais: \n" mensagem += "Código: {} ({})\n".format(response_json['code'], response_json['code_message']) mensagem += "; ".join(response_json['errors']) print(mensagem) print("Cabeçalho da consulta: ", response_json['header']) print("URLs com arquivos de visualização (HTML/PDF): ", response_json['site_receipts']) ``` ## Estamos prontos para ajudar Ainda tem alguma dúvida ou precisa de ajuda na sua integração? Entre em contato em [suporte@infosimples.com.br](mailto:suporte@infosimples.com.br) e receba ajuda da nossa equipe técnica altamente qualificada.