Skillnad mellan versioner av "TTDS/System/Prefix"
Charlie (Felsökning | bidrag) (→Prefix) |
Charlie (Felsökning | bidrag) (→Beskrivning av kortdata) |
||
(29 mellanliggande versioner av samma användare visas inte) | |||
Rad 7: | Rad 7: | ||
De olika typerna av kort hanteras alla på lite olika sätt, detta är en vägledning i hur detta kan sätts upp i systemet.<br /> | De olika typerna av kort hanteras alla på lite olika sätt, detta är en vägledning i hur detta kan sätts upp i systemet.<br /> | ||
<br /> | <br /> | ||
− | + | === Systemet hanterar olika typer av kort === | |
+ | ---- | ||
*[[#Kund|Kundkort]], de kort ni själva vill ge ut till kunder. | *[[#Kund|Kundkort]], de kort ni själva vill ge ut till kunder. | ||
*[[#Taxipass|Taxipasskort]], hantering av kort utfärdade av bolag anslutna till taxipass. | *[[#Taxipass|Taxipasskort]], hantering av kort utfärdade av bolag anslutna till taxipass. | ||
Rad 15: | Rad 16: | ||
Man kan säga att det är information om hur systemet skall hantera kort som används i bilarna.<br /> | Man kan säga att det är information om hur systemet skall hantera kort som används i bilarna.<br /> | ||
<br /> | <br /> | ||
− | + | ||
+ | === När det gäller kund-/taxipass- kort === | ||
+ | ---- | ||
*Kort dras i bilen | *Kort dras i bilen | ||
*Kontroll sker om draget korts prefix finns i systemet under typen kund, om så är kortet godkänt | *Kontroll sker om draget korts prefix finns i systemet under typen kund, om så är kortet godkänt | ||
Rad 23: | Rad 26: | ||
*Efter utfört uppdrag så finns bokningen färdig i systemet för efterbehandling, (statistik eller fakturaunderlag) | *Efter utfört uppdrag så finns bokningen färdig i systemet för efterbehandling, (statistik eller fakturaunderlag) | ||
<br /> | <br /> | ||
− | + | ||
+ | === När det gäller förarkort === | ||
+ | ---- | ||
*Kort dras i bilen vid start av systemet | *Kort dras i bilen vid start av systemet | ||
*Kontroll sker att kortets prefix finns i systemet under typen förare | *Kontroll sker att kortets prefix finns i systemet under typen förare | ||
Rad 30: | Rad 35: | ||
<br /> | <br /> | ||
− | Tillverkning/beställning av kort | + | === Tillverkning/beställning av kort === |
− | + | ---- | |
− | + | Ska ni utfärda egna kort, så skall det förmodligen vara att tryck på kortet.<br /> | |
+ | Samt kortens magnetspår skall programmeras.<br /> | ||
+ | <br /> | ||
Hur programmeringen skall se ut kan du läsa mera om här: | Hur programmeringen skall se ut kan du läsa mera om här: | ||
*[[#Beskrivning av kortdata|Beskrivning av kortdata]] | *[[#Beskrivning av kortdata|Beskrivning av kortdata]] | ||
*[[#Rekommenderad uppbyggnad av kortsträng för kundkort/förarkort|Uppbyggnad av kortsträng för kundkort/förarkort]] | *[[#Rekommenderad uppbyggnad av kortsträng för kundkort/förarkort|Uppbyggnad av kortsträng för kundkort/förarkort]] | ||
− | + | <br /> | |
Det finns ett antal förtag som sysslar med att tillverka kort, alternativt så han ni en egen kortskrivare.<br /> | Det finns ett antal förtag som sysslar med att tillverka kort, alternativt så han ni en egen kortskrivare.<br /> | ||
Viktigt är att verifiera att kort fungerar genom test i liten serie, innan produktion i större skala påbörjas.<br /> | Viktigt är att verifiera att kort fungerar genom test i liten serie, innan produktion i större skala påbörjas.<br /> | ||
− | Vi | + | Vi hjälper gärna till i er process att ta fram dessa kort.<br /> |
<br /> | <br /> | ||
+ | === Ansöka om prefix/nationellt utfärdarnummer === | ||
+ | ---- | ||
Ska ni tillverka eget kundkort måste ni ansöka om ett eget nationellt utfärdarnummer (prefix), detta gör ni hos SIS.<br /> | Ska ni tillverka eget kundkort måste ni ansöka om ett eget nationellt utfärdarnummer (prefix), detta gör ni hos SIS.<br /> | ||
Länk till mera information samt blankett hittar du här, [[Övrig hjälp/Ansöka om prefix|Länk till ansökning om prefix]]<br /> | Länk till mera information samt blankett hittar du här, [[Övrig hjälp/Ansöka om prefix|Länk till ansökning om prefix]]<br /> | ||
+ | <br /> | ||
+ | <br /> | ||
== Prefix == | == Prefix == | ||
+ | <br /> | ||
+ | Här under System/Prefix specificerar ni kort med vars prefix skall hanteras i era bilar.<br /> | ||
+ | <br /> | ||
<br /> | <br /> | ||
[[fil:SystemPrefixKund.png]] | [[fil:SystemPrefixKund.png]] | ||
<br /> | <br /> | ||
+ | <br /> | ||
+ | '''Typ: ''' Väljer den typ av kort vars prefix som skall redigeras <br /> | ||
+ | Läs mer om hur respektive typ hanteras och registreras här:<br /> | ||
+ | *[[#Kund|Kund]] | ||
+ | *[[#Taxipass|Taxipass]] | ||
+ | *[[#Fakturaref|Fakturaref]] | ||
+ | *[[#Förare|Förare]] | ||
+ | *[[#0-TAXI|0-TAXI]] | ||
+ | <br /> | ||
+ | '''Spara: ''' Sparar ändringar i tabellen <br /> | ||
+ | '''Avbryt: ''' Sparar inte ändringar i tabellen <br /> | ||
<br /> | <br /> | ||
<br /> | <br /> | ||
Rad 111: | Rad 136: | ||
[[fil:SystemPrefixTaxipassExample.png]] | [[fil:SystemPrefixTaxipassExample.png]] | ||
− | I listan registrerar ni de taxipass kort som skall accepteras som betalmedel i era bilar.<br /> | + | I listan registrerar ni de prefixen för de taxipass kort som skall accepteras som betalmedel i era bilar.<br /> |
När ett kort registreras i bilen så kontroller systemet kortets prefix, mot de som finns registrerade här.<br /> | När ett kort registreras i bilen så kontroller systemet kortets prefix, mot de som finns registrerade här.<br /> | ||
+ | |||
+ | '''OBS''' Om du ändrat eller lagt till prefix, skicka ett mail till support@taxisystem.se och tala om att du ändrat prefix. Vi aktiverar då dessa, så att de skickas ut till era bilar. | ||
Transaktionerna kopplas mot ett kundnummer, som kan gå ända ner på resenärsnivå.<br /> | Transaktionerna kopplas mot ett kundnummer, som kan gå ända ner på resenärsnivå.<br /> | ||
+ | Önskar du att det skapas en elektronisk fakturafil vid fakturering skall exportparametern för det<br /> | ||
+ | kundnummer prefixet är kopplat till vara "Export Taxipass"<br /> | ||
<br /> | <br /> | ||
+ | [[fil:KundExportTaxipass.png]] | ||
+ | <br /> | ||
+ | <br /> | ||
'''Beskrivning av kolumnerna i listan:''' | '''Beskrivning av kolumnerna i listan:''' | ||
Rad 161: | Rad 193: | ||
== Beskrivning av kortdata == | == Beskrivning av kortdata == | ||
− | För att ett kort skall fungera måste det uppfylla några grundkrav.<br /> | + | För att ett kort skall fungera måste det uppfylla några grundkrav. Det vill säga om inte kortsträngen är uppbyggd enligt detta så nekas kortet av kortläsaren.<br /> |
+ | <br/> | ||
− | ''' | + | '''En kortsträng för spår två skall se ut som följer:''' |
− | + | * Starttecken ";" | |
− | * | + | :- 1 tecken |
− | + | * Plats för 18 tecken (era egna data) | |
− | * | + | :- 18 tecken |
− | * | + | * Checksiffra beräknad enligt luhn modellen, korttillverkare vet hur denna skall beräknas |
− | * | + | :- 1 tecken |
+ | * Skiljetecken | ||
+ | :- 1 tecken | ||
+ | * Giltighetstid enligt ÅÅMM | ||
+ | :- 4 tecken | ||
+ | * Plats för 13 tecken (era egna data) | ||
+ | :- 13 tecken | ||
* Sluta med sluttecknet "?" | * Sluta med sluttecknet "?" | ||
+ | :- 1 tecken | ||
* Innehålla "Longitudinal redundancy check" (LRC) efter sluttecknet | * Innehålla "Longitudinal redundancy check" (LRC) efter sluttecknet | ||
− | * | + | :- 1 tecken |
+ | <br/> | ||
+ | * Antal tecken före skiljetecknet får inte överstiga 20 st inklusive starttecken och checksiffra. | ||
+ | * Antal tecken efter skiljetecknet får inte överstiga 19 st inklusive sluttecken och LRC. | ||
+ | * Den totala längden får inte överstiga 40 tecken inklusive start-, skilje- och sluttecken samt LRC. | ||
+ | |||
+ | <br /> | ||
Hur ni vill bygga upp era kundkort är upp till er själva, och vilken nivå ni vill lägga det på.<br /> | Hur ni vill bygga upp era kundkort är upp till er själva, och vilken nivå ni vill lägga det på.<br /> | ||
Rad 178: | Rad 224: | ||
Exempel på en kortdata sträng: ;9752266500510200525=15010000000100?<br /> | Exempel på en kortdata sträng: ;9752266500510200525=15010000000100?<br /> | ||
+ | <br /> | ||
<br /> | <br /> | ||
Rad 183: | Rad 230: | ||
Vi har en rekommendation på hur kortsträngen kan byggas upp, för att stödja all den funktionalitet som finns.<br /> | Vi har en rekommendation på hur kortsträngen kan byggas upp, för att stödja all den funktionalitet som finns.<br /> | ||
− | + | <br /> | |
'''I TTDS finns stöd för följande nivåer:''' | '''I TTDS finns stöd för följande nivåer:''' | ||
Nuvarande version från 20 oktober 2014 kl. 13.40
Innehåll
Beskrivning av kort hantering i TTDS
För beställningscentralen finns möjligheten att hantera andra kort än kreditkort, till exempel egna kund-, taxipass- och förar- kort.
De olika typerna av kort hanteras alla på lite olika sätt, detta är en vägledning i hur detta kan sätts upp i systemet.
Systemet hanterar olika typer av kort
- Kundkort, de kort ni själva vill ge ut till kunder.
- Taxipasskort, hantering av kort utfärdade av bolag anslutna till taxipass.
- Förarkort, egna förarkort som används bland annat för att logga in i fordonssystemet.
För att korten skall godkännas och hanteras rätt i systemet måste de registreras i TTDS prefixdatabas.
Man kan säga att det är information om hur systemet skall hantera kort som används i bilarna.
När det gäller kund-/taxipass- kort
- Kort dras i bilen
- Kontroll sker om draget korts prefix finns i systemet under typen kund, om så är kortet godkänt
- Godkänt prefix är kopplat mot ett kundnummer i TTDS
- Uppgifter om bland annat taxa och betalsätt hämtas från det kundnumret och skickas till bilen
- Bilen startar uppdraget och det skapas en bokning på det kundnummer som kortet är kopplat till
- Efter utfört uppdrag så finns bokningen färdig i systemet för efterbehandling, (statistik eller fakturaunderlag)
När det gäller förarkort
- Kort dras i bilen vid start av systemet
- Kontroll sker att kortets prefix finns i systemet under typen förare
- Förarnummer som finns lagrat på kortet skickas till systemet som kontrollerar att föraren finns upplagd
- Finns föraren upplagd skickas information om detta till bilen som tillåter att passet startas
Tillverkning/beställning av kort
Ska ni utfärda egna kort, så skall det förmodligen vara att tryck på kortet.
Samt kortens magnetspår skall programmeras.
Hur programmeringen skall se ut kan du läsa mera om här:
Det finns ett antal förtag som sysslar med att tillverka kort, alternativt så han ni en egen kortskrivare.
Viktigt är att verifiera att kort fungerar genom test i liten serie, innan produktion i större skala påbörjas.
Vi hjälper gärna till i er process att ta fram dessa kort.
Ansöka om prefix/nationellt utfärdarnummer
Ska ni tillverka eget kundkort måste ni ansöka om ett eget nationellt utfärdarnummer (prefix), detta gör ni hos SIS.
Länk till mera information samt blankett hittar du här, Länk till ansökning om prefix
Prefix
Här under System/Prefix specificerar ni kort med vars prefix skall hanteras i era bilar.
Typ: Väljer den typ av kort vars prefix som skall redigeras
Läs mer om hur respektive typ hanteras och registreras här:
Spara: Sparar ändringar i tabellen
Avbryt: Sparar inte ändringar i tabellen
De olika typerna i TTDS
Kund
Rekommenderad läsning innan du går vidare
I listan registrerar ni de egna kort som ni vill ska fungera som betalmedel i bilarna.
När ett kort registreras i bilen så kontroller systemet kortets prefix, mot de som finns registrerade här.
Inställningar på bilden är gjorda efter exemplet, som finns i stycket om rekommenderad uppbyggnad.
Beskrivning av kolumnerna i listan:
Prefix: Ert egna prefix nummer
Namn: Namn ni ger prefixet
Kund Start: Position i kortsträngen där kundnumret börjar
Kund Ant: Antal tecken som skall läsas som kundnummer
KST Start: Position i kortsträngen där kostnadsställe börjar
KST Ant: Antal tecken som skall läsas som kostnadsställe
Kod Start: Position i kortsträngen där resenärskoden börjar
Kod Ant: Antal tecken som skall läsas som resenärs
Ref: Fältet anger om inläst kortdata skall sparas i bokningens faktura referens fält
- 0 = Spara INTE kortsträngen i faktura referens fältet
- 1 = Spara kortsträngen i faktura referens fältet
Vill man inte använda sig utav kostnadsställe och kod så kan dessa värden utelämnas
Ett annat sätt att hantera kundkort
Om man vill att kort med ett visst prefix alltid skall registreras på samma kund, kan man använda sig av följande konfiguration.
- Prefix: Prefix nummer för detta kort
- Namn: Namn ni ger prefixet
- Kund Start: -100 ett negativt värde anger att kort med detta prefix alltid skall registreras på kundnummer utan minustecken. Det vill säga, -100 kommer registeras på kund med nummer 100, -233 på kund med nummer 233...
- Kund Ant: blankt
- KST Start: Position i kortsträngen där kostnadsställe börjar
- KST Ant: Antal tecken som skall läsas som kostnadsställe
- Kod Start: Position i kortsträngen där resenärskoden börjar
- Kod Ant: Antal tecken som skall läsas som resenärs
- Ref: Fältet anger om inläst kortdata skall sparas i bokningens faktura referens fält
Vill man inte använda sig utav kostnadsställe och kod så kan dessa värden utelämnas
Taxipass
I listan registrerar ni de prefixen för de taxipass kort som skall accepteras som betalmedel i era bilar.
När ett kort registreras i bilen så kontroller systemet kortets prefix, mot de som finns registrerade här.
OBS Om du ändrat eller lagt till prefix, skicka ett mail till support@taxisystem.se och tala om att du ändrat prefix. Vi aktiverar då dessa, så att de skickas ut till era bilar.
Transaktionerna kopplas mot ett kundnummer, som kan gå ända ner på resenärsnivå.
Önskar du att det skapas en elektronisk fakturafil vid fakturering skall exportparametern för det
kundnummer prefixet är kopplat till vara "Export Taxipass"
Beskrivning av kolumnerna i listan:
Prefix: Prefixet på det taxipasskort som skall accepteras
Namn: Namn ni ger prefixet/kortet
Min: Används ej
Max: Används ej
Kundnummer: Koppla till kundnummer
KST: Koppla till kostnadsställe
Kod: Koppla till resenär med kod
Fakturaref.
Funktionen kommer att utgå ur TTDS och används inte längre.
Förare
Rekommenderad läsning innan du går vidare
Beskrivning av kolumnerna i listan:
Prefix: Ert egna prefix nummer
Namn: Namn ni ger prefixet
Start: Position i kortsträngen där förarnumret börjar
Antal: Antal tecken som skall läsas som förarnummer
0-TAXI
Mera information kommer
Beskrivning av kortdata
För att ett kort skall fungera måste det uppfylla några grundkrav. Det vill säga om inte kortsträngen är uppbyggd enligt detta så nekas kortet av kortläsaren.
En kortsträng för spår två skall se ut som följer:
- Starttecken ";"
- - 1 tecken
- Plats för 18 tecken (era egna data)
- - 18 tecken
- Checksiffra beräknad enligt luhn modellen, korttillverkare vet hur denna skall beräknas
- - 1 tecken
- Skiljetecken
- - 1 tecken
- Giltighetstid enligt ÅÅMM
- - 4 tecken
- Plats för 13 tecken (era egna data)
- - 13 tecken
- Sluta med sluttecknet "?"
- - 1 tecken
- Innehålla "Longitudinal redundancy check" (LRC) efter sluttecknet
- - 1 tecken
- Antal tecken före skiljetecknet får inte överstiga 20 st inklusive starttecken och checksiffra.
- Antal tecken efter skiljetecknet får inte överstiga 19 st inklusive sluttecken och LRC.
- Den totala längden får inte överstiga 40 tecken inklusive start-, skilje- och sluttecken samt LRC.
Hur ni vill bygga upp era kundkort är upp till er själva, och vilken nivå ni vill lägga det på.
De övriga tecknen kan beställningscentralen själv välja att disponera.
Exempel på en kortdata sträng: ;9752266500510200525=15010000000100?
Rekommenderad uppbyggnad av kortsträng för kundkort/förarkort
Vi har en rekommendation på hur kortsträngen kan byggas upp, för att stödja all den funktionalitet som finns.
I TTDS finns stöd för följande nivåer:
- Koppla enbart till kund
- Koppla till kund och kostnadsställe
- Koppla till kund, kostnadsställe och resenär
Vår rekommenderade uppbyggnad stödjer implementering av samtliga ovanstående modeller.
När det gäller förarkort så behövs egentligen bara ett nummer, det nummer föraren fått vid registrering i TTDS.
Vanligtvis så används förarlegitimationens nummer som är sexsiffrigt.
Beskrivning
Alla fält skall fyllas med rätt antal tecken.
Om det önskade värdet kortare, så fyller man fältet med inledande nollor. Exempelvis kundnummer 10 utfylls och blir 000010.
Tabellen beskrivning av de olika delarna i en kortsträng
Punkt | Antal tecken | Start position | Beskrivning | Tecken i exempel |
---|---|---|---|---|
1. | 1 | Starttecken | ; | |
2. | 8 | 0 | Prefix, det prefix beställningscentralen har registrerat som eget | 97522665 |
3. | 6 | 8 | Kundnummer. Referens till kundnummer på registrerad kund i kundregistret Förarnummer. Referens till förarens nummer registrerat i TTDS. |
Kund: 005102 Förar: 123456 |
4. | 4 | 14 | Kostnadsställe. Hänvisar till kostnadsställe under angivet kundnummer, punkt 2 | 0052 |
5. | 1 | 18 | Checksiffra beräknad enligt Luhn-metoden. | Kund: 5 Förar: 1 |
6. | 1 | 19 | Avgränsare | = |
7. | 4 | 20 | Giltighetstid ÅÅMM. | 1501 |
8. | 10 | 24 | Kundkod. Hänvisar till resenär registrerad under angivet kundnummer punkt 2, värdet skall motsvara kod under resenären. | 0000000100 |
9. | 1 | Sluttecken | ? |
Kundkort
Exempel kortsträng kundkort: ;9752266500510200525=15010000000100?
Följande gäller för ovanstående exempel:
- Resan skall registreras på kund med nummer 5102
- Resan skall registreras på kund med nummer 5102 kostnadsställe 52
- Kortet går ut 2015-01
- Resan skall registreras på kund med nummer 5102 resenär med kod 100
Vill man inte knyta kort till varken kostnadsställe eller resenär så anger man 0 i dessa fält, vid tillverkning av kortet.
- Exempel: ;9752266500510200004=15010000000000?
Förarkort
Exempel kortsträng förarkort: ;9752266512345600001=15010000000000?
Följande gäller för ovanstående exempel:
- Körpass skall startas med förare 123456
- Kortet går ut 2015-01
Inställningar kundkort i TTDS följ denna Länk
Inställningar förarkort i TTDS följ denna Länk