Интерфейс за продуктови данни

Ако вече поддържате структуриран източник на продуктови данни, можем да го използваме като основа за актуализациите в PROVERI24.

Текущият стандартен формат за обмен е JSON. Преди активиране уточняваме източника, съпоставяме релевантните полета и валидираме примерен набор от данни.

Не е необходимо да разработвате специална интеграция за PROVERI24, ако вече разполагате с подходящ структуриран източник.

← За доставчици и партньори

Какво се поддържа в момента

Текуща спецификация
Формат	JSON
Схема	`proveri24.provider-offer.v1`
Идентичност на продукта	Стабилни providerId + productId
Актуализации	Предпочитат се пълни продуктови снимки
Времеви отметки	ISO 8601, когато са предоставени от доставчика
Публикуване	Данните се съпоставят и валидират преди да станат видими

Получаването на данни от структуриран източник не означава автоматично, че дадено предложение е обозначено като „потвърдено от доставчика“.

Процес на подготовка

Подготовката е съгласувана за конкретния източник. Активирането не е автоматично.

01
Източник
Определяме поддържания от доставчика източник, който следва да се използва.
02
Пример
Доставчикът предоставя представителен примерен набор или документация.
03
Съпоставяне
Съпоставяме релевантните продуктови полета към модела за сравнение в PROVERI24.
04
Валидация
Проверяваме структурата, задължителните полета и очевидни несъответствия.
05
Активиране
След преглед договореният източник може да се използва за следващи актуализации.

Структура на данните

Полетата по-долу съответстват на текущата схема. Не се изискват полета извън този договор.

Обвивка на набора

Поле	Тип	Наличност	Значение	Пример
schemaVersion	string	Задължително	Версия на публичния формат.	proveri24.provider-offer.v1
generatedAt	string (ISO 8601)	Задължително	Момент на генериране на набора.	2026-08-01T10:00:00.000Z
providerId	string	Задължително	Стабилен идентификатор на доставчика.	demo-insurer
providerName	string	Задължително	Наименование на доставчика.	Demo Insurer
contactEmail	string	Незадължително	Контакт за данни, ако е предоставен.	data@demo-insurer.example
offers	array	Задължително	Пълен набор от продукти в този запис.	[ … ]

Общи полета на продукт

Поле	Тип	Наличност	Значение	Пример
providerId	string	Задължително	Трябва да съвпада с providerId на набора.	demo-insurer
providerName	string	Задължително	Наименование на доставчика за този запис.	Demo Insurer
productId	string	Задължително	Стабилен идентификатор на продукта.	DI-HOME-STD
productName	string	Задължително	Наименование на продукта.	Demo Home Cover Standard
productCategory	string	Задължително	Категория в модела за сравнение.	home-insurance
vertical	string	Задължително	Направление: finance-banking, insurance, telecom или logistics.	insurance
applicationUrl	string (HTTP/HTTPS URL)	Задължително	Адрес към официалната заявка или продуктова страница.	https://demo-insurer.example/apply/home-standard
availability	string	Незадължително	available, temporarily_unavailable или discontinued. По подразбиране available.	available
sourceUpdatedAt	string (ISO 8601)	Задължително	Момент, към който доставчикът счита записа за актуален.	2026-08-01T09:30:00.000Z
sourceRecordId	string	Задължително	Уникален идентификатор на реда в набора.	demo-insurer-home-001
validFrom / validUntil	string (ISO 8601) or null	Незадължително	Период на валидност, ако е известен.	null
notes	string	Незадължително	Кратка бележка към записа.	-

Полета по категория

Освен общите полета, някои категории имат допълнителни полета. Конкретният набор се уточнява при съпоставянето.

finance-bankingcurrency (задължително). Незадължителни, когато са приложими: minAmount, maxAmount, minTermMonths, maxTermMonths, nominalInterestRate, apr, annualFee, fees, representativeExample.
insurancecurrency (задължително). Незадължителни: priceOnRequest, premiumAmount, premiumFrequency, coverageAmount, deductible, policyTermMonths. Ако priceOnRequest е true, premiumAmount може да липсва. В противен случай premiumAmount трябва да е положително число.
telecomcurrency и monthlyPrice (задължителни). Незадължителни: contractLengthMonths, dataAllowanceGb, minutesAllowance, smsAllowance, downloadSpeedMbps, channelsCount.
logisticscurrency и basePrice (задължителни). Незадължителни: maxWeightKg, deliverySpeedDays, serviceType.

Допълнителни параметри, които още не са моделирани изрично, могат да се предадат в attributes, ако това е договорено при съпоставянето.

Примерен JSON (фиктивен доставчик)

Примерът използва измислен доставчик. Не съдържа данни на реална компания.

{
  "schemaVersion": "proveri24.provider-offer.v1",
  "generatedAt": "2026-08-01T10:00:00.000Z",
  "providerId": "demo-insurer",
  "providerName": "Demo Insurer",
  "offers": [
    {
      "vertical": "insurance",
      "sourceRecordId": "demo-insurer-home-001",
      "providerId": "demo-insurer",
      "providerName": "Demo Insurer",
      "productId": "DI-HOME-STD",
      "productName": "Demo Home Cover Standard",
      "productCategory": "home-insurance",
      "currency": "EUR",
      "priceOnRequest": true,
      "applicationUrl": "https://demo-insurer.example/apply/home-standard",
      "sourceUpdatedAt": "2026-08-01T09:30:00.000Z",
      "availability": "available"
    }
  ]
}

Актуализации и версии

По подразбиране PROVERI24 не приема, че даден източник се актуализира в реално време.

Честотата на подаване или проверка се уточнява според конкретния източник.

За надеждно съпоставяне всеки продукт трябва да има стабилен идентификатор.

При несъвместима промяна на публичния формат се използва нова версия на схемата.

Публикуване и проверка

Данни, получени от източник на доставчика: Структуриран набор, който е съпоставен и преминал валидация.
Обозначение „потвърдено от доставчика“: Отделен статус на проверка. Не се присвоява само защото данните са получени от структуриран източник.

Получаването на данни от структуриран източник не означава автоматично, че дадено предложение е обозначено като „потвърдено от доставчика“. Статусът на източника и статусът на проверката се управляват отделно.

Други формати

Ако организацията вече поддържа друг машинно-четим формат или интерфейс, можем да го разгледаме в рамките на техническата подготовка. Поддържането му не се приема предварително и зависи от конкретния формат и начин на достъп.

Технически контакт

Пишете на contact@proveri24.com с кратко описание на източника и, ако е налично, примерен набор или документация.

За доставчици и партньори Формуляр за корекции

Какво се поддържа в момента

Процес на подготовка

Източник

Пример

Съпоставяне

Валидация

Активиране