PUT /{numero}/atualizarAnimalPorNumero

Atualiza as informações de um animal usando seu número de rastreabilidade (chave natural) em vez do UUID interno.

Campo	Valor
Método	PUT
Endpoint	/animal/{numero}/atualizarAnimalPorNumero
Chave Natural	numero (String)
Parâmetro substituído	id (UUID)
Fachada para	PUT /animal/{id}

Parâmetros de Path

Nome	Tipo	Obrigatório	Descrição
numero	String	✅	Número de identificação/rastreabilidade do animal

Body (JSON) — AnimalSync

{
  "sexo": "MA",
  "codigoRaca": "01",
  "dataNascimento": "2022-05-10",
  "dataIdentificacao": "2022-06-01",
  "tipoIdentificacao": "BRINCO",
  "tipoEntrada": "NASCIMENTO",
  "ERASPropriedadeLocalizacao": "12345",
  "ERASPropriedadeNascimento": "12345",
  "ERASPropriedadeResponsavel": "12345",
  "numeroGTAInclusao": "MG-001-2024"
}

Campos que não podem ser alterados serão ignorados automaticamente: numero, identificadorReceitaProdutor, ERASPropriedade*.

Atributos do payload (AnimalSync)

Campo	Tipo	Obrigatório	Formato / Valores aceitos	Descrição
id	String	❌	UUID	ID interno — ignorado na atualização
numero	String	❌	—	Número de rastreabilidade — ignorado na atualização
sexo	String	❌	MA, FE	Sexo do animal
codigoRaca	String	❌	Código numérico (ex: "01")	Código da raça conforme tabela MAPA
dataNascimento	LocalDate	❌	YYYY-DD-MM	Data de nascimento
dataIdentificacao	LocalDate	❌	YYYY-DD-MM	Data de identificação/marcação
dataCadastro	LocalDate	❌	YYYY-DD-MM	Data de cadastro no sistema
dataEntradaPropriedade	LocalDate	❌	YYYY-DD-MM	Data de entrada na propriedade
dataEntradaPropriedadeCertificada	LocalDate	❌	YYYY-DD-MM	Data de entrada na propriedade certificada
dataAbate	LocalDate	❌	YYYY-DD-MM	Data de abate
importado	String	❌	"true" / "false"	Indica se o animal é importado
tipoIdentificacao	String	❌	BRINCO, TATUAGEM, MICROCHIP, etc.	Tipo de identificação do animal
tipoEntrada	String	❌	NASCIMENTO, IMPORTACAO, TRANSFERENCIA, etc.	Tipo de entrada do animal
statusAnimal	String	❌	ATIVO, INATIVO, MORTO, DESLIGADO	Status atual do animal
ERASPropriedadeLocalizacao	String	❌	Código ERAS	Propriedade de localização atual
ERASPropriedadeNascimento	String	❌	Código ERAS	Propriedade de nascimento
ERASPropriedadeResponsavel	String	❌	Código ERAS	Propriedade responsável
identificadorReceitaProdutor	String	❌	CPF ou CNPJ	Produtor responsável — ignorado na atualização
identificadorReceitaProdutorCadastramento	String	❌	CPF ou CNPJ	Produtor que realizou o cadastro
registroDefinitivo	String	❌	—	Número de registro definitivo
registroProvisorio	String	❌	—	Número de registro provisório
numeroGTAInclusao	String	❌	—	Número da GTA de inclusão
idNumero	String	❌	UUID	ID do número de identificação
idNumeracao	String	❌	UUID	ID da numeração associada
idCertificadora	String	❌	UUID	ID da certificadora
idLote	String	❌	UUID	ID do lote
idMorte	String	❌	UUID	ID do registro de morte
idDesligamento	String	❌	UUID	ID do registro de desligamento

Respostas

Código	Descrição
201	Animal atualizado com sucesso
404	Animal não localizado com o número informado
417	Erro interno durante a execução

Exemplo de uso (curl)

curl -X PUT https://<api_url>/animal/123456/atualizarAnimalPorNumero \
  -H "Authorization: Bearer {TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "sexo": "MA",
    "codigoRaca": "01",
    "dataNascimento": "2022-05-10"
  }'

Resposta de sucesso (201)

{
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Resposta de erro — Animal não encontrado (404)

{
  "message": "Animal não localizado: 123456"
}