Carga

Registro de Carga

El endpoint PostAddLoad registra una nueva carga en el sistema MIMS y puede ser visualizada en la pantalla TRP003.

Cómo registrar una carga

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Type	Obligatorio	Descripción
LoadNo	String(25)	Sí	Código externo de la carga
BranchNo	String(25)	Sí	Código externo de la filial
LoadDate	DataHora	Sí	Fecha de carga
RoutingDate	DataHora	No	Fecha/hora de armado de carga
DispatchingDate	DataHora	No	Fecha esperada de inicio de carga
EffectedLoadDate	DataHora	No	Fecha de efectivación de carga
Blocked	Boolean	Sí	Indica si la carga será creada con estado bloqueado
VehiclePlateNo	String(8)	Sí	Placa del vehículo
DriverNo	String(25)	Sí	Código externo del conductor
TransporterNo	String(25)	Sí	Código externo del transportista
LoadType	LoadType	Sí	Enumerador con los posibles valores para Modalidad de Carga: `ltTotalized` (Totalizada), `ltMixed` (Mixta) o `ltSalesOrder` (Orden de Venta)
ShippingType	ShippingType	No	Enumerador con los posibles valores para Tipo de Carga: `sptCarton` (Caja), `sptPallet` (Palletizada) o `sptMixed` (Mixta)
ContainerNo	String(25)	No	Número de contenedor
LoadGroupNo	String(25)	No	Código externo de la carga agrupada
EffectedLoadUserNo	String(25)	No	Código externo del usuario que efectivó la carga
DistributionCenterNo	String(25)	No	Código externo del centro de distribución de carga
IsLoadGroup	Boolean	No	Flag que indica que la carga es una carga agrupada
IsDistributionCenterTransfer	Boolean	No	Flag que indica que la carga es utilizada para transferencia entre CDs
Notes	String(2000)	No	Observaciones
TransporterNotes	String(2000)	No	Observaciones para el transportista
SalesOrderList	AddLoadSalesOrderItemList	No	Lista con todos los códigos externos de las órdenes de carga

Nota

El parámetro SalesOrderList es obligatorio solo cuando la carga no es de tipo agrupada, es decir, cuando el parámetro IsLoadGroup está configurado como false.

📝 Objeto AddLoadSalesOrderItem

El objeto AddLoadSalesOrderItem representa una orden de venta en la carga.

Parámetros de Entrada

Parámetro Tipo Obligatorio Descripción
SalesOrderNo String(25) No Código externo de la orden de venta en la carga
SalesOrderCode Integer No Código interno de la orden de venta en la carga

Parámetro	Tipo	Obligatorio	Descripción
SalesOrderNo	String(25)	No	Código externo de la orden de venta en la carga
SalesOrderCode	Integer	No	Código interno de la orden de venta en la carga

Retorno

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

Ejemplo de Request

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostAddLoad' \
--header 'Content-Type: application/json' \
--data-raw '{
  "BranchNo": "BR001",
  "LoadDate": "2025-03-10T08:00:00Z",
  "RoutingDate": "2025-03-10T07:00:00Z",
  "VehiclePlateNo": "ABC1234",
  "Blocked": true,
  "Notes": "Carga de ejemplo",
  "LoadType": "ltTotalized",
  "DriverNo": "DRV001",
  "TransporterNo": "TRP001",
  "ShippingType": "sptPallet",
  "ContainerNo": "CONT001",
  "LoadGroupNo": "LGR001",
  "IsLoadGroup": false,
  "SalesOrderList": [
    {
      "SalesOrderNo": "SO123",
      "SalesOrderCode": 456
    }
  ],
  "EffectedLoadDate": "2025-03-10T09:00:00Z",
  "EffectedLoadUserNo": "USR001"
}'

Ejemplo de Response

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

🐞 Posibles Errores

Código	Mensaje
ALO‑001	El parámetro Código Externo de Carga (LoadNo) informado ya existe!
ALO‑002	Error al generar programación de camión!
ALO‑003	Error al generar item de programación de camión!
ALO‑004	El estado de la Carga Agrupada informada (LoadGroupNo) ("[estado de carga enviado en la solicitud]") no está disponible. El estado de la Carga Agrupada debe ser "Abierta" o "Bloqueada"!
ALO‑005	El Código Externo de la Carga Agrupada (LoadGroupNo) no pertenece a una Carga Agrupada. Proceso Abortado!
ALO‑006	La Orden de Venta "[valor enviado en la solicitud]" informada en el índice [[código del índice]] pertenece a una carga diferente. Proceso Abortado!
ALO‑007	La Orden de Venta "[valor enviado en la solicitud]" informada en el índice [[código del índice]] es una orden de venta directa. Operación no permitida!
ALO‑008	La Orden de Venta "[valor enviado en la solicitud]" informada en el índice [[código del índice]] está bloqueada. Operación no permitida!
ALO‑009	El estado de la Orden de Venta "[valor enviado en la solicitud]" informada en el índice [[código del índice]] ("[estado de orden de venta vinculada]") no está disponible para carga. Proceso Abortado!
ALO‑010	El parámetro Código Externo de Transportista (TransporterNo) pertenece a un proveedor que no es de tipo "Transportista". Operación no permitida!
ALO‑011	Si es una carga agrupada, el parámetro "LoadGroupNo" no debe ser proporcionado. Proceso Abortado!
ALO‑012	La Orden de Venta "[valor enviado en la solicitud]" informada en el índice [[código del índice]] no fue encontrada!
ALO‑013	Las cargas de transferencia entre centros de distribución no pueden contener más de una orden de venta!
ALO‑014	La carga fue informada como transferencia (parámetro IsDistributionCenterTransfer), sin embargo, no se encontraron configuraciones de transferencia. Proceso Abortado!
ALO‑015	Una carga de transferencia (parámetro IsDistributionCenterTransfer) no puede ser simultáneamente una carga agrupada (parámetro IsLoadGroup)!
ALO‑016	El almacén de origen no puede ser el mismo que el almacén de destino en cargas de transferencia. Proceso abortado!

Exclusión de Carga

El endpoint PostDeleteLoad es responsable de ejecutar la exclusión de una carga en el sistema MIMS.

Cómo excluir una carga

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
LoadNo	String(25)	Sí	Código externo de la carga
BranchNo	String(25)	Sí	Código externo de la filial
NotVerifyTruckWeighed	Boolean	No	Flag que indica si la verificación del registro de pesaje del camión debe ser ignorada
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 --request POST 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostDeleteLoad' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
  "LoadNo": "LOAD12345",
  "BranchNo": "BR001",
  "ErrorIfNotFound": true
}'

Ejemplo de Response

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

🐞 Posibles Errores

Código	Mensaje
DLO‑001	El parámetro Código Externo de Carga (LoadNo) se refiere a una Carga Agrupada y está relacionada con otras Cargas. Proceso Abortado!
DLO‑002	El estado actual de la Carga informada ("[valor enviado en la solicitud]") no está disponible para exclusión!. El estado de la Carga debe ser "Abierta" o "Bloqueada"!
DLO‑003	Existe un mapa de carga para la Carga informada. Operación no permitida!
DLO‑004	El camión de la Carga informada ya fue pesado. Operación no permitida!
DLO‑005	El "LoadNo" informado está bloqueado para el equipo de logística. Operación no permitida!

Cierre de Carga

El endpoint PostLoadClosure es responsable de cerrar una carga en el sistema MIMS.

Cómo cerrar una carga

HTTP POST Request

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

Parámetros de Entrada

Parámetro	Tipo	Obligatorio	Descripción
LoadNo	String(25)	Sí	Código externo de la carga
BranchNo	String(25)	Sí	Código externo de la filial
VehicleTare	Float	No	Tara del vehículo
VehicleGrossWeight	Float	No	Peso bruto del vehículo
TruckArrivalDate	DataHora	No	Fecha/hora de llegada del camión
TruckDepartureDate	DataHora	No	Fecha/hora de salida del camión
MinTolerance	Float	No	Tolerancia mínima
MaxTolerance	Float	No	Tolerancia máxima
ReleaseUserNo	String(25)	No	Usuario de liberación
ReleaseReason	String(50)	No	Motivo de liberación

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 --request POST 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/PostLoadClosure' \
--header 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{
  "LoadNo": "LOAD12345",
  "BranchNo": "BR001",
  "VehicleTare": 15000.5,
  "VehicleGrossWeight": 25000.75,
  "TruckArrivalDate": "2025-02-07T08:30:00",
  "TruckDepartureDate": "2025-02-07T09:45:00",
  "MinTolerance": 50.0,
  "MaxTolerance": 200.0,
  "ReleaseUserNo": "USR001",
  "ReleaseReason": "Carga verificada y aprobada"
}'

Ejemplo de Response

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

🐞 Posibles Errores

Código	Mensaje
LDC‑001	El estado actual de la Carga informada ("[valor enviado en la solicitud]") no está disponible para cierre. El estado de la Carga debe ser "Esperando Pesaje" o "Cerrada"!
LDC‑002	El parámetro Código Externo de Carga (LoadNo) se refiere a una Carga Agrupada, sin embargo una o más Cargas aún no están cerradas. Operación no permitida!

Reapertura / Recomposición de Carga

El endpoint PostLoadReopening permite la reapertura (recomposición) de una carga que ya ha sido cerrada y enviada a ERP.

Cómo realizar reapertura / recomposición de carga

HTTP POST Request

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

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
ErrorIfNotClosed	Boolean	No	Retorna error si la carga informada no está finalizada y ha sido enviada a ERP

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/"PostLoadReopening"' \
--header 'Content-Type: application/json' \
--data '{
  "LoadNo": "LOAD12345",
  "BranchNo": "BR001",
  "ErrorIfNotClosed": true
}'

Ejemplo de Response

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

🐞 Posibles Errores

Código	Mensaje
LRP‑001	El estado actual de la Carga informada ("[valor enviado en la solicitud]") no está disponible para reapertura. El estado de la Carga debe ser "Cerrada"!

Registro de Carga​

Cómo registrar una carga​

Parámetros de Entrada​

📝 Objeto AddLoadSalesOrderItem​

Parámetros de Entrada​

Retorno​

Ejemplo de Request​

Ejemplo de Response​

🐞 Posibles Errores​

Exclusión de Carga​

Cómo excluir una carga​

Parámetros de Entrada​

Retorno​

Ejemplo de Request​

Ejemplo de Response​

🐞 Posibles Errores​

Cierre de Carga​

Cómo cerrar una carga​

Parámetros de Entrada​

Retorno​

Ejemplo de Request​

Ejemplo de Response​

🐞 Posibles Errores​

Reapertura / Recomposición de Carga​

Cómo realizar reapertura / recomposición de carga​

Parámetros de Entrada​

Retorno​

Ejemplo de Request​

Ejemplo de Response​

🐞 Posibles Errores​

Registro de Carga

Cómo registrar una carga

Parámetros de Entrada

📝 Objeto AddLoadSalesOrderItem

Parámetros de Entrada

Retorno

Ejemplo de Request

Ejemplo de Response

🐞 Posibles Errores

Exclusión de Carga

Cómo excluir una carga

Parámetros de Entrada

Retorno

Ejemplo de Request

Ejemplo de Response

🐞 Posibles Errores

Cierre de Carga

Cómo cerrar una carga

Parámetros de Entrada

Retorno

Ejemplo de Request

Ejemplo de Response

🐞 Posibles Errores

Reapertura / Recomposición de Carga

Cómo realizar reapertura / recomposición de carga

Parámetros de Entrada

Retorno

Ejemplo de Request

Ejemplo de Response

🐞 Posibles Errores