Restofy Docs
Toma de pedidos POST

Ficha del cliente de la orden

POST /api/pos-order/get-order-customer-card

Descripción

Devuelve los datos del cliente vinculado a la orden: su crédito, cupo, saldo pendiente, notas y direcciones guardadas.

Detalles

Retorna la ficha del cliente del directorio asociado a la orden: si tiene crédito habilitado, su cupo, el saldo que debe hasta el momento, las notas del contacto y las direcciones guardadas en su libreta con la predeterminada primero. Sirve para consultar al cliente sin salir del pedido, sobre todo cuando compró a crédito. Devuelve la ficha vacía cuando la orden no tiene un cliente registrado.

Permisos requeridos

orders.module

Request

Nombre Tipo Requerido Reglas
orderUuid string
min:36 max:36

Ejemplo de request

curl -X POST https://restofy.pro/api/pos-order/get-order-customer-card \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -H "X-Tenant-Key: <tenantKey>" \
  -d '{
    "orderUuid": "string"
}'

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

Ejemplo de respuesta

Actualizado: 2026-09-08T16:35:34Z
HTTP 200

Request

{
    "orderUuid": "ebccfbf7-86d6-4dd4-be60-3e66058ced24"
}

Response

{
    "success": true,
    "message": "Operación realizada correctamente",
    "data": {
        "customer": {
            "partyUuid": "71f7a421-ab4a-11f1-b72d-f2569efa6eee",
            "name": "Marcela Ríos",
            "phone": "***",
            "notes": "Cliente frecuente, pide sin cebolla.",
            "creditType": "fixed",
            "creditLimitCents": 5000000,
            "accountBalanceCents": null,
            "accountName": null
        },
        "addresses": [
            {
                "label": "Casa",
                "addressLine": "Calle 10 # 20-30",
                "addressDetail": null,
                "addressReference": null,
                "city": "Bogotá",
                "state": null,
                "postalCode": null,
                "notes": null,
                "isDefault": 0
            }
        ]
    }
}