Documentație API

Conectează softul tău de service direct la ROA AUTOPASS (plan Pro).

Cum funcționează

Softul tău trimite prezentările printr-un singur apel HTTP; noi validăm datele, mapăm operațiile pe coduri RAR, oprim duplicatele și transmitem la RAR Auto-Pass. Autentificarea se face cu o cheie API (antetul X-API-Key), generată din contul tău. Credențialele RAR le configurezi o singură dată în cont.

Endpoint-uri principale

Endpoint	Ce face
POST /v1/prezentari	Trimite una sau mai multe prezentări spre declarare
POST /v1/prezentari/valideaza	Dry-run: validare fără trimitere
GET /v1/prezentari/{id}	Starea unei trimiteri
POST /v1/import	Import fișier xlsx/csv prin API
GET /v1/nomenclator	Nomenclatorul de coduri RAR (public)

Exemplu: cerere

curl -X POST "http://autopass.romfast.ro/v1/prezentari" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: rfak_..." \
  -d '{
  "prezentari": [
    {
      "vin": "WVWZZZ1JZXW000001",
      "nr_inmatriculare": "B123ABC",
      "data_prestatie": "2026-06-22",
      "odometru_final": "150000",
      "odometru_initial": "149500",
      "prestatii": [
        {
          "cod_prestatie": "OE-1"
        },
        {
          "cod_op_service": "SF01",
          "denumire": "Schimb filtru ulei"
        }
      ]
    }
  ],
  "rar_env": "test"
}'

Fiecare prestație are fie cod_prestatie (cod RAR din nomenclator), fie cod_op_service + denumire — codurile tale interne le mapăm noi pe coduri RAR, iar maparea rămâne salvată pentru trimiterile următoare.

Exemplu: răspuns

{
  "results": [
    {
      "index": 0,
      "submission_id": 123,
      "vehicul": "B123ABC",
      "status": "queued",
      "motiv": null,
      "id_prezentare": null
    }
  ]
}

Un rezultat per prezentare, în aceeași ordine ca cererea. status poate fi queued (în coadă spre RAR) sau, dacă ceva blochează trimiterea, needs_mapping / needs_data / error — cu explicația în motiv.

Referință completă

• Swagger UI — /docs
• Schema OpenAPI — /openapi.json

După autentificare găsești în aplicație, la Integrare, exemple gata de copiat pentru curl, Python, PHP, C#, Node și Visual FoxPro, plus testarea cheii API și a credențialelor RAR.