批量申请开票

接口说明

提交票源数据到数电管理平台，提交后的票源将会按照业务规则自动或手动进入开票流程,平台对票源数据进行同步校验，如果返回0代表校验通过，否则会失败，在校验之后平台会对票源数据进行写入处理，写入最终结果会在票源处理回调事件中进行推送。

交付配置

包括是否显示销方信息、购方信息、AR人员信息、是否审批、需要的发票格式、联系人信息、使用的邮件模板、发票文件命名规则、备注命名规则等等...

关于参数对交付结果的影响

由于 buyerTaxId、groupName、designatedEmail 这三个参数是可以为空的，所以下表是不同字段存在/不存在对应数据所造成的影响。

buyerTaxId 购方税号	groupName 组名	designatedEmail 指定交付邮箱	buyerName 购方名称	ToWho? 邮件发给谁?	deliveryConfig 交付配置
✅	✅	✅	`可空`	`designatedEmail`	`组别配置`
✅	✅	✖	`可空`	`联系人邮箱`	`组别配置`
✖	✖	✅	`必填`	`designatedEmail`	`默认配置`
✖	✅	✅	`必填`	`designatedEmail`	`默认配置`
✅	✖	✖	`可空`	找不到接受人	报错
✖	✖	✖	`必填`	找不到接受人	报错
✖	✅	✖	`必填`	只给组名没有意义	报错

请求参数

Body 参数application/json

jobCode

string

任务编号

必需

>= 1 字符<= 50 字符

serverCode

enum<string>

服务名称

必需

>= 1 字符<= 50 字符

枚举值:

SubmitInvoiceSource

params

object

提交参数

必需

batchNumber

string

批次号

必需

>= 1 字符<= 18 字符

sellerTaxId

string

销方税号

必需

invoiceList

array [object {19}]

开票数据列表

必需

>= 1 items<= 3 items

示例

{
  "jobCode": "4b8FFFda-dA5F-8b7f-dfB7-eF8362A7dBbE",
  "serverCode": "DeleteDataSource",
  "params": {
    "batchNumber": "d7DC59BB-F7Ba-6C4C-c7b2-B1ee476Ee6f4",
    "sellerTaxId": "cCEdAD49-3D14-87E0-8F3B-016cc8BAF1A4",
    "invoiceList": [
      {
        "invoiceCode": "1fce4832-fBD6-Efdd-E98E-E1E04B6E8427",
        "blueInvoiceNumber": "71",
        "taxIncluded": 1,
        "invoiceType": "外销发票",
        "invoiceCategory": "蓝票",
        "needDelivery": 1,
        "deliveryGourpName": "了要体",
        "groupName": "展证十示",
        "designatedEmail": "y.tti@qq.com",
        "buyerTaxId": "95",
        "buyerName": "增当和众角",
        "bizType": "eiusmod ea",
        "docType": null,
        "rpni": "nostrud ut eu Ut",
        "remarks": "in voluptate Lorem",
        "customParams1": "exercitation",
        "customParams2": null,
        "customParams3": "veniam",
        "list": [
          {
            "index": 48,
            "taxCategory": "ut ipsum amet dolor",
            "taxCode": "57",
            "productName": "全声和热",
            "specification": "sed ea elit",
            "unit": "magna",
            "unitPrice": 26,
            "quantity": 34,
            "invoiceAmount": 72,
            "taxRate": 91,
            "discountAmount": 48,
            "jzjtlx": "officia nisi aute dolore",
            "yhzclx": "labore occaecat minim in sint",
            "sfsyyhzc": 15,
            "remarks": "aliquip occaecat non"
          },
          {
            "index": 57,
            "taxCategory": "amet eu enim irure",
            "taxCode": "25",
            "productName": "直始影究毛真",
            "specification": "fugiat officia ut",
            "unit": "aliquip nisi fugiat",
            "unitPrice": 49,
            "quantity": 40,
            "invoiceAmount": 48,
            "taxRate": 25,
            "discountAmount": 51,
            "jzjtlx": "officia ipsum reprehenderit ut",
            "yhzclx": "dolore incididunt",
            "sfsyyhzc": 51,
            "remarks": "enim ex"
          },
          {
            "index": 17,
            "taxCategory": "est",
            "taxCode": "97",
            "productName": "道口油高习越",
            "specification": "sed",
            "unit": "nisi officia",
            "unitPrice": 40,
            "quantity": 3,
            "invoiceAmount": 16,
            "taxRate": 98,
            "discountAmount": 21,
            "jzjtlx": "in magna eu aliqua dolor",
            "yhzclx": "velit quis mollit dolor in",
            "sfsyyhzc": 13,
            "remarks": "laborum in"
          }
        ]
      },
      {
        "invoiceCode": "4F6Ae1AB-Bf52-af2c-CAf8-aE96B186EDe2",
        "blueInvoiceNumber": "46",
        "taxIncluded": 1,
        "invoiceType": "增值税专用发票",
        "invoiceCategory": "蓝票",
        "needDelivery": 1,
        "deliveryGourpName": "几研观连角一展",
        "groupName": "条她动却",
        "designatedEmail": "e.vfbowq@qq.com",
        "buyerTaxId": "80",
        "buyerName": "领林受物知",
        "bizType": null,
        "docType": null,
        "rpni": null,
        "remarks": null,
        "customParams1": null,
        "customParams2": null,
        "customParams3": null,
        "list": null
      }
    ]
  }
}

返回响应

🟢200成功

application/json

Body

ErrCode

number

返回码

必需

Message

string | null

返回信息

可选

date

string

返回时间

必需

result

object

返回数据

可选

requestId

string

波次ID

必需

每次请求接口会返回的唯一ID

batchNumber

string | null

批次号

可选

count

string

提交数量

必需

示例

{
  "ErrCode": 0,
  "Message": "提交成功",
  "date": "2024-04-19 16:03:02",
  "result": {
    "requestId": "67",
    "batchNumber": "25",
    "count": "72"
  }
}

🟠400失败

🔴500重复

接口说明#

交付配置#

关于参数对交付结果的影响#

请求参数

返回响应

接口说明

交付配置

关于参数对交付结果的影响