{# Empty-state: lipsesc cheie API sau credentiale RAR #} {% if not are_cheie or not are_creds %} {% endif %} {# Card: ID cont si endpoint de baza #}

Cont ID: {{ account_id }} Endpoint: {{ base_url }}

Cererile trimit doar cheia API + datele prezentarii. Credentialele RAR se configureaza o data in Setari si sunt folosite automat la trimitere. Optional, poti include rar_credentials in payload ca sa le suprascrii pe acea cerere.

{# Tab-list PRIMAR: limbaje #}

{# Panel curl #}

{% set ex = exemple["curl"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# Panel python #}

{% set ex = exemple["python"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# Panel PHP #}

{% set ex = exemple["php"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# Panel C# #}

{% set ex = exemple["csharp"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# Panel Node #}

{% set ex = exemple["node"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# Panel VFP: tab-list SECUNDAR pentru dialecte #}

Visual FoxPro — alege dialectul COM:

{# Dialecte VFP #}

{# MSXML2 #}

{% set ex = exemple["vfp_msxml"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# WinHttp #}

{% set ex = exemple["vfp_winhttp"] %}

{{ ex["prezentari"] | e }}

{{ ex["import"] | e }}

{# Card: exemplu cerere + raspuns JSON pentru POST /v1/prezentari #}

Cerere si raspuns JSON

POST /v1/prezentari — o prezentare cu doua operatii: una cu cod RAR direct (cod_prestatie), una cu cod intern + denumire (mapata automat de gateway).

Cerere

{{ exemplu_json["cerere"] | e }}

Raspuns 200 (forma implicita minim)

{{ exemplu_json["raspuns"] | e }}

Obligatorii: vin, nr_inmatriculare, data_prestatie (YYYY-MM-DD), odometru_final (string), prestatii (min. 1).
Fiecare prestatie are cod_prestatie (cod RAR din nomenclator) SAU cod_op_service + denumire — gateway-ul le mapeaza la cod RAR.
Optionale: odometru_initial, obs; rar_env ("test" / "prod") — absent = mediul implicit al contului.
Un rezultat per prezentare, in aceeasi ordine (index = pozitia din cerere). status: queued (in coada), needs_mapping / needs_data / error (blocat — vezi motiv).
id_prezentare e completat doar cand randul era DEJA trimis la RAR (duplicat detectat); altfel apare ulterior, in dashboard sau la GET /v1/prezentari/{id}.
Vrei detalii complete (erori pe camp, coduri nemapate, held)? Trimite "raspuns": "complet" in body.

{# Card: De ce nu ajunge la RAR? (onestitate canal API) #} {# Un POST /v1/prezentari poate intoarce 200 dar randul sa NU plece la RAR. #}

De ce nu ajunge la RAR?

Un POST /v1/prezentari poate intoarce 200 cu status: "queued", dar randul sa NU plece automat la RAR. Cele trei motive:

Conturile noi pornesc cu Trimiterea automata OPRITA (Auto OFF). Primul POST da 200/queued, dar randul e tinut (held=true) si asteapta eliberare manuala. Verifica bifa „Trimite automat la RAR" din dashboard.

Motiv	Ce inseamna	Cum deblochezi
held (Auto OFF)	Contul are Trimiterea automata OPRITA → randul e tinut (`held=true`), NU pleaca la RAR.	Elibereaza manual din dashboard (butonul Trimite / Trimite toate) sau activeaza Trimiterea automata. Verifici cu `GET /v1/prezentari/{id}` (`held=true`).
needs_mapping	Cod operatie fara mapare la un cod RAR din nomenclator.	Intra in editorul de mapare din dashboard; la salvarea maparii randul se re-rezolva automat.
needs_data	Validare de continut esuata (VIN / data prestatie / odometru).	Corectezi datele si repui prezentarea.

{# Card: Export & referinta #}

Export & referinta

Swagger UI — /docs Schema OpenAPI — /openapi.json Colectie Postman — /v1/integrare/postman.json

{# Formular test conexiune cheie API #}

Testeaza conexiunea

{# Formular test credentiale RAR #} {# Login de proba pe mediul ales — fara efecte secundare, nu salveaza nimic. #} {# Banner-ul de rezultat include eticheta mediului ("pe TESTARE" / "pe PRODUCTIE"). #}

Testeaza credentiale RAR

Verifica daca credentialele RAR sunt corecte pe mediul ales. Nu se salveaza nimic.