Restofy Docs

Configurar el envío de un canal de entrega

POST /api/fulfillments/set-delivery-config

Descripción

Define cómo se cobra el envío de una entrega a domicilio: sin cargo, tarifa fija, gratis, por zona o manual.

Detalles

Guarda la forma de cobro del envío de una entrega a domicilio. Según el modo elegido se usa la tarifa fija, un rango para cobro manual o las zonas de entrega seleccionadas. Permite definir un monto a partir del cual el envío es gratis y la categoría fiscal del cobro. Solo aplica a entregas a domicilio.

Permisos requeridos

admin.module

Request

Nombre Tipo Requerido Reglas
fulfillmentUuid string
min:36 max:36
channelId int
min_value:1
mode string
enum:disabled,fixed,free,per_zone,manual
defaultFeeCents int No
min_value:0
minFeeCents int No
min_value:0
maxFeeCents int No
min_value:0
taxCategoryId int No
min_value:1
freeAboveCents int No
min_value:0
zoneIds string No
array_int

Ejemplo de request

curl -X POST https://app.restofy.co/api/fulfillments/set-delivery-config \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "fulfillmentUuid": "string",
    "channelId": 1,
    "mode": "string"
}'

Los valores son demo: reemplázalos por datos reales del negocio.

Ejemplo de respuesta

Actualizado: 2026-07-15T13:20:48Z
HTTP 200

Request

{
    "fulfillmentUuid": "d6ab4f8d-00d3-4d44-a6d4-592d1b49ef20",
    "channelId": 1,
    "mode": "fixed",
    "defaultFeeCents": 500000,
    "freeAboveCents": 8000000
}

Response

{
    "success": true,
    "message": "Envío actualizado",
    "data": {
        "delivery": {
            "mode": "fixed",
            "defaultFeeCents": 500000,
            "minFeeCents": null,
            "maxFeeCents": null,
            "taxCategoryId": null,
            "freeAboveCents": 8000000,
            "zoneIds": []
        }
    }
}