/animal — Visão Geral
Sobre o Módulo Animal
O módulo animal é o coração do sistema SISBOV. Ele permite gerenciar todo o ciclo de vida de bovinos e bubalinos submetidos ao programa de rastreabilidade, desde o cadastro até o abate ou desligamento.
Endpoints Disponíveis
| Método |
Path |
Descrição |
POST |
/animal |
Cadastrar novo animal |
PUT |
/animal/{id} |
Atualizar dados do animal |
GET |
/animal/{id} |
Buscar animal por ID |
GET |
/animal/byNumero/{numero} |
Buscar animal por número de identificação |
GET |
/animal/list |
Listar animais com filtros e paginação |
GET |
/animal/count |
Contar animais por filtro |
PUT |
/animal/{id}/registraDesligamento/{idTipo}/{data} |
Registrar desligamento do animal |
PUT |
/animal/{id}/registraReligamento |
Cancelar desligamento (religar) |
PUT |
/animal/{id}/registraMorte/{idCausa}/{data} |
Registrar morte do animal |
PUT |
/animal/{id}/cancelarMorte |
Cancelar registro de morte |
PUT |
/animal/registraAlteracaoDePosse/{idProdutorDestino} |
Registrar alteração de posse |
GET |
/animal/getMorte/{idMorte} |
Buscar registro de morte |
GET |
/animal/getDesligamento/{idDesligamento} |
Buscar registro de desligamento |
GET |
/animal/consultaSimplificada/{id}/{status} |
Consulta simplificada por status |
GET |
/animal/listaAnimaisStatus/{status} |
Listar animais por status |
| Perfil |
Permissão |
certificadora |
Acesso total aos animais vinculados à sua certificadora |
admin |
Acesso irrestrito |
Modelo Base de Animal (AnimalSync)
| Campo |
Tipo |
Obrigatório |
Descrição |
numero |
string |
✅ |
Número de identificação oficial do animal (15 dígitos) |
idProdutor |
UUID |
✅ |
ID do produtor proprietário do animal |
idPropriedade |
UUID |
✅ |
ID da propriedade onde o animal está |
sexo |
enum |
✅ |
MACHO ou FEMEA |
raca |
string |
✅ |
Raça do animal (ex: NELORE, ANGUS) |
dataNascimento |
date |
✅ |
Data de nascimento (YYYY-MM-DD) |
tipoIdentificacao |
enum |
✅ |
BRINCO, TATUAGEM, DISPOSITIVO_ELETRONICO |
pai |
string |
❌ |
Número/identificação do pai |
mae |
string |
❌ |
Número/identificação da mãe |
racacruzamento |
string |
❌ |
Raça de cruzamento |
Status Possíveis de um Animal
| Status |
Descrição |
ATIVO |
Animal ativo na propriedade |
DESLIGADO |
Animal desligado da certificação |
MORTO |
Morte registrada |
EM_MOVIMENTACAO |
Participando de uma movimentação ativa |