Registro de una Nueva Carga de Entrada de Producto

Descripción

Este endpoint registra una nueva carga de entrada de productos de terceros en el sistema MIMS. Registra información como código de la carga, sucursal, fecha, placa del vehículo, modo de carga, transportador, usuario creador y detalles de los productos de la entrada.

---

Request HTTP Post

Tipo de Solicitud	URL Ejemplo
POST	{{url_base}}/PostAddProductEntrance
Ejemplo	http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/PostAddProductEntrance

---

Parámetros de Entrada

Nombre	Tipo	Obligatorio	Descripción
BranchNo	String(25)	Sí	Código externo en la sucursal
LoadNo	String(25)	Sí	Código externo de la carga
LoadDate	DataHora	Sí	Fecha de la carga
VehiclePlateNo	String(8)	Sí	Placa del vehículo
LoadMode	LoadMode	Sí	Modo de cargamento: ImPurchase (Compra), ImTransfer (Transferencia)
TransporterNo	String(25)	Sí	Código externo del transportador
DriverNo	String(25)	Sí	Código externo del conductor de la carga
LoadCreatedUserNo	String(25)	Sí	Código externo del usuario de la creación de la carga
Notes	String(25)	No	Observaciones
ProductEntranceList	AddProductEntrance	Sí	Lista con las entradas de productos de la carga

---

Retorno

Nombre	Tipo	Obligatorio	Descripción
WebServiceReturn	WebServiceReturn	Sí	Información estándar de respuesta del WebService en la ejecución del método
LoadProductEntranceCode	Integer	Sí	Código interno de la carga de entrada de productos generado en el sistema MIMS

---

Objeto: AddProductEntrance

Descripción: Objeto que representa una entrada de productos en la carga.

Parámetros de Entrada

Nombre	Tipo	Obligatorio	Descripción
PurchaseOrderNo	String(10)	Sí	Código del pedido de compra en el ERP
PurchaseOrderDate	DataHora	Sí	Fecha/hora de la entrada de la compra en el ERP
SupplierNo	String(25)	Sí	Código externo del proveedor
SupplierTypeNo	String(25)	No	Código externo del tipo de proveedor
DocumentNo	String(25)	No	Código de los tipos de documento
DocumentType	DocumentType	No	Tipo de documento
DocumentDate	DataHora	No	Fecha/hora de la emisión del documento
Notes	String(25)	No	Observaciones
ProductEntranceItemList	AddProductEntranceItem	Sí	Lista con los productos de la entrada

---

Objeto: AddProductEntranceItem

Descripción: Objeto que representa un elemento de la entrada de productos.

Propiedades

Nombre	Tipo	Obligatorio	Descripción
ProductNo	String(25)	Sí	Código externo del producto de la entrada
WarehouseNo	String(25)	Sí	Código externo del almacén del material de la entrada
SupplierNo	String(25)	Sí	Código externo del proveedor
CostCenterNo	String(25)	No	Código externo del centro de costo del material
Qty	Float	Sí	Cantidad de cajas
Weight	Float	Sí	Peso unitario de la caja
ProductionDate	DataHora	No	Fecha/hora de fabricación
ExpirationDate	DataHora	No	Fecha de vencimiento
SupplierLotNo	String(50)	Sí	Lote del proveedor del producto
UnitValue	Float	Sí	Valor unitario del producto
DiscountValue	Float	No	Valor de descuento del producto

---

Ejemplo de Request

POST http://suIPyPuerto/datasnap/rest/RESTWebServiceMethods/PostAddProductEntrance
Content-Type: application/json

{
  "BranchNo": "BR001",
  "LoadNo": "LOAD123",
  "LoadDate": "2025-02-20T12:00:00Z",
  "VehiclePlateNo": "ABC1234",
  "LoadMode": "ImPurchase",
  "TransporterNo": "TRANS001",
  "DriverNo": "DRV001",
  "LoadCreatedUserNo": "USER001",
  "Notes": "Carga de productos tercerizados",
  "ProductEntranceList": {
    "PurchaseOrderNo": "PO123",
    "PurchaseOrderDate": "2025-02-20T10:00:00Z",
    "SupplierNo": "SUP001",
    "SupplierTypeNo": "ST001",
    "DocumentNo": "DOC123",
    "DocumentType": "Invoice",
    "DocumentDate": "2025-02-20T11:00:00Z",
    "Notes": "Entrada de productos frescos",
    "ProductEntranceItemList": [
      {
        "ProductNo": "PROD001",
        "WarehouseNo": "WH001",
        "SupplierNo": "SUP001",
        "CostCenterNo": "CC001",
        "Qty": 100.0,
        "Weight": 15.0,
        "ProductionDate": "2025-02-20T09:00:00Z",
        "ExpirationDate": "2025-08-20T23:59:59Z",
        "SupplierLotNo": "LOT001",
        "UnitValue": 25.50,
        "DiscountValue": 2.50
      }
    ]
  }
}

---

Ejemplo de Response

{
  "WebServiceReturn": {
    "Success": true,
    "Message": "Carga de entrada de productos registrada con éxito."
  },
  "LoadProductEntranceCode": 789
}

---

Notas de Desarrollo

• Asegúrese de que BranchNo, LoadNo, TransporterNo, DriverNo, LoadCreatedUserNo, PurchaseOrderNo, SupplierNo y otros códigos externos sean válidos y existentes en el sistema MIMS.
• Los campos de fecha, como LoadDate, PurchaseOrderDate, DocumentDate, ProductionDate y ExpirationDate, deben estar en formato ISO 8601 (ej.: 2025-02-20T12:00:00Z).
• El campo LoadMode acepta valores como ImPurchase (Compra) o ImTransfer (Transferencia).
• El campo DocumentType puede variar conforme el tipo de documento (ej.: Invoice para factura).