Excluir GTA¶

DELETE /integracao/gta/{id}

📌 O que o endpoint faz¶

Este endpoint é responsável por executar a operação de Excluir GTA. Ele trafega dados diretamente na base do SISBOV, permitindo a gestão correta das informações via integração de sistemas. Os dados são processados e validados mediante as rigorosas regras exigidas pelo MAPA para as certificadoras.

🧠 Lógica de Negócio (PORTUGOL)¶

A rotina interna do microserviço e sua cadeia de responsabilidades é definida simplificadamente pelos seguintes passos estruturados:

FUNÇÃO `ExcluirGTA`():
  Executar regras de negócio exclusivas para esta chamada de DELETE.
FIM_FUNÇÃO

📋 Dados da Requisição (Payload)¶

Essa tabela lista de forma robusta os campos do corpo JSON exato deste endpoint, baseado nos payloads presentes no Postman oficial.

Endpoint sem necessidade de Payload no corpo da requisição (ex: filtros via Query Params, Path Params ou operações de Exclusão).

📦 Modelos de Dados (Data Models)¶

Configuração da Requisição¶

URL Base: https://api-cert.sisbov.agro.br (Produção) / https://api-cert-hom.sisbov.agro.br (Homologação)
Path Parameter / Query Parameter: Parâmetros definidos na própria URL (/integracao/gta/{id}). Em caso de paginação, utilizar os query parameters padrões formados por ?pageSize=20&currentPage=0.
Header Parameters:
- Authorization: Bearer <seu_token_jwt> (Obrigatório em todas as chamadas)
- Content-Type: application/json

Payload de Envio (Request)¶

Em endpoints que requerem o envio de corpo de dados (ex: POST, PUT), deve-se enviar um objeto JSON compatível com o DTO adequado. Variáveis obrigatórias não podem ser enviadas como nulas. Em PUTs de atualização as entidades geralmente reagem de forma atômica — você deve preencher o DTO integralmente contendo suas modificações.

Resposta (Response)¶

Sucesso (200/201/204): O payload retornado apresenta o status de confirmação, porções da entidade, ou no caso de cadastros, o { "id": "<uuid>" }.

Erro de Negócio (400/417):

{
  "error": "Descrição detalhada do bloqueio pela regra de negócio"
}

Erro de Acesso (401/403): Token expirado ou dados fora da permissão da certificadora.

🚀 Exemplo de Uso (Postman Collection)¶

Recorte real gerado a partir do arquivo SISBOV 2.0.postman_collection.json.

DELETE https://api-cert-hmg-sisbov.agricultura.gov.br/integracao/gta/308b8adf-f1c9-4734-8731-02606484e63b
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJodHRwczovL2htZy1zaXNib3YuYWdyaWN1bHR1cmEuZ292LmJyIiwiaWF0IjoxNzYyODU3MjgwLCJhdXRoX3RpbWUiOjE3NjI4NTcyODAsIm5hbWUiOiJFZHNvbiIsImV4cCI6MTc2Mjg2NDQ4MCwidXBuIjoiZWRzb25Ac2VrdGVjaC5jb20uYnIiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJlZHNvbkBzZWt0ZWNoLmNvbS5iciIsImdyb3VwcyI6WyJjZXJ0aWZpY2Fkb3JhIl0sImp0aSI6ImIyYjlkMDc3LTYxNWUtNDAxNS04OGZkLTZhODAxNGRhZmQ3YyJ9.UED7utGCHFhk8fCCHfJHadm9j3cbmWqcpG9bWPuzVh_1Xeq4LnK9nLasAWIasXs4kG1tMt2q3BB2faaltu9SRObd_mojOw2uizf_WeFD9pBioLWZvpoUA0IgbxGOC8iEin8auShqNmqD5dO26c8dqDI2tgyaNIIrCbEERHP0KDxJfZhH_PrPBwFCGxnWxa0zYvrLO3yyW0dhfRWyL_9rlYjxgh0sxY-QMt1cWDV7N0QIOs5wlI560gqLgGc4mcfIQJgZHy0FTAOBJ55gfDynCblfOZy0aOm0w0xl_5sxKyvQFsrqh7Tvx4z4ywsJUiWM4c-JorpCqSiE-lkzNOX_iA

📑 Simulação Swagger (OpenAPI)¶

Exemplo da especificação gerada que molda a página do Swagger Interativo:

Nenhuma definição OpenAPI pública encontrada para este endpoint na especificação base.