Carga Entrada Producto

---

Registro de Carga Entrada Producto

El endpoint PostAddProductEntrance es responsable de registrar una carga entrada producto de terceros en el sistema MIMS.

---

Cómo registrar una carga entrada producto de terceros

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
BranchNo	String(25)	Sí	Código externo en la filial
LoadNo	String(25)	Sí	Código externo de la carga
LoadDate	DataHora	Sí	Fecha de carga
LoadMode	LoadMode	Sí	Enumerador con los posibles valores para Modalidad de Carga: ImPurchase (Compra) o ImTransfer (Transferencia)
TransporterNo	String(25)	Sí	Código externo del transportista
DriverNo	String(25)	Sí	Código externo del conductor
LoadCreatedUserNo	String(25)	Sí	Código externo del usuario creador de la carga
VehiclePlateNo	String(8)	Sí	Placa del vehículo
Notes	String(25)	No	Observaciones
ProductEntranceList	AddProductEntrance	Sí	Lista con entradas de carga

📝 Objeto AddProductEntrance

El objeto AddProductEntrance representa una entrada de producto en la carga.

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
PurchaseOrderNo	String(25)	Sí	Código externo de la orden de compra en ERP
PurchaseOrderDate	DataHora	Sí	Fecha/hora de entrada
SupplierNo	String(25)	Sí	Código externo del proveedor
DocumentNo	String(25)	No	Documento
DocumentTypeNo	DocumentType	No	Código de tipo de documento
DocumentDate	DataHora	No	Fecha/hora de emisión del documento
EntranceOrderNo	Integer	No	Número de orden de entrada
Notes	String(25)	No	Observaciones
ProductEntranceItemList	AddProductEntranceItem	Sí	Lista con productos de entrada

📝 Objeto AddProductEntranceItem

El objeto AddProductEntranceItem representa un item de entrada de producto.

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
ProductNo	String(25)	Sí	Código externo del producto de entrada
WarehouseNo	String(25)	Sí	Código externo del almacén de entrada de material
SupplierNo	String(25)	Sí	Código externo del proveedor
CostCenterNo	String(25)	No	Código externo del centro de costo de material
ProductSupplyContractNo	String(25)	No	Código externo del contrato de suministro de producto
Qty	Float	Sí	Cantidad de cajas
Weight	Float	No	Peso unitario por caja
ProductionDate	DataHora	No	Fecha de producció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

---

Retorno

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

---

Ejemplo de Request

POST http://seuIPePorta/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",
      "DocumentTypeNo": "Invoice",
      "DocumentNo": "DOC123",
      "DocumentDate": "2025-02-20T11:00:00Z",
      "EntranceOrderNo": 1,
      "Notes": "Entrada de productos frescos",
      "ProductEntranceItemList": [
        {
          "ProductNo": "PROD001",
          "WarehouseNo": "WH001",
          "SupplierNo": "SUP001",
          "CostCenterNo": "CC001",
          "ProductSupplyContractNo": "CONTRACT001",
          "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": {
    "Status": "wrsSuccess",
    "ErrorCode": "",
    "Message": "",
    "Actor": "",
    "ReturnQuestion": null
  },
  "LoadProductEntranceCode": 789
}

---

🐞 Posibles Errores

Código	Mensaje
ALP‑001	El parámetro Código Externo de Carga Entrada Producto (LoadProductEntranceNo) informado ya existe!

Exclusión de Carga Entrada Producto

El endpoint PostDeleteLoadProductEntrance excluye una carga entrada producto de terceros.

---

Cómo excluir una carga entrada producto de terceros

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
LoadNo	String(25)	Sí	Código externo de carga
BranchNo	String(25)	Sí	Código externo de filial
ErrorIfNotFound	Boolean	No	Retorna error si la carga 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://localhost:8080/datasnap/rest/RESTWebServiceMethods/"PostDeleteLoadProductEntrance"' \
--header 'Content-Type: application/json' \
--data '{
    "BranchNo": "101",
    "LoadNo": "1133",
    "ErrorIfNotFound": true
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
DLP‑001	El estado actual ("[estado actual de la carga]") de "LoadNo" no está disponible para exclusión. El estado de la carga debe ser "BQ" o "AB"!
DLP‑002	El "LoadNo" informado no fue encontrado!
DLP‑003	Exclusión no permitida para el "LoadNo" informado, ya que hay identificaciones vinculadas.
DLP‑004	Exclusión no permitida para el "LoadNo" informado, ya que hay pallets vinculados.

Cerrar Carga Entrada Producto

El endpoint PostFinishLoadProductEntrance cambia el estado de la carga basado en validaciones dentro del método.

---

Cómo cambiar el estado de la carga

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
LoadNo	String(25)	Sí	Código externo de carga
BranchNo	String(25)	Sí	Código externo de filial
ErrorIfNotFound	Boolean	No	Retorna error si la carga 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/"PostFinishLoadProductEntrance"' \
--header 'Content-Type: application/json' \
--data '{
  "LoadNo": "LOAD123",
  "BranchNo": "BR001",
  "ErrorIfNotFound": true
}'

---

Ejemplo de Response

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

---

🐞 Posibles Errores

Código	Mensaje
FLP‑001	El estado actual ("[estado actual de la carga]") del "LoadNo" informado no está permitido para cambiar. El estado de la carga debe ser "FE" o "FD"!

---