Canales de entrega
POST
Crear canal de entrega
POST /api/fulfillments/create-fulfillment
Descripción
Registra un canal de entrega nuevo sobre un tipo de entrega del restaurante.
Detalles
Crea un canal de entrega vinculado a un tipo de entrega activo, como a domicilio o autoservicio. El nombre no puede repetirse entre los canales disponibles. En autoservicio y para llevar se define cómo se llama al cliente cuando el pedido está listo. La configuración de envío y de propinas se define luego por separado. Falla si el tipo de entrega no existe o el nombre ya está en uso.
Permisos requeridos
admin.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| name | string | Sí |
min:2
max:100
|
| fulfillmentTypeId | int | Sí |
min_value:1
|
| description | string | No |
max:2000
|
| callerMode | string | No |
enum:name,sequence,staff_code,diner_code
|
| callerLabel | string | No |
max:30
|
Ejemplo de request
curl -X POST https://restofy.pro/api/fulfillments/create-fulfillment \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"name": "string",
"fulfillmentTypeId": 1
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-11-02T19:00:57Z
HTTP 200
Request
{
"name": "Domicilio sin asignar 476488",
"fulfillmentTypeId": 4,
"description": "Fixture de test"
}Response
{
"success": true,
"message": "Canal de entrega creada",
"data": {
"fulfillment": {
"uuid": "50ac3fa7-af72-4852-8e70-2d9fece900f4",
"name": "Domicilio sin asignar 476488",
"description": "Fixture de test",
"isSystem": 0,
"fulfillmentTypeId": 4,
"fulfillmentTypeCode": "fulfillment.delivery",
"fulfillmentTypeName": "A domicilio",
"isDelivery": 1,
"isCounter": 0,
"callerMode": null,
"callerLabel": null
}
}
}