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 לכל שורה.
מערכות נתמכות
- פריוריטיממשק REST של Priority (OData) מושך הזמנות מ-MAZMIN ומעדכן פריטים, מלאי, מחירים ויתרות.
- SAP Business Oneדרך Service Layer של SAP B1: הזמנות נכנסות כ-Sales Orders, ופריטים, מלאי ויתרות חוזרים ל-MAZMIN.
- חשבשבתסוכן סנכרון קטן במחשב של הנהלת החשבונות קורא מחשבשבת (או מ-H-Cloud) ושולח ל-API של MAZMIN; הזמנות נקלטות כתעודות/הזמנות.
- קומקסשירותי ה-Web Service של Comax מעדכנים פריטים, מלאי ומחירים, ומושכים הזמנות חדשות לפי מועד אחרון.
- ריווחיתה-API של ריווחית מפיק חשבוניות מהזמנות MAZMIN ומחזיר מסמכים ויתרות ללקוחות.
- iCountה-API של iCount מפיק מסמכים מהזמנות ומעדכן יתרות ותשלומים.
- מורנינג (חשבונית ירוקה)ה-API של Morning מפיק חשבונית מס/קבלה להזמנה ומחזיר את המסמך ל-MAZMIN.
- API פתוחלכל מערכת אחרת: מתכנת או Make/Zapier/n8n מתחברים ל-REST API עם מפתח, לפי התיעוד.