Relatórios - GrupoBRA/SocialAPI-v2-Doc GitHub Wiki
Obtendo relatórios
GET: /v1/relatorios/{types}/{offset}/{limit}/
Retorno:
{
"status": true,
"data": {
"SocialAPI": [
{
"id": "5218650135974101770",
"uupfid": "4799192428953130775",
"type": "servidores",
"promise": [
{
"status": "_done",
"datetime": "2019-09-18 14:01:36",
"file": {
"file_url_pdf": "http://bit.ly/32Qff3i",
"file_url_original": "https://s3-sa-east-1.amazonaws.com..."
}
},
{
"status": "_progress",
"datetime": "2019-09-18 13:50:03"
},
{
"status": "_created",
"datetime": "2019-09-18 13:46:15"
}
],
"params": {
"oeid": "10a847803d538b92eab94d19766737",
"date_start": null,
"date_end": null,
"categoria": null,
"lotacao": null,
"fields": [],
"filter": []
}
}
]
}
}
Solicitando um novo relatório
POST: /v1/relatorios/
Validação do body:
- Os campos date_start, date_end, lotacao e categoria são opcionais, para tanto, informar com valor null.
- Tipos de relatórios disponíveis (type):
- servidores, dinamico, fullfilment
- Cosultar os field e filtros permitidos para cada tipo de relatório
Payload:
{
"date_start":"aaaa-mm-dd",
"date_end":"aaaa-mm-dd",
"lotacao": "SECRETARIA DE SAUDE",
"categoria": [1, 2],
"cargo": "PROFESSOR",
"type":"servidores",
"fields": [],
"filters": []
}
Retorno:
Status code: 201
Removendo um relatório
DELETE: /v1/relatorios/{report_id}/
Payload: {empty}
Retorno:
Status code: 204, 404
Collection
{
"id":"",
"oid":"",
"uupfid":"",
"type":"vhky6p",
"promise":[
{
"status":"done",
"datetime":"",
"file":{
"file_url_pdf":"",
"file_url_csv":""
}
},
{
"status":"progress",
"datetime":""
},
{
"status":"queued",
"datetime":""
},
{
"status":"created",
"datetime":""
}
],
"params":{
"oeid":"",
"date_start":"",
"date_end":""
},
"status":[
{
"active": true,
"uupfid": "{uupfid}"
"data_hora": "2019-09-18 13:46:15"
}
]
}
Layout do relatório de servidores e servidores-inativos
Título: Relatório de Servidores {se algum filtro for informado, concatenar o nome aqui, ex: "por Categoria"/"por Lotação"}
Órgão: {nome_do_oid_token} Entidade: {nome_do_oeid_token}
Caso algum filtro seja aplicado: Intervalo: {data_inicio}/{data_fim} Categoria: {categoria} Cargo: {cargo_nome}
CPF;Matrícula;Nome;Sexo;Nascimento;