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.
El uso simultáneo de los parámetros IsDistributionCenterTransfer e IsLoadGroup no está permitido (ver error ALO-015).

📝 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

Tipos de carga en MIMS

El método PostAddLoad permite registrar diferentes tipos de carga en MIMS:

→ Carga normal

Utilizada para el despacho convencional de órdenes de venta destinadas al cliente final, representando el escenario más común de creación de cargas en el sistema.

Informar al menos una orden en la propiedad SalesOrderList.
El parámetro IsDistributionCenterTransfer y el parámetro IsLoadGroup deben permanecer ausentes o con valor false.
El tipo de carga (parámetro LoadType) puede variar según la regla de negocio de la integración.

Ejemplo de Request

{
  "BranchNo": "0102",
  "LoadNo": "LOADTAGAT1",
  "LoadDate": "2026-07-21T00:00:00",
  "RoutingDate": "2026-07-21T00:00:00",
  "DispatchingDate": "2026-07-21T00:00:00",
  "VehiclePlateNo": "MFD0E98",
  "Blocked": false,
  "LoadType": "ltTotalized",
  "ShippingType": "sptCarton",
  "DriverNo": "1",
  "TransporterNo": "033818",
  "DistributionCenterNo": "0102",
  "SalesOrderList": [
    {
      "SalesOrderNo": "ABTMPY",
      "RecnoSC5": 6430995
    }
  ]
}

→ Cargas de transferencia entre centros de distribución

Informar IsDistributionCenterTransfer como true, indicando que es una carga de transferencia.
Informar el centro de distribución de destino en el parámetro DistributionCenterNo.
Informar la orden en SalesOrderList — las cargas de transferencia aceptan solo una orden de venta (ver error ALO-013).
El parámetro IsLoadGroup debe permanecer ausente o con valor false.

Nota

Cuando la carga no está bloqueada (Blocked = false), es obligatorio informar DistributionCenterNo y deben existir configuraciones de transferencia válidas.

Ejemplo de Request

{
  "BranchNo": "0102",
  "LoadNo": "LOADTAGAT2",
  "LoadDate": "2026-07-21T00:00:00",
  "RoutingDate": "2026-07-21T00:00:00",
  "DispatchingDate": "2026-07-21T00:00:00",
  "VehiclePlateNo": "UDV6D02",
  "Blocked": false,
  "LoadType": "ltSalesOrder",
  "ShippingType": "sptCarton",
  "DriverNo": "1",
  "TransporterNo": "002922",
  "IsDistributionCenterTransfer": true,
  "DistributionCenterNo": "0102",
  "SalesOrderList": [
    {
      "SalesOrderNo": "ABTSBH",
      "RecnoSC5": 6434851
    }
  ]
}

→ Carga agrupadora de otras cargas

Informar IsLoadGroup como true, indicando que es una carga agrupadora.
La propiedad SalesOrderList debe enviarse vacía, ya que una carga agrupadora no posee órdenes vinculadas directamente, pues su objetivo es agrupar otras cargas, y no contener órdenes.
El parámetro IsDistributionCenterTransfer debe permanecer ausente o con valor false.

Nota

El parámetro LoadGroupNo se utiliza para vincular una carga a una carga agrupadora ya existente. El proceso de creación debe seguir la siguiente secuencia:

Crear la carga agrupadora, informando IsLoadGroup como true y enviando la propiedad SalesOrderList vacía, es decir, sin órdenes.
Crear las cargas que serán agrupadas, informando IsLoadGroup como false (u omitiendo este parámetro), completando normalmente la propiedad SalesOrderList e informando el número de la carga agrupadora en el parámetro LoadGroupNo. De esta forma, cada carga creada será vinculada a la carga agrupadora previamente registrada.

Ejemplo de Request

{
  "BranchNo": "0102",
  "LoadNo": "LOADTAGAT3",
  "LoadDate": "2026-07-19T00:00:00",
  "RoutingDate": "2026-07-20T00:00:00",
  "DispatchingDate": "2026-07-20T00:00:00",
  "VehiclePlateNo": "ATX4F98",
  "Blocked": false,
  "LoadType": "ltTotalized",
  "ShippingType": "sptCarton",
  "DriverNo": "1",
  "TransporterNo": "033751",
  "SalesOrderList": [],
  "DistributionCenterNo": "0102",
  "IsLoadGroup": true
}

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!
ALO‑017	La placa del vehículo informada ("VehiclePlateNo") debe contener solo letras y números. Verifique el formato de la placa!

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​

Tipos de carga en MIMS​

→ Carga normal​

Ejemplo de Request​

→ Cargas de transferencia entre centros de distribución​

Ejemplo de Request​

→ Carga agrupadora de otras cargas​

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

Tipos de carga en MIMS

→ Carga normal

Ejemplo de Request

→ Cargas de transferencia entre centros de distribución

Ejemplo de Request

→ Carga agrupadora de otras cargas

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