Recepción de Materiales

El endpoint PostAddMaterialReceiving es responsable de registrar una nueva recepción de materiales en el sistema MIMS y puede ser consultado en PRO202.

---

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
ReceivingNo	String(25)	Sí	Código de orden en ERP
BranchNo	String(25)	Sí	Código externo de la filial
ReceivingDate	DataHora	Sí	Fecha de recepción de materiales
SupplierNo	String(25)	Sí	Código externo del proveedor
DocumentNo	String(20)	Sí	Número de documento de recepción
DocumentTypeNo	String(5)	No	Abreviación del tipo de documento de recepción de materiales
PurchaseOrderNo	String(10)	No	Código de orden de compra en ERP
Notes	String(2000)	No	Observaciones de orden
ItemList	AddMaterialReceivingItemList	Sí	Lista de items de recepción de materiales

📝 Objeto AddMaterialReceivingItemList

El objeto AddMaterialReceivingItemList representa la lista de items de recepción de materiales.

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
MaterialNo	String(25)	Sí	Código externo del material
WarehouseNo	String(25)	No	Código externo del almacén de recepción de materiales
CostCenterNo	String(25)	No	Código externo del centro de costo de materiales
Qty	Float	Sí	Cantidad de material
UnitValue	Float	Sí	Valor unitario del material
DiscountValue	Float	No	Valor de descuento del material
SupplierLotNo	String(50)	No	Lote del proveedor del material
LotNo	String(50)	No	Lote del material

---

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 materiales generado en el sistema MIMS

---

Ejemplo de Request

curl --location --request POST 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"PostAddMaterialReceiving"' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
  "ReceivingNo": "REC002",
  "BranchNo": "101",
  "ReceivingDate": "2025-02-07T14:30:00Z",
  "SupplierNo": "F12345",
  "DocumentNo": "DOC987654",
  "DocumentTypeNo": "NF",
  "PurchaseOrderNo": "PO456789",
  "Notes": "Entrada de materiales para reposición.",
  "ItemList": [
    {
      "MaterialNo": "1076",
      "WarehouseNo": "1000101",
      "CostCenterNo": "",
      "Qty": 10,
      "UnitValue": 15.50,
      "DiscountValue": 1.50,
      "SupplierLotNo": "SL20250207",
      "LotNo": "L20250207"
    }
  ]
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
AMR‑001	El parámetro Código Externo de Recepción de Materiales (ReceivingNo) informado ya existe!
AMR‑002	El parámetro Código Externo de Proveedor (SupplierNo) pertenece a un proveedor que no es de tipo "Proveedor". Operación no permitida!
AMR‑003	El Material "[valor enviado en la solicitud]" proporcionado en el índice [[código del índice]] no tiene un Almacén por defecto. Operación no permitida!
AMR‑004	El Material "[valor enviado en la solicitud]" proporcionado en el índice [[código del índice]] controla Número de Lote del Proveedor y el parámetro Lote del Proveedor (SupplierLotNo) no fue proporcionado. Operación no permitida!
AMR‑005	El Material "[valor enviado en la solicitud]" proporcionado en el índice [[código del índice]] controla Número de Lote y el parámetro Lote (LotNo) no fue proporcionado. Operación no permitida!
AMR‑006	Operación de movimiento de material no configurada en la base de datos. Operación no permitida!

---