Logo do SISGRU
API docs by Redocly

SISGRU - Retificações de GRUs (Guia de Recolhimento da União) (Versão 1.0)

Download OpenAPI specification:

Histórico de Alterações

Data Versão Descrição
06/05/2026 1.0 Versão inicial da API.

1. Introdução

Disponibiliza serviços para solicitação de retificações totais e parciais de GRU.

Autenticação: Requer Token JWT (Bearer). O Sistema Externo deve estar previamente cadastrado no SISGRU com permissão de retificação via Web Service concedida pelo Tesouro Nacional.

Limite por requisição: máximo de 50 GRUs por chamada.

Códigos de retorno comuns:

  • 200 — solicitação processada com sucesso (status: "Sucesso").
  • 422 — erros de validação de negócio (status: "Erro"); os detalhes ficam no campo msg do objeto raiz (erros globais) ou nos campos msg de cada item de GRU/parcela.
  • 500 — erro inesperado no servidor.

2. Serviços

2.1. Solicita retificações totais

Solicita retificações totais de GRU. Cada item representa uma GRU a ser retificada. Apenas os atributos da GRU que devem ser retificados precisam ser informados e ao menos um campo deve ser efetivamente alterado para retificar a GRU original.

Request Body schema: application/json
required
cpfOperador
required
string

CPF do operador solicitante. Deve conter somente dígitos, ser válido e corresponder a um usuário SIAFI. Sua UG deve pertencer ao mesmo órgão do Sistema Externo autenticado, que deve ter permissão de retificação via Web Service.

required
Array of objects (Item de GRU) [ 1 .. 50 ] items

Lista de GRUs a serem retificadas totalmente.

Responses

Request samples

Content type
application/json
{
  • "cpfOperador": "12345678909",
  • "retificacoesTotais": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Sucesso",
  • "retificacoesTotais": [
    ]
}

2.2. Solicita retificações parciais

Solicita retificações parciais de GRU. Cada item representa uma GRU com múltiplas parcelas, permitindo alterar campos de cada parcela individualmente. Ao menos um campo deve ser efetivamente alterado em cada parcela para retificar a GRU original.

Obs.: Os campos de valores monetários que não forem informados na retificação parcial serão preenchidos automaticamente com zero. Por exemplo, se vlPrincipal for omitido em uma parcela, o sistema irá tratá-lo como "0.00".

Request Body schema: application/json
required
cpfOperador
required
string

CPF do operador solicitante. Deve conter somente dígitos, ser válido e corresponder a um usuário SIAFI. Sua UG deve pertencer ao mesmo órgão do Sistema Externo autenticado, que deve ter permissão de retificação via Web Service.

required
Array of objects (Item de GRU) [ 1 .. 50 ] items

Lista de GRUs a serem retificadas parcialmente. Não pode ser nula ou vazia. Não pode haver idGRU duplicado.

Responses

Request samples

Content type
application/json
{
  • "cpfOperador": "12345678909",
  • "retificacoesParciais": [
    ]
}

Response samples

Content type
application/json
{
  • "status": "Sucesso",
  • "retificacoesParciais": [
    ]
}