Orden de Pesaje de Animales

---

Registro de Orden de Pesaje de Animales

El endpoint PostAddAnimalWeighingOrder es responsable de registrar una nueva orden de pesaje de animales en el sistema MIMS.

---

Cómo registrar una orden de pesaje de animales

HTTP POST Request

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddAnimalWeighingOrder
Ejemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddAnimalWeighingOrder"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
AnimalWeighingOrderNo	String(25)	Sí	Código externo de la Orden de Pesaje
BranchNo	String(25)	Sí	Código externo de la Filial
WeighingEvent	WeighingEvent	No	Enumerador con los posibles valores para Tipo de Orden de Pesaje: weNormal (Normal), weIncident (Accidente), weInTransit (En Tránsito), weDiverted (Desviado) o weChickenSale (Venta de Pollo)
AnimalWeighingOrderStatusType	AnimalWeighingOrderStatusType	No	Enumerador con los posibles valores para Tipo de Estado de Orden de Pesaje: wsOpened (Abierta) o wsBlocked (Bloqueada)
ScheduleDate	DataHora	Sí	Fecha de programación de la orden de pesaje
CatchDate	DataHora	Sí	Fecha de captura
ScheduleSlaughterDate	DataHora	No	Fecha programada de sacrificio
VehiclePlateNo	String(10)	Sí	Placa del vehículo
VehicleNo	String(25)	No	Código externo del vehículo
TransporterNo	String(25)	Sí	Código externo del transportista
DriverNo	String(25)	Sí	Código externo del conductor
LotNo	String(40)	Sí	Lote
FarmNo	String(25)	Sí	Código externo de la propiedad
ShedNo	Integer	Sí	Código externo del Galpón
CatchMethodNo	String(25)	No	Método de captura
CatchCrewNo	String(25)	Sí	Código externo del equipo de captura
CatchCrewSupervisorNo	String(25)	No	Código externo del supervisor de captura
AnimalAge	Integer	Sí	Edad del animal
CageQty	Integer	Sí	Cantidad de jaulas
AnimalPerCageQty	Integer	Sí	Cantidad de animales por jaula
DocumentNumber	String(25)	No	Número de documento de recepción
ReferenceNumber	String(25)	No	Número de referencia de orden de pesaje
Notes	String(200)	No	Observaciones de orden de pesaje
LoadingOrderNumber	String(5)	No	Número de orden de carga
IsActivatedQAPrope	Boolean	Sí	Indica si hay presencia de Salmonella en la carga
ExpectedAverageWeight	Float	No	Peso promedio esperado de animales
PropertyKMDistance	String(20)	No	Distancia en KM entre propiedad y matadero
QAAnalysisResult	QAAnalysisResultType	No	Enumerador con los posibles valores para Tipo de Resultado de Análisis QA: arNotAssigned (Vacío), arPresent (Presente) o arAbsent (Ausente)

---

Retorno

Parámetro	Tipo	Obligatorio	Descripción
WebServiceReturn	WebServiceReturn	Sí	Informaciones estándar de respuesta del WebService en la ejecución del método
AnimalWeighingOrderCode	Integer	Sí	Código interno de Orden de Pesaje generado en el sistema MIMS

---

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddAnimalWeighingOrder"' \
--header 'Content-Type: application/json' \
--data '{
    "AnimalWeighingOrderNo": "AWO-0115001",
    "BranchNo": "BR-001",
    "WeighingEvent": "weNormal",
    "AnimalWeighingOrderStatusType": "wsOpened",
    "ScheduleDate": "2025-01-15T08:30:00",
    "CatchDate": "2025-01-15T05:00:00",
    "ScheduleSlaughterDate": "2025-01-16T07:00:00",
    "VehiclePlateNo": "ABC1D23",
    "VehicleNo": "VEH-402",
    "TransporterNo": "TRP-012",
    "DriverNo": "DRV-887",
    "LotNo": "LT-2025-01892",
    "FarmNo": "FRM-045",
    "ShedNo": 3,
    "CatchMethodNo": "CMT-02",
    "CatchCrewNo": "CRW-155",
    "CatchCrewSupervisorNo": "SUP-017",
    "AnimalAge": 42,
    "CageQty": 120,
    "AnimalPerCageQty": 14,
    "DocumentNumber": "DOC-77821",
    "ReferenceNumber": "REF-14002",
    "Notes": "",
    "LoadingOrderNumber": "50310",
    "IsActivatedQAPrope": true,
    "ExpectedAverageWeight": 2.45,
    "PropertyKMDistance": "78",
    "QAAnalysisResult": "arPresent"
}'

---

Ejemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    },
    "AnimalWeighingOrderCode": 1001
}

---

🐞 Posibles Errores

Código	Mensaje
AWO‑001	El parámetro Código Externo de Recepción de Ave Viva (AnimalWeighingOrderNo) informado ya existe!
AWO‑002	No se encontró un Supervisor de Captura por defecto para la Propiedad informada (FarmNo)!
AWO‑003	El parámetro Código Externo de Transportista (TransporterNo) pertenece a un proveedor que no es de tipo "Transportista". Operación no permitida!
AWO‑004	El parámetro (AnimalPerCageQty) informado "[valor enviado en la solicitud]" está fuera del rango registrado. El rango debe estar entre "[Cantidad mínima de animales por jaula]" y "[Cantidad máxima de animales por jaula]"!
AWO‑010	No se encontró placa para el código del vehículo ("[valor enviado en la solicitud]")

Exclusión de Orden de Pesaje de Animales

El endpoint PostDeleteAnimalWeighingOrder es responsable de ejecutar la exclusión de una Orden de Pesaje de Animales en el sistema MIMS.

---

Cómo excluir una orden de pesaje de animales

HTTP POST Request

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostDeleteAnimalWeighingOrder
Ejemplo	http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteAnimalWeighingOrder"

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
AnimalWeighingOrderNo	String(25)	Sí	Código externo de la Orden de Pesaje
ErrorIfNotFound	Boolean	No	Retorna error si la orden 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 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteAnimalWeighingOrder"' \
--header 'Content-Type: application/json' \
--data '{
    "AnimalWeighingOrderNo": "1",
    "ErrorIfNotFound": true
}'

---

Ejemplo de Response

{
    "WebServiceReturn": {
        "Status": "wrsSuccess",
        "ErrorCode": "",
        "Message": "",
        "Actor": "",
        "ReturnQuestion": null
    }
}

---

🐞 Posibles Errores

Código	Mensaje
AWO‑007	El "AnimalWeighingOrderNo" informado no puede ser excluido porque hay otras órdenes vinculadas a él
AWO‑008	El estado actual del "AnimalWeighingOrderNo" informado ("[Estado de Orden de Pesaje]") no permite exclusión!
AWO‑009	El "AnimalWeighingOrderNo" informado ya fue enviado al Handheld. Debe ser cancelado por el supervisor de captura!

---