Skip to main content
El servicio permite a los usuarios solicitar la entrega de una o varias bodegas de un contrato de bodegaje y generar el FEB (formato de entrega de bodegas), en línea en formato JSON. Con la fecha de liquidación y las bodegas seleccionadas, la plataforma genera el FEB con la liquidación del contrato (incluido el seguro) y lo envía al correo electrónico del cliente. El método de solicitud es POST y se requiere un encabezado “Authorization” para la autenticación, que debe contener el AccessToken (JWT) obtenido previamente del servicio de inicio de sesión.

​
Prerequisitos

Antes de solicitar la entrega de bodegas, se debe contar con los siguientes datos:

​
Solicitar entrega de bodegas

Request URL: https://{{Ambiente}}/API/api/Storage/SolicitarFEB
Tipo: POST
Content Type: application/json
​
int
required
Código único del contrato de bodegaje (ID).
​
date
required
Fecha de entrega de las bodegas, hasta la cual se liquida el contrato. Se recomienda el formato yyyy-MM-dd; también se aceptan dd/MM/yyyy, dd-MM-yyyy, yyyy/MM/dd y yyyy-MM-ddTHH:mm:ss.
​
int
required
Código de la causal de devolución de las bodegas. Se obtiene del servicio de causales de devolución de bodegas.
​
int
required
Código de la persona autorizada del contrato que realizará la entrega (ContratoPersonaAutorizadaID de PersonasAutorizadas en el servicio de mis bodegas).
​
string
required
Observaciones de la solicitud de entrega (máx. 500 caracteres).
​
array
required
Bodegas del contrato que se van a entregar. Debe tener al menos una bodega.

​
Validaciones

El servicio realiza las siguientes validaciones antes de registrar la solicitud. Si alguna no se cumple, no se genera el FEB y se retorna el error correspondiente.
  • ContratoID, FechaLiquidacion, CausalDevolucionBodegaID, ContratoPersonaAutorizadaID y Observaciones son obligatorios.
  • Observaciones no puede superar 500 caracteres.
  • Se debe enviar al menos una bodega, y cada bodega debe tener BodegaID y ContratoBodegaID.
  • La liquidación y la generación del FEB se procesan en la plataforma SEDI-ERP de la empresa; si allí se presenta un error, se retorna su detalle.
ContratoPersonaAutorizadaID y ContratoBodegaID son obligatorios aunque la validación inicial del modelo no los exija: si se omiten, el servicio responde HTTP 400 con “Error: La persona autorizada es requerida” o “Error: El atributo BodegaID y ContratoBodegaID son requeridos”.

​
Respuesta

Si el AccessToken no se envía, es inválido o expiró, el servicio responde HTTP 401 ({"Code": 401, "Message": "El TokenAcceso no es valido"}). Si falta un campo obligatorio del modelo o tiene un formato inválido, responde HTTP 400 con el detalle de la validación. Cuando el FEB se genera correctamente, rows contiene un registro con los siguientes campos:
​
string
Resultado de la operación: “OK”.
​
int
Código de la salida. Retorna 0 cuando la operación es exitosa.
​
string
“El FEB fue generado exitosamente y enviado a tu correo electrónico.”
Cuando ocurre un error, el servicio responde HTTP 400 con el campo Message, que contiene el detalle del error precedido de “Error:”.