Petra2 Java API – SjStinaInformationProviderInterface.validateOrderForUseWithVouchers

Method description

Metoden används för att säkerställa att en ombokningstransaktion kommer att fungera.

Som indata tas den nya beställningen samt en lista på biljetter som är tänkta att användas som betalning. Det är OK att skicka in biljetter från olika beställningar. Följande kontroller görs i dagsläget:

- Det måste vara samma ägarproducent på raderna.
- Om det är en företagsbeställning så måste samma företag finnas på den nya och den gamla beställningen.
- Kontrollera att betalningssätten på raderna är blandbara (inom och mellan de olika beställningarna).

Först kontrolleras den nya beställningen därefter de gamla beställningsraderna (biljetterna) och därefter kontrolleras att beställningarna är ok att använda tillsammans. Om något inte stämmer så innehåller svaret en lista med fel. Om fel hittas på beställningsnivå kommer inget OrderItemId i svaret. Det första hittade felet för varje beställningsrad läggs till i fellistan. Samtliga funna fel returneras.

Kontrollen kommer även att göras av Petra när man senare kör debitmetoden.


For Javadoc, click here.

Input

ValidateOrderForUseWithVouchersQuery

OrderID
Beställningsnummer för den nya beställningen.
PaymentType
Betalningsmedel för beloppet som inte täcks med ombokningsbar biljett eller värdebevis, t.ex. kontokort eller liknande.
VoucherPayment
Innehåller information om de vouchers (värdebevis eller ombokningsbara biljetter) som ska användas för betalning.
VoucherType
Här anges vilken typ av voucher man tänker använda, antingen SJPConstants.VVoucherTypeVoucher för Värdebevis eller SJPConstants.VVoucherTypeExchange för ombokningsbar biljett.
UsedVoucherList
En lista med de gamla beställningsrader som ska användas för att betala den nya beställningen.

BasePaymentTypeItemList
BasePaymentTypeItemList är en lista med de nya biljetterna som ska betalas med de gamla biljetterna.

Output

ValidateOrderForUseWithVouchersResult

ValidForUseWithVoucher
Visar om kombinationen gammal biljett och ny beställning är ok.

NotValidForUseWithVoucherResult
Visar en lista med fel som upptäcktes vid valideringen.Vilken beställning/beställningsrad om inte är ok visas samt felnummer och feltext som beskriver varför.