Registrar Carga Animal em Lote

POST /animalsBulk

O que o endpoint faz

Cria um registro de carga (AnimalBulkLoad) com status inicial CARREGADO para processamento assíncrono.

O endpoint não recebe o arquivo diretamente. Ele recebe apenas a referência ao upload previamente realizado na file-api.

---

Payload de Envio

Objeto base esperado: AnimalBulkRegisterDTO

Campo	Tipo	Obrigatório	Descrição
idUpload	UUID	✅	Identificador retornado por GET /animalsBulk/gerarBulkUpload
fileName	String	✅	Caminho lógico retornado pela file-api após o upload do arquivo

---

Exemplo de Requisição

{
  "idUpload": "00000000-0000-0000-0000-000000000000",
  "fileName": "ambiente/users_batch/00000000-0000-0000-0000-000000000000/arquivo.json"
}

---

Resposta de Sucesso

{
  "id": "00000000-0000-0000-0000-000000000000"
}

Esse id é o idBulk usado para consultar o processamento.

---

Resposta de Erro

{
  "error": "Erro: descrição da falha"
}

---

Observações

• O fileName deve ser exatamente o valor retornado pela file-api.
• O arquivo referenciado deve estar em formato JSON e compatível com a estrutura esperada pelo processamento em lote.
• Não inclua credenciais ou cabeçalhos sensíveis no payload desse endpoint.
• Para a montagem do conteúdo do arquivo, consulte Como Montar o Arquivo JSON da Carga.