search

posfgit / standard

9 stars 13 forks source link

Detalii tehnice pentru Furnizor #9

Open LucianIonut26 opened 2 years ago

LucianIonut26 commented 2 years ago

Buna ziua!

Va rog sa clarificam cateva aspecte:

  1. In scop este si schimbul de fisiere PDF (e.g. Contractul)?
  2. Cum putem vedea master data-urile ANRE pentru a ne asigura ca trimitem informatii corecte (e.g. Furnizorul, Operatorul etc.) ?
  3. Se pot furniza fisiere JSON (sau XML) pentru mesajul ContractSignedBySupplier (asemanator cu PlaceCreatedByOperator.xml) ?
  4. Mesajele de eroare sunt tratate?

Multumesc!

LucianIonut26 commented 2 years ago

Buna ziua! Puteti sa ne ajutati cu niste raspunsuri? Multumesc!

bogdannedelcu commented 2 years ago

Buna ziua, va raspund punctual:

  1. fisierele PDF completate de clienti in interfata Web a POSF va fi transmis automat ca atasament (sub forma unui link de descarcare) alaturi de mesajul ContractSignedByClient, catre platforma celorlalte parti. Vom reveni pe standardul actual cu specificatii de fisiere atasate.
  2. Vom furniza API pentru interogare entitati din masterdata
  3. Da, vom furniza exemple pentru fiecare tip de mesaj in curand
  4. La ce fel de mesaje de eroare va referiti? Multumesc
LucianIonut26 commented 2 years ago

Buna ziua!

  1. O clarificare aditionala: daca un contract este semnat in afara platformei POSF, in sistemul IT al furnizorului, urmeaza sa incarcam in POSF doar metadatele contractului sau si PDF-ul?
  2. OK!
  3. Cand puteti sa ne furnizati exemple JSON pentru fiecare tip de mesaj (API request) relevant pentru Furnizor (ce primeste si trebuie sa dea)?
  4. De exemplu daca un mesaj trimis de la sistemul IT al furnizorului, in coada de mesaje POSF, nu este procesat corect. Furnizorul primeste o notificare ca mesajul nu a fost procesat? Daca da, din mesaj se poate vedea din cauza carei metadate nu se poate procesa (in caz ca o metadata este gresita)?
  5. Cand o sa fie disponibil mediul de test online POSF?

Multumesc!

bogdannedelcu commented 2 years ago
  1. Doar metadatele,
  2. Am actualizat schema si prima pagina a standardului, revenim cu exemple de mesaje pentru fiecare tip in parte
  3. Mesajul trece prin validarea de schema inainte sa fie publicat in coada de mesaje POSF. API va returna eroare si motiv de eroare pentru mesajele care nu respecta schema XSD.
  4. ANRE estimează ca testările și integrările cu operatorii să înceapă în 25.05.2022.
LucianIonut26 commented 2 years ago

Buna ziua!

Am observat foarte multe intrebari si raspunsuri in ultima vreme. Am doua intrebari:

  1. Documentatia se updateaza automat pe baza intrebarilor si raspunsurilor (daca apar clarificari in urma lor)?
  2. Va exista si un centralizator de intrebari si raspunsuri, grupate pe tipul de actor (operator, furnizor etc.)?

Multumesc!

bogdannedelcu commented 2 years ago

Ref 1: Da, tinem cont de propuneri si actualizam documentatia publicand noi versiuni de standard. Ref 2: Va incurajam sa folositi cautarea in intrebari/raspunsuri. Pe masura ca anumite intrebari si raspunsuri devin relevante pentru standard vom incorpora modificarile si vom crea sectiuni dedicate unde o sa tratam subiectele respective. image

LucianIonut26 commented 2 years ago

Buna ziua! In urma sedintei de astazi revenim cu cateva intrebari, pe care va rugam sa ni le clarificati:

  1. Puteti sa ne dati detalii despre conventia de consum/programul de distributie (anexa la contract) - cum stim ce cantitate contracteaza un client prin POSF?
  2. De unde stim ce modalitate de transmitere a facturilor (posta sau email) alege clientul? S-a discutat despre implementarea unei bife in sistem. Puteti sa ne confirmati?
  3. Ce se intampla daca prin oferta-tip solicitam o scrisoare de garantie bancara sau plata in avans pentru contractare?
  4. Va rugam confirmati codul CUA si coordonatele GPS, din RENNS nu sunt obligatorii pentru furnizori (pentru cazul in care contractele sunt semnate in afara POSF).
  5. De unde stim ca persoana care semneaza contractul este cea care are drept de reprezentare? Poate ar trebui sa mai existe o bifa in acest sens.
  6. Conform Regulamentului de furnizare, solicitantul trebuie sa trimita: cerere de incheiere a contractului, CI/CUI si declaratia pe proprie raspundere privind spatiul. Va rugam confirmati ca cererea si declaratia pot fi trimise sub forma de tipizat (impreuna cu templateul de contract) pe care clientul sa le completeze si apoi sa le incarce, impreuna cu CI/CUI pentru a putea sa semneze contractul
  7. Cand o sa se permita accesul si la aplicatia Web, pentru a putea verifica datele incarcate prin API?
  8. Puteti sa ne dati detalii despre incarcare manuala a datelor? Se poate folosi un template Excel, iar webPOSF poate permite incarcarea lui?
  9. RENNS nu functioneaza, cautarea nu gaseste nicio adresa. Aveti detalii despre cand o sa functioneze?

image

Multumesc!

LucianIonut26 commented 2 years ago

Puteti sa ne dati niste detalii despre upload-ul manual: cum se va face? care este formatul in care trebuie trimite datele?

GabrielaFlorescu commented 2 years ago

@bogdannedelcu ne puteti raspunde, va rog, si la punctele de mai sus?

bogdannedelcu commented 2 years ago

Ref 1: in XSD am adaugat tipul Consumption care poate fi pus pe contract. Aplicatia WEBPOSF il va trimite pe ContractSignedByClient

bogdannedelcu commented 2 years ago

Ref 2: A fost adaugat tipul Marketing in caresunt mentionate aceste elemente. Apare pe contract.

bogdannedelcu commented 2 years ago

Ref 3: Nu se poate prin aplicatia WebPOSF, se va semna la ghiseu/prin posta electronica iar Furnizorul va emite ContractSignedBySupplier

bogdannedelcu commented 2 years ago

Ref 4: Confirmam, totusi sa aveti in vedere ca informatiile de pe Place e bine sa le luati din POSF chiar si cand semnati la ghiseu. Adica mesajul emis ContractSignedBySupplier sa aibe Place completat conform cu ce exista in POSF obtinut prin api-ul /broker/place/...

bogdannedelcu commented 2 years ago

Ref 5: Aplicatia WebPOSF obliga pe cel care semneaza in numele altei persoane fizice sau juridice sa incarca un document care dovedeste calitatea. Aceste documente se vor atasa mesajului ContractSignedByClient si vor putea fi descarcate/consultate de catre Furnizor

bogdannedelcu commented 2 years ago

Ref 6: Fisierele PDF se vor completa automati in aplicatia WebPOSF cu datele din contract. Furnizorul va incarca odata cu oferta si fisierele atasate pe care le va completa sistemul. Va rugam sa folositi acest program https://github.com/posfgit/standard/tree/main/samples/small-company pentru a verifica pentru fisierele PDF faptul ca ele se completeaza corect. Acelasi cod va fi folosit de aplicatia WebPOSF.

bogdannedelcu commented 2 years ago

Ref 7: Transmiteti pe email sau pe whatsapp cand sunteti gata sa facem teste. Imediat ce aplicatia Web este pregatita va vom informa.

bogdannedelcu commented 2 years ago

Ref 8: Acelasi program poate fi folosit la incarcarea manuala a fisierelor XML: https://github.com/posfgit/standard/tree/main/samples/small-company Va prelua din folderul IN toate fisierele .XML si le va incarca in POSF prin API pe contul dvs.

bogdannedelcu commented 2 years ago

Ref 9: Pare ca exista date pentru anumite localitati. Vedeti va rog mentiunile de aici cu privire la adrese. https://github.com/posfgit/standard#cateva-consideratii-despre-adrese

bogdannedelcu commented 2 years ago

Puteti sa ne dati niste detalii despre upload-ul manual: cum se va face? care este formatul in care trebuie trimite datele?

un simplu exemplu de conectare API si publicare/citire mesaje scris in limbajul Java gasiti aici https://github.com/posfgit/standard/tree/main/samples/small-company

bogdannedelcu commented 2 years ago

Ref: Cum putem vedea master data-urile ANRE pentru a ne asigura ca trimitem informatii corecte (e.g. Furnizorul, Operatorul etc.) ? aveti posibilitatea sa interogati lista de operatori/furnizori prin API exemplu aici: https://github.com/posfgit/standard/blob/main/samples/java/src/main/java/com/example/demo/DemoController.java

LucianIonut26 commented 2 years ago

Buna ziua! Va rog sa ne spuneti daca pentru mesajul "ContractCancelledBySupplier" trebuie trimis si un motiv pentru care, contractul a fost anulat. Multumesc!

bogdannedelcu commented 2 years ago

Pentru o buna comunicare intre parti ar fi util sa se completeze un motiv in campul "description". Mesajul respectiv va fi afisat de aplicatia WebPOSF utilizatorilor care au primit acest mesaj.

LucianIonut26 commented 2 years ago

Puteti sa ne dati poza completa de la https://github.com/posfgit/standard/blob/main/img/typesdiagram.png ? Pare incompleta in partea de jos.

Puteti sa ne dati si XSD-ul pentru https://github.com/posfgit/standard/blob/main/samples/small-company/docs/msg.xml ?

Multumesc!

GabrielaFlorescu commented 2 years ago

Ref 4: Confirmam, totusi sa aveti in vedere ca informatiile de pe Place e bine sa le luati din POSF chiar si cand semnati la ghiseu. Adica mesajul emis ContractSignedBySupplier sa aibe Place completat conform cu ce exista in POSF obtinut prin api-ul /broker/place/...

@bogdannedelcu Cum putem lua info de pe Place din POSF atunci cand semnam la ghiseu? Intelegerea noastra a fost ca noi vom avea acces doar la datele locurilor de consum din portofoliul nostru. Apoi, spui de ContractSignedBySupplier - dar acest mesaj vine ca raspuns la ContractSignedbyClient care ni se trimite cu Place completat din platforma, ce sa mai verificam noi?

GabrielaFlorescu commented 2 years ago

Ref 6: Fisierele PDF se vor completa automati in aplicatia WebPOSF cu datele din contract. Furnizorul va incarca odata cu oferta si fisierele atasate pe care le va completa sistemul. Va rugam sa folositi acest program https://github.com/posfgit/standard/tree/main/samples/small-company pentru a verifica pentru fisierele PDF faptul ca ele se completeaza corect. Acelasi cod va fi folosit de aplicatia WebPOSF.

@bogdannedelcu asta inseamna ca pentru toate documentele pe care ni le dorim semnate de client (contract de furnizare, cerere de incheiere a contractului, declaratia pe proprie raspundere privind spatiul) va trebui sa va transmitem template-uri cu campuri dinamice, astfel incat sa stiti unde sa inserati informatiile de la client. Pls confirm.

GabrielaFlorescu commented 2 years ago

@bogdannedelcu referitor la incarcarea manuala a bazei de date cu contracte active:

  1. Pe linkul (https://github.com/posfgit/standard/tree/main/samples/small-company), in folderul DOCS avem exemplu cod Java pentru ContractSignedByClient, dar intelegerea noastra a fost ca transmiterea datelor initiale se va face cu ContractChangedInfo. Avem nevoie de ContractChangedInfo pentru a putea face uploadul de contracte active.
  2. Unde este folderul IN? (nu am vazut decat OUT)
  3. La ce foloseste modelul de contract de furnizare din PDF in cazul uploadului initial?
  4. La ce foloseste semnatura.jpg in cazul uploadului initial?
  5. In PDF, la art. 8, avem “cantitate lunara estimata” – intelegerea noastra a fost ca userul isi va insera in platforma cantitatea estimata (de gaze sau energie electrica) pe fiecare luna in parte. (In PDF nu avem anexa cu programul de livrare / conventia de consum). Va rugam confirmati.
  6. Care este unitatea de masura in care utilizatorii isi vor insera consumul estimat, respectiv in ce unitate de masura vom primi/trimite noi cantitatile? kWh sau MWh?
  7. Templateul de contract va fi acelasi pentru toti furnizorii sau fiecare furnizor va trimite propriul template (cu campuri dinamice) care va fi populat cu informatiile de la utilizator?
  8. Intelegerea noastra a fost ca, la semnarea unui contract in POSF, furnizorul primeste, in afara de metadatele contractului venite cu ContractSignedbyClient, un link catre PDF-ul semnat de client. Cum se aplica semnatura furnizorului pe contract?
  9. Contractele semnate in afara POSF se trimit si in format PDF sau doar metadatele lor prin mesajul ContractChangedInfo? Multumim.
GabrielaFlorescu commented 2 years ago
  1. Pentru contractele semnate la ghiseu furnizorul trebuie sa trimita in platforma si Consumption impartit pe 12 luni?
bogdannedelcu commented 2 years ago

Puteti sa ne dati poza completa de la https://github.com/posfgit/standard/blob/main/img/typesdiagram.png ? Pare incompleta in partea de jos.

Puteti sa ne dati si XSD-ul pentru https://github.com/posfgit/standard/blob/main/samples/small-company/docs/msg.xml ?

Multumesc!

image

bogdannedelcu commented 2 years ago

Puteti sa ne dati poza completa de la https://github.com/posfgit/standard/blob/main/img/typesdiagram.png ? Pare incompleta in partea de jos.

Puteti sa ne dati si XSD-ul pentru https://github.com/posfgit/standard/blob/main/samples/small-company/docs/msg.xml ?

Multumesc!

XSD-ul este acelasi, https://github.com/posfgit/standard/blob/main/ANRESchema.xsd

bogdannedelcu commented 2 years ago

Ref 4: Confirmam, totusi sa aveti in vedere ca informatiile de pe Place e bine sa le luati din POSF chiar si cand semnati la ghiseu. Adica mesajul emis ContractSignedBySupplier sa aibe Place completat conform cu ce exista in POSF obtinut prin api-ul /broker/place/...

@bogdannedelcu Cum putem lua info de pe Place din POSF atunci cand semnam la ghiseu? Intelegerea noastra a fost ca noi vom avea acces doar la datele locurilor de consum din portofoliul nostru. Apoi, spui de ContractSignedBySupplier - dar acest mesaj vine ca raspuns la ContractSignedbyClient care ni se trimite cu Place completat din platforma, ce sa mai verificam noi?

Daca semnati la ghiseu voi initiati primul mesaj ContractSignedBySupplier. Folosind API puteti cere de la POSF datele acelui Place https://github.com/posfgit/standard/blob/main/TestEnvironment.md#interogarea-locurilor-de-consum-folosind-brokerplace

bogdannedelcu commented 2 years ago

Ref 6: Fisierele PDF se vor completa automati in aplicatia WebPOSF cu datele din contract. Furnizorul va incarca odata cu oferta si fisierele atasate pe care le va completa sistemul. Va rugam sa folositi acest program https://github.com/posfgit/standard/tree/main/samples/small-company pentru a verifica pentru fisierele PDF faptul ca ele se completeaza corect. Acelasi cod va fi folosit de aplicatia WebPOSF.

@bogdannedelcu asta inseamna ca pentru toate documentele pe care ni le dorim semnate de client (contract de furnizare, cerere de incheiere a contractului, declaratia pe proprie raspundere privind spatiul) va trebui sa va transmitem template-uri cu campuri dinamice, astfel incat sa stiti unde sa inserati informatiile de la client. Pls confirm.

Intelegerea este corecta, confirmam.

bogdannedelcu commented 2 years ago

Ref 1: Programul Sample Java functioneaza cu orice tip de mesaj, inclusiv ContractChangedInfo. Are structura XML similara cu ContractSignedByClient. O serie de campuri au devenit optionale astfel incat importul initial sa fie facut cu usurinta.

bogdannedelcu commented 2 years ago

Ref 2: L-am creat, il puteti crea si dvs daca nu apare pe disc

bogdannedelcu commented 2 years ago

Ref 3: Sa aveti un exemplu pentru a vedea cum sunt denumite campurile. Cu un editor de PDF vedeti denumirea. image

bogdannedelcu commented 2 years ago

Ref 5: A fost eliminat din standard anexa cu conventia de consum, nu se va trimite in mesajul ContractSignedByClient.

bogdannedelcu commented 2 years ago

Ref 7: Fiecare va incarca propriul template in comparator

bogdannedelcu commented 2 years ago

Ref 8: Folositi programul demo pentru a vedea codul care face semnatura. Este un camp care va fi inlocuit cu o imagine. https://github.com/posfgit/standard/tree/main/samples/small-company

bogdannedelcu commented 2 years ago

Ref 9: Nu se trimit fisiere, conform specificatiilor se vor identifica adrese URL de unde oricine le poate descarca. Este valabil si pentru cele scanate.

https://github.com/posfgit/standard#fisiere-atasate-entitatilor

bogdannedelcu commented 2 years ago

Ref 10: Nu, s-a renuntat.

GabrielaFlorescu commented 2 years ago

@bogdannedelcu poti sa ne spui, te rog, de ce avem ca optiune CUI la LegalIDType? thx

bogdannedelcu commented 2 years ago

Nu se va folosi CUI in LegadIDType, a ramas dintr-o versione mai veche.

LucianIonut26 commented 2 years ago

Buna ziua!

Revin cu cateva intrebari pe care am dori sa le clarificam:

  1. Care este unitatea de masura pentru consum atat pentru Gas cat si pentru Power?

  2. In legatura cu consumul: luna 1 inseamana intotdeauna Ianuarie sau inseamna prima luna de livrare?

  3. Consumul nu este obligatoriu nici in Contract, nici in Place. Nu ar trebui sa fie obligatoriu macar in Place? (ca si Furnizor, noi trebuie sa stim cantitatea contractata)

  4. Oferte vor avea un cod unic? Daca da, cine il va asigna la oferta, Furnizorul sau POSF?

  5. Cand primim ContractSignedByClient, de unde stim ca userul a acceptat oferta cu pretul aferent de ieri si nu oferta pe care am incarcat-o astazi?

  6. Ce inseamna contract status SUSPENDAT? Trebuie sa dam un motiv pentru SUSPENDAT?

  7. In cazul in care userul nu a selectat factura electronica si ea se trimite prin posta, de unde stim care este Invoice Address? O sa fie mereu CorrespondenceAddress?

  8. Puteti sa ne dati detalii despre Marketing - PlatformTerms?

  9. Cum o sa fie tratat Communication Channel: un singur checkbox pentru toate canelele (telefon, mail etc.) sau selectie multipla si clientul isi alege cum poate fi contactat?

Multumesc frumos!

GabrielaFlorescu commented 2 years ago

Buna ziua!

Revin cu cateva intrebari pe care am dori sa le clarificam:

  1. Care este unitatea de masura pentru consum atat pentru Gas cat si pentru Power?
  2. In legatura cu consumul: luna 1 inseamana intotdeauna Ianuarie sau inseamna prima luna de livrare?
  3. Consumul nu este obligatoriu nici in Contract, nici in Place. Nu ar trebui sa fie obligatoriu macar in Place? (ca si Furnizor, noi trebuie sa stim cantitatea contractata)
  4. Oferte vor avea un cod unic? Daca da, cine il va asigna la oferta, Furnizorul sau POSF?
  5. Cand primim ContractSignedByClient, de unde stim ca userul a acceptat oferta cu pretul aferent de ieri si nu oferta pe care am incarcat-o astazi?
  6. Ce inseamna contract status SUSPENDAT? Trebuie sa dam un motiv pentru SUSPENDAT?
  7. In cazul in care userul nu a selectat factura electronica si ea se trimite prin posta, de unde stim care este Invoice Address? O sa fie mereu CorrespondenceAddress?
  8. Puteti sa ne dati detalii despre Marketing - PlatformTerms?
  9. Cum o sa fie tratat Communication Channel: un singur checkbox pentru toate canelele (telefon, mail etc.) sau selectie multipla si clientul isi alege cum poate fi contactat?

Multumesc frumos!

@bogdannedelcu ne raspundeti aici, va rog? thx

bogdannedelcu commented 2 years ago

Ref 2: Luna 1 este Ianuarie

bogdannedelcu commented 2 years ago

Ref 3: A fost prevazut in standard dar pentru moment nu va fi transmis de aplicatia WebPOSF si nu este obligatoriu nici in Place. Se va solicita pe alte canale catre CF sau catre OR aceste informatii

bogdannedelcu commented 2 years ago

Ref 4: Da, ofertele trebuie sa aibe un cod unic care sa nu se repete. Furnizorul are in grija acest aspect.

bogdannedelcu commented 2 years ago

Ref 5: ContractSignedByClient contine codul ofertei unice. O oferta nu se poate modifica, daca se doreste actualizarea pretului se va incarca o noua oferta si se va dezactiva cea anterioara.

bogdannedelcu commented 2 years ago

Ref 6: Suspendarea este o caracteristica a oricaru contract si mentioneaza o perioada in care efectele contractului sunt suspendate. Nu este obligatoriu sa se furnizeze motiv.

bogdannedelcu commented 2 years ago

Ref 7: in ContractSignedByClient va fi campul correspondenceClientAddress pentru facturi prin posta

bogdannedelcu commented 2 years ago

Ref 8: Marketing - PlatformTerms inseamna ca utilizatorul a bifat optiunea ca accepta termenii si conditiile platformei WebPOSF