Consultar Status da Carga Animal em Lote¶

GET /animalsBulk/{idBulk}/status

O que o endpoint faz¶

Retorna o estado atual do processamento de uma carga registrada anteriormente.

Path Parameter¶

Parâmetro	Tipo	Obrigatório	Descrição
`idBulk`	`UUID`	✅	Identificador da carga retornado por `POST /animalsBulk`

Resposta de Sucesso¶

Objeto base retornado: AnimalBulkLoadStatusDTO

Campo	Tipo	Descrição
`idBulk`	`UUID`	Identificador da carga
`status`	`String`	Status atual do lote
`dataHoraCarga`	`LocalDateTime`	Data e hora do registro da carga
`msgErroEstrutura`	`String`	Mensagem de erro estrutural do lote, quando existir
`exceptionMap`	`Map<Integer, String>`	Mapa de falhas por índice do animal

Exemplo de resposta com sucesso¶

{
  "idBulk": "00000000-0000-0000-0000-000000000000",
  "status": "PROCESSADO_COM_SUCESSO",
  "dataHoraCarga": "2026-03-11T14:41:24.042172",
  "msgErroEstrutura": null,
  "exceptionMap": null
}

Exemplo de resposta com rejeição¶

{
  "idBulk": "00000000-0000-0000-0000-000000000000",
  "status": "REJEITADO",
  "dataHoraCarga": "2026-03-11T14:41:24.042172",
  "msgErroEstrutura": null,
  "exceptionMap": {
    "0": "[VALIDAÇÃO] descrição da falha"
  }
}

Respostas de erro¶

404: carga não encontrada.
417: erro ao consultar o status.