allegro / allegro/allegro-api

[NEWS] Serwisy zagraniczne Allegro - od 18 listopada 2024 pozwolimy wszystkim sprzedającym udostępnić oferty na business.allegro.cz oraz wdrożymy wsparcie dla transakcji wewnątrzwspólnotowych / Allegro foreign marketplaces - starting November 18, 2024, we will allow all sellers to list offers on business.allegro.cz and implement support for intra-community transactions

Aperta
#10,184 0 commenti 0 reazioni 1 assegnatario Rivendicata da @AureliuszBrussy Vedi su GitHub
Marketplaces News Offer - management Orders - management
Lingua principale
Nessun dato sulla lingua
Stelle
244
Fork
40
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

Od **18 listopada 2024** pozwolimy wszystkim sprzedającym, niezależnie od rynku bazowego, udostępnić oferty dla klientów firmowych na [business.allegro.cz](https://business.allegro.cz). Wprowadzimy równocześnie wsparcie dla transakcji transgranicznych.

**26 czerwca 2024** udostępniliśmy w Czechach pierwszy serwis dla przedsiębiorców: Allegro Business (``"allegro-business-cz"``). Obecnie jest on dostępny tylko dla sprzedających, których rynek bazowy to ``"allegro-cz"``.

**Jak będzie wyglądać proces kwalifikacji?**

Od **18 listopada 2024** wszyscy sprzedający będą mogli udostępnić swoją ofertę na [business.allegro.cz](https://business.allegro.cz/). Większość takich ofert będzie pochodziła od sprzedających, których rynkiem rejestracji jest [allegro.pl](https://allegro.pl/). W pierwszym kwartale 2025 roku zakwalifikowane będą również ofert z innych rynków, na których operuje Allegro.

Warunkiem udostępnienia ofert na ``"allegro-business-cz"`` będzie:
- Spełnienie [warunków kwalifikacji oferty](https://help.allegro.com/sell/pl/a/jak-udostepnic-oferte-na-rynku-zagranicznym-ZMl7ZDAA1fb?marketplaceId=allegro-pl#jakie-warunki-musza-spelnic-oferty-na-allegrocz) na marketplace ``"allegro-cz"``.
- Spełnienie dodatkowych warunków kwalifikacji do `"business-allegro-cz"``:
- Status sprzedawcy - zweryfikowany do VAT 0%: sprzedający posiada aktywny numer VAT EU w bazie [VIES](https://ec.europa.eu/taxation_customs/vies/#/vat-validation).
- [Sprzedający wystawia fakturę VAT](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA#opcje-faktury-i-stawki-vat) (**payments.invoice** = ``"VAT"`` w ofercie).
- [Ustawienie stawki VAT](https://developer.allegro.pl/tutorials/jak-jednym-requestem-wystawic-oferte-powiazana-z-produktem-D7Kj9gw4xFA#opcje-faktury-i-stawki-vat), zgodną z krajem, z którego wysyłany jest towar (obiekt **taxSettings** w ofercie).

Cena w ofercie dla rynku ``"business-allegro-cz"`` będzie zdefiniowana na podstawie ceny ustawionej dla ``"allegro-cz"`` - będą one ze sobą powiązane. Oznacza to, że zmiany cen dla ``"allegro-cz"`` będą równocześnie dotyczyć rynku ``"allegro-business-cz"`` - **nie będzie mogła się różnić**.

Proces kwalifikacji ofert do rynku ``"allegro-business-cz"`` będziemy realizować stopniowo oraz zakończy się on do **18 listopada 2024**.

**Jakie wprowadzimy zmiany?**

W odpowiedzi dla:

- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/getProductOffer)
- [GET /sale/offers](https://developer.allegro.pl/documentation#operation/searchOffersUsingGET)

możesz spodziewać się, że w obiekcie **additionalMarketplaces** zwrócimy status publikacji oraz cenę dla ``"allegro-business-cz"`` w sytuacji, gdy sprzedający posiada już oferty widoczne na rynku ``"allegro-cz"``.

Ponadto, w odpowiedzi dla:

- [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers)
- [PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/createProductOffers)

po zdefiniowaniu ceny dla rynku ``"allegro-cz"`` w obiekcie **additionalMarketplaces**, automatycznie ustawimy ją również na rynku ``"allegro-business-cz"``. Jeśli przekażesz nam cenę dla rynku ``"allegro-business-cz"``, wówczas musisz pamiętać, by podać tą samą wartość dla rynku ``"allegro-cz"``, gdyż cena nie może się różnić. Próba ustawienia ceny innej, niż tej zdefiniowana dla ``"allegro-cz"`` zakończy się błędem walidacji.

Wdrożymy również zmiany dla:

- [GET /order/checkout-forms](https://developer.allegro.pl/documentation#operation/getListOfOrdersUsingGET)
- [GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation#operation/getOrdersDetailsUsingGET).

W zamówieniach, które spełniają warunki wewnątrzwspólnotowej dostawy towarów (WDT), będziemy przekazywać numer VAT EU kupującego oraz status weryfikacji użytkownika w bazie [VIES](https://ec.europa.eu/taxation_customs/vies/#/vat-validation). Status użytkownika jest ważny na moment zawarcia transakcji. Nie zaktualizujemy statusu dla zamówień historycznych.

**18 listopada 2024** w tablicy **invoice.address.company.ids[]** w polu **type** dodamy nowy typ wartości: ``"VAT_EU"``. Wpis ten będzie oznaczał, że transakcja nosi znamiona wewnątrzwspólnotowej dostawy towarów (WDT) oraz to, że kupujący jest zweryfikowany do transakcji VAT 0%.

W obiekcie **invoice** wdrożymy równocześnie nową tablicę **features**. Będzie to lista flag, które obowiązują dla faktury do danego zamówienia. Zwrócimy w niej jeden z dwóch wykluczających się statusów:

- ``"VAT_EU_VERIFIED"`` - transakcja jest zweryfikowana pod VAT 0%.
- ``"VAT_EU_UNVERIFIED"`` - transakcja nosi znamiona wewnątrzwspólnotowej dostawy towarów (WDT), jednak numer VAT EU nie jest dostępny, a kupujący nie został zweryfikowany pod transakcje VAT 0%. Informacja ta jest pomocna w sytuacji, gdy zamówienie może być potencjalnie rozliczone w ramach wewnątrzwspólnotowej dostawy towarów (WDT), jednak wymaga to dodatkowych ustaleń pomiędzy sprzedającym, a kupującym.

W przypadku, gdy transakcja nie będzie nosić znamion wewnątrzwspólnotowej dostawy towarów (WDT), zwrócimy pustą tablicę. Przewidujemy, że w przyszłości będziemy rozszerzać listę dostępnych wartości w tablicy **invoice.features**.

**Przykładowa struktura obiektu invoice:**

```json5
...
"invoice": {
"required": true,
"features": [
"VAT_EU_VERIFIED"
],
"address": {
"street": "U garáží 1611/1",
"city": "Praha",
"zipCode": "170 00",
"countryCode": "CZ",
"company": {
"name": "Company name",
"ids": [
{
"type": "CZ_ICO",
"value": "12345678"
},
{
"type": "CZ_DIC",
"value": "CZ999999999"
},
{
"type": "VAT_EU",
"value": "CZ999999999"
}
],
"vatPayerStatus": "ACTIVE",
"taxId": "IČO: 12345678, DIČ: CZ999999999",
},
"naturalPerson": {
"firstName": "Petr",
"lastName": "Novák"
}
},
"dueDate": "2024-11-18"
}
...
```

Więcej o obsłudze zamówień przeczytasz w [naszym poradniku](https://developer.allegro.pl/tutorials/jak-obslugiwac-zamowienia-GRaj0qyvwtR).
________________

Starting **November 18, 2024**, we will allow all sellers, regardless of their base marketplace, to list offers for business customers on [business.allegro.cz](http://business.allegro.cz). At the same time, we will introduce support for cross-border transactions.

On **June 26, 2024**, we launched the first marketplace for businesses in the Czech Republic: Allegro Business (``"allegro-business-cz"``). It is currently available only to sellers whose base marketplace is ``"allegro-cz"``.

**What will the qualification process look like?**

As of **November 18, 2024**, all sellers can list offers on business.allegro.cz. Most such offers will come from sellers whose registration marketplace is [allegro.pl](http://allegro.pl). Offers from other markets where Allegro operates will also qualify in the first quarter of 2025.

The conditions for making offers available on ``"allegro-business-cz"`` will be:
- [Meeting the conditions](https://help.allegro.com/sell/pl/a/jak-udostepnic-oferte-na-rynku-zagranicznym-ZMl7ZDAA1fb?marketplaceId=allegro-pl%23jakie-warunki-musza-spelnic-oferty-na-allegrocz) for qualifying an offer on the marketplace ``"allegro-cz"``.
- Meeting additional conditions for ``"business-allegro-cz"`` qualification:
- Seller status - verified for VAT 0%: the seller has an active EU VAT number in the [VIES](https://ec.europa.eu/taxation_customs/vies/#/vat-validation) database.
- The seller issues a VAT invoice (**payments.invoice** = ``"VAT"`` in the offer).
- Set the VAT rate, consistent with the country from which the goods are shipped (**taxSettings** object in the offer).

The offer price for the ``"business-allegro-cz"`` marketplace will be defined based on the price set for ``"allegro-cz"`` - they will be related to each other. This means that price changes for ``"allegro-cz"`` will simultaneously affect the ``"allegro-business-cz"`` marketplace - those prices **cannot differ**.

We will conduct the process of qualifying offers for the ``"allegro-business-cz"`` marketplaces gradually, and it will be completed by **November 18, 2024**.

**What changes will we make?**

In response to:

- [GET /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/getProductOffer)
- [GET /sale/offers ](https://developer.allegro.pl/documentation#operation/searchOffersUsingGET)

the **additionalMarketplaces** object will return the publication status and price for ``"allegro-business-cz"`` in situations where the seller already has offers visible on the ``"allegro-cz"`` marketplace.

Also, in response to:

- [POST /sale/product-offers](https://developer.allegro.pl/documentation#operation/createProductOffers)
- [ PATCH /sale/product-offers/{offerId}](https://developer.allegro.pl/documentation#operation/createProductOffers)

after defining the price for the ``"allegro-cz"`` market in the **additionalMarketplaces** object, we will automatically set it for the ``"allegro-business-cz"`` marketplace as well. If you pass the price for the market ``"allegro-business-cz"``, then you must remember to provide the same value for the ``"allegro-cz"``, as the price cannot differ. Attempting to set a price other than the one defined for ``"allegro-cz"`` will end with a validation error.

We will also implement changes for:

- [GET /order/checkout-forms](https://developer.allegro.pl/documentation#operation/getListOfOrdersUsingGET)
- [GET /order/checkout-forms/{id}](https://developer.allegro.pl/documentation#operation/getOrdersDetailsUsingGET).

In orders that meet Intra-Community Supply of Goods (ICS) conditions, we will provide the buyer's VAT EU number and the user's verification status in the [VIES](https://ec.europa.eu/taxation_customs/vies/#/vat-validation) database. The user status is valid at the time of the transaction. We will not update the status for historical orders.

On **November 18, 2024**, in the array** invoice.address.company.ids[]** in the **type** field we will add a new value type: ``"VAT_EU"``. This entry will indicate that the transaction bears the characteristics of an Intra-Community Supply of Goods (ICS) and that the buyer is verified for 0% VAT transactions.

At the same time, we will implement a new **features** array in the **invoice** object. This will be a list of flags that apply to the invoice for a given order. In it, we will return one of two mutually exclusive statuses:

- ``"VAT_EU_VERIFIED"`` - the transaction is verified for VAT 0%.
- ``"VAT_EU_UNVERIFIED"`` - the transaction bears the characteristics of an Intra-Community Supply of Goods (ICS), but the EU VAT number is not available and the buyer has not been verified for 0% VAT transactions. This information is helpful when the order can potentially be settled under Intra-Community Supply of Goods (ICS), but this requires additional arrangements between the seller and the buyer.

We will return an empty array if the transaction does not bear the characteristics of an Intra-Community Supply of Goods (ICS). We foresee that in the future we will expand the list of available values in the **invoice.features** array.

**Sample invoice object structure:**

```json5
...
"invoice": {
"required": true,
"features": [
"VAT_EU_VERIFIED"
],
"address": {
"street": "U garáží 1611/1",
"city": "Praha",
"zipCode": "170 00",
"countryCode": "CZ",
"company": {
"name": "Company name",
"ids": [
{
"type": "CZ_ICO",
"value": "12345678"
},
{
"type": "CZ_DIC",
"value": "CZ999999999"
},
{
"type": "VAT_EU",
"value": "CZ999999999"
}
],
"vatPayerStatus": "ACTIVE",
"taxId": "IČO: 12345678, DIČ: CZ999999999",
},
"naturalPerson": {
"firstName": "Petr",
"lastName": "Novák"
}
},
"dueDate": "2024-11-18"
}
...
```

You can read more about order processing in [our guide](https://developer.allegro.pl/tutorials/process-orders-PgPMlWDr8Cv).

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.