Restofy Docs
Toma de pedidos POST

Guardar datos de domicilio de la orden

POST /api/pos-order/set-delivery-details

Descripción

Crea o actualiza los datos de envío a domicilio de la orden: destinatario, dirección, referencia y notas.

Detalles

Registra o reemplaza la información del envío a domicilio de la orden con los datos de contacto, dirección y referencias indicadas. Se puede corregir aunque la orden ya esté cobrada; no se permite con la orden cancelada. La ciudad se toma del catálogo oficial de ciudades; las notas generales quedan registradas a nivel de la orden.

Permisos requeridos

orders.module orders.integration lite.module

El usuario solo necesita uno de los permisos listados.

Request

Nombre Tipo Requerido Reglas
orderUuid string Sí
min:36 max:36
customerName string No
max:150
phone string No
max:30
addressLine string No
max:300
addressDetail string No
max:200
municipalityCode string No
max:10
reference string No
max:300
notes string No
max:500
partyAddressId int No
min_value:1

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-order/set-delivery-details \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "orderUuid": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-10-09T02:12:12Z
HTTP 200

Request

{
    "orderUuid": "3d4321a7-9332-41b2-9262-3e443921a179",
    "customerName": "Ana Perez",
    "phone": "***",
    "addressLine": "Calle 1 # 2-3",
    "municipalityCode": "11001"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "orderUuid": "3d4321a7-9332-41b2-9262-3e443921a179"
    }
}