Pesagem de Entrada
Cadastro de Pesagem de Entrada
O endpoint PostAnimalReceiving é responsável pelo cadastro de uma nova pesagem de entrada (entrada de animais) no sistema MIMS e pode ser visualizado na tela BLR008.
Como cadastrar uma pesagem de entrada
Request HTTP Post
| Tipo da Requisição | URL Exemplo |
|---|---|
| POST | {{url_base}}/PostAnimalReceiving |
| Exemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAnimalReceiving" |
Parâmetros de Entrada
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ReceivingNo | String(25) | Sim | Código externo da entrada de animais vivos |
| BranchNo | String(25) | Sim | Código externo da filial |
| AnimalWeighingOrderNo | String(25) | Sim | Código externo da ordem de pesagem |
| LotNo | String(25) | Não | Lote do aviário |
| ReceivingDate | DataHora | Sim | Data de entrada do caminhão |
| VehiclePlateNo | String(10) | Não | Placa do veículo |
| VehicleComplementyPlateNo | String(10) | Não | Placa complementar do veículo |
| SupplierNo | String(25) | Não | Código externo do integrado (fornecedor) |
| FarmNo | String(25) | Não | Código externo da propriedade |
| AnimalLineageNo | String(25) | Não | Código externo da linhagem |
| TransporterNo | String(25) | Não | Código externo do transportador |
| DriverNo | String(25) | Não | Código externo do motorista |
| AnimalMaterialNo | String(25) | Não | Código externo do material animal |
| CatchMethodNo | String(25) | Não | Código externo do método de apanha |
| CatchCrewNo | String(25) | Não | Código externo da equipe de apanha |
| SecondCatchCrewNo | String(25) | Não | Código externo da segunda equipe de apanha |
| AnimalQty | Integer | Sim | Quantidade de cabeças de animais na carga |
| VehicleGrossWeight | Float | Sim | Peso bruto do caminhão |
| CageQty | Integer | Não | Quantidade de gaiolas |
| AnimalAge | Integer | Não | Idade do animal vivo em dias |
| Notes | String(200) | Não | Observações do recebimento dos animais |
| AnimalSexType | AnimalSexType | Não | Enumerador com os possíveis valores para o Sexo do animal: asNotAssigned (Não atribuído), astMixed (Misto), astFemale (Feminino) ou astMale (Masculino) |
| LeavingFarmDate | DataHora | Não | Data/hora em que o caminhão deixou o integrado |
| SlaughterDate | DataHora | Não | Data/hora de Abate |
| CatchStartDate | DataHora | Não | Data/hora do início da apanha |
| CatchEndDate | DataHora | Não | Data/hora do término da apanha |
| InvoiceNumber | Integer | Não | Número da nota fiscal da entrada de animais |
| GtaNumber | Integer | Não | Código do Gta |
| GtaSeries | String(25) | Não | Número de série do Gta |
| ShedList | ShedItemList | Não | Lista de galpões |
📝 Objeto ShedList
O objeto ShedList representa um item da lista de galpões associados a uma entrada de animais no sistema MIMS.
Parâmetros de Entrada
Parâmetro Tipo Obrigatório Descrição ShedNo String(15) Não Código externo do galpão AnimalQty Integer Sim Quantidade de cabeças de animais do galpão FoodRemovalDate DataHora Não Data/hora da retirada de alimento
Retorno
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sim | Informações padrão de resposta do WebService na execução do método |
| ReceivingCode | Integer | Sim | Código interno da entrada de animais gerado no sistema MIMS |
Exemplo de Request
curl --location --request POST '{{url_base}}/PostAnimalReceiving' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
"ReceivingNo": "REC001",
"BranchNo": "101",
"AnimalWeighingOrderNo": "REC001234",
"LotNo": "150481-222",
"DocumentNo": "1234",
"ReceivingDate": "2024-02-07T08:00:00",
"VehiclePlateNo": "ABC1234",
"VehicleComplementyPlateNo": "XYZ5678",
"SupplierNo": "F12345",
"FarmNo": "1",
"AnimalLineageNo": "LIN001",
"TransporterNo": "TRP001",
"DriverNo": "DRV001",
"AnimalMaterialNo": "MAT001",
"AnimalQty": 1000,
"VehicleGrossWeight": 15000.5,
"CageQty": 50,
"AnimalAge": 45,
"Notes": "Recebimento sem intercorrências.",
"CatchMethodNo": "CM001",
"CatchCrewNo": "CC001",
"AnimalSexType": "astMixed",
"LeavingFarmDate": "2024-02-07T04:30:00",
"SlaughterDate": "2024-02-07T12:00:00",
"ItemList": [
{
"MaterialNo": "1000",
"Qty": 500
},
{
"MaterialNo": "1001",
"Qty": 500
}
]
}
Exemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"ReceivingCode": 98765
}
🐞 Possíveis Erros
| Código | Mensagem |
|---|---|
| AAR‑001 | Parâmetro Código Externo da Entrada de Animais Vivos (ReceivingNo) informado já existe! |
| AAR‑002 | Parâmetro Código Externo do Fornecedor (SupplierNo) pertence a um fornecedor que não é do tipo "Integrado". Operação não permitida! |
| AAR‑003 | Parâmetro Código Externo do Transportador (TransporterNo) pertence a um fornecedor que não é do tipo "Transportador". Operação não permitida! |
| AAR‑004 | O status da "AnimalWeighingOrderNo" informada ("[valor enviado na requisição]") não permite uma Entrada. Operação não permitida! |
Exclusão de Pesagem de Entrada
O endpoint PostDeleteAnimalReceiving é responsável por executar a exclusão de uma pesagem de entrada no sistema MIMS.
Como excluir uma pesagem de entrada
Request HTTP Post
| Tipo da Requisição | URL Exemplo |
|---|---|
| POST | {{url_base}}/PostDeleteAnimalReceiving |
| Exemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteAnimalReceiving" |
Parâmetros de Entrada
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ReceivingNo | String(25) | Sim | Código externo da entrada de animais |
| ErrorIfNotFound | Boolean | Não | Retorna erro caso a entrada de animais informada não exista no banco de dados |
Retorno
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sim | Informações padrão de resposta do WebService na execução do método |
Exemplo de Request
curl --location --request POST '{{url_base}}/PostDeleteAnimalReceiving' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
"ReceivingNo": "12345",
"ErrorIfNotFound": true
}'
Exemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
}
}