WALLET GOV.BR - Carteira de documentos gov.br
Ministério da Economia – Secretaria de Governo Digital (ME/SGD)
Versão 2.0 - 09/06/2022
Base / Sistema: Os dados fornecidos à API são oriundos de órgãos públicos que desejam adicionar o seu documento de identificação à wallet do gov.br. / Exemplo: / No caso do RG, os dados são provenientes do Instituto de Identificação do Estado responsável pela emissão do documento. / No caso da CHT, os dados são provenientes da ANAC.
A API tem como objetivo recepcionar os dados necessários para criar documentos na wallet do aplicativo gov.br.
O conjunto de serviços da API permite que o órgão integrador realize a gestão do documento do cidadão no app gov.br, sendo possível através da API:
1 – incluir novos documentos para determinado CPF;
2 – atualizar documentos (segunda via);
3 - excluir documentos.
Público alvo:
Orgãos públicos detentores de documento de identificação do cidadão
Principais Operações
Credencial de acesso à API disponibilizada pela SGD
Token de acesso necessário para realizar a chamada ao serviço de envio e atualização dos documentos
Arquivo json contendo os dados do documento a ser disponibilizado na wallet do app gov.br.
Mensagem informando se o lote enviado através do arquivo json foi gravado com sucesso. Exemplo: "status": 200, "message": "Lote 1872 gravado com sucesso!", "lote": 1872,
Credencial de acesso à API disponibilizada pela SGD
Token de acesso necessário para realizar a chamada ao serviço de envio e atualização dos documentos
Data inicial a qual deseja-se obter o status do processamento dos lotes enviados
Data_fimData final a qual deseja-se obter o status do processamento dos lotes enviados
Número do lote enviado
Recebido_emData em que o lote foi enviado para a wallet do gov.br
Processado_emData de processamento do lote pela wallet do gov.br
statusConsultar o status do processamento do lote enviado, o qual poderá assumir os seguintes valores: PENDENTE – lote ainda está na fila aguardando o processamento do lado do servidor gov.br. NAO_PROCESSADO – ocorreu erro durante o processamento do lote. Recomenda-se consultar o serviço de detalhe do processamento a fim de obter o log de execução. PROCESSAMENTO_INICIADO – lote está em execução pelo servidor do gov.br. PROCESSADO_PARCIALMENTE – ocorreu erro em pelo menos um registro do lote. Recomenda-se consultar o serviço de detalhe do processamento. Após a resolução do problema no arquivo de carga (JSON), será necessário reenviar apenas os registros com erro. PROCESSADO – processamento de todos os registros do lote realizado com sucesso.
Número lote
Data em que o lote foi processado
Total de registrosQuantidade de documentos(registros) enviados em determinado lote (arquivo json)
Registros processadosQuantidade de documentos processados com sucesso pela wallet do gov.br
Duração processamentoDuração do processamento do lote
Consulta os documentos que foram processados com sucesso.
situaçãoConsulta os documentos que estão ativo na wallet do gov.br
Apresenta o nome do documento ao qual o usuário que está realizando a requisição tem acesso
TotalTotal de documentos já enviados com sucesso para a wallet do gov.br.
Total baixadosQuantidade de vezes que o documento já foi baixado pelo usuário no aplicativo gov.br.
Número do CPF a ser excluído
Tipo do documentoNome do documento a ser excluído
Data do processamento da exclusão
StatusStatus da exclusão
MessageMensagem do processamento da exclusão.
Lista de CPFs
Lista de CPFs
Tipo do documentoNome do documento
VersãoVersão da API da wallet
SituaçãoVerifica o status do documento na wallet
Data de processamentoVerifica a data em que ocorreu o processamento do lote do CPF
Número do loteNúmero do lote o qual foi enviado o documento do cidadão
Total de downloadsQuantidade de vezes o cidadão realizou o download do documento no aplicativo gov.br
Endpoints
FAQ - Acesse o link abaixo se está com problemas para acessar a API
Para órgão Público Federal, siga as instruções de adesão ao Conecta gov.br
Quero acessarGermana Almeida (Área de Negócios)
germana.almeida@gestao.gov.br
(61) 2020-2099
Horário Comercial
Rafael Abraão (Responsável Técnico)
rafael.lago@economia.gov.br
(61) 2020-2099
Horário Comercial
