Restofy Docs

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 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
min:2 max:100
fulfillmentTypeId int
min_value:1
description string No
max:2000
callerMode string No
enum:name,pager,queue,table_tent,screen

Ejemplo de request

curl -X POST https://app.restofy.co/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-07-15T13:20:48Z
HTTP 200

Request

{
    "name": "Entrega 1120fe",
    "fulfillmentTypeId": 4,
    "description": "Fixture de test"
}

Response

{
    "success": true,
    "message": "Canal de entrega creada",
    "data": {
        "fulfillment": {
            "uuid": "d6ab4f8d-00d3-4d44-a6d4-592d1b49ef20",
            "name": "Entrega 1120fe",
            "description": "Fixture de test",
            "isSystem": 0,
            "fulfillmentTypeId": 4,
            "fulfillmentTypeCode": "fulfillment.delivery",
            "fulfillmentTypeName": "A domicilio",
            "isDelivery": 1,
            "isCounter": 0,
            "callerMode": null
        }
    }
}