README.md aktualisiert
This commit is contained in:
@@ -1,141 +1,16 @@
|
|||||||
# erpnext_custom
|
# erpnext_custom
|
||||||
|
|
||||||
Custom App für NEXTErp mit WooCommerce ACF Sync (Advanced Custom Fields).
|
Custom App für NEXTErp mit zuverlässigem Sync von Custom Fields zu WooCommerce (ACF / Meta Data).
|
||||||
|
|
||||||
## Funktionen
|
## Funktionen
|
||||||
- Übertragung beliebiger Custom Fields aus dem ERPNext-Item nach WooCommerce (ACF)
|
- Sync beliebiger Custom Fields aus ERPNext-Item nach WooCommerce
|
||||||
- Dynamisches Mapping über das DocType `WooCommerce ACF Mapping`
|
- Verwendung von `meta_data` (stabiler als ACF-Block)
|
||||||
- Funktioniert mit mehreren WooCommerce Servern
|
- Manueller Sync-Button im Item-Formular
|
||||||
|
|
||||||
## Installation (empfohlener Weg)
|
## Installation
|
||||||
|
|
||||||
### 1. App auf dem Server erstellen
|
### 1. App erstellen
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd ~/frappe-bench
|
cd ~/frappe-bench
|
||||||
bench new-app erpnext_custom
|
bench new-app erpnext_custom
|
||||||
```
|
|
||||||
|
|
||||||
Bei den Fragen folgendes eingeben:
|
|
||||||
|
|
||||||
App Title: NEXTErp Custom
|
|
||||||
App Description: WooCommerce ACF Custom Fields Sync
|
|
||||||
App Publisher: Jens Falk
|
|
||||||
App Email: service@falk.plus (oder deine Email)
|
|
||||||
Branch Name: main oder einfach Enter drücken
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd ~/frappe-bench/apps/erpnext_custom/erpnext_custom
|
|
||||||
```
|
|
||||||
|
|
||||||
# Hier die aktuelle api.py einfügen (z.B. per cat > api.py << 'EOF' ...) z.B.
|
|
||||||
```bash
|
|
||||||
cat > api.py << 'EOF'
|
|
||||||
import frappe
|
|
||||||
import requests
|
|
||||||
from frappe import _
|
|
||||||
|
|
||||||
@frappe.whitelist()
|
|
||||||
def sync_custom_fields_to_woocommerce(item_code):
|
|
||||||
"""Sync Custom Fields vom Item nach WooCommerce ACF (dynamisch aus DocType)"""
|
|
||||||
|
|
||||||
if not item_code:
|
|
||||||
frappe.throw(_("Kein Item Code angegeben"))
|
|
||||||
|
|
||||||
try:
|
|
||||||
doc = frappe.get_doc("Item", item_code)
|
|
||||||
except Exception:
|
|
||||||
frappe.throw(_("Item {0} nicht gefunden").format(item_code))
|
|
||||||
|
|
||||||
if not doc.get("woocommerce_servers"):
|
|
||||||
frappe.msgprint(_("Item hat keine verknüpften WooCommerce Server"), indicator="orange")
|
|
||||||
return False
|
|
||||||
|
|
||||||
# Dynamisches Mapping aus dem DocType "WooCommerce ACF Mapping"
|
|
||||||
field_mapping = {}
|
|
||||||
mappings = frappe.get_all("WooCommerce ACF Mapping",
|
|
||||||
filters={"enabled": 1},
|
|
||||||
fields=["erp_field", "acf_field"])
|
|
||||||
|
|
||||||
for m in mappings:
|
|
||||||
if m.erp_field and m.acf_field:
|
|
||||||
field_mapping[m.erp_field] = m.acf_field
|
|
||||||
|
|
||||||
if not field_mapping:
|
|
||||||
frappe.msgprint(_("Keine aktivierten Mappings im DocType 'WooCommerce ACF Mapping' gefunden."), indicator="orange")
|
|
||||||
return False
|
|
||||||
|
|
||||||
success_count = 0
|
|
||||||
errors = []
|
|
||||||
|
|
||||||
for wc_link in doc.woocommerce_servers:
|
|
||||||
if not wc_link.enable_sync or not wc_link.woocommerce_id:
|
|
||||||
continue
|
|
||||||
|
|
||||||
try:
|
|
||||||
wc_server = frappe.get_doc("WooCommerce Server", wc_link.woocommerce_server)
|
|
||||||
|
|
||||||
if not wc_server.api_key or not wc_server.api_secret:
|
|
||||||
errors.append("WooCommerce Server {} hat keine Zugangsdaten".format(wc_link.woocommerce_server))
|
|
||||||
continue
|
|
||||||
|
|
||||||
base_url = wc_server.woocommerce_server_url.rstrip("/")
|
|
||||||
if not base_url.endswith("/wp-json/wc/v3"):
|
|
||||||
base_url += "/wp-json/wc/v3"
|
|
||||||
|
|
||||||
url = "{}/products/{}".format(base_url, wc_link.woocommerce_id)
|
|
||||||
auth = (wc_server.api_key, wc_server.api_secret)
|
|
||||||
|
|
||||||
resp = requests.get(url, auth=auth, timeout=15)
|
|
||||||
resp.raise_for_status()
|
|
||||||
product = resp.json()
|
|
||||||
|
|
||||||
acf_data = product.get("acf", {})
|
|
||||||
|
|
||||||
updated_fields = 0
|
|
||||||
for erp_field, acf_field in field_mapping.items():
|
|
||||||
value = doc.get(erp_field)
|
|
||||||
if value is not None:
|
|
||||||
acf_data[acf_field] = value
|
|
||||||
updated_fields += 1
|
|
||||||
|
|
||||||
if updated_fields == 0:
|
|
||||||
continue
|
|
||||||
|
|
||||||
payload = {"acf": acf_data}
|
|
||||||
|
|
||||||
update_resp = requests.put(url, json=payload, auth=auth, timeout=15)
|
|
||||||
update_resp.raise_for_status()
|
|
||||||
|
|
||||||
success_count += 1
|
|
||||||
|
|
||||||
except Exception as e:
|
|
||||||
error_msg = "Fehler für Item {} / WC-ID {}: {}".format(item_code, wc_link.woocommerce_id, str(e))
|
|
||||||
errors.append(error_msg)
|
|
||||||
frappe.log_error(error_msg, "WooCommerce ACF Sync")
|
|
||||||
|
|
||||||
if success_count > 0:
|
|
||||||
msg = "Custom Fields für {} WooCommerce-Produkt(e) erfolgreich synchronisiert".format(success_count)
|
|
||||||
if errors:
|
|
||||||
msg += " ({} Fehler)".format(len(errors))
|
|
||||||
frappe.msgprint(msg, alert=True, indicator="green")
|
|
||||||
return True
|
|
||||||
else:
|
|
||||||
if errors:
|
|
||||||
frappe.msgprint("Fehler beim Sync:\n" + "\n".join(errors[:3]), indicator="red")
|
|
||||||
else:
|
|
||||||
frappe.msgprint("Keine Felder wurden synchronisiert.", indicator="orange")
|
|
||||||
return False
|
|
||||||
EOF
|
|
||||||
```
|
|
||||||
|
|
||||||
### Installation abschließen
|
|
||||||
|
|
||||||
```bash
|
|
||||||
bench --site erp.berchmans.de install-app erpnext_custom --force
|
|
||||||
bench --site erp.berchmans.de migrate
|
|
||||||
bench restart
|
|
||||||
```
|
|
||||||
|
|
||||||
Weiterer Schritt (nach Installation)
|
|
||||||
Danach das DocType WooCommerce ACF Mapping anlegen
|
|
||||||
Reference in New Issue
Block a user