Track a physical card's delivery

# Tracking a physical card's delivery

## Expected error on a non-physical card

`get_card_order` returns an explicit error if the card was never physically ordered — true for any virtual card, and confirmed live on several long-active physical cards on this account (already activated, no order in progress). An error here **does not mean the card doesn't exist** — it means there's nothing to track on the delivery side for this card at this stage. Check `get_card`/`list_cards` first to confirm the card exists and its status before calling this tool.

## Call

```json
{
  "tool": "get_card_order",
  "params": {
    "companyId": "<companyId>",
    "cardId": "<cardId>"
  }
}
```

## Fields returned

`state` (`to_pickup`, `to_ship`, `shipped`), delivery city/country (not the full address — direct the user to the Spendesk app if they need the exact address), `trackingLink`, `shippedAt`, `receivedAt`, `createdAt` (order date), `consideredAsLost`, `estimatedReceivedAt`.

⚠️ `consideredAsLost` is computed at read time: it is `true` when `receivedAt` is null and the order is more than 30 days old. It is a delivery-delay heuristic, not the card's "Lost" status — never tell the user a card is lost from it. `receivedAt` is not reliably recorded: to know whether the card was received, read its status via `get_card` (Active, Blocked or Ready = received). `city`, `country`, `trackingLink`, `shippedAt`, `receivedAt` and `estimatedReceivedAt` can each be null: read shipping progress from `state`.

## Difference from the cardOrder field on get_card

`get_card`/`list_cards` expose the same `cardOrder` object (same fields), but **only while the card is physical AND in "Pre-activated" status** — as soon as the card is activated, that field disappears from the response. `get_card_order` stays available even after activation, to retrieve order history for a card already in service.

## Example user prompts

- "Where's the physical card ordered for [employee]?"
- "Is this card order running late?"
- "Give me the tracking link for [employee]'s card"