Od 25 maja 2026 udostępnimy nowe metody dostawy obsługiwane przez Allegro One w Polsce dedykowane na eksport do Ukrainy, co wiąże się z obsługą celną. Aby ułatwić wysyłkę takich zamówień poza Unię Europejską i obsłużyć takie zamówienia, będziemy wspierać zaproszonych do programu sprzedających w sprawach formalnych. Wprowadzone zmiany będą po to, by uzyskać dane, które pozwolą naszej agencji celnej One Customs reprezentować sprzedających przed organami celno-skarbowymi, dlatego m.in.:

• zablokujemy możliwość generowania etykiety transportowej do momentu, gdy sprzedający doda fakturę do zamówienia,
• będziemy weryfikować zgodność faktury z danymi w zamówieniu, w celu uniknięcia komplikacji podczas odprawy celnej.

Zmiany te obejmą również API - wprowadzimy nowe pola i zasoby, które pomogą w weryfikacji i identyfikacji faktur oraz umożliwią przekazywanie numerów seryjnych dla przesyłek eksportowanych na Ukrainę.

Kto może skorzystać z opcji eksportu?

Sprzedający musi spełnić następujące warunki:

• spełniać kryteria uczestnictwa w programie i uzyskać do niego zaproszenie,

• wysyłać z lokalizacji w zasięgu kuriera Allegro One,

• mieć zweryfikowane konto firmowe z aktywacją sprzedaży,

• uzupełnić numer EORI w ustawieniach konta (uzyskanie numeru EORI: https://www.biznes.gov.pl/pl/portal/ou1608),

• udzielić pełnomocnictwa dla One Customs do reprezentowania firmy sprzedającego przed organami celno-skarbowymi.

Kiedy oferta będzie zakwalifikowana do eksportu do Ukrainy?

• cennik dostawy musi zawierać metodę Allegro International Ukraina:

  • Allegro International Kurier Ukraina - 01f111ce-18a4-4a90-bf00-f999d9b97ac7
  • Allegro International Odbiór w Punkcie Ukraina - 085a666f-7114-4063-9371-f999d9b97ac7
  • Allegro International Automaty Paczkowe Ukraina - 0cb89f04-2203-45c7-b621-f999d9b97ac7

• ma uzupełnione parametry:

  • kod taryfy celnej (numer HS) dla każdego produktu, id: 250792 - minimum 8-cyfrowy kod CN (Combined Nomenclature) albo 10 i 12-znakowe kody zawierające rozszerzenie TARIC,
  • waga produktu z opakowaniem jednostkowym, id: 17448,

• format Kup Teraz,

• oferta nie jest zestawem produktowym.

Co zmieniliśmy?

1. Weryfikacja i identyfikacja faktur:

   • w zasobie do tworzenia obiektu faktury POST /order/checkout-forms/{id}/invoices pole "invoiceNumber" staje się wymagane podczas dodawania faktury w przypadku eksportu na Ukrainę metodą dostawy Allegro One.

   • dla zasobu do pobierania szczegółów faktur GET /order/checkout-forms/{id}/invoices:

     • dodaliśmy pole "orderMode", które wskazuje tryb zamówienia: REGULAR lub UKRAINE_EXPORT,
     • wprowadziliśmy nową strukturę "verification", która umożliwia weryfikację faktury w kontekście eksportu i zawiera status oraz szczegóły weryfikacji.

Przykładowy response z nową strukturą odpowiedzi (fragment):

{  
  "orderMode": "REGULAR", // możliwe wartości: REGULAR, UKRAINE_EXPORT
  "invoices": [  
    {  
      // ...
      "file": {  
        // ...
        "verification": {  
          "status": "ACCEPTED_WITH_WARNINGS", // możliwe wartości - ACCEPTED, ACCEPTED_WITH_WARNINGS, REJECTED (potencjalnie w przyszłości), WAITING
          "details": [    // szczegóły            {  
              "type": "WARNING", // typ informacji (WARNING lub ERROR) 
              "code": "MISSING_EORI_NUMBER",    // dostępne wartości NOT_VERIFIED_EORI, HSN_REQUIRED, INVALID_HSN, FORBIDDEN_HSN, WEIGHT_WITH_INDIVIDUAL_PACKAGING_REQUIRED, INVOICE_REQUIRED, FORBIDDEN_CATEGORY, PRODUCT_SET_NOT_ALLOWED, MISSING_GPSR 
              "message": "Missing EORI number" // szczegółowe informacje dotyczące statusu
            }  
          ]  
        }  
      }  
    }  
  ],  
  // ...
}

2. Obsługa numerów seryjnych i numeru HS w zamówieniach:

   • dodaliśmy nowy zasób POST /order/checkout-forms/{id}/serial-numbers do przekazywania numerów seryjnych dla pozycji zamówienia (line items):
     • liczba numerów seryjnych nie może być większa niż liczba sztuk danej pozycji zamówienia - orders[].lineItems[].quantity,
     • możliwa jest edycja i usuwanie numerów seryjnych przez podanie aktualnej listy.

Przykładowy request:

{
  "lineItems": [     // przedmioty wchodzące w skład zamówienia
    "id": "8cf2a9a0-2136-11f1-806c-cfe0938beb3b",
    "serialNumbers": {    // nymery seryjne unikalne dla każdej sztuki towaru
      "entries": [    // lista numerów seryjnych
 { "value": "SN1254353" },
 { "value": "SN4324211" }
      ]
    }
  ]
}

• Dla zasobów do pobierania zamówień GET /order/checkout-forms oraz GET /order/checkout-forms/{id}:

  • rozszerzyliśmy zasoby o pole "serialNumbers" w sekcji "lineItems", gdzie zwrócimy dodane numery seryjne - dostępne tylko w przypadku eksportu na Ukrainę,
  • dla zamówień wysyłanych do Ukrainy w szczegółach zamówienia wyświetlimy kod taryfy celnej - numer HS produktu "hsNumber", pobierany z parametrów oferty.

Przykładowy response (fragmenty):

{
  "id": "8cf2a9a0-2136-11f1-806c-cfe0938beb3b",
  "status": "READY_FOR_PROCESSING",
  "invoice": {
    "required": true,
    "address": {
            "street": "vul. Sumska 10, kv. 5",
            "city": "Kharkiv",
            "zipCode": "61001",
            "countryCode": "UA",
            "company": null,
            "naturalPerson" {
        "firstName": "Iwan",
        "lastName": "Szewczenko"
        }
         },
    "dueDate": null,
    "features": null
  },
  "lineItems": [
    {
      "id": "8cf2a9a0-2136-11f1-806c-cfe0938beb3b",
      "offer": {
        "id": "10000000030",
        "name": "Słuchawki bezprzewodowe",
        ...
        "hsNumber": "8517130000"    // kod taryfy celnej, unikatowy numer dla każdego produktu, pobierany z parametrów oferty, tylko dla zamówień z krajem dostawy UA ([Harmonized System (HS) Codes](https://www.trade.gov/harmonized-system-hs-codes))
      },
      "serialNumbers": {    // numer seryjny unikalny dla każdej sztuki towaru
        "expected": true,    // wskazuje, czy trzeba dodać numery seryjne. Sprzedawca ma obowiązek podać numery seryjne podczas realizacji zamówienia, jeśli kraj docelowy tego wymaga, a kategoria produktu kwalifikuje się do podania numerów seryjnych.
        "entries": [    // lista numerów seryjnych dodanych do zamówienia
          {"value": "SN1254353"},    
          {"value": "SN4324211"}
        ]
      }
    }
  ],
...
  "updatedAt": "2026-03-16T12:49:50.683Z",
  "revision": "b3a81206"
}