Entrii Hjelpesenter
NB EN

Billetter og hentekoder i DCI4WTP

Slik genereres billetter i Axess DCI4WTP ved ordrebekreftelse og ved aktivering — strekkoder, bestillingsnummer som ekstern ordre-referanse, og hva kunden bruker ved henting eller innsjekk.

Når en kunde fullfører kjøp av DCI4WTP-produkter i Entrii, utstedes vanlige billetter automatisk i Axess ved ordrebekreftelse. Hver utstedt billett får en strekkode fra DCI4WTP. Ordren får et bestillingsnummer som sendes til Axess som ekstern ordre-referanse — dette er grunnlaget for henting og forhåndsbetalt billettmodus.

Billetter på billettyper som Krever aktivering, får status Venter på aktivering og utstedes ikke i Axess ved ordrebekreftelse. Utstedelse skjer når aktivering startes — for eksempel av kunden, via skanner, eller i backoffice med Aktiver. Entrii ber da Axess om å utstede billetten i bakgrunnen; når det lykkes, får billetten status Aktiv med strekkode/hentekode.

Billettgenerering — steg for steg

  1. Ordre bekreftes

    Når ordrestatus settes til Bekreftet, genererer Entrii et bestillingsnummer (order_number) og oppretter lokale billetter. Billetter som skal utstedes med én gang får status Utkast. Billetter på billettyper med Krever aktivering får status Venter på aktivering og utstedes ikke i Axess i dette steget.

  2. Køjobb utsteder i DCI4WTP (ved ordrebekreftelse)

    Hendelsen OrderConfirmed legger IssueOrderTickets i køen for billetter i Utkast. Billetter med status Venter på aktivering hoppes over — de utstedes ikke ved ordrebekreftelse. For hver billett jobben tar med, gjelder:

    1. Grupperer billetter (frittstående + pakkelinjer) i én eller flere SOAP-kall

    2. Kaller issueTicket11 og mottar strekkoder og metadata fra Axess

    3. Lagrer strekkode på ticket.code og metadata (transaction_id, serial_number, valid_to osv.)

    4. Bekrefter produksjon med msgIssueTicket8 → billettstatus blir Aktiv

  3. Hva lagres på billetten?

    • ticket.code — strekkode/QR fra Axess (SZBCNR_24)

    • integration_metadata.barcode, transaction_id, serial_number, pos_id, project_id, journal_id, valid_to

    • Status Aktiv = produsert og klar til bruk

Utstedelse når aktivering starter

For billetter med status Venter på aktivering skjer utstedelse i Axess først når aktivering startes — for eksempel når kunden aktiverer selv, en skanner registrerer aktivering, eller noen i backoffice bruker handlingen Aktiver. En aktiveringsfrist kan også starte aktivering når den inntreffer (avhengig av oppsett på billettypen). Billetter der utstedelse i Axess allerede pågår aktiveres ikke automatisk ved fristen.

  1. Entrii ber Axess om å utstede én billett om gangen i bakgrunnen (for hver billett som skal aktiveres).

  2. Axess returnerer strekkode og nødvendig metadata; Entrii lagrer hentekoden/strekkoden på billetten.

  3. Når utstedelsen er bekreftet, fullfører Entrii aktiveringen — billettstatus blir Aktiv med gyldig strekkode klar til bruk.

Bestillingsnummer og hentekoder

Entrii genererer ikke et eget hentekode-felt. I stedet brukes bestillingsnummeret som ekstern ordre-referanse i DCI4WTP:

Entrii

DCI4WTP / Axess

Bruk i praksis

order_number (bestillingsnummer)

SZEXTORDERNUMBER + forhåndsbetalt (BPREPAIDTICKET)

Kunde og frontdesk kan bruke bestillingsnummer ved henting i PICK UP BOX, kiosk eller kasse i Axess

ticket.code (strekkode)

Produsert billett (barcode/QR)

Direkte innsjekk/validering ved port, QR på mobil eller utskrift

Hent live billettdata fra Axess

På billetter som er utstedt i DCI4WTP kan du i backoffice hente oppdatert status og rådata direkte fra Axess — uten å synkronisere scannhistorikk eller endre billettstatus i Entrii. Dette er nyttig ved feilsøking av blokkering, gyldighet og hva Axess faktisk har registrert.

  1. Åpne billetten

    Gå til Billetter → velg billett som er koblet til DCI4WTP-integrasjonen og er Aktiv med strekkode (utstedt ved ordrebekreftelse eller etter aktivering).

  2. DCI4WTP-fanen

    Under billettvisningen, åpne fanen DCI4WTP. Fanen viser lagret integration_metadata fra utstedelse. Knappen Hent fra Axess vises når billetten har DCI4WTP-utstedelsesdata (transaction_id og serial_number).

  3. Les modalen

    Klikk Hent fra Axess. Entrii henter live data fra Axess og viser:

    • Blokkeringsstatus — om billetten er blokkert eller kansellert i Axess

    • Salgsdata (getTicketSalesData2) — blant annet billetttype, pool, gyldighet og pris fra Axess. For utstedte billetter skal salgsdata komme frem også når gyldig fra og gyldig til er ulike datoer. Entrii spør Axess først med billettens gyldig-fra-dato; finnes det ikke treff, prøves gyldig-til og deretter journalnummer fra utstedelsen.

    • Lesertransaksjoner (getReaderTrans) — passeringer registrert i Axess. Har Axess ingen passeringer, vises Ingen passeringer registrert i Axess. Det er en tom tilstand — ikke en feilmelding øverst i modalen.

    • Dekodet strekkode — vises når kasse, prosjekt og serienummer fra Axess stemmer med det som er lagret på billetten fra utstedelsen. Verdien er den 24-sifrede Axess-koden som ble lagret ved utstedelse, ikke en annen Entrii-generert kode.

    Hvis én kilde feiler, vises resten likevel. Feilmeldinger listes øverst i modalen.

Billettstatus og livssyklus

  • Utkast — opprettet lokalt, venter på utstedelse via IssueOrderTickets ved ordrebekreftelse

  • Venter på aktivering — billettypen har Krever aktivering; ingen utstedelse i Axess før aktivering startes

  • Aktiv — produsert i DCI4WTP med strekkode (klar til bruk)

  • Suspendert — blokkert i DCI4WTP via serial_number

  • Kansellert — kansellert i Axess når billetten kanselleres eller refunderes i Entrii. Køarbeideren kjører jobben. CLI-kommandoen dci4wtp:cancel-produced-tickets er bare for manuell opprydding.

Verifiser billettflyt før go-live:

av 4 punkter fullført

Relaterte artikler

Automatiske jobber for DCI4WTP-synkronisering

Oversikt over køjobber, planlagt synkronisering og hendelsesdrevet billettutstedelse i DCI4WTP-integrasjonen — hva som k

Sette opp produkt og synkronisere tariffer fra DCI4WTP

Slik oppretter du frittstående billettprodukter i Entrii, kobler dem til synkroniserte billettyper og persontyper, og he