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

# Adres i koperta

> Jak podać odbiorcę i polski adres dostawy oraz jak ustawić adres zwrotny na kopercie.

Każda pocztówka podróżuje w kopercie C6 (162 × 114 mm), zaadresowanej ręcznie tym samym krojem pisma co kartka.

![Odręcznie zaadresowana koperta z firmą i adresem nadawcy w lewym górnym rogu oraz odbiorcą Pani Anna Kowalska, ul. Marszałkowska 10 m. 4, 00-001 Warszawa na środku.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/postcards/envelope.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=b730436957fe28abed5549ed6b1eaee3)

## Odbiorca

Podaj osobę, firmę albo jedno i drugie. Wymagane jest co najmniej `first_name` lub `company_name`.

| Pole | Przykład | Limit |
| - | - | - |
| `prefix` | `Pani`, `Pan`, `Dr` | 30 znaków |
| `first_name` | `Anna` | 255 znaków |
| `last_name` | `Kowalska` | 255 znaków |
| `company_name` | `Studio Forma` | 255 znaków |

```json theme={null}
{
  "recipient": {
    "prefix": "Pani",
    "first_name": "Anna",
    "last_name": "Kowalska"
  }
}
```

## Adres dostawy

Paperjoy dostarcza pocztówki wyłącznie na adresy w **Polsce**.

| Pole | Przykład | Zasada |
| - | - | - |
| `line_1` | `ul. Marszałkowska 10` | Wymagane. Ulica i numer budynku. |
| `line_2` | `m. 4` | Opcjonalne. Numer lokalu, piętro lub „c/o”. |
| `postal_code` | `00-001` | Wymagane. Dwie cyfry, myślnik, trzy cyfry. |
| `city` | `Warszawa` | Wymagane. |
| `country` | `PL` | Wymagane. Zawsze `PL`. |

```json theme={null}
{
  "address": {
    "line_1": "ul. Marszałkowska 10",
    "line_2": "m. 4",
    "postal_code": "00-001",
    "city": "Warszawa",
    "country": "PL"
  }
}
```

Ponieważ każdy adres jest krajowy, na kopercie nie pojawia się linia z nazwą kraju.

> [!WARNING]
>
> Paperjoy sprawdza format adresu, a nie to, czy adres istnieje. Upewnij się, że kod pocztowy pasuje do miasta i że podano numer lokalu. Pocztówki wysłanej na zły adres nie da się zawrócić.

## Adres zwrotny

W lewym górnym rogu koperty jest nazwa i adres Twojej organizacji. Domyślnie Paperjoy używa danych firmy z faktur.

Aby wpisać inną nazwę lub adres, np. sklepu zamiast siedziby, otwórz [**Ustawienia → Organizacja**](https://paperjoy.co/settings/organization) i zaznacz **Użyj innych danych nadawcy na kopertach**. Dane na fakturach się nie zmienią.

![Strona ustawień Organizacja z danymi firmy pobranymi na podstawie NIP i opcją użycia innych danych nadawcy na kopertach.](https://mintcdn.com/paperjoy/F1MJj4Vyrx0MCZIR/images/app/organization.webp?fit=max\&auto=format\&n=F1MJj4Vyrx0MCZIR\&q=85\&s=20120f085a494d9d1ee4a618669e6ded)

## Układ koperty

Paperjoy rozmieszcza tekst na każdej kopercie zgodnie z zasadami Poczty Polskiej:

* Pole na znaczek w prawym górnym rogu (74 × 40 mm) zostaje puste.
* Pas 15 mm wzdłuż prawej i dolnej krawędzi zostaje pusty.
* Długie linie adresu odbiorcy przesuwają się w lewo zamiast się zawijać.

Jeśli adres odbiorcy lub adres zwrotny jest za długi, Paperjoy odrzuca pocztówkę błędem `422` dla pola `address`:

```json theme={null}
{
  "message": "The sender or recipient address does not fit on the envelope.",
  "errors": {
    "address": ["The sender or recipient address does not fit on the envelope."]
  }
}
```

Skróć najdłuższą linię, np. zamieniając „ulica” na „ul.” albo przenosząc numer lokalu do `line_2`.


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