QPartner

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