shandex_edi_2024/edi_947.py

558 lines
17 KiB
Python
Raw Normal View History

2024-03-13 14:53:19 -07:00
#!/usr/bin/env python3
"""
Consume a generic 947 file from 3PLs, and translate into a Sage X3
readable file - import template ZSCS.
For Shadex we also need to reply with a 997
947 is warehouse advice, to alert us of damages or amount changes from something
like a count
"""
#what about serial numbers?
#status on L line?
#remove negative line, needs to look up stocou? not sure.
# pylint: disable=too-many-instance-attributes
import dataclasses
import datetime
import decimal
import functools
import pathlib
import re
import shutil
import typing
import smtplib
2024-03-14 15:46:57 -07:00
import pprint
2024-03-13 14:53:19 -07:00
from email.mime.multipart import MIMEMultipart
from email.mime.text import MIMEText
import records # type: ignore
import yamamotoyama # type: ignore
import yamamotoyama.x3_imports # type: ignore
THIS_DIRECTORY = pathlib.Path(__file__).parent
X12_DIRECTORY = THIS_DIRECTORY / "incoming"
IMPORTS_DIRECTORY = THIS_DIRECTORY / "x3_imports"
2024-03-14 15:46:57 -07:00
EDI_997_DIRECTORY = THIS_DIRECTORY / "997_processing"
2024-03-13 14:53:19 -07:00
SHANDEX_947_FILENAME_RE = re.compile(
2024-07-05 15:08:22 -07:00
r"\A 947_QTY_STASH-YAMAMOTOYAMA_ \S+ [.]edi \Z", re.X | re.M | re.S
2024-03-13 14:53:19 -07:00
)
DAMAGE_CODE_MAPPING = {
"07" : 'RD',#Product Dumped or Destroyed
2024-03-14 15:46:57 -07:00
"AV" : 'RD',#Damaged in Transit
"55" : 'A',#Product Taken Off Hold
"AA" : 'A',#Physical Count
"05" : 'Q'#Product Put on Hold
2024-03-13 14:53:19 -07:00
}
DAMAGE_CODE_DESCRIPTIONS_MAPPING = {
"07" : "Product Dumped or Destroyed",
2024-03-14 15:46:57 -07:00
"AV" : "Damaged in Transit",
"55" : "Product Taken Off Hold",
"AA" : "Physical Count",
"05" : "Product Put on Hold"
}
#This transaction can also be used for inventory counts, which we will report on but not process
EMAIL_ONLY_CODES = ['AA']
#When we receive an EDI to change status, it will either be A or Q, the reverse of the earlier code
DAMAGE_CODE_SOURCE_MAPPING = {
"07" : 'A',#Product Dumped or Destroyed
"AV" : 'A',#Damaged in Transit
"55" : 'Q',#Product Taken Off Hold
"AA" : 'A',#Physical Count
"05" : 'A'#Product Put on Hold
2024-03-13 14:53:19 -07:00
}
def main():
"""
Do it!
"""
2024-03-14 15:46:57 -07:00
for edi_filename in X12_DIRECTORY.iterdir():
if SHANDEX_947_FILENAME_RE.match(edi_filename.name):
2024-12-12 09:41:34 -08:00
pprint.pprint(edi_filename.name)
2024-03-14 15:46:57 -07:00
process_file(edi_filename)
2024-03-13 14:53:19 -07:00
# file moved to 997 processing folder to be sent later
shutil.move(edi_filename, EDI_997_DIRECTORY / edi_filename.name)
2024-03-14 15:46:57 -07:00
combine_zscs()
def combine_zscs():
"""
Collect all ZSCS imports into a single file for easy import.
"""
archive_directory = IMPORTS_DIRECTORY / "archive"
archive_directory.mkdir(exist_ok=True)
with (IMPORTS_DIRECTORY / "ZSCS.dat").open(
"w", encoding="utf-8", newline="\n"
) as combined_import_file:
for individual_import_filename in IMPORTS_DIRECTORY.glob(
"ZSCS_*.dat"
):
with individual_import_filename.open(
"r", encoding="utf-8", newline="\n"
) as individual_import_file:
for line in individual_import_file:
combined_import_file.write(line)
shutil.move(
individual_import_filename,
archive_directory / individual_import_filename.name,
)
2024-03-13 14:53:19 -07:00
def tokens_from_edi_file(
edi_filename: pathlib.Path,
) -> typing.Iterator[typing.List[str]]:
"""
Read tokens from EDI file
"""
with edi_filename.open(encoding="utf-8", newline="") as edi_file:
for record in edi_file.read().split("~"):
fields = record.split("*")
2024-03-14 15:46:57 -07:00
if fields[0] in {
2024-03-13 14:53:19 -07:00
"ISA",
"GS"
"N1",
"N9",
"SE",
"GE",
"IEA"
}:
continue
yield fields
def gtin_lookup(gtin):
2024-07-05 15:08:22 -07:00
with yamamotoyama.get_connection() as db_connection:
2024-03-13 14:53:19 -07:00
return db_connection.query(
"""
select
[ITM].[ITMREF_0],
[ITM].[ITMDES1_0],
[ITM].[EANCOD_0],
[ITM].[ZCASEUPC_0]
2024-07-05 15:08:22 -07:00
from [PROD].[ITMMASTER] [ITM]
join [PROD].[ITMFACILIT] [ITF]
2024-03-14 15:46:57 -07:00
on [ITM].[ITMREF_0] = [ITF].[ITMREF_0]
and [ITF].[STOFCY_0] = 'WON'
2024-03-13 14:53:19 -07:00
where
2024-10-02 13:22:37 -07:00
replace([ITM].[ZCASEUPC_0],' ','') = :zcaseupc
2024-12-12 09:41:34 -08:00
or replace([ITM].[EANCOD_0],' ','') = :zcaseupc
2024-03-13 14:53:19 -07:00
""",
zcaseupc=gtin,
).first()["ITMREF_0"]
2024-03-14 15:46:57 -07:00
def stock_movement_alert(itmref, qty, lot, status):
2024-03-13 14:53:19 -07:00
msg = MIMEMultipart()
msg['Subject'] = 'New Stock Change from Shandex'
msg['Precedence'] = 'bulk'
msg['From'] = 'x3report@stashtea.com'
msg['To'] = 'isenn@yamamotoyama.com, vgomez@yamamotoyama.com'
msg['CC'] = 'bleeson@stashtea.com'
2024-03-14 15:46:57 -07:00
emailtext = f'Item: {itmref}\nQty: {qty}\nLot: {lot}\nStatus: {DAMAGE_CODE_MAPPING[status]}\nReason: {DAMAGE_CODE_DESCRIPTIONS_MAPPING[status]}'
2024-03-13 14:53:19 -07:00
msg.attach(MIMEText(emailtext, 'plain'))
with smtplib.SMTP_SSL("smtp.gmail.com", 465) as smtp:
smtp.login(user='x3reportmk2@yamamotoyama.com', password=r'n</W<7fr"VD~\2&[pZc5')
smtp.send_message(msg)
def process_file(edi_filename: pathlib.Path):
"""
Convert a specific EDI file into an import file.
"""
warehouse_stockchange = StockChange()
vcrlin = 0
for fields in tokens_from_edi_file(edi_filename):
if fields[0] == "G62":
iptdat = fields[2]
warehouse_stockchange.header.iptdat = datetime.datetime.strptime(
iptdat, "%Y%m%d"
).date()
2024-03-14 15:46:57 -07:00
if fields[0] == 'W15':
transaction_number = fields[2]
2024-03-13 14:53:19 -07:00
if fields[0] == "W19":
vcrlin += 1000
# W19*AV*35*CA**UK*10077652082651***03022026C
_, status, qty, uom, _, _, gtin, _, _, lot = fields[:10]
2024-03-14 15:46:57 -07:00
product = gtin_lookup(gtin)
stock_movement_alert(product, qty, lot, status)
if status in EMAIL_ONLY_CODES:
2024-07-05 15:08:22 -07:00
continue
2024-03-13 14:53:19 -07:00
warehouse_stockchange.header.vcrdes = DAMAGE_CODE_DESCRIPTIONS_MAPPING[status]
subdetail = StockChangeSubDetail(
qtypcu=int(qty),
2024-03-14 15:46:57 -07:00
qtystu=int(qty),
2024-03-13 14:53:19 -07:00
sta=DAMAGE_CODE_MAPPING[status],
pcu=uom
)
detail_line = StockChangeDetail(
vcrlin=vcrlin,
2024-03-14 15:46:57 -07:00
itmref=product,
2024-03-13 14:53:19 -07:00
pcu=uom,
2024-03-14 15:46:57 -07:00
sta=DAMAGE_CODE_SOURCE_MAPPING[status],
2024-03-13 14:53:19 -07:00
lot=lot
)
warehouse_stockchange.append(
detail_line,
subdetail,
)
time_stamp = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
with yamamotoyama.x3_imports.open_import_file(
2024-03-14 15:46:57 -07:00
IMPORTS_DIRECTORY / f"ZSCS_{transaction_number}_{time_stamp}.dat"
2024-03-13 14:53:19 -07:00
) as import_file:
warehouse_stockchange.output(import_file)
@dataclasses.dataclass
class StockChangeSubDetail:
"""
Information that goes onto a stockchange sub-detail line, taken from ZPTHI template.
"""
pcu: str = ""
qtypcu: int = 0
qtystu: int = 0
loc: str = ""
sta: str = "A"
def convert_to_strings(self) -> typing.List[str]:
"""
Convert to strings for X3 import writing.
"""
2024-03-14 15:46:57 -07:00
def fix_uom(uom):
x3_uom = ''
if uom == 'CA':
x3_uom = 'CS'
else:
x3_uom = uom
return x3_uom
2024-03-13 14:53:19 -07:00
return yamamotoyama.x3_imports.convert_to_strings(
[
"S",
2024-03-14 15:46:57 -07:00
fix_uom(self.pcu),
2024-03-13 14:53:19 -07:00
self.qtypcu,
self.qtystu,
self.loc,
self.sta,
]
)
@dataclasses.dataclass
class StockChangeDetail:
"""
Information that goes on a stockchange detail line, taken from ZPTHI template.
"""
vcrlin: int = 0
itmref: str = ""
pcu: str = ""
pcustucoe: int = 1 #does this need a lookup?
sta: str = "A"
2024-03-13 14:53:19 -07:00
loctyp: str = ""
loc: str = ""
lot: str = ""
slo: str = ""
sernum: str = ""
palnum: str = ""
ctrnum: str = ""
qlyctldem: str= ""
owner: str = "WON"
subdetails: typing.List[StockChangeSubDetail] = dataclasses.field(
default_factory=list
)
2024-03-20 09:42:04 -07:00
def palnum_lookup(self, itmref, lot, status):#TODO prevent the crash when we don't have the lot supplied in X3
2024-03-13 14:53:19 -07:00
"""
Pick a palnum from X3 using the lot, location, and status
2024-03-14 15:46:57 -07:00
It matters which one we use, best attempt is to get the largest one available
2024-03-13 14:53:19 -07:00
"""
2024-07-05 15:08:22 -07:00
with yamamotoyama.get_connection() as db_connection:
2024-03-20 09:42:04 -07:00
result = db_connection.query(
2024-03-13 14:53:19 -07:00
"""
2024-03-14 15:46:57 -07:00
select top 1
2024-03-13 14:53:19 -07:00
[STO].[STOFCY_0],
[STO].[ITMREF_0],
[STO].[LOT_0],
2024-03-14 15:46:57 -07:00
[STO].[PALNUM_0],
[STO].[QTYSTU_0]
2024-07-05 15:08:22 -07:00
from [PROD].[STOCK] [STO]
2024-03-13 14:53:19 -07:00
where
[STO].[ITMREF_0] = :itmref
and [STO].[STOFCY_0] = 'WON'
and [STO].[LOT_0] = :lot
and [STO].[STA_0] = :status
2024-03-14 15:46:57 -07:00
order by
[STO].[QTYSTU_0] desc
2024-03-13 14:53:19 -07:00
""",
itmref=itmref,
lot=lot,
status=status
2024-03-20 09:42:04 -07:00
).first()
if result:
return result["PALNUM_0"]
else:
raise NotImplementedError
2024-03-13 14:53:19 -07:00
def gtin_lookup(self, gtin):
2024-07-05 15:08:22 -07:00
with yamamotoyama.get_connection() as db_connection:
2024-03-13 14:53:19 -07:00
return db_connection.query(
"""
select
[ITM].[ITMREF_0],
[ITM].[ITMDES1_0],
[ITM].[EANCOD_0],
[ITM].[ZCASEUPC_0]
2024-07-05 15:08:22 -07:00
from [PROD].[ITMMASTER] [ITM]
join [PROD].[ITMFACILIT] [ITF]
2024-03-14 15:46:57 -07:00
on [ITM].[ITMREF_0] = [ITF].[ITMREF_0]
and [ITF].[STOFCY_0] = 'WON'
2024-03-13 14:53:19 -07:00
where
[ITM].[ZCASEUPC_0] = :zcaseupc
""",
zcaseupc=gtin,
).first()["ITMREF_0"]
def append(self, subdetail: StockChangeSubDetail):
"""
Add subdetail
"""
subdetail.pcu = self.pcu
self.subdetails.append(subdetail)
def check_subdetail_qty(self):
"""
Check for shortages by totaling up subdetail quantities.
"""
total_cases = 0
for subdetail in self.subdetails:
total_cases -= subdetail.qtypcu
return abs(total_cases)
def convert_to_strings(self) -> typing.List[str]:
"""
Convert to strings for X3 import writing.
"""
def fix_uom(uom):
x3_uom = ''
if uom == 'CA':
x3_uom = 'CS'
else:
x3_uom = uom
return x3_uom
2024-03-14 15:46:57 -07:00
2024-03-13 14:53:19 -07:00
self.qty = self.check_subdetail_qty()
2024-03-20 09:42:04 -07:00
self.palnum = self.palnum_lookup(self.itmref, self.lot, self.sta)
2024-03-13 14:53:19 -07:00
return yamamotoyama.x3_imports.convert_to_strings(
[
"L",
self.vcrlin,
2024-03-14 15:46:57 -07:00
self.itmref,
2024-03-13 14:53:19 -07:00
fix_uom(self.pcu),
self.pcustucoe,
self.sta,
self.loctyp,
self.loc,
self.lot,
self.slo,
self.sernum,
2024-03-20 09:42:04 -07:00
self.palnum,
2024-03-13 14:53:19 -07:00
self.ctrnum,
self.qlyctldem,
self.owner
]
)
def __eq__(self, item: typing.Any) -> bool:
"""
Test for equality
"""
if isinstance(item, str):
return self.itmref == item
if isinstance(item, StockChangeDetail):
return self.itmref == item.itmref
return False
# def fill(self):#not needed for stockchanges
# """
# Set soplin & itmdes from itmref & sohnum
# """
# def get() -> records.Record:
# with yamamotoyama.get_connection() as database:
# how_many = (
# database.query(
# """
# select
# count(*) as [how_many]
# from [PROD].[SORDERP] as [SOP]
# where
# [SOP].[SOHNUM_0] = :sohnum
# and [SOP].[ITMREF_0] = :itmref
# """,
# sohnum=self.sohnum,
# itmref=self.itmref,
# )
# .first()
# .how_many
# )
# if how_many == 1:
# return database.query(
# """
# select top 1
# [SOP].[SOPLIN_0]
# ,[SOP].[ITMDES1_0]
# ,[SOP].[SAU_0]
# from [PROD].[SORDERP] as [SOP]
# where
# [SOP].[SOHNUM_0] = :sohnum
# and [SOP].[ITMREF_0] = :itmref
# order by
# [SOP].[SOPLIN_0]
# """,
# sohnum=self.sohnum,
# itmref=self.itmref,
# ).first()
# result = get()
# self.soplin = result.SOPLIN_0
# self.itmdes = result.ITMDES1_0
# self.sau = result.SAU_0
@dataclasses.dataclass
class StockChangeHeader:
"""
Information that goes on a stockchange header, taken from ZSCS template.
"""
vcrnum: str = ""
stofcy: str = "WON"
iptdat: datetime.date = datetime.date(1753, 1, 1)
vcrdes: str = ""
pjt: str = ""
trsfam: str = "CHX"
def convert_to_strings(self) -> typing.List[str]:
"""
Convert to X3 import line
"""
return yamamotoyama.x3_imports.convert_to_strings(
[
"E",
self.vcrnum,
self.stofcy,
self.iptdat.strftime("%Y%m%d"),
self.vcrdes,
self.pjt,
self.trsfam,
]
)
class StockChangeDetailList:
"""
List of stockchange details
"""
_details: typing.List[StockChangeDetail]
_item_set: typing.Set[str]
def __init__(self):
self._details = []
self._item_set = set()
def append(
self,
stockchange_detail: StockChangeDetail,
stockchange_subdetail: StockChangeSubDetail,
):
"""
Append
"""
itmref = stockchange_detail.itmref
if itmref in self._item_set:
for detail in self._details:
if detail == itmref:
detail.subdetails.append(stockchange_subdetail)
return
self._item_set.add(itmref)
#stockchange_detail.fill()
stockchange_detail.append(stockchange_subdetail)
self._details.append(stockchange_detail)
def __iter__(self):
return iter(self._details)
class StockChange:
"""
Warehouse stockchange, both header & details
"""
header: StockChangeHeader
details: StockChangeDetailList
_sdhnum: str
def __init__(self):
self.header = StockChangeHeader()
self._sdhnum = ""
self.details = StockChangeDetailList()
def append(
self,
stockchange_detail: StockChangeDetail,
stockchange_subdetail: StockChangeSubDetail,
):
"""
Add detail information.
"""
self.details.append(stockchange_detail, stockchange_subdetail)
@property
def sdhnum(self):
"""
shipment number
"""
return self._sdhnum
@sdhnum.setter
def sdhnum(self, value: str):
if self._sdhnum != value:
self._sdhnum = value
if value:
self._fill_info_from_shipment()
def output(self, import_file: typing.TextIO):
"""
Output entire order to import_file.
"""
output = functools.partial(
yamamotoyama.x3_imports.output_with_file, import_file
)
output(self.header.convert_to_strings())
for detail in self.details:
output(detail.convert_to_strings())
for subdetail in detail.subdetails:
#shipment = detail.sdhnum
#item = detail.itmref
output(subdetail.convert_to_strings())
# for record in subdetail.stojous(shipment, item):
# output(subdetail.convert_to_strings())
# output(record)
if __name__ == "__main__":
main()
2024-03-20 09:42:04 -07:00