Фінансові дані

Базова адреса для функцій роботи з даним розділом /finance/.

Історія курсів валют

GET /finance/currencies/rates/history

Вертає історію курсів валют за останніх сім днів від поточної дати.

{
  "history_rates": {
    "EUR": [
      {
        "period": "2018-03-08T12:09:54Z",
        "rate": 33.6500
      },
      {
        "period": "2018-03-09T12:09:54Z",
        "rate": 33.6500
      },
      {
        "period": "2018-03-10T12:09:54Z",
        "rate": 33.6500
      },
      {
        "period": "2018-03-11T12:09:54Z",
        "rate": 33.6500
      },
      {
        "period": "2018-03-12T12:09:54Z",
        "rate": 33.6500
      },
      {
        "period": "2018-03-13T12:09:54Z",
        "rate": 33.6500
      },
      {
        "period": "2018-03-14T12:09:54Z",
        "rate": 33.6500
      }
    ],
    "USD": [
      {
        "period": "2018-03-08T12:09:54Z",
        "rate": 27.2000
      },
      {
        "period": "2018-03-09T12:09:54Z",
        "rate": 27.2000
      },
      {
        "period": "2018-03-10T12:09:54Z",
        "rate": 27.2000
      },
      {
        "period": "2018-03-11T12:09:54Z",
        "rate": 27.2000
      },
      {
        "period": "2018-03-12T12:09:54Z",
        "rate": 27.2000
      },
      {
        "period": "2018-03-13T12:09:54Z",
        "rate": 27.2000
      },
      {
        "period": "2018-03-14T12:09:54Z",
        "rate": 27.2000
      }
    ]
  }
}

Примітка

Вертає історію тільки по певним валютам, набір валют не можна вказати

Поточні курси валют

GET /finance/currencies/rates
{
  "rates": [
    {
      "priority": 1,
      "rate": 29.80000000,
      "currency_name": "EUR"
    },
    {
      "priority": 2,
      "rate": 26.05000000,
      "currency_name": "USD"
    },
    {
      "priority": 3,
      "rate": 1.14400000,
      "currency_name": "EUR/USD"
    }
  ]
}

Список валют

GET /finance/currencies/list
{
  "currencies": [
    {
      "uuid": "A358000C2947F7AE11E23F5617780B16",
      "name": "ГРН"
    },
    {
      "uuid": "A358000C2947F7AE11E23F5617780B18",
      "name": "EUR"
    },
    {
      "uuid": "A358000C2947F7AE11E23F5617780B17",
      "name": "USD"
    }
  ]
}

Список договорів контрагента

GET /finance/contracts/list

Приклад відповіді:

{
  "contracts": [
    {
      "uuid": "812D000C2999A7E611E576524555E66B",
      "name": "Договор 1 (ГРН)",
      "code": "000007740",
      "allowed_sum": 10.00,
      "allowed_days": 2,
      "total": 0.0
    },
    {
      "uuid": "8165000C2999A7E611E6CDD59EA99E45",
      "name": "Договор 2 (EUR)",
      "code": "000015497",
      "allowed_sum": 100.00,
      "allowed_days": 1,
      "total": 0.58
    }
  ]
}

Інформація про договір

GET /finance/contract/(contract_uuid)
GET /finance/contract/default
Query Parameters:
 
  • contract_uuid – ID договору або ключове слово default.

Вертає наступну інформацію про договір:

  • дозвіл на відвантаження (Так/ні і текст) - shipment
  • інформація про договір - info
  • платіжний календар - payment_terms
  • сума боргу - credit

Дозвіл на відвантаження:

"shipment": {
  "allowed": true,
  "error": false,
  "message": "Отгрузка разрешена"
}

Сума боргу:

"credit": {
  "client_total": 350,
  "total": 350,
  "currency": "EUR"
}

Інформація про договір:

"info": {
  "allowed_sum": 600,
  "control_sum": true,
  "allowed_days": 600,
  "control_days": true,
  "uuid": "AB234...",
  "name": "название договора",
  "currency": "EUR",
  "available_days": 30,
  "exceeded_days": 0,
  "available_sum": 820,
  "exceeded_sum": 0
}

Платіжний календар:

"payment_terms": [
  {
    "transactions_day": "2018-01-01T00:00:00Z",
    "payment_day": "2018-01-11T00:00:00Z",
    "balance": 57,
    "balance_cumulative": 383
  }
]

QR код для оплати

GET /finance/payment/qr

Повертає зображення - qr код, який веде на сторінку оплати в Privat24.