Snaplii (Vorschau)

Durchsuchen Sie Snaplii Geschenkgutscheinmarken, überprüfen Sie Ihren Snaplii Cash-Saldo, und erhalten Sie ein Preisangebot vor dem Kauf. Ausgaben stammen nur aus Ihrem prepaid Snaplii Cash.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Service Class Regions
Copilot Studio Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logic Apps Standard Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure Government Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Snaplii Inc.
URL https://www.snaplii.com/help-center/
E‑Mail customerservice@snaplii.com
Connectormetadaten
Herausgeber Snaplii
Website https://www.snaplii.com/a2m/
Datenschutzrichtlinie https://www.snaplii.com/privacy-policy/
Categories Finanzieren; Handel

Snaplii

Mit diesem Connector können Copilot Studio Agenten Snaplii Geschenkkartenmarken durchsuchen, den Snaplii Cash-Saldo des Benutzers überprüfen und vor dem Kauf ein Preisangebot erhalten. Ausgaben stammen nur aus dem im Voraus bezahlten Snaplii Cash des Benutzers; ein Anführungszeichen berechnet nichts.

Prerequisites

Ein Snaplii-Konto in Kanada oder die USA und ein API-Schlüssel, der in der Snaplii-App erstellt wurde (Mehr, Zahlungsmethoden, AI-Zahlungsverwaltung, neuer API-Schlüssel).

So erhalten Sie Anmeldeinformationen

Erstellen Sie den API-Schlüssel in der Snaplii-App, wählen Sie den Umfang und das Ausgabenlimit aus, und geben Sie ihn ein, wenn Sie die Verbindung erstellen. Der Schlüssel kann jederzeit in der App widerrufen werden.

Erste Schritte mit Ihrem Connector

Listen Sie die Kategorien und Marken auf, öffnen Sie die Details einer Marke, um eine Karte und einen Betrag zu wählen, und geben Sie diese Karte an.

Bekannte Probleme und Einschränkungen

  • Verfügbar für Snaplii-Konten in Kanada und nur für die USA.
  • Der Verbinder liest den Katalog, den Saldo und die Anführungszeichen; Es kauft keine Geschenkgutscheine, zahlt Rechnungen oder sendet Geld.
  • Der Katalog listet die Marken auf der Snaplii-App-Startseite auf.
  • Ausgaben stammen nur aus prepaid Snaplii Cash.
  • Die Karten-ID in einem Zitat muss genau aus den Markendetails kopiert werden.

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Standard Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Standard

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Required
Snaplii-API-Schlüssel securestring Der Snaplii-API-Schlüssel für diese API True

Aktionen

Abrufen von Markendetails und Bezeichnungen für Geschenkkarten

Gibt die Karten der Marke und deren Bezeichnungen zurück. FIXED erfordert den genauen PreisStart; VARIABLE erfordert einen Betrag zwischen priceStart und priceEnd.

Angebot eines Geschenkgutscheinkaufs

Geben Sie einen Geschenkgutscheinkauf an. Lesen Sie vor dem Zitieren die Markendetails, und bestätigen Sie die Karten-ID und den Betrag mit einer ihrer Bezeichnungen. Ein positives primaryPayAmount bedeutet, dass Snaplii Cash die Bestellung nicht vollständig abdeckt. Nichts wird durch ein Angebot in Rechnung gestellt.

Geschenkgutscheinkategorien und Marken auflisten

Der Katalog ist auf das Land des authentifizierten Kontos eingegrenzt. Es wird kein parameter locationProv gesendet.

Snaplii Cash-Saldo erhalten

Der Saldo befindet sich in der Kontowährung (CA=CAD, US=USD), das Land, das mit dem Zugriffstoken zurückgegeben wird.

Abrufen von Markendetails und Bezeichnungen für Geschenkkarten

Gibt die Karten der Marke und deren Bezeichnungen zurück. FIXED erfordert den genauen PreisStart; VARIABLE erfordert einen Betrag zwischen priceStart und priceEnd.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Kartenmarken-ID
card_brand_id True string

Kartenmarkenbezeichner.

Gibt zurück

Die Marke, die direkt oder unter Daten zurückgegeben wird.

Angebot eines Geschenkgutscheinkaufs

Geben Sie einen Geschenkgutscheinkauf an. Lesen Sie vor dem Zitieren die Markendetails, und bestätigen Sie die Karten-ID und den Betrag mit einer ihrer Bezeichnungen. Ein positives primaryPayAmount bedeutet, dass Snaplii Cash die Bestellung nicht vollständig abdeckt. Nichts wird durch ein Angebot in Rechnung gestellt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Artikel-ID
itemId True string

Die Geschenkkarten-ID, genau {cardBrandId}-{cardTemplateId}: die cardBrandId der Marke, ein Bindestrich und die cardTemplateId der ausgewählten Karte, beide wurden aus den Markendetails kopiert. Senden Sie niemals eine ID allein, eine Karte von einer anderen Marke oder eine erratene ID.

Preis
price True string

Dezimalbetrag, der als JSON-Zeichenfolge in der Kontowährung gesendet wird.

voucherOption
voucherOption True string
cashbackOption
cashbackOption True string
specifiedVoucher
specifiedVoucher string

Spezifische Gutschein-ID. Legen Sie "voucherOption" auf "USE" fest, wenn Sie einen Gutschein auswählen.

Gibt zurück

Kursbeträge. primaryPayAmount ist der Rest nach angewendeten Fonds/Rabatten; Null bedeutet nicht, dass die Bestellung kostenlos ist.

Geschenkgutscheinkategorien und Marken auflisten

Der Katalog ist auf das Land des authentifizierten Kontos eingegrenzt. Es wird kein parameter locationProv gesendet.

Gibt zurück

Die kategorien, die auf der Snaplii-App-Startseite angezeigt werden.

Snaplii Cash-Saldo erhalten

Der Saldo befindet sich in der Kontowährung (CA=CAD, US=USD), das Land, das mit dem Zugriffstoken zurückgegeben wird.

Gibt zurück

Der Saldo, der direkt oder unter Daten zurückgegeben wird, in der Kontowährung.

Definitionen

GatewayObject

Ein Gatewayobjekt.

Name Pfad Typ Beschreibung
object

Ein Gatewayobjekt.

CatalogResponse

Die kategorien, die auf der Snaplii-App-Startseite angezeigt werden.

Name Pfad Typ Beschreibung
categories
categories array of GatewayObject

Kategorien mit ihren Marken.

AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

FaceValueRules

FIXED verwendet "priceStart" als genauen Nennwert. VARIABLE verwendet "priceStart" und "priceEnd" als inklusive Grenzen.

Name Pfad Typ Beschreibung
type
type string
priceStart
priceStart AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

priceEnd
priceEnd AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

CardTemplate

Eine Kartenvorlage; Rabattwerte sind Cashback-Prozentsätze.

Name Pfad Typ Beschreibung
cardTemplateId
cardTemplateId string
faceValueRules
faceValueRules FaceValueRules

FIXED verwendet "priceStart" als genauen Nennwert. VARIABLE verwendet "priceStart" und "priceEnd" als inklusive Grenzen.

Rabatt
discount AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

regularDiscount
regularDiscount AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

CardBrand

Name Pfad Typ Beschreibung
cardBrandId
cardBrandId string
Karten
cards array of CardTemplate

CardBrandResponse

Die Marke, die direkt oder unter Daten zurückgegeben wird.

Name Pfad Typ Beschreibung
cardBrandId
cardBrandId string
Karten
cards array of CardTemplate
data
data CardBrand

BalanceResponse

Der Saldo, der direkt oder unter Daten zurückgegeben wird, in der Kontowährung.

Name Pfad Typ Beschreibung
Gleichgewicht
balance AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

Gleichgewicht
data.balance AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

QuoteResponse

Kursbeträge. primaryPayAmount ist der Rest nach angewendeten Fonds/Rabatten; Null bedeutet nicht, dass die Bestellung kostenlos ist.

Name Pfad Typ Beschreibung
orderAmount
orderAmount AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

primaryPayAmount
primaryPayAmount AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

voucherAmount
voucherAmount AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

cashbackUseAmount
cashbackUseAmount AmountValue

Ein Betrag oder eine Rate als Zeichenfolge oder Zahl.

voucherName
voucherName string