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

# Previsualitza una cita

> Previsualitza els tubs i la factura d'una cita

Retorna el que necessita una cita, segons els panells i biomarcadors que inclou. No es fa cap comanda.

* `containers`: els tubs, les targetes o els pots que prepara el professional.
* `pricing`: l'import segons la teva tarifa. [Pressuposta la cistella](https://docs.anivahealth.com/ca/api/pricing/quote-cart.md) retorna el mateix
  import sense cita.
* `routing`: sempre `null`.

Requereix un dels àmbits `appointments_view`, `appointments_schedule`, `appointments_operate` o `appointments_manage`.

## Sol·licitud

### Paràmetres de ruta

**id** `string` *required*

Identificador únic (UUID) de la cita de la qual vols previsualitzar els requisits de recipients.

## Resposta

Si té èxit, l'API retorna `200 OK` amb els requisits de recipients i camps reservats per a ús futur.

**containers** `object[]` *required*

Matriu de recipients necessaris per a la recollida de mostres. Està buida quan no s'ha afegit cap panell ni biomarcador a la cita. També està buida quan encara no es pot determinar el dia i la ubicació de la cita, per exemple quan no té hora programada.

**recipient**

**type** `string`

Identificador del tipus de recipient. Un d'aquests valors: `serum`, `serum_capillary`, `serum_capillary_plain`, `edta`, `edta_capillary`, `citrate`, `lihep`, `lihep_capillary`, `glucoexact`, `fluoride`, `fluoride_capillary`, `homocysteine`, `urine`, `dried_blood_spot`, `swab`, `stool`, `saliva`, `hair` o `trace_metal`.

**name** `string`

Nom llegible del recipient (p. ex., "Serum", "EDTA", "Li-Heparin").

**cap\_color** `string`

Codi de color hexadecimal del tap del recipient per mostrar-lo (p. ex., `"#A0784B"`). `null` quan el
recipient no té tap.

**volume** `string`

Capacitat de volum del recipient (p. ex., `"7.5 ml"`). `null` quan el volum no s'aplica.

**article\_number** `string`

Número de catàleg del fabricant (REF), quan es coneix (p. ex., `"01.1602.001"`). S'omet en els recipients sense número d'article assignat.

**count** `integer`

Nombre de recipients d'aquest tipus necessaris.

**routing** `null`

Detalls d'encaminament de laboratori — no s'exposen intencionadament, sempre `null`.

**pricing** `object | null`

L'import complet de la cistella per a la cita, segons la teva tarifa. `null` quan la cita no té
anàlisis associades o quan la teva clau no té l'àmbit `prices_view`. [Preus](https://docs.anivahealth.com/ca/concepts/pricing.md) explica el
model; els imports individuals segueixen la referència dels [objectes de
preu](https://docs.anivahealth.com/ca/api/biomarkers/list-biomarkers.md#objectes-de-preu).

**Camps de l'import**

**total\_cents** `integer`

El que costa la cistella segons la teva tarifa: les posicions amb preu més els panells amb preu més les files
de biomarcadors amb preu. Una fila amb `price_cents: null` no suma res, així que una cistella que en contingui una suma menys
del que costarà.

**retail\_total\_cents** `integer`

El mateix total segons la tarifa recomanada de venda al públic.

**fees** `object`

Els càrrecs que afegeix una extracció de sang segons la teva tarifa, en cèntims. Es cobren a la factura mensual. Consulta [Obtén la
tarifa](https://docs.anivahealth.com/ca/api/pricing/get-rate-card.md).

**càrrecs**

**phlebotomy\_fee\_cents** `integer`

Càrrec de flebotomia per cita completada.

**snack\_fee\_cents** `integer`

Refrigeri per al pacient. Es factura només quan el pacient rep un refrigeri. S'omet quan els teus
pacients no en reben; contacta amb Aniva per oferir refrigeris.

**logistics\_fee\_cents** `integer`

Càrrec de missatgeria per a la recollida. Les teves cites a la mateixa ubicació el mateix dia comparteixen un sol
càrrec.

**material\_fee\_cents** `integer`

Consumibles: tubs, etiquetes, bossa.

**total\_with\_fees\_cents** `integer`

`total_cents` més cada tarifa de `fees`, amb la tarifa logística completa. És inferior quan una
altra de les teves cites comparteix la recollida.

**positions** `object[]`

Cada posició que s'ha activat en aquesta cistella — facturada un sol cop, íntegrament, i que
lliura tot el seu conjunt de membres. Inclou `id`, `name`, `price_cents`, `retail_cents` i `tier`.
Una posició que no és visible per als socis s'activa i es factura igualment, i s'informa amb `id`
i `name` definits com a `null`.

**panels** `object[]`

Cada panell vinculat, amb `id`, `name`, `price_cents` i `retail_cents`.

**biomarkers** `object[]`

Una fila per cada biomarcador **lliurat** — el que has demanat, més els components que han
incorporat les seves ràtios i els membres que lliuren les seves posicions.

**id** `number`

Identificador del biomarcador.

**name** `string`

Nom visible del biomarcador.

**price\_cents** `integer | null`

El que costa aquesta fila a la teva targeta, amb `retail_cents` al costat. `0` quan una posició
el paga; `null` quan Aniva no en pot establir el preu.

**required\_by** `number[]`

Les ràtios que han incorporat aquest component a la cistella. S'omet si no ho ha fet cap. Un
component es paga un sol cop per cistella, independentment de quantes ràtios en depenguin.

**requires** `number[]`

Present quan aquesta fila ÉS una ràtio: els components pels quals es factura.

**via\_position** `string`

La posició que paga aquest marcador, motiu pel qual la fila costa `0`. S'omet quan res no el
cobreix. `null` quan la posició que el cobreix no és visible per als socis.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Format d'ID no vàlid — el valor proporcionat no és un UUID vàlid. |
| `403` | Prohibit — la teva clau API no té accés a aquesta operació. |
| `404` | No s'ha trobat la cita. |
| `500` | Error intern del servidor. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/preview \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "containers": [
    {
      "type": "serum",
      "name": "Serum",
      "cap_color": "#A0784B",
      "volume": "7.5 ml",
      "article_number": "01.1602.001",
      "count": 3
    },
    {
      "type": "edta",
      "name": "EDTA",
      "cap_color": "#D13438",
      "volume": "3.4 ml",
      "article_number": "04.1914.001",
      "count": 2
    },
    {
      "type": "glucoexact",
      "name": "GlucoEXACT",
      "cap_color": "#9E9E9E",
      "volume": "3.1 ml",
      "article_number": "05.1074.001",
      "count": 1
    }
  ],
  "routing": null,
  "pricing": {
    "total_cents": 13751,
    "retail_total_cents": 17029,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 19001,
    "positions": [
      {
        "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
        "name": "Aniva Blood Count",
        "price_cents": 452,
        "retail_cents": 520,
        "tier": "routine"
      }
    ],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [
      { "id": 42, "name": "HDL Cholesterol", "price_cents": 233, "retail_cents": 268, "required_by": [279] },
      {
        "id": 71,
        "name": "Hemoglobin",
        "price_cents": 0,
        "retail_cents": 0,
        "via_position": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d"
      },
      { "id": 84, "name": "High-Sensitivity C-Reactive Protein (hs-CRP)", "price_cents": 1166, "retail_cents": 1341, "required_by": [279] },
      { "id": 279, "name": "hs-CRP / HDL Ratio", "price_cents": 0, "retail_cents": 0, "requires": [42, 84] }
    ]
  }
}
```

```json 200 (no panels) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": null
}
```

```json 200 (one item without a price) theme={null}
{
  "containers": [],
  "routing": null,
  "pricing": {
    "total_cents": 11900,
    "retail_total_cents": 14900,
    "fees": {
      "phlebotomy_fee_cents": 2500,
      "snack_fee_cents": 500,
      "logistics_fee_cents": 2000,
      "material_fee_cents": 250
    },
    "total_with_fees_cents": 17150,
    "positions": [],
    "panels": [
      {
        "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
        "name": "Hormones (Female)",
        "price_cents": 11900,
        "retail_cents": 14900
      }
    ],
    "biomarkers": [{ "id": 555, "name": "Poppy Seeds (Pap s)", "price_cents": null, "retail_cents": null }]
  }
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.