Propiedad
El endpoint PostAddFarm es responsable de registrar una nueva granja (o propiedad) en el sistema MIMS. Este registro puede ser visualizado en la pantalla CAD073.
Cómo registrar una propiedad
Request HTTP POST
| Tipo de Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/PostAddFarm |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddFarm" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| FarmNo | String(25) | Sí | Código externo de la propiedad |
| Name | String(40) | Sí | Descripción de la propiedad |
| SupplierNo | String(15) | Sí | Código externo del proveedor/integrado |
| Address | AddressInfo | Sí | Objeto que contiene las informaciones de la dirección de la propiedad |
| FederalRegisterNo | String(14) | No | CNPJ/CPF de la propiedad |
| ProductorRegisterNo | String(22) | No | Número del productor rural |
| String(200) | No | Dirección de correo electrónico de la propiedad | |
| AgricultureSecretaryCode | Integer | No | Código de la Secretaría de Agricultura |
| InternalFarmCode | String(25) | No | Código interno de la propiedad |
| OverwriteIfExists | Boolean | No | Flag que indica si los datos deben ser sobrescritos si el registro ya existe |
| TransportDataFarmSlaughterItemList | TransportDataFarmSlaughterItem | No | Lista de datos de transporte entre la unidad de sacrificio y la propiedad |
Nota
- La obligatoriedad del parámetro
Addresses definida por configuración. Por defecto, este parámetro es obligatorio. Para alterar este comportamiento, consulte al consultor responsable.
📝 Objeto TransportDataFarmSlaughterItem
El objeto TransportDataFarmSlaughterItem representa un item de los datos de transporte en el sistema MIMS.
Parámetros de Entrada
Parámetro Tipo Obligatorio Descripción BranchNo String(25) No Código Externo de la Filial Distance Float No Distancia entre la propiedad y la Unidad de Sacrificio (Filial) TransportTime Integer No Tiempo de recorrido entre la propiedad y la Unidad de Sacrificio (Filial)
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Informaciones estándar de respuesta del WebService en la ejecución del método |
| FarmCode | Integer | Sí | Código interno de la propiedad generada en el sistema MIMS |
Ejemplo de Request
curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddFarm"' \
--header 'Content-Type: application/json' \
--data-raw '{
"FarmNo": "FARM-00123",
"Name": "Propiedad Santa Lucía",
"SupplierNo": "SUP-045",
"Address": {
"Address": "Carretera Municipal KM 15",
"District": "VAL FLOR",
"ZIPCode": "06456100",
"City": "EMBU-GUACU",
"State": "SAO PAULO",
"StateInitials": "SP",
"Country": "BRASIL"
},
"FederalRegisterNo": "12345678000199",
"ProductorRegisterNo": "PR-982345",
"Email": "contato@santaluzia.com.br",
"AgricultureSecretaryCode": 45678,
"InternalFarmCode": "IFC-0099",
"OverwriteIfExists": true,
"TransportDataFarmSlaughterItemList": [
{
"BranchNo": "FIL-001",
"Distance": 125.6,
"TransportTime": 180
}
]
}'
Ejemplo de Response
{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"FarmCode": 1023
}
🐞 Posibles Errores
| Código | Mensaje |
|---|---|
| AFM‑001 | ¡El parámetro Código Externo de la Granja/Propiedad (FarmNo) informado ya existe! |
| AFM‑002 | ¡El parámetro Código Externo del Integrado (SupplierNo) pertenece a un proveedor que no es del tipo "Integrado". Operación no permitida! |
| AFM‑003 | ¡La Unidad de Sacrificio no fue encontrada para la filial informada ([valor enviado en la solicitud]). Operación no permitida! |