Recibir un despacho
POST /api/dispatches/create-dispatch-reception
Descripción
Registra qué llegó de un despacho y lo carga en una bodega.
Detalles
Cada insumo se marca recibido, recibido sin insumo o no recibido. Solo lo recibido con insumo suma al inventario, con la cantidad que realmente llegó. Cada insumo recibido queda asociado para los próximos despachos y actualiza su costo. Lo no recibido queda listo para que el restaurante que envió lo reingrese.
Permisos requeridos
dispatches.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| dispatchUuid | string | Sí |
min:36
max:36
|
| toStorageLocationId | int | Sí |
min_value:1
|
| receptionNotes | string | No |
max:500
|
| lines | array | Sí | — |
| lines[].dispatchLineUuid | string | Sí |
min:36
max:36
|
| lines[].lineStatusCode | string | Sí |
enum:received,received_unlinked,not_received
|
| lines[].receivedQuantityBase | string | Sí |
decimal
min_value:0
|
| lines[].inventoryItemId | int | No |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/dispatches/create-dispatch-reception \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"dispatchUuid": "string",
"toStorageLocationId": 1,
"lines": [
{
"dispatchLineUuid": "string",
"lineStatusCode": "string",
"receivedQuantityBase": "string"
}
]
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
{
"dispatchUuid": "a049c9f1-cdd9-405a-8b89-969483e802a6",
"toStorageLocationId": 1,
"receptionNotes": null,
"lines": [
{
"dispatchLineUuid": "228cd95f-945c-41ab-bc12-903aefbe0c5f",
"lineStatusCode": "received",
"receivedQuantityBase": 3000,
"inventoryItemId": 1
},
{
"dispatchLineUuid": "0be96633-1915-4cdf-8705-b627ebc59577",
"lineStatusCode": "not_received",
"receivedQuantityBase": 0
}
]
}Response
{
"success": true,
"message": "Despacho recibido",
"data": {
"dispatchUuid": "a049c9f1-cdd9-405a-8b89-969483e802a6",
"statusCode": "received_with_differences"
}
}