Acompanhamento¶

O registro de um acompanhamento deve ser enviado a cada etapa da prestação do serviço.

1. Registrar Acompanhamentos¶

O método Registrar Acompanhamentos permite que seja registrada informações de acompanhamento do serviço.

Para mais informações, verifique a documentação Swagger.

Atenção

Vale lembrar que a geração do formulário de avaliação está condicionada ao registro de pelo menos um acompanhamento.

Endpoint de homologação¶

https://api-acompanha-avalia-servicos.dev.nuvem.gov.br/api/acompanhamento/

Endpoint de produção¶

https://acompanhamento.servicos.gov.br/api/acompanhamento/

Parâmetros de Entrada¶

{
  "cpfCidadao": "08254631654",
  "dataEtapa": "10/10/2017",
  "dataSituacaoEtapa": "10/10/2017",
  "etapa": "Inicial",
  "orgao": "36802",
  "protocolo": "0001AC.20171212",
  "servico": "47",
  "situacaoEtapa": "Alguma descrição da situação."
}

cpfCidadao (string, optional): Informe o CPF do cidadão que está executando o serviço. Esse CPF vai ser validado com 11 dígitos.
dataEtapa (string): Data da etapa que o serviço foi executado no formato “dd/mm/aaaa”.
dataSituacaoEtapa (string): Data da etapa que o situação foi criado/alterado no formato “dd/mm/aaaa”.
etapa (string): Descrição da etapa que o serviço se encontra na dataEtapa.
orgao (string): ID do órgão, caso não saiba qual ID do órgão consulte a API do Portal de Serviços

Atenção

Esse é o código do órgão na API do Portal de Serviços e não o código SIORG do órgão.

protocolo (string): Protocolo interno do órgão referente ao serviço sendo executado. Geralmente é utilizado uma identificação única do sistema.
servico (string): ID do serviço, caso não saiba qual ID do serviço consulte a API do Portal de Serviços.
situacaoEtapa (string): Descrição da etapa do serviço.

Veja um exemplo de acesso utilizando o cURL

$ curl -v -X POST --header 'Content-Type: application/json;charset=UTF-8' -k \
--header 'Authorization: Basic YWxhZGluQGRpc25leS5jb206b3BlbnNlc2FtZQ==' \
--header 'Accept-Language: pt-br' \
--header 'Accept: application/json' -d '{ \
 "cpfCidadao": "08254631654", \
 "dataEtapa": "10/10/2017", \
 "dataSituacaoEtapa": "10/10/2017", \
 "etapa": Final", \
 "orgao": "36802", \
 "protocolo": "0001AC.20171212", \
 "servico": "47", \
 "situacaoEtapa": "Alguma descrição da situação." \
 }' 'https://api-acompanha-avalia-servicos.dev.nuvem.gov.br/api/acompanhamento/'

Veja um exemplo de acesso utilizando Java

import org.apache.http.HttpHeaders;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.methods.HttpPut;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;

public class Acompanhamento {

    private final CloseableHttpClient httpClient = HttpClients.createDefault();

    public static void main(String[] args) throws Exception {
        Acompanhamento acompanhamento = new Acompanhamento();
        try {
            acompanhamento.enviarAcompanhamento();
        } finally {
            acompanhamento.close();
        }
    }

    private void close() throws IOException {
        httpClient.close();
    }

    private void enviarAcompanhamento() throws Exception {
        String url = "https://api-acompanha-avalia-servicos.dev.nuvem.gov.br/api/acompanhamento/";
        String payload = "{" +
                "\"cpfCidadao\": \"99999999999\", " +
                "\"dataEtapa\": \"10/10/2020\", " +
                "\"dataSituacaoEtapa\": \"10/10/2020\", " +
                "\"etapa\": \"Inicial\", " +
                "\"orgao\": \"123\", " +
                "\"protocolo\": \"001\", " +
                "\"servico\": \"02\", " +
                "\"situacaoEtapa\": \"Texto.\"" +
                "}";
        HttpPost request = new HttpPost(url);
        request.addHeader(HttpHeaders.AUTHORIZATION, "Basic " + "ZmFiaW8uZmVybmFuZGV");
        request.addHeader("Content-Type", "application/json;charset=UTF-8");
        request.addHeader("Accept-Language", "pt-br");
        request.addHeader("Accept", "application/json");
        StringEntity entity = new StringEntity(payload, ContentType.APPLICATION_JSON);
        request.setEntity(entity);
        HttpResponse response = httpClient.execute(request);
        BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "utf-8"), 8);
        String line = null;
        while ((line = reader.readLine()) != null) // Read line by line
            System.out.print(line);
    }
}

Parâmetros de Saída¶

{
  "message": "Acompanhamento registrado com sucesso.",
  "status": "CREATED"
}

messagem: Mensagem que descreve o status da operação.
status: Status final da operação. Pode ser CREATED, BAD REQUEST ou INTERNAL_SERVER_ERROR

Aviso

Para uma listagem completa da saída por favor verifique a documentação Swagger.

2. Solicitar Conclusão/Reabertura de uma prestação de serviço¶

Esse método permite registrar a conclusão ou reabertura de uma prestação de serviço de um protocolo já registrado.

Após os registros dos acompanhamentos e encerrada a prestação do serviço, poderá ser informada a conclusão da prestação do serviço utilizando o método Realizar a conclusão ou reabertura de uma prestação de serviço. Contudo, para gerar o link do formulário de avaliação não é necessário que o atendimento esteja concluído.