ProductOverviewResponse(ProductOverviewResponse)

Vue 360° d'un produit : fiche, stock, prix, ventes, meilleurs clients et dernières ventes.
{
    "_links": {
        "group_overview": "/api/product-groups/7/overview",
        "inventory_health": "/api/inventory/health?group_by=product",
        "product_detail": "/api/inventory/products/by-id/412",
        "products_analytics": "/api/products/analytics?from=2026-07-09&to=2026-10-07&group_by=product",
        "self": "/api/products/412/overview?lookback_months=3&top_customers_limit=10&recent_sales_limit=10",
        "to_reorder": "/api/inventory/to-reorder"
    },
    "cache": {
        "age_seconds": 0,
        "cached_at": "2026-10-07T09:12:00-04:00",
        "expires_at": "2026-10-07T13:12:00-04:00",
        "force_refreshed": false,
        "key_hash": "sha1:592f7dd8519b8405219e04021028d261e86f41b2",
        "status": "miss",
        "ttl_policy": "current_period_4h",
        "ttl_remaining_seconds": 14400
    },
    "identity": {
        "code": "VIS-B8-100",
        "group": {
            "code": "7",
            "id": 7
        },
        "is_active": true,
        "is_used": true,
        "location": "A-12",
        "name": "Vis à bois n° 8 — boîte de 100",
        "suppliers": [
            {
                "catalog_number": "VB8-100",
                "code": "DISTFIC",
                "cost": 6.4,
                "id": 58,
                "lead_time_days": 5
            }
        ],
        "unit": "BTE"
    },
    "metadata": {
        "customers_distinct": 6,
        "extracted_at": "2026-10-07T09:12:00-04:00",
        "organisation_id": "entreprise_exemple",
        "recent_sales_core_kept": 23,
        "scope": "product_360_live_card_plus_window_scan",
        "scope_note": "Fiche, stock et prix lus en direct ; ventes de la fenêtre conservées en cache par produit.",
        "sdk_indexes_used": {
            "invoicing": 6,
            "invoicing_line": 6,
            "product": 1
        },
        "window_invoices_count": 1240
    },
    "pricing": {
        "average_cost": 6.25,
        "last_cost": 6.4,
        "last_vs_average_pct": 2.4,
        "prices": {
            "liquidation": 9.99,
            "promo": 11.49,
            "regular": 12.99
        }
    },
    "product": {
        "code": "VIS-B8-100",
        "id": 412,
        "name": "Vis à bois n° 8 — boîte de 100"
    },
    "recent_sales": [
        {
            "_links": {
                "invoice_detail": "/api/invoicing/transactions/by-id/18920"
            },
            "customer": {
                "code": "CONST-EX",
                "id": 105,
                "name": "Construction Exemple inc."
            },
            "date": "2026-10-02",
            "invoice": {
                "id": 18920
            },
            "qty": 20,
            "total_amount": 259.8,
            "unit_price": 12.99
        },
        {
            "_links": {
                "invoice_detail": "/api/invoicing/transactions/by-id/18874"
            },
            "date": "2026-09-18",
            "invoice": {
                "id": 18874
            },
            "qty": 10,
            "total_amount": 129.9,
            "unit_price": 12.99
        }
    ],
    "sales": {
        "first_sale_date": "2026-07-11",
        "last_sale_date": "2026-10-02",
        "monthly_trend": [
            {
                "lines_count": 6,
                "margin": 679,
                "month": "2026-07",
                "qty": 100,
                "revenue": 1299
            },
            {
                "lines_count": 9,
                "margin": 1213.2,
                "month": "2026-08",
                "qty": 180,
                "revenue": 2338.2
            },
            {
                "lines_count": 7,
                "margin": 869.7,
                "month": "2026-09",
                "qty": 130,
                "revenue": 1688.7
            },
            {
                "lines_count": 1,
                "margin": 131.8,
                "month": "2026-10",
                "qty": 20,
                "revenue": 259.8
            }
        ],
        "qty_per_day": 4.7253,
        "totals": {
            "cost": 2692,
            "invoices_count": 18,
            "lines_count": 23,
            "margin": 2893.7,
            "margin_pct": 51.81,
            "qty": 430,
            "revenue": 5585.7
        }
    },
    "stock": {
        "by_item": [
            {
                "available": 220,
                "id": 1033,
                "location": "A-12",
                "maximum_qty": 400,
                "on_hand": 240,
                "on_order": 100,
                "reorder_point": 150,
                "reserved": 20
            }
        ],
        "settings": {
            "delivery_delay_days": 5,
            "maximum_qty": 400,
            "reorder_point": 150
        },
        "stock_value": 1500,
        "totals": {
            "available": 220,
            "on_hand": 240,
            "on_order": 100,
            "on_quote": 0,
            "reserved": 20
        }
    },
    "top_customers": [
        {
            "_links": {
                "customer_overview": "/api/customers/by-id/105/overview"
            },
            "customer": {
                "code": "CONST-EX",
                "id": 105,
                "name": "Construction Exemple inc."
            },
            "invoices_count": 9,
            "last_purchase_date": "2026-10-02",
            "qty": 250,
            "revenue": 3247.5,
            "share_pct": 58.14
        },
        {
            "_links": {},
            "invoices_count": 4,
            "last_purchase_date": "2026-09-18",
            "qty": 50,
            "revenue": 649.5,
            "share_pct": 11.63
        }
    ],
    "window": {
        "days": 91,
        "from": "2026-07-09",
        "lookback_months": 3,
        "to": "2026-10-07"
    }
}