ربط زاتكا بـ Go
طلب HTTP واحد من Go (net/http + database/sql): ماثل يبني الفاتورة ويوقّعها ويرسلها للهيئة، ويرجّع رد الهيئة والـ XML القانوني والـ PDF مع رمز QR.
١. جرّبه الحين (بدون مفتاح)
// go run main.go: the sandbox needs no key
package main
import ("bytes"; "encoding/json"; "fmt"; "net/http")
func main() {
body, _ := json.Marshal(map[string]any{"environment": "sandbox", "pdf": true, "invoice": map[string]any{
"type": "simplified", "line_items": []map[string]any{{"name": "قهوة", "quantity": 2, "price": "50.00"}}}})
r, _ := http.Post("https://matheel.app/api/v1/invoices", "application/json", bytes.NewReader(body))
var res map[string]any
json.NewDecoder(r.Body).Decode(&res)
fmt.Println(res["status"]) // reported
}
٢. الدالة الجاهزة بعد الدفع
تقفل صف الجهاز (عشان دفعتين بنفس اللحظة ما يكسرون السلسلة)، ترسل الفاتورة مع "pdf": true، وتحفظ device_token الجديد. أي رد غير 200 يرجّع الـ transaction والمفتاح القديم يظل صالح.
// database/sql + net/http.
func MatheelInvoice(db *sql.DB, items []map[string]any) (map[string]any, error) {
tx, err := db.Begin()
if err != nil { return nil, err }
defer tx.Rollback() // no-op after Commit
var token string
if err := tx.QueryRow("SELECT token FROM matheel_device WHERE id = 1 FOR UPDATE").Scan(&token); err != nil { return nil, err }
body, _ := json.Marshal(map[string]any{"device_token": token, "pdf": true,
"invoice": map[string]any{"type": "simplified", "line_items": items}})
req, _ := http.NewRequest("POST", "https://matheel.app/api/v1/invoices", bytes.NewReader(body))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer "+os.Getenv("MATHEEL_KEY"))
r, err := http.DefaultClient.Do(req)
if err != nil { return nil, err }
defer r.Body.Close()
var res map[string]any
json.NewDecoder(r.Body).Decode(&res)
if r.StatusCode != 200 { return nil, fmt.Errorf("matheel %d: %v", r.StatusCode, res) }
if _, err := tx.Exec("UPDATE matheel_device SET token = $1 WHERE id = 1", res["device_token"]); err != nil { return nil, err }
return res, tx.Commit()
}
٣. للإنتاج
- سجّل جهازك مرة (مفتاح الجهاز أو لينك التفعيل) وحط
device_tokenفي جدولmatheel_device. - لو المبلغ اللي معك شامل الضريبة، أرسل
"prices_include_vat": true. - احفظ
invoice_xml(القانوني) وpdfمع الطلب، والتطبيق يعرض الـ PDF من سيرفرك.
أسئلة شائعة
أحتاج مكتبة Go خاصة بزاتكا؟
لا. ماثل API عادي بـ JSON: طلب HTTP واحد. التوقيع والـ XML والشهادة والإرسال للهيئة كلها عند ماثل.
وين أحفظ مفتاح الجهاز؟
صف واحد في قاعدة بياناتك (جدول matheel_device). بعد كل رد 200 احفظ device_token الجديد في نفس الـ transaction.
أجرّب قبل الاشتراك؟
إيه، على بيئة المطورين بدون مفتاح: الطلب تحت يرجّع رد الهيئة الحقيقي والـ PDF.