Localizações Exclusivas

Retorna as localizações exclusivas associadas ao usuário autenticado, incluindo informações sobre disponibilidade para venda, status de ocupação, dimensões, capacidade e outras configurações operacionais.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Body

Example

{
    "success": true,
    "message": "Localizações recuperadas com sucesso",
    "search_query": "",
    "filters": [],
    "pagination": {
        "page": 1,
        "per_page": 15,
        "last_page": 1,
        "has_prev_page": false,
        "has_next_page": false,
        "records": {
            "from": 1,
            "to": 1,
            "total": 1
        }
    },
    "data": [
        {
            "name": "L1-1",
            "code": "01.05.01.01.01.01",
            "barcode": "01.05.01.01.01.01",
            "type": {
                "value": "SHELF",
                "label": "Prateleira"
            },
            "status": {
                "value": "occupied",
                "label": "Ocupado"
            },
            "dimensions": {
                "width": "600.00",
                "height": "400.00",
                "depth": "400.00",
                "volume": "96000.000"
            },
            "capacity": {
                "volume": {
                    "total": "96000.000",
                    "occupied": "22500.000",
                    "available": 73500,
                    "occupancy_rate": 23.44
                },
                "weight": {
                    "total": "20000.000",
                    "occupied": "4.500",
                    "available": 19995.5,
                    "occupancy_rate": 0.02
                }
            },
            "occupancy_status": {
                "status": "low",
                "label": "Baixa ocupação",
                "color": "green"
            },
            "operational_config": {
                "is_exclusive": true,
                "sale_availability": {
                    "is_available": false,
                    "status": "storage_only",
                    "label": "Apenas Armazenamento",
                    "description": "Esta localização é usada exclusivamente para armazenamento, não para vendas",
                    "color": "blue",
                    "icon": "warehouse"
                },
                "can_pick_orders": false
            },
            "inventory_summary": {
                "has_products": true,
                "unique_products_count": 1,
                "total_items": 15
            },
            "zone": {
                "name": "Mezanino",
                "code": "01.05"
            },
            "is_active": true,
            "created_at": "2025-07-21T18:18:44.000000Z",
            "updated_at": "2025-07-21T19:25:29.000000Z"
        }
    ]
}

Request

Responses