ペルー — 車両保険（SOAT）

エンドポイント

https://api.verifik.co/v2/pe/vehiculo/soat

本サービスは、ペルーにおける車両の保険ステータスに関する情報を提供します。保険会社名、契約開始日・終了日、車両のナンバープレート、契約番号、用途種別、車両クラス、契約ステータスなどの詳細を返します。

ヘッダー

名前	値
Content-Type	application/json
Authorization	Bearer <token>

パラメーター

名前	型	必須	説明
plate	string	はい	照会するナンバープレート。スペースやドットを含めずに入力してください。

リクエスト

JavaScript

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.verifik.co/v2/pe/vehiculo/soat',
  params: {plate: 'ABC123'},
    headers: {
    Accept: 'application/json',
    Authorization: 'jwt <your_token>'
  }
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/pe/vehiculo/soat?plate=", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/pe/vehiculo/soat?plate=")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in 
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/pe/vehiculo/soat?plate=');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}

レスポンス

200

{
  "data": {
    "plate": "ABC123",
    "soat": {
      "ConsultarSoatResult": {
        "NombreCompania": "Interseguro",
        "FechaInicio": "27/04/2022",
        "FechaFin": "27/04/2023",
        "Placa": "ABC123",
        "NúmeroPoliza": "000000000000000000001",
        "NombreUsovehiculo": "PARTICULAR",
        "NombreClasevehiculo": "AUTOMOVIL",
        "Estado": "VIGENTE",
        "CodigoUnicoPoliza": "0000000000000000000000008",
        "CodigoSBSAseguradora": "001",
        "FechaControlPolicial": "26/04/2022"
      }
    }
  },
  "signature": {
    "dateTime": "July 19, 2022 3:08 PM",
    "message": "Certified by Verifik.co"
  }
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

{
"code": "MissingParameter",
"message": "missing plate\n"
}

ユースケース

• SOAT 検証: 強制交通事故保険（SOAT）の現在の有効性を検証します。
• 保険サービス: 有効な契約および有効期限を検証します。
• 交通管理: 強制保険の遵守を検証します。
• 運送会社: フリート車両の保険を検証します。
• コンプライアンス検証: 契約の有効性を確認します。

機能

• ✅ ナンバープレートによる照会
• ✅ SOAT の完全な契約情報
• ✅ 保険会社名
• ✅ 契約開始日および終了日
• ✅ 契約ステータス（有効 / 無効）
• ✅ 一意の契約コード
• ✅ SBS 保険会社コード
• ✅ 警察管理日
• ✅ Verifik.co による認証済みレスポンス