Procon

Esta API funciona de forma semelhante ao monitoramento de distribuições: você nos fornece os logins da empresa nos sistemas do Procon (SINDEC, outros) e nós fazemos logins automatizados diariamente (a partir das 17h) nos SINDECS de todo Brasil buscando as novas reclamações abertas contra a empresa dos logins fornecidos.

Para cada nova CIP obtida, realizamos o tratamento dos dados, classificando automaticamente a reclamação dentro de um conjunto de critérios pré-estabelecidos. Enviamos então diariamente via Excel ou chamada na API os detalhes das reclamações (CIPs).

A automatização deste processo acelera a análise e resposta à carta.

Por padrão os robôs retroagem até 30 dias da data atual. Mas, caso seja necessário, é possível varrer qualquer período solicitado.

O número FA é um número de atendimento, chamado Folha de Atendimento, e independe de ser uma CIP ou uma Reclamação, qualquer um dos dois tem um número FA.

Uma Reclamação pode se originar de uma CIP ou não.

O mesmo número FA pode existir numa CIP e numa Reclamação caso a primeira tenha dado origem à segunda.

Se enviamos uma CIP e depois uma Reclamação com mesmo número a cobrança é feita uma vez para a CIP e outra para a Reclamação, afinal são duas entidades diferentes que inclusive são tratadas por áreas diferentes em muitas empresas, mesmo que uma tenha dado origem à outra.

O padrão da API é enviar apenas CIPs. Caso deseje receber também reclamações, entre em contato com nosso Suporte.

Os passos de funcionamento da API são:

  • Preliminarmente, os logins das empresas nos diversos SINDECs e outros sites do PROCON são configurados via API Digesto, através de chamadas HTTP POST para criação de entidades procon_fornecedor.
  • No passo 1, obtemos diariamente após horário comercial, junto aos sistemas do Procon, as reclamações. Baixamos os detalhes de cada reclamação, bem como os anexos/cartas.
  • No passo 2, realizamos o tratamento desses dados, realizando checagens de dados das partes e uniformização dos dados.
  • No passo 3, as novas informações de processos e pessoas que passem nos filtros e regras de negócio são enviados via chamadas HTTP diretamente para seu sistema, ou ficam disponíveis para consulta via chamadas HTTP à API Digesto. Esta chamada realizada pela API Digesto é feita via um HTTP POST, no formato descrito em Eventos.

Cobertura

Monitoramos diariamente de forma eletrônica e automatizada todos os sites SINDEC, além do Procon de Campinas.

Listagem de orgãos/sistemas Procon cobertos:

  • Sindec AC
  • Sindec AL
  • Sindec AM
  • Sindec CE
  • Sindec GO
  • Sindec ES
  • Sindec PR
  • Sindec RS
  • Sindec PB
  • Sindec TO
  • Sindec PA
  • Sindec PE
  • Sindec RN
  • Sindec RJ
  • Sindec BA
  • Sindec DF
  • Sindec MG
  • Sindec Belo Horizonte
  • Sindec PI
  • Sindec MA
  • Sindec SP
  • ProconWeb Campinas
  • ProconWeb São José dos Campos
  • Sindec Paulistano
  • Sindec MT
  • Sindec MS
  • Sindec SC
  • Sindec SE
  • Sindec RO
  • Proconsumidor
  • Sistema Integrado ProconSP
  • Sistema Integrado ProconSP 2

Recomendamos inscrever seu e-mail para receber atualizações da cobertura.

Robô Proconsumidor

O funcionamento geral segue o mesmo princípio dos robôs Sindec. Este robô faz o login o usuário/senha fornecido pelo cliente final, seleciona o fornecedor correspondente que está habilitado na conta, entra na página de atendimentos, seleciona a opção “Todos” no campo “Credenciada de Atendimento” e realiza a busca, capturando todas as reclamações dos últimos 30 dias.

Frequencia de monitoramento

Todos os logins são usados para acesso ao respectivo site pelo menos uma vez ao dia após fim do horário comercial.

Listando instâncias de sites Procon

Esta operação serve para listar a base padronizada da Digesto de sites do Procon.

É necessário informar o ID Digesto de uma instância do Procon ao fazer o cadastro de novos logins de fornecedores.

Os ids das instâncias de sites Procon são fixos, porém frequentemente novos municípios são adicionados à lista de cobertura. Caso algum desejado não esteja disponível, entre em contato conosco.

GET https://op.digesto.com.br/api/procon/instancias

Retorna dicionário JSON com todas as instâncias de Procon. As chaves desse dicionário são os ID Digesto das instancias Procon.

Exemplo de chamada:

GET https://op.digesto.com.br/api/procon/instancias HTTP/1.1
Accept: application/json

Exemplo de resposta:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "1": {
        "procon_codigo": "sindecma0001",
        "procon_estado": "MA",
        "procon_municipio": null,
        "procon_nome": "PROCON ESTADUAL DO MARANHAO",
        "sindec_sistema": 0,
        "sindec_url": "http://sindec.sedihc.ma.gov.br/sindecconsulta/defaultfornecedor.asp"
    },
    "10": {
        "procon_codigo": "sindecsp0017",
        "procon_estado": "SP",
        "procon_municipio": "Suzano",
        "procon_nome": "PROCON MUNICIPAL DE SUZANO",
        "sindec_sistema": 2,
        "sindec_url": "http://sindec.procon.sp.gov.br/sindecconsulta2/public/fornecedor"
    },
    "100": {
        "procon_codigo": "sindecmg0067",
        "procon_estado": "MG",
        "procon_municipio": "Caratinga",
        "procon_nome": "PROCON MUNICIPAL DE CARATINGA",
        "sindec_sistema": 0,
        "sindec_url": "https://sindec.mpmg.mp.br:444/sindecconsulta/defaultfornecedor.asp"
    },
    "101": {
        "procon_codigo": "sindecmg0068",
        "procon_estado": "MG",
        "procon_municipio": "Conselheiro Pena",
        "procon_nome": "PROCON MUNICIPAL DE CONSELHEIRO PENA",
        "sindec_sistema": 0,
        "sindec_url": "https://sindec.mpmg.mp.br:444/sindecconsulta/defaultfornecedor.asp"
    }
}
Request Headers:
 
Response Headers:
 

Cadastrando logins de fornecedores monitorados

Aviso

A configuração de cadastro do serviço de monitoramento Procon diretamente está sem previsão de lançamento, retornando somente seus resultados via API. Para realizar um novo cadastro, basta se cadastrar na planilha e retornamos em até 48h com a confirmação do pedido e o prazo para ativação do monitoramento.

Como todas as outras entidades da API, basta realizar um HTTP POST para o endereço do recurso procon_fornecedor.

A entidade recém criada é retornada, junto com seu id no campo $uri.

Repare que é obrigatório passar o id da instância Procon à qual este login pertence.

POST https://op.digesto.com.br/api/procon_fornecedor

Exemplo de chamada:

POST https://op.digesto.com.br/api/procon_fornecedor HTTP/1.1
Content-Type: application/json

{
    "nome": "Empresa 1",
    "is_pj": true,
    "cnpj_cpf": 26082388000100,
    "procon_instancia_id": 101,
    "usuario": "empresa1",
    "senha": "senha1"
}
Request Headers:
 
Response Headers:
 
Status Codes:

Exemplo de resposta:

HTTP/1.1 200 OK
Content-Type: application/json


{
    "$uri": "/api/procon_fornecedor/2",
    "nome": "Empresa 1",
    "is_pj": true,
    "cnpj_cpf": 26082388000100,
    "procon_instancia_id": 101,
    "usuario": "empresa1",
    "senha": "senha1"
}

Exemplo de retorno webhook com eventos descrevendo novas reclamações PROCON

No campo data dos eventos, enviamos uma única reclamação, com o schema procon_cip.

O evento exemplo abaixo notifica sobre uma nova reclamação de um procon_fornecedor.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "target_url": "https://op.digesto.com.br/api/procon_cip/1234",
  "source_user_custom": "login_fornecedor_cliente_1235",
  "created_at": "2016-05-25T08:38:32.941264",
  "source_url": ["https://op.digesto.com.br/api/procon_fornecedor/53"],
  "target_number": "21.001.035.17-0040211 03/11/2017",
  "evt_type": 10,
  "data": {
      "id_digesto": 26323,
      "numero_fa": "21.001.035.17-0040211",
      "situacao": 0,
      "situacao_outro": null,
      "tipo_cip": "Sindec CIP Eletronica",
      "resposta_prazo_expirada": 0,
      "data_geracao": "03/11/2017",
      "data_aviso": "03/11/2017",
      "prazo_resposta": "18/11/2017",
      "data_extracao": "03/11/2017",
      "estado": "MA",
      "municipio": "São Luís",
      "consumidor_nome": "JOAO SILVA",
      "consumidor_cpf": "82449929314",
      "fornecedor_nome": "Banco Panamericano",
      "fornecedor_cnpj": "59285411000113",
      "procon_nome": "PROCON ESTADUAL DO MARANHÃO",
      "sindec_url": "http://sindec.sedihc.ma.gov.br/sindecconsulta/defaultfornecedor.asp",
      "procon_codigo": "sindecma0001",
      "procon_instancia_id": 1,
      "fornecedor_usuario": "592854110003",
      "anexos": "https://storage.googleapis.com/procon-data/sindecsp0001-cipeletronica-35001003191291441.pdf?Expires=1888274800&GoogleAccessId=dg-op-web%40digestojud.iam.gserviceaccount.com&Signature=K5aAp%2FQuKuof0u8J10lPWx79%2FLxKXoZjkIg%2FEs%2B0figsrRR4Egjb9ZzBOa3dbc%2ByPPRqpHHeFUbb3y3hrdrDpxcKxglI9jXg9e0c8I5GCh81u82wnS7nkfQiKsbBG%2BOg2AxFWBUhXUnFQd6P47Jl6xKbcuSa2jFoGCbGv0Z%2F92HEaY517Hbds%2F8xDEWe%2F3%2BLRO3trHWuoPJccx3Gq86IxtIVszu7rs8p8IxxtbEfpFDsHrzR6QeOyBbG0CVrJtkj7CTQDZfKb6%2B4i0dbwhNKF0D5WmKCT02S7jtaLtMLMgw54bX1Dn%2BoVUubbPQwuQioIlv5W9Sc8Cq0HjIP5zdemg%3D%3D, https://storage.googleapis.com/procon-data/sindecsp0001-cipeletronica-35001003191291441.pdf?Expires=1888274800&GoogleAccessId=dg-op-web%40digestojud.iam.gserviceaccount.com&Signature=K5aAp%2FQuKuof0u8J10lPWx79%2FLxKXoZjkIg%2FEs%2B0figsrRR4Egjb9ZzBOa3dbc%2ByPPRqpHHeFUbb3y3hrdrDpxcKxglI9jXg9e0c8I5GCh81u82wnS7nkfQiKsbBG%2BOg2AxFWBUhXUnFQd6P47Jl6xKbcuSa2jFoGCbGv0Z%2F92HEaY517Hbds%2F8xDEWe%2F3%2BLRO3trHWuoPJccx3Gq86IxtIVszu7rs8p8IxxtbEfpFDsHrzR6QeOyBbG0CVrJtkj7CTQDZfKb6%2B4i0dbwhNKF0D5WmKCT02S7jtaLtMLMgw54bX1Dn%2BoVUubbPQwuQioIlv5W9Sc8Cq0HjIP5zdemg%3D%3D, https://storage.googleapis.com/procon-data/sindecsp0001-cipeletronica-35001003191291441.pdf?Expires=1888274800&GoogleAccessId=dg-op-web%40digestojud.iam.gserviceaccount.com&Signature=K5aAp%2FQuKuof0u8J10lPWx79%2FLxKXoZjkIg%2FEs%2B0figsrRR4Egjb9ZzBOa3dbc%2ByPPRqpHHeFUbb3y3hrdrDpxcKxglI9jXg9e0c8I5GCh81u82wnS7nkfQiKsbBG%2BOg2AxFWBUhXUnFQd6P47Jl6xKbcuSa2jFoGCbGv0Z%2F92HEaY517Hbds%2F8xDEWe%2F3%2BLRO3trHWuoPJccx3Gq86IxtIVszu7rs8p8IxxtbEfpFDsHrzR6QeOyBbG0CVrJtkj7CTQDZfKb6%2B4i0dbwhNKF0D5WmKCT02S7jtaLtMLMgw54bX1Dn%2BoVUubbPQwuQioIlv5W9Sc8Cq0HjIP5zdemg%3D%3D"
  }
}