> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analyses des livraisons

> Comparez les échecs de livraison, les coûts prestataires, les frais clients et les destinations.

```text Établissement theme={null}
GET /v1/locations/{location_id}/analytics/delivery
```

```text Organisation commerciale theme={null}
GET /v1/organizations/{organization_id}/analytics/delivery
```

## Statistiques

| Champ                      | Signification                                                                                                                               |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `failed_delivery_count`    | Commandes en livraison ayant atteint l'état « échec » ou « annulée » pendant la période.                                                    |
| `provider_delivery_cost`   | Frais de livraison facturés au restaurant par les prestataires de livraison.                                                                |
| `customer_delivery_fee`    | Frais de livraison facturés aux clients par le restaurant.                                                                                  |
| `delivery_fee_balance`     | `customer_delivery_fee - provider_delivery_cost`. Une valeur négative signifie que le restaurant a absorbé une partie du coût de livraison. |
| `top_cities[].order_count` | Commandes livrées dans une ville de destination ; disponible pour un établissement, dans la limite de dix villes.                           |

Les montants d'un établissement utilisent la `currency` de la réponse. Les totaux d'une organisation sont regroupés dans `by_currency`, y compris `failed_delivery_count`, car chaque compartiment représente le même ensemble d'établissements.

```json Extrait de réponse établissement theme={null}
{
  "currency": "EUR",
  "summary": {
    "failed_delivery_count": 2,
    "provider_delivery_cost": 420.25,
    "customer_delivery_fee": 310,
    "delivery_fee_balance": -110.25
  },
  "top_cities": [{ "city": "Paris", "order_count": 64 }]
}
```

Pour un rapport de livraison, passez `service_type=delivery`. Avec `collection`, les valeurs liées aux commandes sont volontairement limitées au retrait, pour lequel les frais de livraison sont normalement nuls.