Aveti mai jos linkul de Swagger ce descrie fiecare endpoint al mediului de TESTARE.


https://apps.rarom.ro/test-rar-autopass/swagger-ui/index.html   

 

Acest Swagger nu permite autentificarea pentru testare directa, insa aici gasiti API si payload/parametri, modele de date ce pot fi testate prin tool`uri specifice (PostMan)  cu credentialele pe care vi le`am creat:


Am atasat documentatia si un screenshot ca exemplu de login.
 

Ca sa poata fi integrate in PRODUCTIE, API se modifica astfel :


https://apps.rarom.ro/rar-autopass/swagger-ui/index.html    folosind credentialele societatii/reprezentantei societatii.



Inainte de a trece in productie am rugamintea sa reveniti pentru a verifica corectitudinea datelor din mediul de test.



Imaginea odometrului nu mai este obligatorie.

Prezentarile prin API se vor trimite cu status “FINALIZATA”.

-              este necesar intai login https://apps.rarom.ro/test-rar-autopass/public/login  apoi folosirea Bearer token in apelul pentru POST Prezentare


-              pentru POST Prezentare modelul este urmatorul, spre exemplu, restul de date fiind asociate/generate de server:

{ 

  "b64Image":"UklGRn5FAgBXRUJQVlA4WAoAAAAoAAAA/wMA/wMASUNDUAobAAAAABsKbGNtc.... etc stringul base 64", --OPTIONAL

    "dataPrestatie": "2024-07-25",

    "nrInmatriculare": "B999GEN",

    "obs": "TEST", --OPTIONAL

    "odometruFinal": "9999999",

    "odometruInitial": null, - se completeaza doar daca se schimba/repara instrumentele care afiseaza nr km

   "prestatii": [

        {

            "codPrestatie": "OE-1",

            "idPrezentare": null

        },

        {

            "codPrestatie": "OE-2",

            "idPrezentare": null

        },

 

       {

        Se adauga prestatii in continuare daca este cazul

       }

    ],

    "sistemReparat": "null",

    "status": "FINALIZATA",

    "vin": "XXXXXXXX888888888"

}

            Si vom primi ca raspuns:

{

    "statusCode": 200,

    "message": "Prezentare adaugata cu succes",

    "data": {

        "id": 59950,

        "dataPrestatie": "2024-07-25",

        "vin": "XXXXXXXX888888888",

        "odometruFinal": 9999999,

        "idAgent": 1587,

        "tipPrestatie": "GENERIC",

        "odometruInitial": null,

        "idUser": 22,

        "sistemReparat": "null",

        "obs": "TEST",

        "nrInmatriculare": "B999GEN",

        "status": "FINALIZATA",

        "prestatii": [

            {

                "idPrezentare": 599950,

                "codPrestatie": "OE-1"

            },

            {

                "idPrezentare": 599950,

                "codPrestatie": "OE-2"

            }

        ],

       "b64Image":"UklGRn5FAgBXRUJQVlA4WAoAAAAoAAAA/wMA/wMASUNDUAobAAAAABsKbGNtc.... etc stringul base 64"

}

 

-              Daca se intervine asupra instrumentelor care afiseaza kilometrajul se va introduce odometru initial(indicatia inainte de reparatie/schimbat) si odometru final (indicatia dupa reparatie/ schimbat)

 

-              Codurile de prestatie pot fi interogate prin API pentru a le putea asocia dvs cu operatiunile ce se executa de catre societate.

https://apps.rarom.ro/test-rar-autopass/swagger-ui/index.html#/nomenclator-controller/getPrestatiiNomUsingGET  

 

 
Testele pentru integrare se vor face NUMAI pe mediul de test:

https://apps.rarom.ro/test-rar-autopass/swagger-ui/index.html  

-----------------------------------------
In urma constatarii unor date introduse eronat, API RAR Auto-Pass (atat mediul de test cat si cel de productie) a suferit unele modificari legate de constrangerile campurilor transmise, unele fiind deja existente, iar altele adaptate, dupa cum urmeaza:

Data – nu poate fi mai devreme de 01.12.2024 sau mai tarziu de “astazi”

VIN – 17 caractere, majuscule, fara spatii, caractere speciale sau literele O,I,Q

Imagine odometru, daca este atasata, trebuie sa fie format base64.

Daca in lista de prestatii se regaseste R-ODO SAU I-ODO, campul odometru initial trebuie sa fie deasemenea transmis.

Numarul de inmatriculare – fara spatii sau caractere speciale, max 10 caractere, litere + cifre, majuscule.


Acestea sunt deja aplicate si detalii se regasesc in raspunsul API, in cazul in care nu sunt respectate. 

----------------------------
Doar prezentarile cu status SALVATA pot fi anulate, nu si cele cu status FINALIZATA. Raspunsul este : EROARE_STATUS_ANULARE("Eroare la schimbarea statusului prezentarii. Id not found."), de acolo confuzia.

 

Anularea Prezentarilor se poate face din interfata web atat timp cat acestea sunt inca editabile(SALVATA).  Odata marcate ca FINALIZATA , prezentarile nu se mai pot anula.
 

Scopul API este strict de INSERT prezentari ca si FINALIZATE. Toate celelalte operatiuni CRUD se vor face din web unde este cazul.
 

Daca s-au introdus date eronate acestea pot fi rectificate de catre Registrul Auto, in urma unei solicitari la suport.autopass@rarom.ro , dar acum nu este cazul fiindca sunteti pe mediul de test.  

Inca un aspect de mentionat pe mediul de test , la interogarea listei de prezentari finalizate nu veti primi in raspuns si prestatiile, insa pe mediul de productie acestea sunt disponibile pentru vizualizare, pot fi filtrate by keyword sau date range, si apoi pot fi exportate in Excel.
--------------------------------
