Эндпоинт расчёта VAT

GET

calculate

curl --request GET \
  --url https://vat.cleariflow.com/v1/calculate/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://vat.cleariflow.com/v1/calculate/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://vat.cleariflow.com/v1/calculate/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://vat.cleariflow.com/v1/calculate/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "amount_excluding_vat": "175.00",
    "amount_including_vat": "208.25",
    "country": {
        "code": "DE",
        "name": "Germany"
    },
    "vat_amount": "33.25",
    "vat_category": "standard",
    "vat_rate": "0.190"
}

Начало работы

Базовый URL

https://vat.cleariflow.com/v1/calculate/

Эндпоинт расчёта

Эндпоинт calculate требует ваш уникальный API-ключ, страну и сумму для расчёта:

https://vat.cleariflow.com/v1/calculate/
? api_key = YOUR_UNIQUE_API_KEY
& amount = 175  
& country_code = DE
& category = standard

Успешный запрос возвращает полные результаты расчёта VAT: ставки, суммы и информацию о стране:

{
    "amount_excluding_vat": "175.00",
    "amount_including_vat": "208.25",
    "country": {
        "code": "DE",
        "name": "Germany"
    },
    "vat_amount": "33.25",
    "vat_category": "standard",
    "vat_rate": "0.190"
}

Параметры запроса

String

обязательно

Ваш уникальный API-ключ. У каждого пользователя уникальные ключи для каждого API Cleariflow, поэтому ключ API проверки VAT не будет работать, например, с API геолокации IP.

String

обязательно

Сумма, для которой нужно получить или рассчитать VAT.

String

обязательно

Двухбуквенный ISO 3166-1 alpha-2 код страны, в которой совершается транзакция.

String

обязательно

Категория VAT для расчёта. Используйте «standard» для стандартной ставки или конкретные категории вроде «e-books», «audiobooks» и т.д. для пониженных ставок.

Boolean

Если сумма уже включает VAT и нужен обратный расчёт с разделением суммы и VAT, установите true. Если параметр не указан явно, по умолчанию false.

Параметры ответа

Ответ API возвращается в универсальном лёгком формате JSON.

String

Сумма без VAT.

String

Сумма базовой суммы и VAT, т.е. amount_excluding_vat + vat_amount.

String

Рассчитанная сумма VAT.

String

Категория покупки, определяющая право на пониженную ставку. См. список поддерживаемых категорий ниже.

String

Ставка VAT в виде десятичной строки (например, «0.190» для 19%).

Object

Объект с информацией о стране.

String

Двухбуквенный ISO 3166-1 alpha-2 код страны, в которой совершается транзакция.

String

Название страны, для которой рассчитывается VAT.

Эндпоинт расчёта VAT

curl --request GET \
  --url https://vat.cleariflow.com/v1/calculate/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://vat.cleariflow.com/v1/calculate/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://vat.cleariflow.com/v1/calculate/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://vat.cleariflow.com/v1/calculate/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
    "amount_excluding_vat": "175.00",
    "amount_including_vat": "208.25",
    "country": {
        "code": "DE",
        "name": "Germany"
    },
    "vat_amount": "33.25",
    "vat_category": "standard",
    "vat_rate": "0.190"
}

Проверка

Поиск

Создание

Эндпоинт расчёта VAT

Начало работы

Базовый URL

Эндпоинт расчёта

Параметры запроса

Параметры ответа

​Начало работы

​Базовый URL

​Эндпоинт расчёта

​Параметры запроса

​Параметры ответа

Начало работы

Базовый URL

Эндпоинт расчёта

Параметры запроса

Параметры ответа