Zasoby koszyka

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Partner składa zamówienie, gdy klient chce kupić subskrypcję z listy ofert.

Koszyk

Opisuje koszyk.

Właściwość	Pisz	Opis
identyfikator	string	Identyfikator koszyka dostarczony po pomyślnym utworzeniu koszyka.
creationTimeStamp	Data/godzina	Data utworzenia koszyka w formacie daty i godziny. Zastosowane po pomyślnym utworzeniu koszyka.
lastModifiedTimeStamp	Data/godzina	Data ostatniej aktualizacji koszyka w formacie daty i godziny. Zastosowane po pomyślnym utworzeniu koszyka.
expirationTimeStamp	Data/godzina	Data wygaśnięcia koszyka w formacie daty i godziny. Zastosowane po pomyślnym utworzeniu koszyka.
lastModifiedUser	string	Użytkownik, który ostatnio zaktualizował koszyk. Zastosowane po pomyślnym utworzeniu koszyka.
lineItems	Tablica obiektów	Tablica zasobów CartLineItem .
stan	string	Stan koszyka. Możliwe wartości to "Aktywne" (można je zaktualizować/przesłać) i "Zamówiono" (zostały już przesłane).

CartLineItem

Reprezentuje jeden element zawarty w koszyku.

Właściwość	Pisz	Opis
identyfikator	string	Unikatowy identyfikator elementu wiersza koszyka. Zastosowane po pomyślnym utworzeniu koszyka.
catalogItemId	string	Identyfikator elementu wykazu.
Friendlyname	string	Opcjonalny. Przyjazna nazwa elementu zdefiniowanego przez partnera w celu ułatwienia uściślania.
quantity	int	Liczba licencji lub wystąpień.
currencyCode	string	Kod waluty.
billingCycle	Obiekt	Typ cyklu rozliczeniowego ustawiony dla bieżącego okresu.
termDuration	string	Reprezentacja iso 8601 czasu trwania terminu. Bieżące obsługiwane wartości to P1M (jeden miesiąc), P1Y (jeden rok) i P3Y (trzy lata).
Uczestników	Lista par ciągów obiektów	Kolekcja PartnerID w rekordzie podczas zakupu.
provisioningContext	Ciąg słownika<, ciąg>	Dodatkowy kontekst używany podczas aprowizacji zakupionego elementu. Aby określić, które wartości są potrzebne dla określonego elementu, zapoznaj się z właściwością provisioningVariables jednostki SKU.
orderGroup	string	Grupa wskazująca, które elementy można przesłać razem w tej samej kolejności.
addonItems	Lista obiektów CartLineItem	Kolekcja elementów wiersza koszyka dla dodatków. Te elementy zostaną zakupione w ramach subskrypcji podstawowej, która wynika z zakupu elementu wiersza koszyka głównego.
error	Obiekt	Zastosowane po utworzeniu koszyka, jeśli wystąpił błąd.
renewsTo	Tablica obiektów	Tablica zasobów RenewsTo .
ZaświadczenieAccepted	bool	Wskazuje umowę na warunki oferty lub jednostki SKU. Wymagane tylko w przypadku ofert lub jednostek SKU, w których wartość SkuAttestationProperties lub OfferAttestationProperties wymusza wartość True.
identyfikator promocji	string	Identyfikator promocji, który ma zostać zastosowany do elementu wiersza koszyka.
customTermEndDate	Data/godzina	Data zakończenia pierwszego okresu rozliczeniowego nowej subskrypcji.

Kalkulacja cen

Reprezentuje szczegóły ceny. Kwoty cen są udostępniane przed opodatkowaniem.

Właściwość	Typ	Wymagani	opis
Listprice	double	Nie.	Cena wymieniona w wykazie bez zastosowanych modyfikatorów cen.
discountedPrice	double	Nie.	Cena po zastosowaniu wszystkich odpowiednich modyfikator cen.
proporcjonalnaprice	double	Nie.	Obniżona cena po wykonaniu proration.
price	double	Nie.	Cena w odpowiedniej walucie rozliczeniowej po zastosowaniu wszystkich rabatów i dokonaniu proration.
Cenakońcowa	double	Nie.	Cena elementu liniowego z zastosowanymi ilościami, rabatami i proporcjonalnościami w odpowiedniej walucie rozliczeniowej.

RenewsTo

Reprezentuje jeden element zawarty w elemencie wiersza koszyka.

Właściwość	Typ	Wymagani	opis
termDuration	string	Nie	Reprezentacja iso 8601 czasu trwania okresu odnowienia. Bieżące obsługiwane wartości to P1M (jeden miesiąc) i P1Y (jeden rok).

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów Centrum partnerskiego.

CartError

Reprezentuje błąd występujący po utworzeniu koszyka.

Właściwość	Pisz	Opis
Errorcode	CartErrorCode	Typ błędu koszyka.
errorDescription	string	Opis błędu, w tym wszelkie uwagi dotyczące obsługiwanych wartości, wartości domyślnych lub limitów.
additionalInformation	AdditionalInformation	Dodatkowe informacje dotyczące błędu.

AdditionalInformation

Dodatkowe informacje o błędzie.

Właściwość	Pisz	Opis
availableQuantity	int	Liczba pozostałych licencji, które można kupić dla danej jednostki SKU produktu.
purchasedQuantity	int	Liczba zakupionych licencji.

CartErrorCode

Typy błędów koszyka.

Nazwisko	ErrorCode	opis
CurrencyIsNotSupported	10 000	Waluta nie jest obsługiwana dla danego rynku
CatalogItemIdIsNotValid	10001	Identyfikator elementu wykazu jest nieprawidłowy
QuotaNotAvailable	10002	Za mało dostępnego limitu przydziału
InventoryNotAvailable	10003	Spis nie jest dostępny dla wybranej oferty
UczestnicyIsNotSupportedForPartner	10004	Ustawianie uczestników nie jest obsługiwane w przypadku partnera
UnableToProcessCartLineItem	10006	Nie można przetworzyć elementu wiersza koszyka.
SubscriptionIsNotValid	10007	Subskrypcja jest nieprawidłowa.
SubscriptionIsNotEnabledForRI	10008	Subskrypcja nie jest włączona w przypadku zakupów rezerwacji.
SandboxLimitExceeded	100000	Przekroczono limit piaskownicy.
InvalidInput	10010	Dane wejściowe ogólne są nieprawidłowe.
SubscriptionNotRegistered	10011	Subskrypcja jest nieprawidłowa.
ZaświadczenieNotAccepted	10012	Zaświadczenie nie zostało zaakceptowane.
MaxAllowedSeatsPerSubscriptionExceeded	10015	Żądana liczba miejsc przekracza limit.
Nieznane	0	Domyślna wartość

CartCheckoutResult

Reprezentuje wynik wyewidencjonowania koszyka.

Właściwość	Pisz	Opis
orders	Lista obiektów Order.	Kolekcja zamówień.
orderErrors	Lista obiektów OrderError.	Kolekcja błędów zamówienia.

OrderError

Reprezentuje błąd występujący podczas wyewidencjonowania koszyka podczas tworzenia zamówienia.

Właściwość	Pisz	Opis
orderGroupId	string	Identyfikator grupy zamówień zamówienia z błędem.
code	int	Kod błędu.
opis	string	Opis błędu.