Tipul cardului se referă la clasificarea unui card Shell în funcție de destinația sa, de domeniul de acces și de aplicabilitatea geografică.
Acesta determină parametrii operaționali ai cardului. CardTypeId este un identificator numeric al CardType.
TokenType este un parametru opțional în timpul comenzii cardului. Un tip de token definește aspectul cardului și tipul de plic care va fi utilizat pentru cardul nou comandat.
Atunci când CardTypeId și TokenTypeId sunt furnizate în momentul comenzii cardului, combinația dintre CardTypeId și TokenTypeId trebuie să existe în sistemul Shell.
Categorie de utilizare:
Flotă: Pentru vehiculele din flotă (vehicule comerciale ușoare, autoturisme, vehicule de serviciu); limite de tranzacție mai mici, frecvență de tranzacție mai mare.
Comercial Road Transport(camioane grele, vehicule de transport pe distanțe lungi): Aceste tipuri de carduri vor avea, în mod implicit, limite de tranzacție mai mari.
Domeniu de acceptare:
Single : Utilizabil numai la stațiile Shell.
Multi : Poate fi utilizat la stațiile Shell și la locațiile partenerilor
Hibrid: - cardul este acceptat la stațiile Shell Recharge și la locațiile de roaming
Domeniu de acoperire geografică:
Național: Poate fi utilizat numai în țara emitentă.
Internațional: Poate fi utilizat în mai multe țări.
Configurarea tipului de card
Atunci când un client semnează un contract pentru un card Shell, Shell creează un cont de card pentru client.
Ca parte a configurării contului, Shell configurează tipurile de card permise în funcție de contract. Acestea definesc ce tipuri de carduri poate comanda clientul.
CardType trebuie să fie:
- activ și configurat la nivelul contului de card.
-
CardTypeId furnizat în cererile de comandă a cardurilor nu este configurat în cont. Solicitarea va fi acceptată, iar eroarea va fi returnată în cadrul apelului /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": "Validarea cererii de comandă a cardului a eșuat pentru parametrii de intrare - [CardTypeId nevalid.]", "GatewaySyncErrorCode": null, "GatewaySyncErrorDescription": null, "GatewaySyncStatus": null, "MainReference": 715047, "ReferințăCardComandă": 947113, "StareComandă": "X", "IDPlătitor": 12, "NumărPlătitor": "DE00000012", "ProcessedDate": "20250826 13:12:52", "PurchaseCategoryCode": null, "PurchaseCategoryId": 124, "PurchaseCategoryName": null, "SubmittedDate": "26.08.2025 15:11:50", "SyncProcessedDate": null, "SyncRequestedDate": null, "VRN": null, "OrderRequestId": "233e4567-1313-12d3-a456-426614174000", "ExpiryDate": null, "ClientReferenceId": null, "StatusDescription": "Failed" } -
Obligatoriu la comandarea cardului. Dacă nu este furnizat, API-ul va returna codul de stare 400 cu următoarea eroare de validare
{ "RequestId": "233e4567-1313-12d3-a456-426614174000", "Status": "EȘUAT", "Errors": [ { "Code": "E0001", "Title": "Eroare de validare", "Detail": "Valori lipsă/nevalide pentru: [CardDetails[0]]", "Informații suplimentare": { "CardTypeId": "Nevalid | Interval (1,2147483647)" } } ] }
Pentru a obține ID-urile tipurilor de carduri disponibile în cont, apelați punctul final /customer-management/v1/cardtype.
