Docs

# Get Vignette Sale

Retrieve details of a specific vignette sale.

This endpoint is typically used in post-checkout flows to:

  • Retrieve vignette details if the activation webhook notification failed or was missed.

# Request

GET /v1/vignette/details/<sale_id>

# Parameters

Parameter Type Required Description
sale_id string Yes The unique identifier of the draft vignette. Matches the id field returned by /v1/vignette/create.

# Code samples

curl -X POST "https://api.rovinieteonline.ro/v1/vignette/details/<sale_id>" \
     -H "X-Authorization: [YOUR_API_KEY]" \
     -H "Content-Type: application/json"
try {
    const res = await fetch("https://api.rovinieteonline.ro/v1/vignette/details/<sale_id>", {
        method: "POST",
        headers: {
            "X-Authorization": "[YOUR_API_KEY]",
            "Content-Type": "application/json"
        },
    })
    const json = await res.json()
    console.log(json)
} catch (err) {
    console.log(err)
}

# Response

On success, the endpoint will return this response:

{
  "id": "string",
  "total": 0,
  "currency": "string",
  "totalCurrencyAmount": {
    "amountBGN": 0,
    "amountEUR": 0
  },
  "createdOn": "2025-06-20T09:05:53.675Z",
  "active": true,
  "email": "string",
  "saleRows": [
    {
      "active": true,
      "cashReceiptPrinted": true,
      "createdOn": "2025-06-20T09:05:53.675Z",
      "id": "string",
      "kapschProperties": {
        "id": "string",
        "product": {
          "id": 0,
          "vehicleType": "car",
          "emissionClass": "none",
          "validityType": "day"
        },
        "status": 0,
        "vehicle": {
          "lpn": "string",
          "countryCode": "string"
        },
        "validity": {
          "requestedValidityStartDate": "2025-06-20T09:05:53.675Z",
        },
        "price": {
          "currency": "string",
          "amount": 0
        },
        "purchase": {
          "purchaseDateTimeUTC": "2025-06-20T09:05:53.675Z"
        }
      },
      "productsResponse": {
        "categoryDescriptionText": "string",
        "description": "string",
        "emissionClass": "none",
        "emissionClassText": "string",
        "id": 0,
        "mongoId": "string",
        "price": {
          "currency": "string",
          "amount": 0
        },
        "currencyAmount": {
          "amountBGN": 0,
          "amountEUR": 0
        },
        "productType": "TOLL",
        "productTypeLabel": "string",
        "validityType": "day",
        "validityTypeText": "string",
        "vehicleType": "car",
        "vehicleTypeText": "string"
      },
      "remoteClientId": "string",
      "stornoPrinted": true,
      "uniqueFiscalSaleId": "string"
    }
  ]
}

On error the endpoint will return this response

{
    "status": "string",
    "code": 0,
    "message": "string",
    "errors": []
}