Surat Kuasa Pendebitan Rekening (SKPR)

Surat Kuasa Pendebitan Rekening (SKPR).

SKPR Object

Name
status
Type
string
Description
Enum code indicating the status of the reading result.
1. SUCCESS
2. NO_FILE
3. FILE_INVALID_FORMAT
4. FAILED
Name
reason
Type
string
Description
A human-readable message providing more details about the reading result.
Name
read
Type
object
Description
Contains the extracted information for each field in the SKPR. Each fields has value (The reading), value_original, page_index, polygon (coordinates of the value: top-left, top-right, bottom-right, bottom-left), confidence (in percentage), and confidence_text.
- Name
  debit_account_request_type
  Type
  string
  Description
  A checklist option of the debit account request type between: new_request or change_request
- Name
  complete_name
  Type
  string
  Description
  The complete name of the applicant.
- Name
  id_card_number
  Type
  string
  Description
  The applicant’s id card number.
- Name
  validity_period
  Type
  string
  Description
  The validity period of the applicant’s id
- Name
  act_for
  Type
  string
  Description
  Apply as between : individual, business_entity, parent
- Name
  position
  Type
  string
  Description
  The applicant’s position if acting as the business entity.
- Name
  company_name
  Type
  string
  Description
  The applicant’s company name if acting as the business entity.
- Name
  address
  Type
  string
  Description
  The correspondent address of the applicant.
- Name
  rt_rw
  Type
  string
  Description
  The RT/RW of the applicant.
- Name
  district
  Type
  string
  Description
  The applicant’s district.
- Name
  city
  Type
  string
  Description
  The correspondence city.
- Name
  zip_code
  Type
  string
  Description
  The applicant’s zip code.
- Name
  province
  Type
  string
  Description
  The applicant’s province.
- Name
  attorney_in_fact_name
  Type
  string
  Description
  The attorney-in-fact’s name
- Name
  attorney_in_fact_address
  Type
  string
  Description
  The address of the attorney-in-fact.
- Name
  attorney_in_fact_id_card_number
  Type
  string
  Description
  The id card number of the attorney-in-fact.
- Name
  attorney_in_fact_company_code
  Type
  string
  Description
  The company name of the attorney-in-fact.
- Name
  office_phone
  Type
  string
  Description
  The office phone number.
- Name
  home_phone
  Type
  string
  Description
  The applicant’s home phone number.
- Name
  mobile_phone_number_1
  Type
  string
  Description
  The applicant’s mobile phone number.
- Name
  mobile_phone_number_2
  Type
  string
  Description
  The applicant’s mobile phone number.
- Name
  account_number
  Type
  string
  Description
  The applicant’s account number.
- Name
  email_address
  Type
  string
  Description
  The applicant’s email address.
- Name
  bank_name
  Type
  string
  Description
  The applicant’s bank name.
- Name
  account_currency
  Type
  string
  Description
  The currency used in the account. The checklist values are between: IDR, USD, other_currencies.
- Name
  policy_currency
  Type
  string
  Description
  The currency used in the policy. The checklist values are between: IDR, USD, other_currencies.
- Name
  policy_amount
  Type
  string
  Description
  The policy amount.
- Name
  signing_date
  Type
  string
  Description
  The signing date.
- Name
  signing_location
  Type
  string
  Description
  The signing location.
- Name
  bank_account_details
  Type
  array of object
  Description
  Information for each bank account in the document
  Name
  bank_account_number
  Type
  string
  Description
  The applicant’s bank account number.
  Name
  bank_account_owner_name
  Type
  string
  Description
  The bank account owner’s name.
- Name
  policy_details
  Type
  array of object
  Description
  Information for each policy in the document
  Name
  policy_number
  Type
  string
  Description
  The premium’s policy number.
  Name
  policyholder_name
  Type
  string
  Description
  The name of the policy holder.
  Name
  relationship_with_policyholder
  Type
  string
  Description
  The relationship of the applicant with the policyholder. The options are as such: spouse, child, parent, sibling, guardian, myself, business_entity, other_relationshop

POST/ocr/v1/skpr

Read SKPR

Detects a valid SKPR image and returns the information as text.

Required parameter

Name
image
Type
file (.png, .jpg, .jpeg, .tiff, .pdf)
Description
The image file for the SKPR.

Sample Request

POST

/ocr/v1/skpr


    1
2
3
4
5

    import { Vision } from '@glair/vision';

const vision = new Vision({ apiKey: 'api-key', username: 'username', password: 'password' });

await vision.ocr.skpr({ image: '/path/to/image/SKPR.jpg' });

Sample Response


    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258

    {
  "status": "SUCCESS",
  "reason": "File Successfully Read",
  "read": {
    "debit_account_request_type": {
      "value": "Pengajuan Pendebetan Rekening",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "complete_name": {
      "value": "BILLY BUMBLEBEE SIFULAN",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "id_card_number": {
      "value": "3175070101909999",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "validity_period": {
      "value": "1 Year",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "act_for": {
      "value": "untuk diri sendiri",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "position": {
      "value": "Supervisor",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "company_name": {
      "value": "Best Company Ltd",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "address": {
      "value": "JL DIMANA NO 100, ANTAH BERANTAH, DUREN SAWIT, DKI JAKARTA",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "rt_rw": {
      "value": "02/01",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "district": {
      "value": "Central District",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "city": {
      "value": "Sampletown",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "zip_code": {
      "value": "12345",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "province": {
      "value": "Sample Province",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "attorney_in_fact_name": {
      "value": "PT. Asuransi Jiwa Sequis Life",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "attorney_in_fact_address": {
      "value": "Sequis Tower Level 33, Jl. Jend. Sudirman No. 71, SCBD Jakarta",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "attorney_in_fact_id_card_number": {
      "value": "123456",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "attorney_in_fact_company_code": {
      "value": "00350286",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "office_phone": {
      "value": "123-456-789",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "home_phone": {
      "value": "987-654-321",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "mobile_phone_number_1": {
      "value": "123-456-7890",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "mobile_phone_number_2": {
      "value": "123-456-7890",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "account_number": {
      "value": "1234567890",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "email_address": {
      "value": "email@company.com",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "bank_name": {
      "value": "Swiss Bank",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "account_currency": {
      "value": "IDR",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "policy_currency": {
      "value": null,
      "page_index": null,
      "polygon": null,
      "confidence": null,
      "confidence_text": null
    },
    "policy_amount": {
      "value": null,
      "page_index": null,
      "polygon": null,
      "confidence": null,
      "confidence_text": null
    },
    "signing_date": {
      "value": "2021-02-21",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "signing_location": {
      "value": "Sample City",
      "page_index": 0,
      "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
      "confidence": 99,
      "confidence_text": 99
    },
    "bank_account_details": [
      {
        "bank_account_number": {
          "value": "98765432",
          "page_index": 0,
          "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
          "confidence": 99,
          "confidence_text": 99
        }
      },
      {
        "bank_account_owner_name": {
          "value": "Bob Smith",
          "page_index": 0,
          "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
          "confidence": 99,
          "confidence_text": 99
        }
      }
    ],
    "policy_details": [
      {
        "policy_number": {
          "value": "POL12345",
          "page_index": 0,
          "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
          "confidence": 99,
          "confidence_text": 99
        }
      },
      {
        "policyholder_name": {
          "value": "Eva Martinez",
          "page_index": 0,
          "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
          "confidence": 99,
          "confidence_text": 99
        }
      },
      {
        "relationship_with_policyholder": {
          "value": "Spuouse",
          "page_index": 0,
          "polygon": [[0, 0], [1, 0], [1, 1], [0, 1]],
          "confidence": 99,
          "confidence_text": 99
        }
      }
    ]
  }
}

Request ID

An associated request identifier is generated for every request made to this endpoint. This value can be found in the response headers under Request-Id

Responses

Various responses for this endpoint, in addition to general responses specified in Errors.

`200 - OK`

Request with readable SKPR image

Response


    1
2
3
4
5

    {
  "status": "SUCCESS",
  "reason": "File Successfully Read",
  //...,
}

// TODO: no "Request with non SKPR File"?

`400 - Bad Request`

Request without form-data image

Response


    1
2
3
4
5

    {
  "status": "NO_FILE",
  "reason": "No file in request body",
  //...,
}

`415 - Unsupported Media Type`

Request with non-image file format

Response


    1
2
3
4
5

    {
  "status": "FILE_INVALID_FORMAT",
  "reason": "Failed to process invalid file format. Please upload the correct file format",
  //...,
}