Настройки на Barsy за Common Provider

Common Provider е универсален адаптер за интеграция с външни системи за управление на начисления. Чрез него Barsy може да се свърже с произволна система, която имплементира стандартния Common Provider API.

Насрещната истема е необходимо да поддържа следните API endpoints:

Search List

GET {api_url}/common_api/search_list

Отговорът следва да е във формат:

{
  "results": [
    {
      "search_value": "Стойност1",
      "search_title": "Наименование1"
    },
    {
      "search_value": "Стойност2",
      "search_title": "Наименование2"
    }
  ]
}

Add Charge

POST {api_url}/common_api/add_charge

Следва да приема следните параметри:

{
  "search_value": "Стойност1",
  "currency": "EUR",
  "service_date": "2026-03-05 14:30:00",
  "orders": [
    {
      "article_id": 1,
      "article_name": "Кафе еспресо",
      "price": 3.20,
      "quantity": 2,
      "tax_rate": 20
    },
    {
      "article_id": 2,
      "article_name": "Минерална вода",
      "price": 1.80,
      "quantity": 1,
      "tax_rate": 20
    }
  ]
}

А в случай на групиране:

{
  "search_value": "Стойност1",
  "currency": "EUR",
  "service_date": "2026-03-05 14:30:00",
  "groups": [
    {
      "group_name": "Артикули с ДДС 20% по сметка 5",
      "price": 8.20,
      "tax_rate": 20
    },
    {
      "group_name": "Артикули с ДДС 9% по сметка 5",
      "price": 4.50,
      "tax_rate": 9
    }
  ]
}

Грешки

При грешка се очаква резултат в следния формат:

{
  "message": "Описание на грешката на разбираем за потребителя език"
}