edf-tool 0.1.0__py3-none-any.whl

edf_tool/__init__.py

@@ -0,0 +1,3 @@
+"""edf-tool: monthly export-of-services invoice + bank EDF form generator. Runs fully offline."""
+
+__version__ = "0.1.0"

edf_tool/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

edf_tool/banks/__init__.py

@@ -0,0 +1,22 @@
+"""Bank form adapters.
+
+Each adapter module exposes:
+    NAME, DESCRIPTION, TEMPLATE (file in edf_tool/data), PDF_SHEETS (sheets in the 2-page PDF)
+    check_template(wb)            -> raise TemplateError if the file isn't the layout we know
+    fill(wb, cfg, inv)            -> write all values into the workbook
+    place_signature(wb, png)      -> float the signature image over the signatory line
+
+To support another bank, copy hdfc_services.py, change the cell map, and register it below.
+See CONTRIBUTING.md.
+"""
+from ..errors import ConfigError
+from . import hdfc_services
+
+REGISTRY = {hdfc_services.NAME: hdfc_services}
+
+
+def get(name):
+    try:
+        return REGISTRY[name]
+    except KeyError:
+        raise ConfigError("Unknown bank_format '%s'. Supported: %s" % (name, ", ".join(sorted(REGISTRY))))

edf_tool/banks/hdfc_services.py

@@ -0,0 +1,138 @@
+"""HDFC Bank - "Request letter for Export of Services & EDF Filing Cum Disposal Instructions
+for Credit" (the version HDFC circulated in September 2026).
+
+Only this exact layout has been tested. If HDFC changes the form, check_template() stops
+the run instead of writing values into the wrong cells.
+"""
+from ..errors import TemplateError
+from ..textutil import amount_in_words, dmony, dmy, money, num, short_money
+
+NAME = "hdfc_services"
+DESCRIPTION = "HDFC Bank - Export of Services EDF request letter + annexure (Sept 2026 form)"
+TEMPLATE = "hdfc_services_2026_09.xlsx"
+
+LETTER = "REQUEST LETTER"
+ANNEX = "EDF Annexure"
+INV1 = "Invoice Details 1 "          # trailing space is in HDFC's file
+INV2 = "Invoice Details 2 "
+PDF_SHEETS = (LETTER, INV1)
+
+# (sheet, cell, text the label must start with)
+FINGERPRINT = [
+    (LETTER, "A1", "Request letter for Export of Services"),
+    (LETTER, "A5", "Account no. to be Credited"),
+    (LETTER, "A6", "Purpose Code"),
+    (LETTER, "A11", "Exporter Name"),
+    (LETTER, "A19", "Description of Services"),
+    (LETTER, "A21", "Third Party"),
+    (LETTER, "J24", "Invoice No"),
+    (LETTER, "A29", "Debit all processing charges"),
+    (LETTER, "A34", "Remark"),
+    (ANNEX, "A9", "EDF Form No"),
+    (ANNEX, "K9", "Service recipient Name"),
+    (ANNEX, "T9", "Relationship between Exporter"),
+    (INV1, "A2", "Invoice No"),
+    (INV1, "J2", "Remarks"),
+]
+
+
+def check_template(wb):
+    bad = []
+    for sheet, ref, expect in FINGERPRINT:
+        got = (wb.value(sheet, ref) or "").strip()
+        if not got.lower().startswith(expect.lower()):
+            bad.append("%s!%s expected '%s...' but found '%s'" % (sheet, ref, expect, got[:40]))
+    if bad:
+        raise TemplateError("This doesn't look like the HDFC export-of-services form edf-tool knows:\n  "
+                            + "\n  ".join(bad),
+                            hint="HDFC may have changed the form. Open an issue with the new form attached "
+                                 "(remove your personal data first).")
+
+
+def fill(wb, c, inv):
+    ex, bk, cl, tp, sv = c["exporter"], c["bank"], c["client"], c["third_party"], c["service"]
+    cur = sv["currency"]
+    amt, net, fee = inv["amount"], inv["net"], inv["fee"]
+    has_tp = bool(tp.get("enabled"))
+    payer_short = tp.get("name", "").split(",")[0] if has_tp else ""
+
+    words = "%s (%s %s)" % (amount_in_words(amt, cur), cur, money(amt))
+    exporter = "M/S. %s (%s: %s), %s" % (ex["firm_name"], "Proprietor" if "propriet" in ex.get("constitution", "").lower()
+                                         else "Authorised signatory", ex["proprietor"], ", ".join(ex["address_lines"]))
+    via = ("by SWIFT wire from %s on behalf of %s" % (tp["name"], cl["name"])) if has_tp else ("by SWIFT wire from %s" % cl["name"])
+    fee_txt = ("; %s deducts %s %s transaction fee, net %s %s" % (payer_short or "Intermediary", cur, short_money(fee), cur,
+                                                                   short_money(net))) if fee else ""
+    remark = "Payment for invoice %s (%s %s) will be received %s%s." % (inv["invoice_no"], cur, short_money(amt), via, fee_txt)
+    if fee:
+        inv_remark = ("Via %s; %s %s fee deducted, net %s %s" % (payer_short, cur, short_money(fee), cur, short_money(net))
+                      if has_tp else "%s %s charges deducted, net %s %s" % (cur, short_money(fee), cur, short_money(net)))
+        row_remark = ("%s fee %s %s" % (payer_short, cur, short_money(fee))) if has_tp else ("Charges %s %s" % (cur, short_money(fee)))
+    else:
+        inv_remark = ("Via %s" % payer_short) if has_tp else "-"
+        row_remark = ("Via %s" % payer_short) if has_tp else "-"
+    signer_role = "Proprietor" if "propriet" in ex.get("constitution", "").lower() else "Authorised Signatory"
+
+    L = LETTER
+    for ref, v in [
+        ("A4", bk["branch_name"]), ("AG3", dmony(inv["letter_date"])), ("H5", bk["account_no"]),
+        ("F6", "%s - %s" % (sv["purpose_code"], sv["purpose_description"])),
+        ("L7", "No forward contract - bank card rate on date of credit"),
+        ("A8", "AD Code: To be filled by Bank"), ("P8", "IEC: %s" % (ex.get("iec") or "Not applicable")),
+        ("AB8", "GSTIN: %s" % ex["gstin"]), ("A9", "Customer PAN: %s" % ex["pan"]),
+        ("P10", "%s, %s, %s (IFSC: %s)" % (bk.get("name", "HDFC Bank Ltd"), bk["branch_name"], bk["branch_address"], bk["ifsc"])),
+        ("P11", exporter),
+        ("E12", "Service"), ("AD12", "Regular Export"), ("F13", "Internet"),
+        ("P14", "Others (Specify) - Service exporter"),
+        ("AD15", "Country of Final Destination: %s" % cl["country"]),
+        ("D16", dmy(inv["invoice_date"])), ("U16", "Non dispatch"),
+        ("G19", sv["description"]), ("G20", words),
+        ("E21", "YES" if has_tp else "NO"),
+        ("S21", ("%s, %s" % (tp["name"], tp.get("short_address") or tp["address"])) if has_tp else "-"),
+        ("B25", cl.get("short_address") or cl["name"]), ("E25", cl["country"]), ("J25", inv["invoice_no"]),
+        ("O25", dmy(inv["invoice_date"])), ("T25", cur), ("U25", num(amt)), ("X25", num(net)), ("AB25", "-"),
+        ("AE25", sv.get("short_description") or sv["description"]), ("AH25", sv["sac"]), ("AK25", row_remark),
+        ("Q29", bk.get("fee_account_no") or bk["account_no"]), ("M30", ex["phone"]), ("AE30", ex["email"]),
+        ("E34", remark), ("B35", "%s (%s: %s)" % (ex["firm_name"], signer_role, ex["proprietor"])),
+        ("B40", "AUTHORISED SIGNATORY\n(Signature as per Bank record with company seal)"),
+    ]:
+        wb.set(L, ref, v)
+    wb.restyle(L, "G19", "113", "114")   # HDFC's template has a strikethrough font on this cell
+
+    A = ANNEX
+    wb.set(A, "A6", bk.get("fee_account_no") or bk["account_no"])
+    for ref in ("B7", "L7", "O7"):
+        wb.set(A, ref, None)              # stray test text in the template
+    for ref, v in [
+        ("B11", "Service"), ("C11", "Internet"), ("D11", "Others (Specify)"),
+        ("E11", "Others (advance payment, etc. including transfer/remittance to bank a/c maintained overseas)"),
+        ("F11", "Regular Export"), ("H11", "Non dispatch"), ("I11", sv["description"]), ("J11", words),
+        ("K11", cl["name"]), ("L11", ", ".join(cl["address_lines"])), ("M11", cl["country"]),
+        ("Q11", tp["name"] if has_tp else None), ("R11", tp["address"] if has_tp else None),
+        ("S11", cl["country"]), ("T11", tp.get("relationship") if has_tp else None),
+        ("U11", "Service exporter - %s (non-SEZ/EOU/STPI)" % ex.get("constitution", "Sole Proprietorship")),
+    ]:
+        wb.set(A, ref, v)
+    for col in "BCDEFHIJ":
+        wb.set(A, col + "12", None)       # one EDF per run
+
+    I = INV1
+    for ref, v in [("A3", inv["invoice_no"]), ("B3", dmy(inv["invoice_date"])), ("C3", num(amt)), ("D3", cur),
+                   ("E3", num(net)), ("F3", "-"), ("G3", "-"), ("H3", sv["description"]), ("I3", sv["sac"]),
+                   ("J3", inv_remark)]:
+        wb.set(I, ref, v)
+    for r in range(4, 8):
+        wb.set(I, "A%d" % r, None)        # template placeholder numbers
+    for r in range(3, 8):
+        wb.set(INV2, "A%d" % r, None)
+
+    heights = {r: 22 for r in list(range(2, 10)) + [14, 19, 20, 21, 29, 30, 33, 35, 39]}
+    heights.update({36: 30, 37: 30, 38: 30, 10: 34, 11: 34, 12: 30, 13: 30, 16: 22, 17: 22, 18: 22,
+                    25: 36, 26: 20, 27: 20, 28: 20, 34: 40})
+    wb.layout(L, heights)
+    wb.layout(A, {11: 110}, landscape=True, pages_wide=3)
+    wb.layout(I, {3: 60}, landscape=True)
+
+
+def place_signature(wb, png):
+    # just above the "____" signatory line (B39), left aligned with it
+    wb.add_image(LETTER, png, col=1, row=36, col_off=60000, row_off=260000, width_emu=1950000)