[NEWS] Wysyłam z Allegro - raport z podsumowaniem wygenerowanych etykiet / Ship with Allegro - a report with a summary of the generated labels

W **Wysyłam z Allegro** wprowadziliśmy nową funkcjonalność: możliwość generowania podsumowań utworzonych etykiet. Podsumowanie to, dołączane jako załącznik do etykiet, może zawierać wybrane przez sprzedającego dane, takie jak: numer zamówienia, dodatkowe informacje na etykiecie, uwagi do zakupu czy przedmioty.

**Jak wygenerować raport?**

Możesz wygenerować raport podczas tworzenia etykiet za pomocą [POST /shipment-management/label](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getShipmentLabels). W tym celu skorzystaj nowego obiektu **"summaryReport"**. Aby kontrolować kształt raportu, skorzystaj z pól:

- **"placement"** - miejsca dołączenia raportów:
- LAST - zbiorczo, na ostatniej stronie
- EVERY - osobno, po każdej z etykiet
- **"fields"** - lista pól drukowanych w raporcie.

**Przykładowy request:**

```json5
curl -X 'POST' \
'https://api.allegro.pl/shipment-management/label' \
-H 'accept: application/octet-stream' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"shipmentIds": [
"ba88f0fb-acf3-438a-877e-580da50c0874"
],
"pageSize": "A4",
"cutLine": true,
"summaryReport": {
"placement": "LAST", // miejsca dołączenia raportów:
// LAST - zbiorczo, na ostatniej stronie,
// EVERY - osobno, po każdej z etykiet.
"fields": [
"WAYBILL" // niepusta tablica pól drukowanych w raporcie, dostępne wartości:
// WAYBILL, ORDER_ID, BUYER_LOGIN, ITEMS, DIMS_AND_WEIGHT,
// ADD_LABEL_TEXT, NOTES_FOR_ORDER, REF_NUMBER, COD,
// INSURANCE
]
}
}'
```

**Dlaczego wdrożyliśmy zmianę?**

Wprowadziliśmy tę zmianę, aby usprawnić proces pakowania przesyłek. Sprzedający często najpierw drukują etykiety, a później dopasowują je do zamówień. Raport ułatwi takie dopasowanie.

Więcej o Wysyłam z Allegro przeczytasz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-zarzadzac-przesylkami-przez-wysylam-z-allegro-LRVjK7K21sY).

---------

We have introduced a new feature in **Ship with Allegro**: the ability to generate summaries of created labels. This summary, included as an attachment to the labels, can contain data selected by the seller, such as: order number, additional information on the label, notes on the purchase or items.

**How to generate a report?**

You can generate a report during label creation using [POST /shipment-management/label](https://developer.allegro.pl/documentation#tag/Shipment-management/operation/getShipmentLabels). To do this, use the new **"summaryReport"** object. To control the shape of the report, use the fields:

- **"placement"** - places to attach reports:
- LAST - collectively, on the last page
- EVERY - separately, after each label
- **"fields"** - a list of fields printed in the report.

**Sample request:**

```json5
curl -X 'POST' \
'https://api.allegro.pl/shipment-management/label' \
-H 'accept: application/octet-stream' \
-H 'Content-Type: application/vnd.allegro.public.v1+json' \
-d '{
"shipmentIds": [
"ba88f0fb-acf3-438a-877e-580da50c0874"
],
"pageSize": "A4",
"cutLine": true,
"summaryReport": {
"placement": "LAST", // position to attach reports:
// LAST - collectively, on the last page,
// EVERY - separately, after each label
"fields": [
"WAYBILL" // Non-empty array of fields printed in the report, available values:
// WAYBILL, ORDER_ID, BUYER_LOGIN, ITEMS, DIMS_AND_WEIGHT,
// ADD_LABEL_TEXT, NOTES_FOR_ORDER, REF_NUMBER, COD,
// INSURANCE
]
}
}'
```

**Why did we implement the change?**

We implemented this change to streamline the process of packaging shipments. Sellers often print labels first and then match them to orders. The report will make such matching easier.

You can read more about Ship with Allegro in [our guide](https://developer.allegro.pl/tutorials/how-to-manage-parcels-via-ship-with-allegro-ZM9YAyGKWTV).