Materia Prima

---

Registro de Materia Prima

El endpoint PostAddRawMaterial es responsable del registro de una nueva materia prima en el sistema MIMS.

---

Cómo registrar una materia prima

Request HTTP Post

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
RecipeNo	String(25)	Sí	Código externo de la receta de materia prima
BranchNo	String(25)	Sí	Código externo de la filial
RecipeName	String(25)	Sí	Nombre de la receta de materia prima
MainProductNo	String(25)	Sí	Código externo del producto principal
Standard	Boolean	No	Flag que indica si la materia prima es estándar
OverwriteIfExists	Boolean	No	Flag que indica que los datos deben ser sobrescritos si el registro ya existe
ItemList	AddRawMaterialItemList	Sí	Lista de items de la materia prima

📝 Objeto AddRawMaterialItemList

El objeto AddRawMaterialItemList representa una lista con los items de la materia prima.

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
ItemNo	String(25)	Sí	Código del item
MaterialNo	String(25)	No	Código externo del material
ProductNo	String(25)	No	Código externo del producto
Qty	Float	Sí	Cantidad (debe ser mayor que cero)
MinTolerance	Integer	No	Tolerancia mínima
MaxTolerance	Integer	No	Tolerancia máxima
SubstitutedRawMaterial	Boolean	No	Flag que indica si hay materia prima sustituta
SubstitutedProductNo	String(25)	No	Código externo del producto sustituto
SubstitutedMaterialNo	String(25)	No	Código externo del material sustituto
SubstitutedPercentage	Integer	No	Porcentaje de sustitución
Dosed	Boolean	No	Flag que indica si el item es dosificado
WarehouseNo	String(25)	No	Código externo del almacén
MeasurementUnitERP	String	No	Unidad de medida en ERP

Nota

• Es obligatorio informar MaterialNo O ProductNo, pero no ambos al mismo tiempo.
• Si SubstitutedRawMaterial es true, es necesario informar SubstitutedMaterialNo o SubstitutedProductNo y SubstitutedPercentage.

---

Retorno

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

---

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddRawMaterial"' \
--header 'Content-Type: application/json' \
--data '{
    "RecipeNo": "REC001",
    "BranchNo": "FIL001",
    "RecipeName": "Receta Estándar",
    "MainProductNo": "PROD001",
    "Standard": true,
    "OverwriteIfExists": true,
    "ItemList": [
        {
            "ItemNo": "1",
            "MaterialNo": "MAT001",
            "Qty": 10.5,
            "MinTolerance": 0,
            "MaxTolerance": 5,
            "SubstitutedRawMaterial": false,
            "Dosed": false,
            "WarehouseNo": "ALM001",
            "MeasurementUnitERP": "KG"
        }
    ]
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
ARM‑001	¡El Número del Material [valor enviado en la solicitud] no existe en la Receta (Materia Prima) [valor enviado en la solicitud]!
ARM‑002	¡No puede informar Material y Producto al mismo tiempo. Informe un Material o un Producto!
ARM‑003	¡Es necesario informar un Material o un Producto!

Eliminación de Materia Prima

El endpoint PostDeleteRawMaterial es responsable de ejecutar la eliminación de una materia prima en el sistema MIMS.

---

Cómo eliminar una materia prima

Request HTTP Post

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
MainProductNo	String(25)	Sí	Código externo del producto principal
RecipeNo	String(25)	Sí	Código externo de la receta de materia prima
BranchNo	String(25)	Sí	Código externo de la 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

---

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostDeleteRawMaterial"' \
--header 'Content-Type: application/json' \
--data '{
    "MainProductNo": "PROD001",
    "RecipeNo": "REC001",
    "BranchNo": "FIL001"
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
DRM‑001	¡La Materia Prima no existe!
DRM‑002	¡La Materia Prima ya fue utilizada en un lote y no permite eliminación!
DRM‑003	¡La Materia Prima es fija y no permite eliminación!

Eliminación de Item de Materia Prima

El endpoint PostDeleteRawMaterialItem es responsable de ejecutar la eliminación de un item de una materia prima en el sistema MIMS.

---

Cómo eliminar un item de materia prima

Request HTTP Post

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
MainProductNo	String(25)	Sí	Código externo del producto principal
RecipeNo	String(25)	Sí	Código externo de la receta de materia prima
BranchNo	String(25)	Sí	Código externo de la filial
MaterialNo	String(25)	No	Código externo del material
ProductNo	String(25)	No	Código externo del producto

Nota

• Es obligatorio informar MaterialNo O ProductNo para identificar el item a ser eliminado.

---

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/"PostDeleteRawMaterialItem"' \
--header 'Content-Type: application/json' \
--data '{
    "MainProductNo": "PROD001",
    "RecipeNo": "REC001",
    "BranchNo": "FIL001",
    "MaterialNo": "MAT001"
}'

---

Ejemplo de Response

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