GD(SD)退货推NCC红字销售订单
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>GD(SD)退货推NCC红字销售订单—有原单关联退货、无原单关联退货</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://ip:port/uapws/rest/gy/yyt</code>
-<code>http://183.6.55.151:8088/uapws/rest/gy/yyt</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>post </li>
</ul>
<h5>header参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">Content-Type</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>application/json;charset=UTF-8</td>
</tr>
</tbody>
</table>
<h5>body参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">method</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口名称 RedSaleOrder</td>
</tr>
<tr>
<td style="text-align: left;">ts</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">long</td>
<td>请求时间戳(到秒即可)</td>
</tr>
<tr>
<td style="text-align: left;">json</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>订单json对应数组数组,每个对象包含2个属性 head,bodys</td>
</tr>
</tbody>
</table>
<h5>data订单参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">head</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">object</td>
<td>订单头部信息</td>
</tr>
<tr>
<td style="text-align: left;">bodys</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">array</td>
<td>订单行信息</td>
</tr>
</tbody>
</table>
<h5>head参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>字段</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">pk_org</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>组织</td>
</tr>
<tr>
<td style="text-align: left;">dbilldate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单日期(字符串:”yyyy-MM-dd”)</td>
</tr>
<tr>
<td style="text-align: left;">ctrantypeid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单类型(30-04飞单销售,30-Cxx-GF内部销售</td>
</tr>
<tr>
<td style="text-align: left;">ccustomerid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户编码编码</td>
</tr>
<tr>
<td style="text-align: left;">vdef1</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>结算客户编码</td>
<td>销售方项目</td>
</tr>
<tr>
<td style="text-align: left;">vdef6</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>GD结算客户编码</td>
<td>GD收货方项目</td>
</tr>
<tr>
<td style="text-align: left;">vdef3</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>GD仓库编码</td>
<td>GD仓库</td>
</tr>
<tr>
<td style="text-align: left;">vdef32</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>客户订单号</td>
</tr>
<tr>
<td style="text-align: left;">vdef17</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>发货仓库编码</td>
</tr>
<tr>
<td style="text-align: left;">vdef26</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>销售类型 NOR 赊销,PAY 现销</td>
<td>NCC关联原单处理</td>
</tr>
<tr>
<td style="text-align: left;">vdef7</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>飞单供应商编码</td>
</tr>
<tr>
<td style="text-align: left;">ctransporttypeid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>运输方式编码</td>
<td>A01市外配送,B01空运到门,D01汽运零担,E01厂家直送,F01汽运到站,H01市内配送,J01EA提货,K01自提,M01快递寄付,N01卡航,O01快递到付,Q01汽运包车,T01铁运,X01客户送货,Y01空运机场</td>
</tr>
<tr>
<td style="text-align: left;">vdef25</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>业务类别编码</td>
</tr>
<tr>
<td style="text-align: left;">vnote</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
</tbody>
</table>
<h5>bodys参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">cmaterialvid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>物料编码</td>
</tr>
<tr>
<td style="text-align: left;">vbatchcode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>批次号<code>由NCC处理,若GD推送的有原单关联的退货,则自动找原蓝单的数据关联退货;若GD推送的是无原单退货,则需自动生成一个批次号</code></td>
</tr>
<tr>
<td style="text-align: left;">nnum</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">decimal(28,2)</td>
<td>主数量</td>
</tr>
<tr>
<td style="text-align: left;">nqtorigtaxprice</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">decimal(28,2)</td>
<td>含税单价<code>GD销售含税单价</code></td>
</tr>
<tr>
<td style="text-align: left;"><code>vbdef3</code></td>
<td style="text-align: left;"><code>否</code></td>
<td style="text-align: left;"><code>decimal(28,2)</code></td>
<td><code>采购主含税单价</code>,有原单的NCC自动获取原单的拣货的数据。<code>无原单的</code>根据<code>结算客户+物料”</code>去找最新的一个批次的采购含税单价,采购无税单价、采购供应商等数据回写到销售订单上,并自动计算价差等数据</td>
</tr>
<tr>
<td style="text-align: left;"><code>vbdef7</code></td>
<td style="text-align: left;"><code>否</code></td>
<td style="text-align: left;"><code>decimal(28,2)</code></td>
<td><code>采购税率</code>,<code>有原单关联</code>自动关联获取原单数据信息,<code>无原单退货</code>NCC处理获取最新批次的数据</td>
</tr>
<tr>
<td style="text-align: left;"><code>vbdef8</code></td>
<td style="text-align: left;"><code>否</code></td>
<td style="text-align: left;"><code>decimal(28,2)</code></td>
<td><code>采购供应商</code>,-<code>有原单退货</code>自动关联获取原单数据,<code>无原单</code>则由NCC处理</td>
</tr>
<tr>
<td style="text-align: left;">ntaxrate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">decimal(28,2)</td>
<td>税率</td>
</tr>
<tr>
<td style="text-align: left;">blargessflag</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>是否赠品(Y/N)</td>
</tr>
<tr>
<td style="text-align: left;">vrownote</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注</td>
</tr>
<tr>
<td style="text-align: left;">vsrccode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>来源单据号--<code>有原单退货</code>需回传原蓝单单号,<code>无原单</code>则由NCC处理</td>
</tr>
<tr>
<td style="text-align: left;">vsrcrowno</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>来源表体行号---退货需回传<code>原蓝单单号对应的表体行号</code>,正向时NCC有回传数据信息的,GD做退货的话,需要回传对应行,NCC才能找到原单关联,<code>无原单</code>则由NCC处理</td>
</tr>
</tbody>
</table>
<h5>请求示例</h5>
<pre><code> {
&quot;method&quot;: &quot;RedSaleOrder&quot;,
&quot;json&quot;: {
&quot;head&quot;: {
&quot;pk_org&quot;: &quot;6400&quot;,
&quot;dbilldate&quot;: &quot;2024-08-13 12:12:12&quot;,
&quot;ctrantypeid&quot;: &quot;30-04&quot;,
&quot;ccustomerid&quot;: &quot;C23.868546&quot;,
&quot;vnote&quot;: &quot;接口测试1&quot;,
&quot;vdef1&quot;:&quot;H571C.64&quot;,
&quot;vdef3&quot;:&quot;1100W1&quot;,
&quot;vdef17&quot;:&quot;CDW98&quot;,
&quot;vdef26&quot;:&quot;PAY&quot;,
&quot;vdef7&quot;:&quot;1100&quot;,
&quot;vdef32&quot;:&quot;GD22211&quot;,
&quot;ctransporttypeid&quot;:&quot;A01&quot;
},
&quot;bodys&quot;: [{
&quot;cmaterialvid&quot;: &quot;0201002001&quot;,
&quot;nnum&quot;: &quot;-10&quot;,
&quot;nqtorigtaxprice&quot;: &quot;300&quot;,
&quot;ntaxrate&quot;: &quot;13&quot;,
&quot;vsrccode&quot;:&quot;SO302024080800000327&quot;,
&quot;vsrcrowno&quot;:&quot;10&quot;
}]
}
}</code></pre>
<h5>返回示例</h5>
<pre><code>{
&quot;status&quot;: &quot;0&quot;,
&quot;msg&quot;: &quot;操作成功!&quot;,
&quot;result&quot;: {
&quot;vbillcode&quot;: &quot;SO302024081300000456&quot;,
&quot;pk&quot;: &quot;1001ZZ1000000027UC3F&quot;
}
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>请求状态码</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>接口返回消息</td>
</tr>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">Object/Array</td>
<td>请求数据,每个接口对应根据接口字段自行定义</td>
</tr>
</tbody>
</table>
<h5>result返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">vbillcode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>单据号</td>
</tr>
<tr>
<td style="text-align: left;">pk</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>单据主键</td>
</tr>
</tbody>
</table>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">0</td>
<td style="text-align: left;">String</td>
<td>接口返回对象«object»</td>
</tr>
<tr>
<td style="text-align: left;">1</td>
<td style="text-align: left;">String</td>
<td>接口错误</td>
</tr>
</tbody>
</table>