Publicações

Listar agrupamentos de publicações.

GET · API de Integração v2

GET/v2/publicacoes/agrupamentos

Listar agrupamentos para a atualização

Retorna uma linha por data, UF e diário, com quantidade total, tratadas, pendentes e percentual tratado. É a rota adequada para montar a grade principal da atualização de publicações.

Tratamento: qtd informa o total da linha. O objeto tratamento reúne qtdTratadas, qtdPendentes, percentualTratado, grupoTratado e status (PENDENTE, PARCIAL ou CONCLUIDO). Descartadas contam como tratadas; grupoTratado só é verdadeiro quando há publicações e nenhuma está pendente.

Período: use dataInicio e dataFim, no formato yyyy-MM-dd, para delimitar a consulta. Os filtros uf, siglaDiario, lido, numeroProcesso, responsavelIds, equipeIds, somenteSemResponsaveis e processoCadastro têm o mesmo significado da listagem individual.

Cenário preenchido para teste: GET /v2/publicacoes/agrupamentos?processoCadastro=TODOS&dataInicio=2026-09-28&dataFim=2026-09-28&pagina=1&tamanho=25. Ele corresponde à consulta legada de 28/09/2026. Na API nova, o intervalo legado data=28/09/2026 - 28/09/2026 vira as duas datas ISO; use somente tamanho, sem limit, perPage, per_page, itemsPerPage ou size.

Estados: lido=true inclui publicações concluídas e descartadas; lido=false retorna somente as não tratadas. somenteSemResponsaveis=true restringe aos processos sem responsáveis. Para processoCadastro, use TODOS, CADASTRADOS ou NAO_CADASTRADOS.

Paginação: pagina começa em 1; tamanho padrão é 15 e aceita no máximo 100 itens.

Autenticação

X-API-Key no cabeçalho. Como autenticar

Parâmetros de consulta14

dataDisponibilizacaoFimstring

Fim opcional do intervalo de disponibilização.

dataDisponibilizacaoIniciostring

Início opcional do intervalo de disponibilização.

dataFimstring

Fim do período. O cenário preenchido usa 28/09/2026.

exemplo: 2026-09-28
dataIniciostring

Início do período. O cenário preenchido usa 28/09/2026.

exemplo: 2026-09-28
equipeIdsarray

IDs opcionais das equipes. Repita o parâmetro para vários IDs.

lidoboolean

true para tratadas, false para não tratadas; ausente traz todas.

valores: false · true
numeroProcessostring

Busca textual opcional pelo número do processo.

paginainteger

Página, iniciando em 1.

exemplo: 1padrão: 1
processoCadastrostring

Situação de cadastro do processo.

exemplo: TODOSpadrão: TODOSvalores: CADASTRADOS · NAO_CADASTRADOS · TODOS
responsavelIdsarray

IDs opcionais dos responsáveis. Repita o parâmetro para vários IDs.

siglaDiariostring

Sigla opcional do diário, obtida em /v2/publicacoes/opcoes/diarios.

somenteSemResponsaveisboolean

true restringe a processos sem responsáveis.

valores: false · true
tamanhointeger

Itens por página, entre 1 e 100. Sem parâmetro, a API usa 15; o cenário preenchido usa 25.

exemplo: 25
ufstring

UF opcional do diário.

Respostas5

Exemplos ilustrativos · nenhuma requisição é enviada

200 · Sucesso

Quando acontece
A operação foi concluída.
Como tratar
Leia os dados retornados; em listagens, confira também a paginação.

Exemplo declarado no OpenAPI · application/json

Exemplo · HTTP 200
{
  "content": [
    {
      "uf": "SP",
      "siglaDiario": "DIARIO-EXEMPLO",
      "nomeDiario": "Diário fictício para demonstração",
      "dataPublicacao": "2026-09-28",
      "dataDisponibilizacao": "2026-09-25",
      "qtd": 10,
      "tratamento": {
        "qtdTratadas": 9,
        "qtdPendentes": 1,
        "percentualTratado": 90,
        "grupoTratado": false,
        "status": "PARCIAL"
      }
    }
  ],
  "page": 1,
  "perPage": 25,
  "total": 1,
  "totalPages": 1
}

Contrato de respostas

200Página de agrupamentos com resumo de tratamento.

Página de agrupamentos com resumo de tratamento.

application/json

contentAgrupamentoPublicacoesResponse[]
Ver propriedades
dataDisponibilizacaostring
exemplo: yyyy-MM-dd
dataPublicacaostring
exemplo: yyyy-MM-dd
nomeDiariostring
qtdinteger
formato: int32
siglaDiariostring
tratamentoResumoTratamentoPublicacoesResponse
Ver propriedades do item
grupoTratadoboolean
percentualTratadointeger
formato: int32
qtdPendentesinteger
formato: int32
qtdTratadasinteger
formato: int32
statusstring
ufstring
pageinteger
formato: int32
perPageinteger
formato: int32
totalinteger
formato: int64
totalPagesinteger
formato: int32
400Filtro inválido, inclusive data fora de yyyy-MM-dd.

Filtro inválido, inclusive data fora de yyyy-MM-dd.

application/json

codestring
exemplo: validation_error
correlationIdstring
exemplo: c4ce7307-1917-4539-b17a-9c73c972c261
detailstring
exemplo: Existem campos inválidos na requisição.
errorsErroItemApiResponse[]
Ver propriedades
codestring

Código estável do erro

exemplo: field_validation_error
fieldstring

Campo relacionado

exemplo: agenda.titulo
messagestring

Mensagem segura

exemplo: não deve estar em branco
instancestring
exemplo: /v2/agenda
requestIdstring
exemplo: e9db6635-7db3-40cb-8dd2-453c25e6a461
statusinteger
formato: int32exemplo: 400
titlestring
exemplo: Erro de validação
typestring
formato: uriexemplo: /errors/validation-error
401Não autenticado; a camada de segurança encerra a requisição antes do controller.

Não autenticado; a camada de segurança encerra a requisição antes do controller.

O contrato não declara um corpo para esta resposta.

403Sem permissão para consultar; a camada de segurança encerra a requisição antes do controller.

Sem permissão para consultar; a camada de segurança encerra a requisição antes do controller.

O contrato não declara um corpo para esta resposta.

500Erro interno ao consultar a fonte de publicações.

Erro interno ao consultar a fonte de publicações.

application/json

codestring
exemplo: validation_error
correlationIdstring
exemplo: c4ce7307-1917-4539-b17a-9c73c972c261
detailstring
exemplo: Existem campos inválidos na requisição.
errorsErroItemApiResponse[]
Ver propriedades
codestring

Código estável do erro

exemplo: field_validation_error
fieldstring

Campo relacionado

exemplo: agenda.titulo
messagestring

Mensagem segura

exemplo: não deve estar em branco
instancestring
exemplo: /v2/agenda
requestIdstring
exemplo: e9db6635-7db3-40cb-8dd2-453c25e6a461
statusinteger
formato: int32exemplo: 400
titlestring
exemplo: Erro de validação
typestring
formato: uriexemplo: /errors/validation-error
© 2026 Expedit LawtechFeito para conectar.