QPartner

Z SPIN2-wiki
Verzia z 09:16, 17. apríl 2020, ktorú vytvoril Roman.adamjak (diskusia | príspevky) (→‎POST contract)
Prejsť na: navigácia, hľadanie 
ZSPINCFH-11366SPIN11248 Novy user QPartner - Zmena zápisu do SPIN, výpočet US, RPMN, Odplata, Max RPMN, výška splátky


V súvislosti so vznikom novej Quatro aplikácie QPartner, ktorá bude automaticky zapisovať zmluvy do backendovej aplikácie SPIN SK, je potrebné v SPINe realizovať nasledovné zmeny:


- Vytvorenie služieb pre zápis do SPIN SK pre nového technického usera
- Pridanie nových polí do SPINu
- Pridanie nastavení v číselníku Typy zmlúv
- Zmena logiky kontroly na strop RPMN
- Zmena zápisu úrokovej sazdby, RPMN, Odplaty
- Zmena výpočtu výšky splátky

Všetky tieto zmeny sa budú týkať iba časti produkcie – tých zmlúv, ktoré budú zapisované novým userom. Pre časť produkcie teda zostanú aj nastavenia po starom.

Návrh


Súčasný stav. Existujú v spine spôsoby výpočtu US, Odmena, RPMN – A,B,C,D,E. D a E spôsob je môžu platiť v systéme súčasne pre tovarovú pôžičku. Pre ich správne napĺňanie je identifikácia v číselníku Typ zmluvy.
Pridanie nového spôsobu výpočtu je potrebné zohľadniť v ZZP , ktoré vychádzajú výpočtom z daných vzorcov. Ide o zzp Mimoriadna splátka, Zmena RPMN, Zmena poistenia RPMN.
Spôsoby výpočtov pre jednotlivé typ – počet vzorcov
Spôsob výpočtu US RPMN Odplata
D 1 1 2
E 3 1 2

1- ide o výpočet RPMN, US sa nepočíta, rovná sa RPMN, odplata je iná len ak ide o zmluvu s poistením, inak rovnako vzorec 1
2- ide o vzorec kde vstupuje splátka s poistením
3- nový spôsob výpočtu US



Číselníky

Typ zmluvy


Doplniť novú záložku Frontend medzi Dalšie údaje a Akcie do [Menu] LEA číselníky -> ZMluva -> Typy zmlúv -> [Karta] Frontend , bude mať len formulár, lebo bude na typ zmluvy len jedno nastavenie
Povinné polia:
Nastavenie pre výpočet US,RPMN,Odplata: FRONTEND/SPIN, default SPIN
Nastavenie pre výpočet splátky: FRONTEND/SPIN, default SPIN
Nastavenie pre predajný kanál: Povinný/Nepovinný, default Nepovinný
Nastavenie pre kontrolu RPMN: Dátum podpisu/Dátum rekalkulácie, default Dátum podpisu

Predajný kanál


Pridať nový číselník do [Menu] LEA číselníky -> Zmluva -> Predajný kanál namiesto Distribučný kanál. Distribučný kanál presunúť do šípky.


Stĺpce + formulár
• Kód - varchar,12, povinný
• Názov - varchar,200, povinný
• Platnosť od – date, povinný
• Platnosť do – date , nepovinný

Jednoznačný indentifikátor bude kód predajného kanála, ten bude použitý aj následne v službách.


Zaevidovanie zmluvy

Záložka zmluva


 [Menu] LEA Zmluva -> Zaevidovanie quatro  -> [Karta] Zmluva


Doplniť Predajný kanál za Akcia. Predajný kanál – vyberač z číselníka Predajných kanálov – kontrola platnosti k sysdate.
Povinný pre typ zmluvy, ktorý má v nastavení typu zmluvy – predajný kanál povinný. 


 znepovinniť pole mesačné finančné výdavky


Záložka podmienky


[Menu] LEA Zmluva -> Zaevidovanie quatro -> [Karta] Podmienky -> [časť] Splátky


ak bude na type zmluvy LEA_TYP_ZMLUVY_FRONTEND. VYPOCET_US = F, potom budú RPMN, Odplata, US a spôsob výpočtu US editovateľné, a nebude sa nič počítať ani kontrolovať
ak bude na type zmluvy LEA_TYP_ZMLUVY_FRONTEND. VYPOCET_US = S, potom budú tieto údaje needitovateľné a budú počítané v SPINe.
Ak bude na type zmluvy LEA_TYP_ZMLUVY_FRONTEND. VYPOCET_SPLATKA = F, potom bude pole splátka editovateľné. Kontrolovať na rozdiel, ABS(splátka * počet splátok + akontácia – zmluvná cena) < splátka
Ak bude na type zmluvy LEA_TYP_ZMLUVY_FRONTEND. VYPOCET_SPLATKA = S, tak sa bude splátka počítať ako teraz a nebude editovateľná. Č
asť splátky umožniť editovať hodnotu Splátka, RPMN, US, Odplata podľa nastavenia na type zmluvy. Na základe prepočtu Zmluvná cena - splátka*počet splátok sa vypočíta dorovnanie – tak ako doteraz. Zohľadní sa v poslednej splátke.
Spôsob výpočtu US – listbox D alebo E. Možnosť zadať, len ak nastavenie na type zmluvy – Frontend.


[Menu] LEA Zmluva -> Zaevidovanie quatro -> [Karta] Podmienky -> [časť] Fakturácia
Časť fakturácia pridať Dátum rekalkulácie.
Dátum rekalkulácie - Povinný pre typ zmluvy, ktorý má nastavenú kontrolu Odplaty podľa Dátumu rekalkulácie. Editovateľný ak nie je zmluva zamknutá rovnako ako splátka, akontácia...

Kontrola RPMN


Pri zápise podmienok sa v súčasnosti kontroluje výška odplaty na max podľa dátumu podpisu zmluvy. Ak na type zmluvy je nastavené – kontrola podľa dátumu rekalkulácie. Max Odplatu kontrolovať podľa dátumu rekalkulácie RPMN. 


==Správa zmluvy==

Zmluva

[Menu] LEA Zmluva -> Správa zmluvy -> [Karta] Zmluva
Pridať stĺpec Dátum rekalkulácie.

Kontrola

[Menu] LEA Zmluva -> Správa zmluvy -> [Karta] Kontrola Doplniť pole Dátum rekalkulácie.

Záložka Podmienky

[Menu] LEA Zmluva -> Správa zmluvy -> [Karta] Podmienky Doplniť pole predajný kanál v časti Akcia.


Doplniť pole Dátum rekalkulácie v časti Fakturácia.

Doplniť pole US v časti Splátky.
Rovnako upraviť záložku podmienky Lea Zmluva – Zákazník evidencia.

Geminy


Upraviť existujúce rozhranie, aby nevyžadovalo údaje podľa nastavenia typu zmluvy.

Lea API


Cieľom je dodať nové API rozhranie, ktoré bude obsahovať všetky základné funkčnosti pre zápis zmluvy a zákazníka, technológia podoruje protokol JSON, obsahuje autentifikáciu a využitie tokenov. Komunikácia je
synchrónna. Servis je nutné inštalovať na server s platformou Windows, v aktuálnom období podporovanou dodávateľom.

Dokumentácia je aktualizovaná na url:port/swagger/ui/index na url:port/swagger/docs/Lea


POST contract


Špecifikácia
• Metóda na zápis zmluvy
• Pri zápise bude kontrolovaná povinnosť vyplnenia polí, ak nebude povinný atribút dodaný, zápis končí chybovou hláškou
• Zápis adries, výrobkov, voliteľných údajov, ručiteľov, poznámok, bankových účtov bude možné zapísať viac hodnôt.
• Ak zápis zlyhá z iných dôvodov ako je vyplnenosť polí, bude poslaná systémová hláška
• Pri zápise bude kontrolovaný autorizačný kód, ak sa nájde zmluva s autorizačným kodom, tak sa zmluva nezapíše
• Pri vyhľadaní zákazníka sa bude zákazník identifikovať podla cons_id + rodné číslo, ak sa nenájde sa založí, popis v POST client

Príklad 

  "clientId": 5135010,
   "applicationId": null,
   "contractTypeId": "PZEX5",
   "actionId": null,
   "paymentsCount": 10,
   "firstPaymentPercentage": 10,
   "signatureDate": "2020-4-9",
   "paymentForm": "P",
   "invoiceNumber": "7651319038",
   "receivedAt": "2020-4-9",
   "signatureDateOZ": null,
   "salePlaceCode": "*E11527",
   "dealerCode": "*E1152702",
   "authorisationCode": "2020040915",
   "clientEmail": "N",
   "newClient": "N",
   "reportCode": null,
   "firstPaymentValue": 145,
   "assuranceId": 336085456,
   "bankAccountIban": null,
   "bankAcountOwner": null,
   "recommenderId": null,
   "contractStatusCode": "B",
   "payment": 130.5,
   "insurance": 3.78,
   "specificSymbol": null,
   "spravaPrePrijimatela": null,
   "sellingChannel": "pk1",
   "rpmn": 15.80,
   "odplata": 15.80,
   "interestRate": 15.80,
   "methodRpmn": "D",
  "dateOfRecalculation": "2020-4-9",
   "barcode": null,
   "product": [
       {
           "productCode": "M1N",
           "price": 1380,
           "contractPrice": 1450,
           "producer": "A DATA",
           "brand": "hoho",
           "serialNo": "hohoho"
       }
   ],
   "optionalData": [
       {
           "code": "POCVYZIV",
           "dataCode": null,
           "dataDesc": null,
           "dataNocode": "100"
       }
   ],
   "note": [
       {
           "code": "cc-pf",
           "value": "skuska poznamky z API Lea",
           "date": "9.4.2020",
           "date2": null
       }
   ],
   "bonus": null,
   "approvals": [
       {
           "approvalCode": "BANKSL1",
           "value": "A",
           "isValidFrom": "2020-4-10",
           "isValidTo": null,
           "text": null
       }
   ]

contract{} Polia Vyhodené polia Popis Format povinné client{} Client array A applicationId LEA_ZMLUVA_INFO.CISLO_ZIADOST Number 22 contractTypeId Typ zmluvy (názov) String A actionId Kod akcie String A paymentsCount Počet splátok Number A firstPaymentPercentage Percento akontácie Number A signatureDate Dátum podpisu Date paymentForm Spôsob úhrady String A invoiceNumber Podmienky/fakturácia/číslo faktúry, aj do VU zmluvy GEMIVSY String N receivedAt Dátum prevzatia Date N signatureDateOZ Podmienky/Obchodný zástupka/Dátum Date N salePlaceId Podmienky/Obchodné miesto/číslo OZ ID, id firmy, nesmie mať ukončenú spoluprácu, do zmluva.firma_id salePlaceCode Zapracovať nie ID ale číslo predajne, overiť duplicitu, Podmienky/Obchodné miesto/číslo OZ ID, id firmy, nesmie mať ukončenú spoluprácu, do zmluva.firma_id String A dealerId Zodpovedný pracovník - predajca ID, kontroluje sa, či predajca je pod salePlaceId, do zmluva.oz_id dealerCode Zapracovať nie ID ale číslo predavača, overiť duplicitu, Zodpovedný pracovník - predajca ID, kontroluje sa, či predajca je pod salePlaceCode, do zmluva.oz_id String A authorisationCode Autorizačný kód String A clientEmail Lea_zmluva_info.email = A/N String N noteId Presunuté do note{} OUT noteTypeId Presunuté do note{} incomeConfirmation Predložené doklady/potvrdené doklady, lea_zmluva_info.doklady incomeConfirmationPartner Predložené doklady/OP potvrdenie manželky, lea_zmluva_info.doklady sipo Predložené doklady/SIPO, lea_zmluva_info.doklady accountExtract Predložené doklady/výpis z účtu, lea_zmluva_info.doklady zrorExtract Predložené doklady/výpis z ZL, lea_zmluva_info.doklady other Predložené doklady/Iné, lea_zmluva_info.doklady newClient Kontakty/Nový klient, lea_zmluva_info.novy_zakaznik String N variableSymbol Len pre update reportId Kod tlačiva, lea_zmluva_info.kod_tlaciva reportCode Kod tlačiva, lea_zmluva_info.kod_tlaciva String A catalogId Kod katalogu, po kontrole katalogu sa zapíše ide koeficientu do lea_zmluva_koeficient firstPaymentValue Suma akontácie Number A vatId Nepoužíva sa assuranceId Sadzba poistenia id String N bankAccount Bude len IBAN bankId Bude len IBAN bankAccountIban Bankový účet pre úhradu splátok string N bankIdIban Id banky pre založenie BU, ak sa nenájde bankAcountOwner Zapisuje sa do VU zmluvy MBU String N guarantyForm Nepoužíva sa, spôsob ručenia guarantor1 Ručiteľ 1 guarantor2 Ručiteľ 2 coApplicant Zápis spolužiadateľa, do ručiteľa, potrebné dodefinovať Array value Nepoužíva sa, hodnota ručenia city Nepoužíva sa, ručenie description Nepoužíva sa, ručenie deliverTo Doručiť komu,do VU zmluvy kod MD_OSOBA deliveryStreet Adresa doručenia, ulica, adresa sa zapíše ku zmluve deliveryZip Adresa doručenia, PSC deliveryCity Adresa doručenia, mesto deliveryPhone Doručiť telefon, do VU zmluvy kod MD_TELEFON deliveryDate Doručiť dátum deposit Suma zálohy na akontáciu cardCode Nepoužíva sa paymentCard Platobná karta, zmluva_info paymentCardNumber Číslo platobnej karty, zmluva_info cardAccountNumber Číslo kartového účtu, zmluva_info reservedUntil Dátum rezervácie, zmluva_info numberOZ Čislo OZ, zmluva.oz_id, obchodný zástupca ozId ID = je to numberOZ numberTOZ ID tipera recommenderId Zodpovený za spracovanie, do zmluva_info.zodpovedny_id String N contractId ID zaevidovanej zmluvy OUT text Note{} contractStatusCode Stav zmluvy kod String A contractPrice Nepoužíva sa, Zmluvná cena payment Výška splátky, posledná splátka bude vypočítaná v SPINE Number A bonus Bonus{} cashOnDelivery Suma dobierky insurance Suma poistenia Number evidenceNumber Evidenčné číslo OUT dealerBankAccount používa sa to až na faktúre dealerBankId dealerBankAccountId specificSymbol Zapis do VU zmlvuy GEMISSY String N noteDate Note{} noteDate2 Note{} clientCardId Číslo zákazníckej karty bankAccountForSettlementPaymentId Id BU firmy pre úhrady splátok deleteMode Len pri zmazaní zmluvy maturityDate Dátum splatnosti faktúry firstPaymentDate Dátum akontácie depositInvoice Nepoužíva sa pri zápise OUT approveQCUP Nepoužíva sa pri zápise OUT interestRateClient Zmluva_info.us_klient , pridať aj zápis do tabuľky lea_zmluva_rpmn, podla nastavenia na type zmluvy pozicka OUT urok OUT spravaPrePrijimatela Zápis do VU zmluvy GEMISPP String N product{} Produkt Array optionaData{} Voliteľné údaje Array note{} poznámky Array complaint{} Reklamácie = nie bude samostatne Array bonus{} Bonusy Array coApplicant{} Spolužiadateľ Array approvals{} Súhlasy Array sellingChannel predajny kanal kod String N rpmn RPMN z frontendu, zápis do lea_zmluva_rpmna podla nastavenia na type zmluvy Number N odplata odpata z frontendu, zápis do lea_zmluva_rpmna podla nastavenia na type zmluvy Number N interestRate US z frontendu, Zmluva_info.us_klient , pridať aj zápis do tabuľky lea_zmluva_rpmn, podla nastavenia na type zmluvy Number N methodRpmn sposob vypoctu RPMN z frontendu string N dateOfRecalculation datum rekalkulácie Date N barcode barcode string N

Zdroj: „https://wiki.helios.eu/sk/spin2/index.php?title=QPartner&oldid=21046“