GOSI 数据 API：工资、证明与 SANED

GOSI · 身份 4.7 ★

GOSI 是沙特社会保险总机构（General Organization for Social Insurance）的官方 Android 客户端，该机构为私营部门工人、雇主与受益人运行缴费型保险。通过 Nafath 数字确认（或已保存的生物识别解锁）后，缴费人可拉取工资与缴费证明、估算养老金、申请 SANED 失业险、更新待遇 IBAN，并离线保存电子证明；雇主在同一客户端切换到仪表盘、缴费人搜索、工资更新、证明签发与合规指标。可选的 Taqdeer 优惠、步数挑战与 Health Score 挨着保险台账。上架下载量 100 万+，约 10.06 万条评价给出 4.7 分；开发者栏为 General organization for social insurance - GOSI，地址利雅得 12315，支持邮箱 [email protected]。它是国家社保钱包而不是商业银行应用，旁边是作为身份轨道的 Nafath 与作为 OTP 通道的 Absher。

缴费工资行钉住 contributoryWage 对 monthlyContributoryWage 与 employerContributionAmount。证明卡片保留 certificateNumber 与 certificateType。待遇行带有 estimatedPension 与 kSanedBenefit；登录名片是 nationalIdentificationNumber 加 contributorId 与 ibanAccountNo。

薪酬台对账利雅得租户已经展示的同一 contributoryWage；证明柜台签发分享页已经列出的同一 certificateNumber；SANED 服务亭读取 kSanedBenefit 并旁置 estimatedPension——openData Studio 把这份保险台账变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

发起 Nafath 登录
POST /v1/gosi/nafath osint
用 nationalIdentificationNumber 发起 Nafath 登录，等待应用内数字确认。
认证方式：无需登录。请求体为 nationalIdentificationNumber。用户在 Nafath 应用中确认数字。
- nationalIdentificationNumber
- nafathCheck
- status
```
POST /v1/gosi/nafath HTTP/1.1
Content-Type: application/json
X-AppVersion: 3.2.41

{
  "nationalIdentificationNumber": "1098765432"
}
```
```
{
  "nafathCheck": true,
  "status": "PENDING"
}
```
兑换 Nafath 会话
POST /v1/gosi/session osint
把已确认的 Nafath 登录换成 accessToken 与 contributorName 名片。
认证方式： Nafath 确认后无需额外登录。响应 accessToken 在之后请求中作为 Authorization Bearer 发送。
- accessToken
- nationalIdentificationNumber
- contributorName
```
POST /v1/gosi/session HTTP/1.1
Content-Type: application/json
X-AppVersion: 3.2.41

{
  "nationalIdentificationNumber": "1098765432"
}
```
```
{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9...",
  "nationalIdentificationNumber": "1098765432",
  "contributorName": "AHMED ALI"
}
```
生物识别解锁
POST /v1/gosi/biometrics osint
解锁已登记的生物识别登录并返回 accessToken。
认证方式：先前登记后的设备生物识别断言。返回 accessToken。
- nationalIdentificationNumber
- accessToken
- status
```
POST /v1/gosi/biometrics HTTP/1.1
Content-Type: application/json
X-AppVersion: 3.2.41

{
  "nationalIdentificationNumber": "1098765432"
}
```
```
{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9...",
  "status": "OK"
}
```

登录缴费人资料

GET /v1/gosi/me osint

返回登录缴费人名片：姓名、contributorId 与 ibanAccountNo。

认证方式： POST /v1/gosi/session 签发的 Bearer accessToken。

nationalIdentificationNumber
contributorName
contributorNameArabic
contributorId
ibanAccountNo

GET /v1/gosi/me HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json

{
  "nationalIdentificationNumber": "1098765432",
  "contributorName": "AHMED ALI",
  "contributorNameArabic": "أحمد علي",
  "contributorId": 44102,
  "ibanAccountNo": "SA0380000000608010167519"
}

在册缴费人

GET /v1/gosi/contributors opendata

分页 ACTIVE 缴费人，含 occupationName 与 contributoryWage。

认证方式： Bearer accessToken。雇主会话分页 ACTIVE 行。

contributorId
contributorName
nationalIdentificationNumber
occupationName
contributoryWage

GET /v1/gosi/contributors?status=ACTIVE&pageNo=1 HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json

{
  "contributors": [{
    "contributorId": 44102,
    "contributorName": "AHMED ALI",
    "nationalIdentificationNumber": "1098765432",
    "occupationName": "Software Engineer",
    "contributoryWage": "12000.00"
  }]
}

工资摘要
GET /v1/gosi/wages openfinance
返回 contributoryWage、monthlyContributoryWage 与 employerContributionAmount。
认证方式： POST /v1/gosi/session 签发的 Bearer accessToken。
- contributoryWage
- monthlyContributoryWage
- averageMonthlyContributoryWageCalculation
- employerContributionAmount
- wpsWage
```
GET /v1/gosi/wages HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json
```
```
{
  "contributoryWage": "12000.00",
  "monthlyContributoryWage": "12000.00",
  "averageMonthlyContributoryWageCalculation": "11850.00",
  "employerContributionAmount": "1080.00",
  "wpsWage": "12000.00"
}
```
证明目录
GET /v1/gosi/certificates opendata
列出可签发证明，含 certificateNumber 与 certificateType。
认证方式： Bearer accessToken。访客预登录核验用 certificateNumber 加国民身份证，无需会话。
- certificateNumber
- certificateType
- certificateWccId
- status
```
GET /v1/gosi/certificates HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json
```
```
{
  "certificates": [{
    "certificateNumber": "WCC-88421",
    "certificateType": "WAGE",
    "certificateWccId": "wcc-88421",
    "status": "READY"
  }]
}
```

签发证明

POST /v1/gosi/certificates/issue opendata

签发工资、缴费或待遇证明，返回 certificateNumber。

认证方式： POST /v1/gosi/session 签发的 Bearer accessToken。

certificateType
language
certificateNumber
status

POST /v1/gosi/certificates/issue HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "certificateType": "WAGE",
  "language": "en"
}

{
  "certificateNumber": "WCC-88421",
  "certificateType": "WAGE",
  "status": "READY"
}

既有待遇

GET /v1/gosi/benefits openfinance

返回 estimatedPension、kTotalMonthlyBenefit 与 benefitHistory 行。

认证方式： POST /v1/gosi/session 签发的 Bearer accessToken。

estimatedPension
kTotalMonthlyBenefit
eligibleToGetBenefit
kBenefitName
kMonthlyBenefit

GET /v1/gosi/benefits HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json

{
  "estimatedPension": "4800.00",
  "kTotalMonthlyBenefit": "4800.00",
  "eligibleToGetBenefit": true,
  "benefitHistory": [{
    "kBenefitName": "Retirement",
    "kMonthlyBenefit": "4800.00"
  }]
}

SANED 历史
GET /v1/gosi/saned opendata
返回 SANED 失业险状态与 kSanedBenefit。
认证方式： Bearer accessToken。部分 SANED 步骤还以 X-Otp 发送 Absher OTP。
- kSanedBenefit
- status
- eligibleToGetBenefit
```
GET /v1/gosi/saned HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json
```
```
{
  "kSanedBenefit": "2000.00",
  "status": "ELIGIBLE",
  "eligibleToGetBenefit": true
}
```

更新待遇 IBAN

POST /v1/gosi/iban openfinance

提交新的 ibanAccountNo 用于养老金或待遇发放。

认证方式： POST /v1/gosi/session 签发的 Bearer accessToken。

ibanAccountNo
status

POST /v1/gosi/iban HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Content-Type: application/json

{
  "ibanAccountNo": "SA0380000000608010167519"
}

{
  "ibanAccountNo": "SA0380000000608010167519",
  "status": "PENDING"
}

机构资料
GET /v1/gosi/establishment opendata
返回雇主 establishmentRegistrationNo 与 unpaidEstablishmentList。
认证方式：雇主会话上的 Bearer accessToken。
- establishmentRegistrationNo
- establishmentRegistrationNumber
- totalNoOfEstablishments
- unpaidEstablishmentList
```
GET /v1/gosi/establishment HTTP/1.1
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...
Accept: application/json
```
```
{
  "establishmentRegistrationNo": "7001234567",
  "establishmentRegistrationNumber": "7001234567",
  "totalNoOfEstablishments": 1,
  "unpaidEstablishmentList": []
}
```

数据类别

身份
缴费人
工资
证明
待遇
SANED
IBAN
机构
登录会话

数据使用场景与案例

对照机构台账的薪酬工资对账
人事拉取 GET /v1/gosi/wages（contributoryWage、monthlyContributoryWage、employerContributionAmount）并旁置 GET /v1/gosi/contributors，让申报工资在 WPS 报送前与 GOSI 台账一致。
人事入职证明台
用工台读取 GET /v1/gosi/certificates 再 POST /v1/gosi/certificates/issue（certificateNumber、certificateType），让工资或缴费证明不必去网点即可归档。
SANED 资格核验
待遇服务亭读取 GET /v1/gosi/saned（kSanedBenefit、eligibleToGetBenefit）并旁置 GET /v1/gosi/benefits（estimatedPension），让失业与养老金芯片落在同一张卡上。
IBAN 发放更新
养老金发放台在 GET /v1/gosi/me 之后 POST /v1/gosi/iban（ibanAccountNo），让新的沙特 IBAN 记在同一 contributorId 下。

常见问题

GOSI 如何认证 API 调用？

POST /v1/gosi/nafath 用 nationalIdentificationNumber 发起 Nafath 确认。POST /v1/gosi/session 把它换成 accessToken。POST /v1/gosi/biometrics 解锁已保存的生物识别。之后的请求发送 Authorization Bearer accessToken。

哪些端点暴露工资与缴费人？

GET /v1/gosi/wages 返回 contributoryWage、monthlyContributoryWage 与 employerContributionAmount。GET /v1/gosi/contributors 分页带 occupationName 的 ACTIVE 行。GET /v1/gosi/me 返回 contributorId 与 ibanAccountNo。

返回哪些证明与待遇字段？

GET /v1/gosi/certificates 列出 certificateNumber 与 certificateType。POST /v1/gosi/certificates/issue 签发一张。GET /v1/gosi/benefits 返回 estimatedPension。GET /v1/gosi/saned 返回 kSanedBenefit。

API 是否覆盖 IBAN 更新与机构？

覆盖。POST /v1/gosi/iban 提交 ibanAccountNo。GET /v1/gosi/establishment 在雇主会话上返回 establishmentRegistrationNo 与 unpaidEstablishmentList。

与 GOSI 相似的应用

VssID — VssID 是越南社保的公民自助客户端，带电子手册与 BHYT 卡；GOSI 是沙特对照，带工资证明、SANED 与 Nafath 登录。
Pak Identity — Pak Identity 是 NADRA 的 CNIC 保险库；GOSI 则在 Nafath 确认后以社保工资、证明与待遇 IBAN 为中心。
Налоги ФЛ — Налоги ФЛ 是俄罗斯联邦税务局自助客户端；GOSI 是沙特社保台账，而不是税务柜。
Microsoft Authenticator — Microsoft Authenticator 存放工作或学校 OTP；GOSI 把 Nafath 当作国家身份轨道，并用可选的本机生物识别打开同一保险账户。
Absher — Absher 是内政部国家服务应用，也是 GOSI 部分 SANED 步骤使用的 OTP 通道；GOSI 本身是社保钱包。
Nafath — Nafath 是国家数字身份确认应用：GOSI 在那里发起数字确认，再把它换成保险会话。
DigiLocker — DigiLocker 是印度的已签发证件钱包；GOSI 的工资与缴费证明在沙特社保里扮演同一角色。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

GOSI 数据 API：工资、证明与 SANED

应用截图

API 端点一览

发起 Nafath 登录

兑换 Nafath 会话

生物识别解锁

登录缴费人资料

在册缴费人

工资摘要

证明目录

签发证明

既有待遇

SANED 历史

更新待遇 IBAN

机构资料

数据类别

数据使用场景与案例

对照机构台账的薪酬工资对账

人事入职证明台

SANED 资格核验

IBAN 发放更新

常见问题

与 GOSI 相似的应用

更多身份类应用

Microsoft Authenticator

Pak Identity

VssID

Налоги ФЛ

相关主题

需要集成这个 App 的数据 API？

GOSI 数据 API：工资、证明与 SANED

应用截图

API 端点一览

发起 Nafath 登录

兑换 Nafath 会话

生物识别解锁

登录缴费人资料

在册缴费人

工资摘要

证明目录

签发证明

既有待遇

SANED 历史

更新待遇 IBAN

机构资料

数据类别

数据使用场景与案例

对照机构台账的薪酬工资对账

人事入职证明台

SANED 资格核验

IBAN 发放更新

常见问题

相关应用

与 GOSI 相似的应用

更多身份类应用

Microsoft Authenticator

Pak Identity

VssID

Налоги ФЛ

相关主题

需要集成这个 App 的数据 API？