OBI欧倍德公司是德国建材和家居装饰零售连锁店，在德国以及其他欧洲国家拥有众多分店，是欧洲领先的DIY（Do It Yourself）零售商之一。为了更好地处理与全球供应商之间的业务数据往来，OBI采用EDI提高其供应链的自动化水平，提高数据处理效率。
本文将从业务的角度出发，带领大家了解供应商N公司在对接OBI 的EDI项目中遇到的挑战以及相应的解决方案。
梳理需求文档
确认需要与OBI建立EDI连接之后，将会向供应商提供大量的EDI规范文档。企业需要从中提取当前项目需要使用的资料。
1.文件名中带ECOM的EDI文档是专门提供给线上平台的订单使用的，其他文件则是给Store partner 用。本次案例中，供应商N公司主要给OBI的线下门店供货，业务类型为Store partner。
2.ORDERS采购订单的规范文件有D01B和D93A两个版本，经沟通，OBI 推荐使用 D01B。
3.对接不同国家的OBI门店，需要注意区分不同的UNB ID（用于标识交易伙伴身份的代码，OBI的 UNB ID由14位数字组成），本案例对接OBI 德国，因此UNB ID需要选择德国（DE）。
供应商还可能会遇到：OBI AT、OBI PL、OBI CH、OBI CZ、OBI SK、OBI HU、OBI SI、OBI IT以及OBI BA。
AS2连接测试
梳理好需求文档之后，便可以联系OBI的EDI团队申请做AS2测试，通过附件方式提供AS2参数；
在AS2测试过程中，遇到这样的问题：N公司可以成功接收OBI发来的测试文件，但向OBI发送测试文件时会出现Timeout的报错，这是因为OBI有IP白名单限制，供应商需要和其EDI团队沟通，添加即可。
注：本项目N公司由OBI提供的WEB EDI切换至直连EDI。AS2不分测试生产，仅通过测试标识区分，一旦开始AS2测试（带测试标识的生产订单），OBI即会关闭Web EDI通道，关闭WEB EDI后，需要联系OBI，暂时通过邮件接收 PDF 订单。
EDI 业务测试
ORDERS采购订单
如何将OBI发来的ORDERS采购订单报文转换为企业内部可处理的格式呢？这里需要处理OBI报文中提供的字段信息与N公司业务系统中的字段信息之间的映射。
映射中可能会遇到的问题
在知行之桥EDI系统完成实施后，需要与OBI进行测试，需要注意以下内容：
- Delivery date, requested：含义为请求交货日期
- Payment terms : 60天付款会有3%的折扣，注意该折扣不需要计算到发票总金额中
- Terms of delivery：商务条款DDP，对应EDI规范中的Code是CPT = Freight, Carriage paid to destination，当订单金额低于250欧元时需要加20欧的运费
- Allowance or charge：样品订单或者新店开业首批订单或者店铺装修会额外包含10%折扣，并且付款周期会延长到120天
- ShipToGLN：OBI在EDI中仅传输GLN（若未传输GLN才会提供详细送货地址），在收到订单数据后，需要根据OBI门店列表去匹配门店地址信息
- InvoiceGLN：OBI在EDI订单中未传输，经和OBI确认，该值固定，客户需要自行维护在系统中
- LIN-GTIN：OBI某种情况下（如OBI门店绕过总部直接下单的情况）发来的订单不包含GTIN，且SupplierArticleNumber错误，这类订单需要客户做额外处理
订单测试流程及相关注意事项 - 请求OBI发测试订单，OBI回复：一旦通过AS2 进行订单测试，OBI会通过AS2传输带测试文件的标识，同时会关闭WEB EDI的使用
- 针对不同ship to信息，订单号可能会重复。
- 如果订单需要变更应该如何处理？OBI答复称不支持通过EDI进行订单变更，如果需要取消订单，则必须由供应商和订货的OBI商店直接澄清和解释。
ORDERS 采购订单切换生产流程
EDI-ORDERS切换生产，需要客户在供应商门户网站下载“Infoboard文档”，填写并回传给OBI。注：切换时间为每个月的第一个周一
订单切换完成后，才可以继续测试DESADV/INVOIC，根据生产订单发送带有测试标识的DESADV，进行结构验证。体现在知行之桥EDI系统中，就是在EDIFACT端口下，勾选测试标识符（UNB11）。勾选后，生成的DESADV的UNB11=1，表示当前报文为测试报文。
DESADV 发货通知
映射中可能会遇到的问题
- DeliveryNoteNumber：该值必须和线下的发货通知单据保持一致。The DESADV document number should be the delivery note number of the paper delivery note.
- Delivery date (estimated)：预计交货日期
- SSCC相关：不传输，因此EDI-DESADV中不包含PACLoop
4.LIN-GTIN：当ORDERS中未传GTIN时，回传的DESADV要和订单保持一致
发货通知测试流程及相关注意事项
先发送带有测试标识的EDI文件，进行EDI结构测试；接下来会进入content测试，供应商需要向OBI发送正式发货的DESADV，OBI物流团队会检查数据，待OBI检查完成后会通知客户切换生产。
OBI检查注意事项：
- OBI要求在到货前收到ASN
- ASN 中的delivery note number 不能重复
- 检查DESADV数据与实际收货数据是否一致
在OBI物流团队完成检查后，会邮件通知供应商将DESADV切换到生产。
INVOIC 发票信息
映射中可能会遇到的问题
- FTX-Segment：要体现出发票存在折扣协议以及免税
示例代码如下：
FTX+AAK+1+ST3'
FTX+REG+1+IGL::246'AAK = Prize conditions ，ST3表示存在折扣或者奖金
REG = Registration information，IGL = tax free inner community delivery (for DE/AT)，246 = GS1 Germany (for DE)
2.Delivery date/time (actual)：实际交货日期
3.Message line item for not invoiced units included in assortment不涉及到
4.带整单折扣的情况
Header中需要体现折扣金额和折扣百分比，ALC-Qualifier为A，表示津贴
ALC+A+++1+DI'
PCD+3:10:13'
MOA+8:129.26'5.带明细折扣的情况
LIN+2++88888****:EN'
PIA+1+AD.*******:SA'
PIA+1+81*****:BP'
IMD+F++:::M*****e'
IMD+F++:::Gr. S'
QTY+47:1:PCE'
QTY+46:1:PCE'
QTY+192:1:PCE'
MOA+203:80.241'
PRI+AAB:114.63:::1:PCE'
PRI+AAA:80.24:::1:PCE'
ALC+A+++1+DI'
PCD+3:30'
MOA+8:34.389'6.带整单折扣和明细折扣的情况
Header中需要体现折扣金额和折扣百分比，ALC-Qualifier为A，表示津贴
ALC+A+++1+DI'
PCD+3:10:13'
MOA+8:122.6541'明细部分需要有ALC段表示折扣信息
LIN+2++88888****:EN'
PIA+1+AD.*******:SA'
PIA+1+81*****:BP'
IMD+F++:::M*****e'
IMD+F++:::Gr. S'
QTY+47:1:PCE'
QTY+46:1:PCE'
QTY+192:1:PCE'
MOA+203:80.241'
PRI+AAB:114.63:::1:PCE'
PRI+AAA:80.24:::1:PCE'
ALC+A+++1+DI'
PCD+3:30'
MOA+8:34.389'汇总时需要减去整单折扣金额
UNS+S'
MOA+79:1226.541'
MOA+77:1103.8869'
MOA+124:0.00'
MOA+125:1103.8869'
MOA+131:-122.6541'7.带运费的情况：
Header中需要体现运费总金额，ALC-Qualifier为C，表示收费
ALC+C+++1+FC'
MOA+8:20.00'8.发票中金额的计算逻辑
MOA+79:1292.60'
MOA+77:1163.34'
MOA+124:0.00'
MOA+125:1163.34'
MOA+131:-129.26'TotalLineItemsAmount：1292.60，所有Item明细中的产品金额之和
- TotalMonetaryAmount：1163.34，发票总金额=应税金额+税额
- TotalTaxableAmount：1163.34，总的应税金额=总行金额+所有折扣或运费的总金额(TotalLineItemsAmount + TotalAmountOfAllowancesAndcharges）
- TotalAmountOfAllowancesAndcharges：总津贴或收费金额= 所有的折扣和运费的总金额，注意：如果只有折扣，那么该值为负的，如果只有运费该值则为正的，运费折扣都有则需要计算，若运费大于折扣则为正值，若运费小于折扣则为负值
- TotalTaxAmount：总税额=应税金额*税率，注意：该项目税率为0，所以总税额也为0
发票测试流程及相关注意事项
发送带有测试标识的EDI文件，目前的发票都不含税，税率相关情况可以参考以下表格。
| business model | ship from | ship to | judge | tax rate | |
|---|---|---|---|---|---|
| 商业模式 | 发货地 | 收货地 | 判断条件 | 运用税率 | |
| B2B | NL | NL | NL | 21% | B2B，当收=发，取收货国税率，否则为0 |
| B2B | NL | 非NL国家 | 0 | 0% | |
| B2B | DE | DE | DE | 19% | |
| B2B | DE | 非DE国家 | 0 | 0% | |
| B2B | FR | FR | FR | 20% | |
| B2B | FR | 非FR国家 | 0 | 0% | |
| B2B | …… | 0 | 0% | ||
| B2C | NL | NL | NL | 21% | B2C，税收跟随收货国税率 |
| B2C | NL | DE | DE | 19% | |
| B2C | DE | DE | DE | 19% | |
| B2C | DE | NL | NL | 21% | |
| B2C | FR | DE | DE | 19% | |
| B2C | FR | NL | NL | 21% | |
| B2C | FR | FR | FR | 20% |
2.先进行EDI结构测试，再进行content测试
上线前：EDI-INVOIC需要和线下的PDF发票并行发送，OBI会检查发票数据对比，待OBI确认完成后才会通知客户上线，上线后只发送EDI-INVOIC，不再发送PDF发票。
RECADV 汇款通知
汇款通知测试流程及相关注意事项
联系OBI通过AS2发送汇款通知，OBI会在每周三、周四发送。
REMADV 中除了有客户发送的发票外，还会反馈 Credit Notes的信息，通过DOC+381的方式直接扣减对应的金额。
DOC+381+92668'
MOA+77:54845.68'
MOA+52:0'
MOA+79:54845.68'
DTM+137:20240709:102'但汇款通知中并不反馈关于Credit Notes扣减的明细信息。对供应商而言，财务部分将无法确认扣款原因。
经过和业务沟通，了解到除了供应商发出的INVOIC之外，OBI目前会给发送以下三种类型的发票给客户：
- invoice：OBI主动找供应商收活动广告费
- credit note：OBI减少对供应商的收款，如广告费算错，冲销广告费
- debit note：OBI减少向供应商付款，如延期交付罚款，OBI主动debit note冲减应付金额
可以通过这些发票来获取扣款的详细信息。
了解更多 EDI 信息，请参阅: EDI 是什么？
阅读原文
![[qt] 多线程应用01](https://i-blog.csdnimg.cn/direct/0291b294f6c74dfda829ef3d1290fc01.png)