Udostępnij za pośrednictwem


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:

  1. Zidentyfikuj i pobierz produkt i jednostkę SKU, którą chcesz kupić.

  2. 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.

  3. 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:

  1. 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.

  2. 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.

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.