GET /api/products/{id}
Recupera i dettagli di un prodotto specifico associato all’azienda collegata al token, compresi i dati di calcolo e margine.
Autenticazione
- Tipo: Bearer Token
- Header richiesto:
Authorization: Bearer {api_token}
Request
Headers
| Chiave | Valore |
|---|
| Authorization | Bearer {api_token} |
URL Parameters
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|
id | integer | Sì | ID del prodotto da recuperare |
Esempio di richiesta
GET /api/products/101
Authorization: Bearer {api_token}
Response
{
"success": true,
"data": {
"product": {
"id": 101,
"company_id": "23",
"type": "1",
"name": "Crostata di frutta",
"current_price": "8.50",
"vat": "10",
"measure": "porzione",
"created_at": "2025-06-01T12:00:00Z",
"updated_at": "2025-06-15T09:00:00Z"
},
"product_data": {
"id": 55,
"product_id": "101",
"total_ingredient": "3.20",
"total_labor": "1.50",
"total_labor_inactive": "0.20",
"total_labor_active": "1.30",
"total_machinery": "0.50",
"total_item": "5.20",
"total_extra_cost": "0.30",
"total_structure_cost": "0.40",
"total_calculation": "6.40",
"total_single": "6.40",
"margin": "2.10",
"margine_lordo": "2.20",
"margine_operativo": "1.80",
"margine_iva_lordo": "0.85",
"margine_iva_netto": "0.75",
"percentuale_margine_lordo": "34.37",
"percentuale_margine_netto": "31.25",
"time_labor": "0:15",
"time_machinery": "0:05",
"food_cost_percent": "50",
"total_commissions": "0.40",
"recommendedPrice": "9.50",
"variation_price_range": "1.00",
"percentuale_variation_price_range": "11.76",
"last_update": "2025-06-15",
"created_at": "2025-06-01T12:00:00Z",
"updated_at": "2025-06-15T09:00:00Z"
}
}
}
Dettaglio campi product
| Campo | Tipo | Descrizione |
|---|
| id | integer | ID univoco del prodotto |
| company_id | string | ID dell’azienda a cui appartiene il prodotto |
| type | string | Tipo di prodotto (valore fisso 1) |
| name | string | Nome del prodotto |
| current_price | string | Prezzo corrente di vendita |
| vat | string | Percentuale IVA |
| measure | string | Unità di misura (es. porzione, kg, lt, ecc.) |
| created_at | timestamp | Data creazione |
| updated_at | timestamp | Data ultima modifica |
📄 Dettaglio campi product_data
| Campo | Tipo | Descrizione |
|---|
| id | integer | ID univoco record dati prodotto |
| product_id | string | ID del prodotto |
| total_ingredient | string | Costo totale degli ingredienti |
| total_labor | string | Costo totale della manodopera |
| total_labor_inactive | string | Quota di manodopera inattiva (es. pause, tempi morti) |
| total_labor_active | string | Quota di manodopera effettivamente produttiva |
| total_machinery | string | Costo di utilizzo macchinari |
| total_item | string | Totale complessivo di ingredienti e lavorazioni |
| total_extra_cost | string | Costi extra |
| total_structure_cost | string | Costi di struttura allocati sul prodotto |
| total_calculation | string | Calcolo complessivo dei costi |
| total_single | string | Prezzo di produzione unitario |
| margin | string | Margine |
| margine_lordo | string | Margine lordo |
| margine_operativo | string | Margine operativo |
| margine_iva_lordo | string | Margine lordo comprensivo di IVA |
| margine_iva_netto | string | Margine netto comprensivo di IVA |
| percentuale_margine_lordo | string | Percentuale margine lordo |
| percentuale_margine_netto | string | Percentuale margine netto |
| time_labor | string | Tempo di lavoro per produrre il prodotto |
| time_machinery | string | Tempo di utilizzo macchinari |
| food_cost_percent | string | Percentuale food cost rispetto al prezzo |
| total_commissions | string | Eventuali commissioni |
| recommendedPrice | string | Prezzo di vendita consigliato |
| variation_price_range | string | Scostamento di prezzo suggerito |
| percentuale_variation_price_range | string | Percentuale di scostamento prezzo suggerito |
| last_update | string | Data ultimo aggiornamento calcolo |
| created_at | timestamp | Data creazione record |
| updated_at | timestamp | Data ultima modifica |