Kaj sta CardTypeId in TokenTypeId v zahtevku za naročilo kartice?

Vrsta kartice se nanaša na razvrstitev kartice Shell glede na njeno predvideno uporabo, obseg dostopa in geografsko veljavnost.

Določa operativne parametre kartice. CardTypeId je številčni identifikator vrste kartice (CardType).

TokenType je neobvezni parameter pri naročanju kartice. Vrsta žetona določa videz kartice in vrsto poštnega nosilca, ki se bo uporabil za novo naročeno kartico.

Če sta pri naročilu kartice navedena CardTypeId in TokenTypeId, mora kombinacija CardTypeId in TokenTypeId obstajati v sistemu Shell.

Kategorija uporabe:

Flota: Za vozila flote (lahka gospodarska vozila, osebna vozila, servisna vozila); nižje transakcijske omejitve, višja pogostost transakcij.
Commercial Road Transport(težka tovorna vozila, vozila za prevoz na dolge razdalje): Te vrste kartic bodo privzeto imele višje omejitve transakcij.

Obseg sprejemanja:
Single : Uporabna le na bencinskih postajah Shell.
Večnamenska : Uporabna na lokacijah Shell in partnerskih lokacijah
Hibridna: - kartica se sprejema na lokacijah Shell Recharge in v gostovanju

Geografski obseg:
Nacionalna: Uporabna le v državi izdaje.
Mednarodno: Uporabna v več državah.

Konfiguracija vrste kartice

Ko stranka podpiše pogodbo o Shell kartici, Shell za stranko ustvari kartični račun.
V okviru nastavitve računa Shell konfigurira dovoljene vrste kartic na podlagi pogodbe. Ti določajo, katere vrste kartic lahko stranka naroči.

Vrsta kartice mora biti:

• Aktivna in konfigurirana na ravni računa kartice.

• ID vrste kartice, naveden v zahtevkih za naročilo kartice, ni nastavljen na računu. Zahteva bo sprejeta, napaka pa bo vrnjena v klicu /card-management/v1/ordercardenquiry –

   {
   "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": "Preverjanje veljavnosti zahtevka za naročilo kartice ni uspelo zaradi vnesenih parametrov – [Neveljaven CardTypeId.]",
              "Koda napake sinhronizacije prehoda": null,
   "Opis napake sinhronizacije prehoda": null,
   "Stanje sinhronizacije prehoda": null,
   "Glavna referenca": 715047,
              "OrderCardReference": 947113,
   "OrderStatus": "X",
   "PayerId": 12,
   "PayerNumber": "DE00000012",
              "ProcessedDate": "20250826 13:12:52",
   "PurchaseCategoryCode": null,
   "PurchaseCategoryId": 124,
              "ImeKategorijeNakupa": null,
   "DatumPošiljanja": "20250826 15:11:50",
   "DatumObdelaveSinhronizacije": null,
   "DatumZahtevaneSinhronizacije": null,
              "VRN": null,
   "ID zahtevka za naročilo": "233e4567-1313-12d3-a456-426614174000",
              "ExpiryDate": null,
   "ClientReferenceId": null,
   "StatusDescription": "Failed"
   }

• Obvezno pri naročanju kartice. Če ni navedeno, bo API vrnil statusno kodo 400 z naslednjo napako pri preverjanju veljavnosti

  {
      "RequestId": "233e4567-1313-12d3-a456-426614174000",
      "Status": "NEUSPEŠNO",
      "Errors": [
   {
              "Code": "E0001",
   "Title": "Napaka pri preverjanju",
   "Detail": "Manjkajoče / neveljavne vrednosti za: [CardDetails[0]]",
              "AdditionalInfo": {
   "CardTypeId": "Neveljavno | Območje (1,2147483647)"
   }
   }
      ]
  }

Če želite pridobiti ID-je tipov kartic, ki so na voljo na računu, pokličite končno točko /customer-management/v1/cardtype.