Snaplii (wersja zapoznawcza)

Przeglądaj marki kart upominkowych Snaplii, sprawdź saldo Snaplii Cash i uzyskaj ofertę cenową przed zakupem. Wydatki pochodzą tylko z przedpłaconych Snaplii Cash.

Ten łącznik jest dostępny w następujących produktach i regionach:

Service Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Contact
Name Snaplii Inc.
adres URL https://www.snaplii.com/help-center/
Email customerservice@snaplii.com
Metadane łącznika
Publisher Snaplii
Website https://www.snaplii.com/a2m/
Zasady ochrony prywatności https://www.snaplii.com/privacy-policy/
Categories Finanse; Handel

Snaplii

Ten łącznik pozwala Copilot Studio agentów przeglądać marki kart upominkowych Snaplii, sprawdzić saldo Snaplii Cash użytkownika i uzyskać ofertę cenową przed zakupem. Wydatki pochodzą tylko z przedpłaconych Snaplii Cash użytkownika; a quote charges nothing( Opłaty za cudzysłów).

Prerequisites

Konto Snaplii w Kanadzie lub Stany Zjednoczone i klucz interfejsu API utworzony w aplikacji Snaplii (Więcej, formy płatności, zarządzanie płatnościami sztucznej inteligencji, nowy klucz interfejsu API).

Jak uzyskać poświadczenia

Utwórz klucz interfejsu API w aplikacji Snaplii, wybierz jego zakres i limit wydatków, a następnie wprowadź go podczas tworzenia połączenia. Klucz można odwołać w aplikacji w dowolnym momencie.

Wprowadzenie do łącznika

Wyświetl listę kategorii i marek, otwórz szczegóły marki, aby wybrać kartę i kwotę, a następnie zacytować tę kartę.

Znane problemy i ograniczenia

  • Dostępne tylko dla kont Snaplii w Kanadzie i Stany Zjednoczone.
  • Łącznik odczytuje wykaz, saldo i oferty; nie kupuje kart upominkowych, płaci rachunki ani nie wysyła pieniędzy.
  • Katalog zawiera listę marek wyświetlanych na stronie głównej aplikacji Snaplii.
  • Wydatki pochodzą tylko z przedpłaconych Snaplii Cash.
  • Identyfikator karty w cudzysłowie musi zostać skopiowany dokładnie ze szczegółów marki.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Wartość domyślna

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Opis Required
Klucz interfejsu API Snaplii securestring Klucz interfejsu API Snaplii dla tego interfejsu API True

Akcje

Get Snaplii Cash balance

Saldo znajduje się w walucie konta (CA=CAD, US=USD), kraju zwróconego przy użyciu tokenu dostępu.

Lista kategorii kart upominkowych i marek

Wykaz jest o określonym zakresie w kraju uwierzytelnionych kont. Nie jest wysyłany parametr locationProv.

Oferty zakupu karty upominkowej

Zacytuj zakup karty upominkowej. Przed cytowaniem przeczytaj szczegóły marki i potwierdź identyfikator karty i kwotę pasują do jednego z jego nominałów. Dodatnia podstawowaPayAmount oznacza Snaplii Cash nie obejmuje w pełni zamówienia. Nic nie jest obciążane cytatem.

Pobieranie szczegółów i nominałów marki karty prezentowej

Zwraca karty marki i ich nominały. Naprawiono wymaga dokładnej cenyStart; Zmienna wymaga kwoty między priceStart i priceEnd.

Get Snaplii Cash balance

Saldo znajduje się w walucie konta (CA=CAD, US=USD), kraju zwróconego przy użyciu tokenu dostępu.

Zwraca

Saldo, zwrócone bezpośrednio lub w obszarze danych, w walucie konta.

Lista kategorii kart upominkowych i marek

Wykaz jest o określonym zakresie w kraju uwierzytelnionych kont. Nie jest wysyłany parametr locationProv.

Zwraca

Kategorie wyświetlane na stronie głównej aplikacji Snaplii.

Oferty zakupu karty upominkowej

Zacytuj zakup karty upominkowej. Przed cytowaniem przeczytaj szczegóły marki i potwierdź identyfikator karty i kwotę pasują do jednego z jego nominałów. Dodatnia podstawowaPayAmount oznacza Snaplii Cash nie obejmuje w pełni zamówienia. Nic nie jest obciążane cytatem.

Parametry

Nazwisko Klucz Wymagane Typ Opis
itemId
itemId True string

Identyfikator karty upominkowej, dokładnie {cardBrandId}-{cardTemplateId}: karta markiBrandId, jeden łącznik i karta wybranej kartyTemplateId, oba skopiowane z szczegółów marki. Nigdy nie wysyłaj jednego identyfikatora, karty z innej marki lub odgadnięcia identyfikatora.

price
price True string

Kwota dziesiętna wysłana jako ciąg JSON w walucie konta.

voucherOption
voucherOption True string
cashOption
cashbackOption True string
specifiedVoucher
specifiedVoucher string

Identyfikator konkretnego kuponu. Ustaw kuponOption na użycie podczas wybierania kuponu.

Zwraca

Kwoty ofert. primaryPayAmount jest resztą po zastosowaniu funduszy/rabatów; zero nie oznacza, że zamówienie jest bezpłatne.

Pobieranie szczegółów i nominałów marki karty prezentowej

Zwraca karty marki i ich nominały. Naprawiono wymaga dokładnej cenyStart; Zmienna wymaga kwoty między priceStart i priceEnd.

Parametry

Nazwisko Klucz Wymagane Typ Opis
Identyfikator marki karty
card_brand_id True string

Identyfikator marki karty.

Zwraca

Marka, zwrócona bezpośrednio lub pod danymi.

Definicje

GatewayObject

Obiekt bramy.

Nazwisko Ścieżka Typ Opis
object

Obiekt bramy.

CatalogResponse

Kategorie wyświetlane na stronie głównej aplikacji Snaplii.

Nazwisko Ścieżka Typ Opis
categories
categories array of GatewayObject

Kategorie z ich markami.

AmountValue

Kwota lub stawka jako ciąg lub liczba.

Kwota lub stawka jako ciąg lub liczba.

FaceValueRules

FIXED używa priceStart jako dokładnego nominału. ZMIENNA używa wartości priceStart i priceEnd jako granic inkluzywnych.

Nazwisko Ścieżka Typ Opis
typ
type string
priceStart
priceStart AmountValue

Kwota lub stawka jako ciąg lub liczba.

priceEnd
priceEnd AmountValue

Kwota lub stawka jako ciąg lub liczba.

CardTemplate

Szablon karty; wartości rabatu to procenty rabatu.

Nazwisko Ścieżka Typ Opis
cardTemplateId
cardTemplateId string
faceValueRules
faceValueRules FaceValueRules

FIXED używa priceStart jako dokładnego nominału. ZMIENNA używa wartości priceStart i priceEnd jako granic inkluzywnych.

rabat
discount AmountValue

Kwota lub stawka jako ciąg lub liczba.

regularDiscount
regularDiscount AmountValue

Kwota lub stawka jako ciąg lub liczba.

CardBrand

Nazwisko Ścieżka Typ Opis
cardBrandId
cardBrandId string
Karty
cards array of CardTemplate

CardBrandResponse

Marka, zwrócona bezpośrednio lub pod danymi.

Nazwisko Ścieżka Typ Opis
cardBrandId
cardBrandId string
Karty
cards array of CardTemplate
dane
data CardBrand

BalanceResponse

Saldo, zwrócone bezpośrednio lub w obszarze danych, w walucie konta.

Nazwisko Ścieżka Typ Opis
saldo
balance AmountValue

Kwota lub stawka jako ciąg lub liczba.

saldo
data.balance AmountValue

Kwota lub stawka jako ciąg lub liczba.

QuoteResponse

Kwoty ofert. primaryPayAmount jest resztą po zastosowaniu funduszy/rabatów; zero nie oznacza, że zamówienie jest bezpłatne.

Nazwisko Ścieżka Typ Opis
orderAmount
orderAmount AmountValue

Kwota lub stawka jako ciąg lub liczba.

primaryPayAmount
primaryPayAmount AmountValue

Kwota lub stawka jako ciąg lub liczba.

voucherAmount
voucherAmount AmountValue

Kwota lub stawka jako ciąg lub liczba.

cashUseAmount
cashbackUseAmount AmountValue

Kwota lub stawka jako ciąg lub liczba.

voucherName
voucherName string