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

# Szybki start z wycenami wysyłki

> Pokaż w koszyku własnego sklepu internetowego ceny wysyłki z reguł wysyłki Zippendo za pomocą API wycen wysyłki.

Interfejs API do wycen wysyłki pozwala Twojemu własnemu koszykowi pokazywać klientom opcje dostawy i ceny, które ustawiono w Zippendo. Wysyłasz koszyk i adres dostawy, a Zippendo odpowiada jedną stawką dla każdej Twojej [reguły wysyłki](/docs/pl/settings/shipping-rules), która pasuje do tego koszyka.

## Kiedy z niego korzystać

* Sklep internetowy na zamówienie lub headless z własnym koszykiem
* Aplikacja, która potrzebuje cen wysyłki, zanim utworzy przesyłkę
* Koszyk, w którym jedna stała stawka nie wystarcza

Shopify i WooCommerce nie potrzebują tego API: Zippendo podaje ich stawki w koszyku za Ciebie. Zobacz [Wyceny wysyłki](/docs/pl/how-to/shipping-quotes). Użyj API, gdy ceny są potrzebne **Twojemu własnemu** koszykowi.

## Zapytanie

Wyślij koszyk i miejsce docelowe na `POST /orgs/{orgId}/shipping-quote`:

```bash theme={null}
curl -X POST https://api.zippendo.com/orgs/{orgId}/shipping-quote \
  -H "Authorization: Bearer zipp_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "destination": {
      "country": "DK",
      "postalCode": "2100",
      "city": "Copenhagen"
    },
    "items": [
      {
        "name": "T-shirt",
        "quantity": 1,
        "grams": 250,
        "price": 29900
      }
    ],
    "currency": "DKK"
  }'
```

`price` to cena jednostkowa w najmniejszej jednostce waluty (øre dla DKK, centy dla EUR), a `grams` to waga jednej sztuki. Dodaj `totalPriceCents` z wartością koszyka po rabatach, jeśli Twoje reguły wysyłki uwzględniają wartość zamówienia.

## Odpowiedź

```json theme={null}
{
  "rates": [
    {
      "serviceName": "Standard DK",
      "serviceCode": "postnord:PNL13:rule_01HZX9K2QF",
      "totalPrice": "3900",
      "currency": "DKK",
      "carrierName": "PostNord",
      "carrierSlug": "postnord",
      "productId": "PNL13",
      "shippingRuleId": "rule_01HZX9K2QF"
    }
  ]
}
```

Zippendo sprawdza każdą regułę wysyłki, której **Kraje docelowe** obejmują `destination.country`. Każda reguła, której **Warunki wysyłki** pasują do koszyka, staje się jedną stawką. Nosi nazwę reguły, a cenę wyznacza pasujący warunek (najniższa cena, jeśli pasuje kilka). `totalPrice` jest podane w najmniejszej jednostce waluty, jako ciąg znaków. Gdy żadna reguła nie pasuje, otrzymasz `{ "rates": [] }`, więc w takim przypadku pokaż w koszyku opcję zastępczą.

Pełną listę pól znajdziesz w [Wycenach wysyłki](/docs/pl/how-to/shipping-quotes) i w [dokumentacji API](/docs/api-reference/overview).

## Wymagania

* Co najmniej jeden **połączony przewoźnik**
* Co najmniej jedna **reguła wysyłki** dla krajów, do których wysyłasz. Reguły decydują, jakie stawki się pojawią i ile kosztują.
* **Token API** z uprawnieniem `read:shipping_rules`. Zobacz [Szybki start z REST API](/docs/pl/quickstarts/rest-api).

## Następne kroki

<CardGroup cols={2}>
  <Card title="Reguły wysyłki" icon="route" href="/docs/pl/settings/shipping-rules">
    Wybierz, które produkty przewoźnika są oferowane według wagi, wartości i kraju.
  </Card>

  <Card title="Dokumentacja API" icon="code" href="/docs/api-reference/overview">
    Pełne szczegóły zapytań i odpowiedzi, z piaskownicą do testów.
  </Card>
</CardGroup>


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