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

Базова адреса для функцій роботи з даним розділом /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,
    "message": "Отгрузка разрешена"
}

Сума боргу:

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

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

"info": {
    "allowed_sum": 600,
    "control_sum": True,
    "allowed_days": 600,
    "control_days": True,
    "uuid": "AB234...",
    "name": "название договора",
    "currency": "EUR"
}

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

"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.