Pesaje de Entrada
Registro de Pesaje de Entrada
El endpoint PostAnimalReceiving es responsable de registrar un nuevo pesaje de entrada (recepción de animales) en el sistema MIMS y puede ser visualizado en la pantalla BLR008.
Cómo registrar un pesaje de entrada
HTTP POST Request
| Tipo de Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/PostAnimalReceiving |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAnimalReceiving" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ReceivingNo | String(25) | Sí | Código externo de recepción de animal vivo |
| BranchNo | String(25) | Sí | Código externo de la filial |
| AnimalWeighingOrderNo | String(25) | Sí | Código externo de la orden de pesaje |
| LotNo | String(25) | No | Lote de aves |
| ReceivingDate | DataHora | Sí | Fecha de entrada del camión |
| VehiclePlateNo | String(10) | No | Placa del vehículo |
| VehicleComplementyPlateNo | String(10) | No | Placa complementaria del vehículo |
| SupplierNo | String(25) | No | Código externo del integrado (proveedor) |
| FarmNo | String(25) | No | Código externo de la propiedad |
| AnimalLineageNo | String(25) | No | Código externo del linaje |
| TransporterNo | String(25) | No | Código externo del transportista |
| DriverNo | String(25) | No | Código externo del conductor |
| AnimalMaterialNo | String(25) | No | Código externo del material animal |
| CatchMethodNo | String(25) | No | Código externo del método de captura |
| CatchCrewNo | String(25) | No | Código externo del equipo de captura |
| SecondCatchCrewNo | String(25) | No | Código externo del segundo equipo de captura |
| AnimalQty | Integer | Sí | Cantidad de cabezas de animales en la carga |
| VehicleGrossWeight | Float | Sí | Peso bruto del camión |
| CageQty | Integer | No | Cantidad de jaulas |
| AnimalAge | Integer | No | Edad del animal vivo en días |
| Notes | String(200) | No | Observaciones de recepción de animales |
| AnimalSexType | AnimalSexType | No | Enumerador con los posibles valores para Sexo Animal: asNotAssigned (No Asignado), astMixed (Mixto), astFemale (Hembra) o astMale (Macho) |
| LeavingFarmDate | DataHora | No | Fecha/hora cuando el camión salió del integrado |
| SlaughterDate | DataHora | No | Fecha/hora de sacrificio |
| CatchStartDate | DataHora | No | Fecha/hora de inicio de captura |
| CatchEndDate | DataHora | No | Fecha/hora de fin de captura |
| InvoiceNumber | Integer | No | Número de factura de recepción de animales |
| GtaNumber | Integer | No | Código GTA |
| GtaSeries | String(25) | No | Número de serie GTA |
| ShedList | ShedItemList | No | Lista de galpones |
📝 Objeto ShedList
El objeto ShedList representa un item en la lista de galpones asociados con una recepción de animales en el sistema MIMS.
Parámetros de Entrada
Parámetro Tipo Obligatorio Descripción ShedNo String(15) No Código externo del galpón AnimalQty Integer Sí Cantidad de cabezas de animales en el galpón FoodRemovalDate DataHora No Fecha/hora de retiro de alimento
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Informaciones estándar de respuesta del WebService en la ejecución del método |
| ReceivingCode | Integer | Sí | Código interno de recepción de animales generado en el sistema MIMS |
Ejemplo 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": "Recepción sin intercurrencias.",
"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
}
]
}'
Ejemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"ReceivingCode": 98765
}
🐞 Posibles Errores
| Código | Mensaje |
|---|---|
| AAR‑001 | El parámetro Código Externo de Recepción de Animal Vivo (ReceivingNo) informado ya existe! |
| AAR‑002 | El parámetro Código Externo de Proveedor (SupplierNo) pertenece a un proveedor que no es de tipo "Integrado". Operación no permitida! |
| AAR‑003 | El parámetro Código Externo de Transportista (TransporterNo) pertenece a un proveedor que no es de tipo "Transportista". Operación no permitida! |
| AAR‑004 | El estado del "AnimalWeighingOrderNo" informado ("[valor enviado en la solicitud]") no permite una Recepción. Operación no permitida! |
Exclusión de Pesaje de Entrada
El endpoint PostDeleteAnimalReceiving es responsable de ejecutar la exclusión de un pesaje de entrada en el sistema MIMS.
Cómo excluir un pesaje de entrada
HTTP POST Request
| Tipo de Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/PostDeleteAnimalReceiving |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteAnimalReceiving" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| ReceivingNo | String(25) | Sí | Código externo de recepción de animales |
| ErrorIfNotFound | Boolean | No | Retorna error si la recepción de animales informada no existe en la base de datos |
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Informaciones estándar de respuesta del WebService en la ejecución del método |
Ejemplo de Request
curl --location --request POST '{{url_base}}/PostDeleteAnimalReceiving' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
"ReceivingNo": "12345",
"ErrorIfNotFound": true
}'
Ejemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
}
}