[NEWS] Zamówienia - udostępniliśmy zasób, dzięki któremu dodasz link do dokumentów rozliczeniowych / Orders - we have introduced a resource that allows you to add a link to billing documents

Udostępniliśmy nowy endpoint [POST /order/{orderId}/billing-documents/links](https://developer.allegro.pl/documentation#tag/Order-management/operation/uploadOrderBillingDocumentLink), za pomocą którego dodasz linki do dokumentów rozliczeniowych dla kupujących. W najbliższych tygodniach, po wejściu w szczegóły zamówienia na stronie internetowej, kupujący będzie mógł pobrać e-paragon lub fakturę z dedykowanego miejsca.

Dodatkowo, w istniejącym zasobie [GET /order/checkout-forms/{id}/invoices](https://developer.allegro.pl/documentation#tag/Order-management/operation/getOrderInvoicesDetails), w nowym polu **links**, dodaliśmy informacje o dodanych linkach do dokumentów.

**Ważne!** Wspieramy wyłącznie linki osadzone w wybranych domenach. Ich listę znajdziesz w przyszłości na stronie dla sprzedających. Jeśli chcesz, abyśmy dodali do naszej listy domenę, w której osadzasz linki, skontaktuj się z nami za pośrednictwem [formularza kontaktowego](https://allegro.pl/pomoc/kontakt?srsltid=AfmBOoomTwfSNmmyn86_J1-tYqD0yQRkYLUE2gWCilCTVK108zL5YWIb).

Więcej szczegółów o zarządzaniu fakturami i e-paragonami znajdziesz [w naszym poradniku](https://developer.allegro.pl/tutorials/jak-obslugiwac-zamowienia-GRaj0qyvwtR#faktury-i-e-paragony).

**Dlaczego wprowadzamy zmianę?**

Dzięki nowym rozwiązaniom kupujący będą mieć ułatwiony dostęp do faktur i paragonów, co przełoży się jednocześnie na mniejszą liczbę zapytań do sprzedających.

**Jakie zmiany w zasobach API planujemy w przyszłości?**

Ścieżka nowego zasobu [POST /order/{orderId}/billing-documents/links](https://developer.allegro.pl/documentation#tag/Order-management/operation/uploadOrderBillingDocumentLink) różni się od dotychczasowych endpointów i ma to związek z planowanymi zmianami. W przyszłości chcemy uprościć załączanie dokumentów rozliczeniowych, tak aby odbywało się to w jednym kroku, a nie, jak obecnie, w dwóch.  Zmiany te wprowadzimy na zasobach o innych ścieżkach, dając przy tym czas na dostosowanie aplikacji. Będziemy o tym informować w osobnych komunikatach.

-----

We have released a new endpoint, [POST /order/{orderId}/billing-documents/links](https://developer.allegro.pl/documentation#tag/Order-management/operation/uploadOrderBillingDocumentLink), which you can use to add links to billing documents for buyers. In the coming weeks, buyers will be able to download their e-receipt or invoice directly via the link from the order details page.

Additionally, in the existing resource [GET /order/checkout-forms/{id}/invoices](https://developer.allegro.pl/documentation#tag/Order-management/operation/getOrderInvoicesDetails), we have added information about the document links in a new field - **links**.

**Note!** We only support links placed in selected domains. You will find a list of these domains on the seller page in the future. If you would like us to add the domain where you place your links to our list, please use [the contact form.](https://allegro.pl/pomoc/kontakt?srsltid=AfmBOoomTwfSNmmyn86_J1-tYqD0yQRkYLUE2gWCilCTVK108zL5YWIb)

You can find more details on managing invoices and e-receipts in [our guide](https://developer.allegro.pl/tutorials/process-orders-PgPMlWDr8Cv#invoices-and-e-receipts).

**Why are we introducing this change?**

These new solutions will give buyers easier access to e-receipts and invoices, which in turn means fewer inquiries for sellers.

**What changes in the API resources are we planning for the future?**

The path for the new resource, [POST /order/{orderId}/billing-documents/links](https://developer.allegro.pl/documentation#tag/Order-management/operation/uploadOrderBillingDocumentLink), differs from the existing endpoints, and this is related to planned changes.

In the future, we want to simplify the attachment of billing documents to a single step, rather than the current two. We will introduce these changes to the resources with different paths, allowing time to adjust your applications. We will inform you about this in separate communications.