Canales de entrega
POST
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. También permite elegir un domiciliario por defecto, que se asigna solo si un pedido de este canal se paga sin nadie asignado a mano.
Permisos requeridos
admin.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| fulfillmentUuid | string | Sí |
min:36
max:36
|
| channelId | int | Sí |
min_value:1
|
| mode | string | Sí |
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
|
| taxRuleId | int | No |
min_value:1
|
| freeAboveCents | int | No |
min_value:0
|
| zoneIds | string | No |
array_int
|
| defaultCourierId | int | No |
min_value:1
|
Ejemplo de request
curl -X POST https://restofy.pro/api/fulfillments/set-delivery-config \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-H "X-Tenant-Key: <tenantKey>" \
-d '{
"fulfillmentUuid": "string",
"channelId": 1,
"mode": "string"
}'Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-09-08T16:35:34Z
HTTP 200
Request
{
"fulfillmentUuid": "21d573d5-b37d-4d0a-8794-f782dd84efdc",
"channelId": 1,
"mode": "fixed",
"defaultFeeCents": 500000,
"defaultCourierId": 2
}Response
{
"success": true,
"message": "Envío actualizado",
"data": {
"delivery": {
"mode": "fixed",
"defaultFeeCents": 500000,
"minFeeCents": null,
"maxFeeCents": null,
"taxRuleId": null,
"freeAboveCents": null,
"zoneIds": [],
"defaultCourierId": 2
}
}
}