U: v3/new-tax-control-fapiao/*

TheNorthMemory · May 11, 2024 · 6920d04 · 6920d04
1 parent 4889b6f
commit 6920d04
Show file tree

Hide file tree

Showing 8 changed files with 95 additions and 14 deletions.
diff --git a/docs/v3/new-tax-control-fapiao/fapiao-applications.yaml b/docs/v3/new-tax-control-fapiao/fapiao-applications.yaml
@@ -1,5 +1,5 @@
 post:
-  x-last-updated-at: 2022.01.25
+  x-last-updated-at: 2023.10.12
   x-role:
     - 直连商户
     - 服务商
@@ -115,8 +115,20 @@ post:
                     properties:
                       tax_code:
                         type: string
-                        description: 货物或应税劳务、服务编码
+                        description: 税局侧规定的货物或应税劳务、服务税收分类编码
                         example: '3010101020203000000'
+                      goods_category:
+                        type: string
+                        description: 税局侧规定的货物或应税劳务、服务分类名称
+                        example: 运输服务
+                      goods_name:
+                        type: string
+                        description: 货物或应税劳务、服务名称
+                        example: 出租汽车客运服务
+                      goods_id:
+                        type: number
+                        description: 企业侧维护的货物或应税劳务、服务编码
+                        example: 1
                       specification:
                         type: string
                         description: 规格型号
@@ -133,6 +145,14 @@ post:
                         type: integer
                         description: 单行金额合计
                         example: 429900
+                      tax_rate:
+                        type: number
+                        description: 税率
+                        example: 1300
+                      tax_prefer_mark:
+                        type: string
+                        description: 税收优惠政策标识
+                        example: NO_FAVORABLE
                       discount:
                         type: boolean
                         description: 是否折扣行

diff --git a/docs/v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/fapiao-files.yaml b/docs/v3/new-tax-control-fapiao/fapiao-applications/{fapiao_apply_id}/fapiao-files.yaml
@@ -25,4 +25,25 @@ get:
       example: '20200701123456'
   responses:
     '200':
-      schema: {}
+      schema:
+        type: object
+        properties:
+          fapiao_download_info_list:
+            type: array
+            description: 发票列表
+            items:
+              type: object
+              required: []
+              properties:
+                fapiao_id:
+                  type: string
+                  description: 商户发票单号
+                  example: '20200701123456'
+                download_url:
+                  type: string
+                  description: 发票文件下载地址
+                  example: https://pay.wechatpay.cn/invoicing/fapiao/fapiao-file
+                status:
+                  type: string
+                  description: 发票状态
+                  example: ISSUE_ACCEPTED
diff --git a/docs/v3/new-tax-control-fapiao/merchant/development-config.yaml b/docs/v3/new-tax-control-fapiao/merchant/development-config.yaml
@@ -1,5 +1,5 @@
 patch:
-  x-last-updated-at: 2022.01.13
+  x-last-updated-at: 2023.10.12
   x-role:
     - 直连商户
     - 服务商
@@ -14,13 +14,19 @@ patch:
       required: true
       schema:
         type: object
-        required:
-          - callback_url
         properties:
           callback_url:
             type: string
             description: 商户回调地址
             example: https://pay.weixin.qq.com/callback
+          sub_mch_code:
+            type: string
+            description: 子商户号
+            example: '1900000109'
+          show_fapiao_cell:
+            type: boolean
+            description: 全部账单展示开发票入口开关
+            example: false
   responses:
     '200':
       schema:
@@ -32,8 +38,12 @@ patch:
             type: string
             description: 商户回调地址
             example: https://pay.weixin.qq.com/callback
+          show_fapiao_cell:
+            type: boolean
+            description: 全部账单展示开发票入口开关
+            example: false
 get:
-  x-last-updated-at: 2022.01.13
+  x-last-updated-at: 2023.10.12
   x-role:
     - 直连商户
     - 服务商
@@ -54,3 +64,7 @@ get:
             type: string
             description: 商户回调地址
             example: https://pay.weixin.qq.com/callback
+          show_fapiao_cell:
+            type: boolean
+            description: 全部账单展示开发票入口开关
+            example: false
diff --git a/docs/v3/new-tax-control-fapiao/merchant/tax-codes.yaml b/docs/v3/new-tax-control-fapiao/merchant/tax-codes.yaml
@@ -1,5 +1,5 @@
 get:
-  x-last-updated-at: 2021.11.22
+  x-last-updated-at: 2023.10.12
   x-role:
     - 直连商户
     - 服务商
@@ -70,14 +70,22 @@ get:
                 - tax_rate
                 - tax_prefer_mark
               properties:
+                goods_name:
+                  type: string
+                  description: 由商户自定义的货物或应税劳务、服务名称
+                  example: example_goods_name
+                goods_id:
+                  type: number
+                  description: 企业侧维护的货物或应税劳务、服务编码
+                  example: 1
+                goods_category:
+                  type: string
+                  description: 税局侧规定的货物或应税劳务、服务分类名称
+                  example: 出租汽车客运服务
                 tax_code:
                   type: string
                   description: 货物或应税劳务、服务编码
                   example: '3010101020203000000'
-                goods_name:
-                  type: string
-                  description: 货物或应税劳务、服务名称
-                  example: 出租汽车客运服务
                 tax_rate:
                   type: integer
                   description: 税率

diff --git a/docs/v3/new-tax-control-fapiao/user-title.yaml b/docs/v3/new-tax-control-fapiao/user-title.yaml
@@ -1,5 +1,5 @@
 get:
-  x-last-updated-at: 2021.11.22
+  x-last-updated-at: 2023.10.12
   x-role:
     - 直连商户
     - 服务商

diff --git a/docs/v3/new-tax-control-fapiao/user-title/title-url.yaml b/docs/v3/new-tax-control-fapiao/user-title/title-url.yaml
@@ -1,5 +1,5 @@
 get:
-  x-last-updated-at: 2021.11.22
+  x-last-updated-at: 2023.10.12
   x-role:
     - 直连商户
     - 服务商
@@ -82,3 +82,7 @@ get:
             type: string
             description: 抬头填写小程序页面路径
             example: pages/xxxPage
+          miniprogram_user_name:
+            type: string
+            description: 抬头填写小程序的用户名
+            example: gh_86a091e50ad4@app
diff --git a/src/V3/NewTaxControlFapiao/FapiaoApplications.php b/src/V3/NewTaxControlFapiao/FapiaoApplications.php
@@ -39,10 +39,15 @@ public function post(array $options = [
                 'remark' => '备注',
                 'items' => [[
                     'tax_code' => '3010101020203000000',
+                    'goods_category' => '运输服务',
+                    'goods_name' => '出租汽车客运服务',
+                    'goods_id' => 1,
                     'specification' => 'A4',
                     'unit' => '次',
                     'quantity' => 100000000,
                     'total_amount' => 429900,
+                    'tax_rate' => 1300,
+                    'tax_prefer_mark' => 'NO_FAVORABLE',
                     'discount' => true,
                 ],],
             ],],
@@ -80,10 +85,15 @@ public function postAsync(array $options = [
                 'remark' => '备注',
                 'items' => [[
                     'tax_code' => '3010101020203000000',
+                    'goods_category' => '运输服务',
+                    'goods_name' => '出租汽车客运服务',
+                    'goods_id' => 1,
                     'specification' => 'A4',
                     'unit' => '次',
                     'quantity' => 100000000,
                     'total_amount' => 429900,
+                    'tax_rate' => 1300,
+                    'tax_prefer_mark' => 'NO_FAVORABLE',
                     'discount' => true,
                 ],],
             ],],

diff --git a/src/V3/NewTaxControlFapiao/Merchant/DevelopmentConfig.php b/src/V3/NewTaxControlFapiao/Merchant/DevelopmentConfig.php
@@ -17,6 +17,8 @@ interface DevelopmentConfig
     public function patch(array $options = [
         'json' => [
             'callback_url' => 'https://pay.weixin.qq.com/callback',
+            'sub_mch_code' => '1900000109',
+            'show_fapiao_cell' => true,
         ],
     ]): ResponseInterface;
 
@@ -28,6 +30,8 @@ public function patch(array $options = [
     public function patchAsync(array $options = [
         'json' => [
             'callback_url' => 'https://pay.weixin.qq.com/callback',
+            'sub_mch_code' => '1900000109',
+            'show_fapiao_cell' => true,
         ],
     ]): PromiseInterface;