---
# System prepended metadata

title: 發票登入SOP
tags: [開發文件]

---

---
title: 發票登入SOP
tags: 開發文件
---

# 發票登入SOP

### 9F給10F串接的API文件：
[For 10F 發票怪獸 api](https://docs.google.com/spreadsheets/d/1zxAhRDGkencfhjnCC0IhoFXXFpmEOtaV-gCzYbveFtQ/edit?pli=1#gid=678021954)

### 登入發票活動用API：
[0_發票登入 API 的範本](https://docs.google.com/spreadsheets/d/1SuIDAs26dCfCe3fSBouxcne5UGif70XVoC1Z4Y4bi7I/edit#gid=1868766499)


- 統一基本的6支API (欄位規則：小駝峰)
    1. invoice：登入電子發票
    2. invoiceImg：登入傳統發票
    3. invoiceCarrier：載具登入
    4. awards：取得得獎名單
    5. recipientinfo/{code}：驗證得獎資格
    6. recipientinfo：得獎寄送資訊回填

### 步驟：

1. 開立專案與對應的campaign_id
   DB - Campaign、InvoiceCampaign
2. 確認9F已匯入相關的關鍵字與act_id，act_id與campaign_id相同
3. 確認獎項 與 抽獎方式，並同步與PM 溝通 lotteryCode 規則
4. 建立後台抽獎所需的測試資料
5. 確認前端得獎名單如何組合

### 注意事項：

- 傳統發票只存在10F
- 載具抓取時間為凌晨 3:00，耗時約莫2~4小時
- 傳統發票為上傳圖片人工審核

### 匯入功能：
- [x] 傳統發票
- [x] 特殊資格驗證 (待修改)
- [ ] 得獎結果匯入 （執行中）
