Typ karty označuje klasifikaci karty Shell na základě jejího zamýšleného použití, rozsahu přístupu a geografické platnosti.
Určuje provozní parametry karty. CardTypeId je číselný identifikátor typu karty (CardType).
TokenType je volitelný parametr při objednávce karty. Typ tokenu definuje vzhled karty a to, jaký obal bude použit pro nově objednanou kartu.
Pokud jsou při objednávce karty zadány hodnoty CardTypeId a TokenTypeId, musí kombinace CardTypeId a TokenTypeId existovat v systému Shell.
Kategorie použití:
Fleet: Pro vozidla vozového parku (lehká užitková vozidla, osobní automobily, servisní vozidla); nižší transakční limity, vyšší frekvence transakcí.
Kommerční dálková doprava(těžká nákladní vozidla, vozidla pro dálkovou dopravu): Tyto typy karet budou mít ve výchozím nastavení vyšší transakční limity.
Rozsah přijímání:
Single : Použitelné pouze na čerpacích stanicích Shell.
Multi : Lze použít na čerpacích stanicích Shell a u partnerských provozoven
Hybrid: – karta je přijímána na čerpacích stanicích Shell Recharge a v roamingových lokalitách
Geografický rozsah:
Národní: Lze použít pouze v zemi vydání.
Mezinárodní: Lze použít ve více zemích.
Konfigurace typu karty
Když zákazník podepíše smlouvu o kartě Shell, společnost Shell mu zřídí kartový účet.
V rámci zřízení účtu společnost Shell nakonfiguruje povolené typy karet na základě smlouvy. Tyto typy určují, jaké typy karet si zákazník může objednat.
Typ karty (CardType) musí být:
- Aktivní a nakonfigurovaný na úrovni kartového účtu.
-
ID typu karty (CardTypeId) uvedené v žádostech o objednání karty není na účtu nastaveno. Žádost bude přijata a při volání /card-management/v1/ordercardenquiry bude vrácena chyba –
{ "AccountId": 12, "AccountNumber": "DE00000012", "BCOReference": null, "BCORowNumber": null, "CardGroupId": null, "CardGroupName": null, "CardId": null, "CardPAN": null, "CardTypeCode": null, "CardTypeId": 206, "CardTypeName": null, "DriverName": null, "ErrorCode": "12011", "ErrorDescription": "Ověření požadavku na objednání karty selhalo kvůli vstupním parametrům – [Neplatné CardTypeId.]", "Kód chyby synchronizace brány": null, "Popis chyby synchronizace brány": null, "Stav synchronizace brány": null, "Hlavní reference": 715047, "OrderCardReference": 947113, "OrderStatus": "X", "PayerId": 12, "PayerNumber": "DE00000012", "ProcessedDate": "20250826 13:12:52", "PurchaseCategoryCode": null, "PurchaseCategoryId": 124, "Název kategorie nákupu": null, "Datum odeslání": "20250826 15:11:50", "Datum zpracování synchronizace": null, "Datum požadavku na synchronizaci": null, "VRN": null, "OrderRequestId": "233e4567-1313-12d3-a456-426614174000", "ExpiryDate": null, "ClientReferenceId": null, "StatusDescription": "Failed" } -
Povinné při objednávání karty. Pokud není zadáno, API vrátí stavový kód 400 s níže uvedenou chybou ověření
{ "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "FAILED", "Errors": [ { "Code": "E0001", "Title": "Chyba ověření", "Detail": "Chybějící / neplatné hodnoty pro: [CardDetails[0]]", "AdditionalInfo": { "CardTypeId": "Neplatné | Rozsah (1,2147483647)" } } ] }
Chcete-li získat identifikátory typů karet (CardTypeIds) dostupné pro daný účet, vyvolejte koncový bod /customer-management/v1/cardtype.
