MAZMIN
התחברות
API v1

MAZMIN API למפתחים

REST API פשוט שמחבר את MAZMIN לכל ERP, הנהלת חשבונות או מערכת קופות: מושכים הזמנות, מאשרים קליטה, ודוחפים מוצרים, מלאי, מחירים, לקוחות וחשבוניות.

מפתח לכל חיבורנוצר במסך "חיבורים ו-API", נשמר מוצפן (hash) וניתן לביטול בכל רגע.
בידוד מלאמפתח רואה רק את נתוני החברה שלו ורק את ההרשאות שקיבל.
עד 5,000 שורות לקריאהעדכונים מרוכזים, עם דוח שגיאות לכל שורה.

התחלה מהירה

# 1. Pull new orders
curl "https://mazmin-fawn.vercel.app/api/v1/orders?unsynced=true" \
  -H "Authorization: Bearer mzn_live_xxxxxxxx"

# 2. After the ERP accepts it, acknowledge
curl -X POST "https://mazmin-fawn.vercel.app/api/v1/orders/GL-26034/ack" \
  -H "Authorization: Bearer mzn_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "erp_ref": "SO-10422", "ok": true }'

# 3. Push stock every few minutes
curl -X PUT "https://mazmin-fawn.vercel.app/api/v1/stock" \
  -H "Authorization: Bearer mzn_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '[{ "sku": "GL-1001", "stock": 96 }]'

נקודות קצה

  • GET/orders?unsynced=true&since=2026-11-01T00:00:00Z&limit=100orders:read

    הזמנות חדשות (עם פרטי הלקוח וח.פ)

  • POST/orders/GL-26034/ackorders:write

    אישור קליטה ב-ERP, מספר מסמך וסטטוס

    { "erp_ref": "SO-10422", "ok": true, "status": "approved" }
  • PUT/productsproducts:write

    יצירה ועדכון מוצרים לפי מק״ט

    [{ "sku": "GL-1001", "name": "אורז פרסי 1 ק״ג", "base_price": 8.2, "units_per_carton": 10, "stock": 120 }]
  • PUT/stockstock:write

    עדכון מלאי בלבד

    [{ "sku": "GL-1001", "stock": 96 }]
  • PUT/pricesprices:write

    מחיר אישי ללקוח (null מוחק)

    [{ "business_id": "514203391", "sku": "GL-1001", "price": 7.9 }]
  • GET/customerscustomers:read

    רשימת לקוחות

  • PUT/customerscustomers:write

    יצירה ועדכון לקוחות לפי ח.פ

    [{ "business_id": "514203391", "name": "סופר כהן", "credit_limit": 25000, "payment_terms": "net30" }]
  • PUT/invoicesinvoices:write

    חשבוניות וזיכויים מהנהלת החשבונות (יתרות ללקוח)

    [{ "number": "INV-88106", "business_id": "514203391", "date": "2026-11-05", "due_date": "2026-12-05", "amount": 2410.5, "paid": 0, "order_number": "GL-26034" }]

תשובות: ‎200 עם { data }, ‏401 מפתח שגוי, ‏403 חסרה הרשאה, ‏404 לא נמצא, ‏400 קלט שגוי. עדכונים מרוכזים מחזירים created / updated / errors לכל שורה.

מערכות נתמכות

  • Pפריוריטיממשק REST של Priority (OData) מושך הזמנות מ-MAZMIN ומעדכן פריטים, מלאי, מחירים ויתרות.
  • SAPSAP Business Oneדרך Service Layer של SAP B1: הזמנות נכנסות כ-Sales Orders, ופריטים, מלאי ויתרות חוזרים ל-MAZMIN.
  • חחשבשבתסוכן סנכרון קטן במחשב של הנהלת החשבונות קורא מחשבשבת (או מ-H-Cloud) ושולח ל-API של MAZMIN; הזמנות נקלטות כתעודות/הזמנות.
  • Cקומקסשירותי ה-Web Service של Comax מעדכנים פריטים, מלאי ומחירים, ומושכים הזמנות חדשות לפי מועד אחרון.
  • רריווחיתה-API של ריווחית מפיק חשבוניות מהזמנות MAZMIN ומחזיר מסמכים ויתרות ללקוחות.
  • iCiCountה-API של iCount מפיק מסמכים מהזמנות ומעדכן יתרות ותשלומים.
  • Mמורנינג (חשבונית ירוקה)ה-API של Morning מפיק חשבונית מס/קבלה להזמנה ומחזיר את המסמך ל-MAZMIN.
  • { }API פתוחלכל מערכת אחרת: מתכנת או Make/Zapier/n8n מתחברים ל-REST API עם מפתח, לפי התיעוד.