# Invoice

**Repository Path**: PettyHandSome/Invoice

## Basic Information

- **Project Name**: Invoice
- **Description**: 航信电子发票开具和签章
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 15
- **Created**: 2020-12-27
- **Last Updated**: 2020-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 航信全国版电子发票开具与签章

### 使用说明
**注意：<br>1.部署时候PKCS7.JAVA 要单独打包 和它引用的包一起放在放在 tomcat\lib\目录下【PKCS7.JAR, commons-io-2.4.jar,guava-2.0.jar】，否则重启应用会报错动态库已经被加载<br>2.CA加密相关文件放在 D盘 CA目录下<br>3.PKCS7.JAVA必须在com.aisino包下,否则会报错<br>4.出问题就找航信<br>5.全国版本签章接口在调用时候要在商品名称前加上商品简称再调用签章<br>**

### 金额计算公式
```
//含税金额=数量*含税单价
// 不含税金额 = 含税金额/（ 1+税率） ， 并保留两位小数
// 税额 = 含税金额 - 不含税金额
```

### 发票开具
* 接口地址 
```
http://127.0.0.1:8003/print
```

* 调用方式
```
Post
```

* 报文格式
```
{
    "InfoKind": "",
    "InfoSellerAddressPhone": "",
    "InfoSellerBankAccount": "",
    "InfoClientName": "",
    "InfoClientTaxCode": "",
    "InfoClientBankAccount": "",
    "InfoClientAddressPhone": "",
    "InfoCashier": "",
    "InfoChecker": "",
    "InfoInvoicer": "",
    "InfoNotes": "",
    "Details": [
        {
            "ListGoodsName": "",
            "ListStandard":"",
            "ListPrice": "",
            "ListUnit": "",
            "ListNumber": "",
            "ListPriceKind": "",
            "InfoTaxRate": ""
        }
    ]
}
```
* 参数说明
```
{
    "InfoKind":"",//发票种类 0:专票 2:普票 51：电子票
    "InfoSellerAddressPhone":"",//售方地址及电话
    "InfoSellerBankAccount":"",//售方开户行及账号
    "InfoClientName":"",//开票名称
    "InfoClientTaxCode":"",//购方税号
    "InfoClientBankAccount":"",//购方开户行及账号
    "InfoClientAddressPhone":"",//开票地址，电话
    "InfoCashier":"",//收款人
    "InfoChecker":"",//复核人
    "InfoInvoicer":"",//开票人
    "InfoNotes":"",//备注
    "Details":[//商品明细
        {
            "ListGoodsName":"",//服务名称
            "ListStandard":"",//规格型号
            "ListPrice":"",//单价
            "ListUnit":"",//单位
            "ListNumber":"",//数量
            "ListPriceKind":"",//含税价标志 
            "InfoTaxRate":""//税率 税率（ 5%传 5）
        }
    ]
}
```

* 返回值
```
{
    "retCode": "",//返回代码 0：成功 1：失败
    "retMsg": "",//返回信息
    "InfoTypeCode": "",//发票代码
    "InfoNumber": ""//发票号码
}
```

### 发票作废
* 接口地址 
```
http://127.0.0.1:8003/cancel
```

* 调用方式
```
Post
```

* 报文格式
```
{
    "InfoKind": "",//发票种类 0:专票 2:普票
    "InfoTypeCode": "",//发票代码
    "InfoNumber": ""//发票号码
}
```

* 返回值
```
{
    "retCode": "",//返回代码 0：成功 1：失败
    "retMsg": "",//返回信息
}
```

### 发票冲红

* 接口地址同发票开具
```
/* 
开具负数增值税普通发票，必须在备注中注明“对应正数发票代
码 :XXXXXXXXXX 号码 :YYYYYYYY”字样，其中“ X”为发票左上角 10 位
或 12 位代码数字， “ Y”为发票右上角 8 位号码数字。
开具负数增值税专用发票，必须在备注中注明“开具红字增值税专用发票
信息表编号 XXXXXXXXXXXXXXXX”，其中 X 为信息表编号。
*/
```

### 电子发票

* 接口地址 
```
http://127.0.0.1:8003/Invoice/rs/aisino/invoice
```

* 调用方式
```
Post
```

* 报文格式
```
蓝字发票开票报文
{
    "InfoKind": "51",
    "InfoSellerAddressPhone": "新疆石河子市北二路14小区7号  0993-2080300",
    "InfoSellerBankAccount": "建行新疆区石河子市分行营业部 65001630100050002211",
    "InfoClientName": "购买方",
    "InfoClientTaxCode": "",
    "InfoClientBankAccount": "购买方银行银行",
    "InfoClientAddressPhone": "购买方地址电话",
    "InfoCashier": "收款",
    "InfoChecker": "复核",
    "InfoInvoicer": "开票",
    "InfoNotes": "2333",
    "KPLX":"0",  //开票类型  0正票 1 红票
    "operatorID":"123456",//操作员id
    "Details": [
        {
            "ListGoodsName": "基础水费",
            "ListStandard":"商业",
            "ListPrice": "10",
            "ListUnit": "1",
            "ListNumber": "1",
            "ListPriceKind": "1",
            "InfoTaxRate": "3"
        },
        {
            "ListGoodsName": "基础水费",
            "ListStandard":"商业",
            "ListPrice": "11",
            "ListUnit": "1",
            "ListNumber": "1",
            "ListPriceKind": "1",
            "InfoTaxRate": "3"
        }
    ]
}
```

```
红票
{
    "InfoKind": "51",
    "InfoSellerAddressPhone": "新疆石河子市北二路14小区7号  0993-2080300",
    "InfoSellerBankAccount": "建行新疆区石河子市分行营业部 65001630100050002211",
    "InfoClientName": "购买方",
    "InfoClientTaxCode": "",
    "InfoClientBankAccount": "购买方银行银行",
    "InfoClientAddressPhone": "购买方地址电话",
    "InfoCashier": "收款",
    "InfoChecker": "复核",
    "InfoInvoicer": "开票",
    "InfoNotes":"对应正数发票代码:065001700111号码:06429929",
    "KPLX":"1",  //1 红票
    "operatorID":"123456",//操作员id
    "YFP_DM":"065001700111",//原发票代码
    "YFP_HM":"06429929",//原发票号码
    "Details": [
        {
            "ListGoodsName": "基础水费",
            "ListStandard":"商业",
            "ListPrice": "10",
            "ListUnit": "1",
            "ListNumber": "1",
            "ListPriceKind": "1",
            "InfoTaxRate": "3"
        },
        {
            "ListGoodsName": "基础水费",
            "ListStandard":"商业",
            "ListPrice": "11",
            "ListUnit": "1",
            "ListNumber": "1",
            "ListPriceKind": "1",
            "InfoTaxRate": "3"
        }
    ]
}
```

* 返回值
```
{
    "retCode": "",//返回代码 0：成功 1：失败
    "retMsg": "",//返回信息
    "InfoTypeCode": "",//发票代码
    "InfoNumber": ""//发票号码
    "PDF_URL":"" //pdf 地址
}
```


### 发票模块相关信息

* 新增数据表
```
<?xml version="1.0"  encoding='utf-8'?>
<!DOCTYPE hibernate-mapping PUBLIC 
	"-//Hibernate/Hibernate Mapping DTD 3.0//EN"
	"http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">
<hibernate-mapping>
    <!--商品信息-->
    <class   entity-name="t_commodity" table="t_commodity" >
    <!-- 商品编号 -->
		<id name="id" type="int">
			<generator class="identity"></generator>
		</id>
		<!--商品名称-->
		<property name="f_comname" type="string"/>
		<!--税收编码-->
		<property name="f_taxcode" type="string"/>
		<!--税率-->
		<property name="f_taxrate" type="string"/>
		<!--单位-->
		<property name="f_taxunit" type="string"/>
		<!--规格型号-->
		<property name="f_taxmodel" type="string"/>
		<!-- 操作员 -->
		<property name="f_operator" type="string"/>
		<!-- 上次修改时间 -->
		<property name="f_operationdate" type="date"/>
	</class>
</hibernate-mapping>
```
* 商品信息表的操作页面
```
需要包括 录入，修改和删除数据 
商品名称、商品编码必填
```

* 新增单值

```
售方纳税人识别号 
销售方名称
```