Kupowanie elementów katalogu
W poniższym scenariuszu przedstawiono ogólny proces zakupu elementów z katalogu przy użyciu interfejsu API Centrum partnerskiego.
Odkrycie
Wybierz produkty i jednostki SKU utrzymania zapasów i sprawdź ich dostępność przy użyciu następujących modeli interfejsu API Centrum partnerskiego:
- Product — konstrukcja grupowania dla towarów lub usług, które można kupić. Produkt sam w sobie nie jest przedmiotem do zakupu.
- SKU — jednostka SKU do zakupu w ramach produktu. Reprezentują one różne kształty produktu.
- Dostępność - konfiguracja, w której jednostka SKU jest dostępna do zakupu (na przykład kraj/region, waluta i segment branżowy).
Aby kupić element z katalogu, wykonaj następujące kroki:
Zidentyfikuj i pobierz produkt i jednostkę SKU, którą chcesz kupić.
Sprawdź stan magazynowy dla SKU. Niniejszy krok jest wymagany tylko w przypadku jednostek SKU, które są oznaczone wartością InventoryCheck we właściwości purchasePrerequisites.
Pobierz dostępność dla jednostki SKU . Podczas składania zamówienia będzie potrzebny identyfikator pozycji katalogowej oraz dostępność. Aby uzyskać tę wartość, użyj jednego z następujących interfejsów API:
Przesyłanie zamówienia
Aby przesłać zamówienie elementu wykazu, wykonaj następujące czynności:
Utwórz Koszyk na umieszczenie kolekcji przedmiotów z katalogu, które zamierzasz kupić. Podczas tworzenia koszyka pozycje koszyka są automatycznie grupowane w oparciu o możliwość zakupu razem w tym samym Zamówieniu.
Sprawdź koszyk. Sfinalizowanie koszyka powoduje utworzenie zamówienia .
Pobieranie szczegółów zamówienia
Szczegóły zamówienia można pobrać przy użyciu identyfikatora zamówienia lub uzyskać listę zamówień dla klienta. Istnieje opóźnienie do 15 minut między upływem czasu przesłania zamówienia a wyświetleniem go na liście zamówień klienta.
Zobacz Uzyskiwanie zamówienia według identyfikatora, aby uzyskać szczegółowe informacje o indywidualnym zamówieniu przy użyciu identyfikatorów zamówień.
Zobacz Pobierz wszystkie zamówienia klienta, aby uzyskać listę zamówień dla klienta przy użyciu identyfikatora klienta.
Zobacz Pobieranie listy zamówień według klienta i typu cyklu rozliczeniowego, aby uzyskać listę zamówień klienta według typu cyklu rozliczeniowego, co pozwala na osobne wyświetlanie zamówień na elementy katalogu (opłat jednorazowych) oraz zamówień rozliczanych rocznie lub miesięcznie.
Zarządzanie cyklem życia
W ramach zarządzania cyklem życia elementów katalogu w Centrum partnerskim możesz pobrać informacje o elemencie katalogu uprawnieniai uzyskać szczegóły rezerwacji przy użyciu identyfikatora zamówienia rezerwacji. Aby zobaczyć przykłady, jak to zrobić, zobacz Pobieranie uprawnień.
Faktura i uzgadnianie
W poniższych scenariuszach pokazano, jak programowo przeglądać faktury klientai pobierać salda oraz podsumowania kont, które obejmują jednorazowe opłaty za pozycje katalogu.
Saldo i płatność
Aby uzyskać saldo bieżącego konta w domyślnej walucie, które obejmuje zarówno opłaty cykliczne, jak i jednorazowe (element katalogu), zobacz Pobieranie bieżącego salda konta.
Saldo i płatność w wielu walutach
Aby uzyskać saldo bieżącego konta i kolekcję podsumowań faktur zawierającą opłaty cykliczne i jednorazowe dla każdego z typów walut klienta, zobacz Pobieranie podsumowań faktur.
Faktury
Aby uzyskać zbiór faktur, które pokazują opłaty cykliczne i jednorazowe, zobacz Uzyskaj zbiór faktur.
Pojedyncza faktura
Aby pobrać określoną fakturę przy użyciu identyfikatora faktury, zobacz Pobieranie faktury według identyfikatora.
Pojednanie
Aby uzyskać kolekcję szczegółów elementu wiersza faktury (elementy wiersza uzgodnień) dla określonego identyfikatora faktury, zobacz Pobieranie elementów wiersza faktury.
Pobieranie faktury jako pliku PDF
Aby pobrać wyciąg z faktury w formie PDF przy użyciu identyfikatora faktury, zobacz Get an invoice statement.