ربط زاتكا بـ Elixir / Phoenix
طلب HTTP واحد من Elixir / Phoenix (Req + Ecto): ماثل يبني الفاتورة ويوقّعها ويرسلها للهيئة، ويرجّع رد الهيئة والـ XML القانوني والـ PDF مع رمز QR.
١. جرّبه الحين (بدون مفتاح)
Mix.install([:req])
%{body: res} =
Req.post!("https://matheel.app/api/v1/invoices",
json: %{environment: "sandbox", pdf: true, invoice: %{
type: "simplified", line_items: [%{name: "قهوة", quantity: 2, price: "50.00"}]}})
IO.puts(res["status"]) # reported
٢. الدالة الجاهزة بعد الدفع
تقفل صف الجهاز (عشان دفعتين بنفس اللحظة ما يكسرون السلسلة)، ترسل الفاتورة مع "pdf": true، وتحفظ device_token الجديد. أي رد غير 200 يرجّع الـ transaction والمفتاح القديم يظل صالح.
# Ecto (import Ecto.Query) + Req. A non-200 fails the match and raises, so the transaction rolls back and the old token stays.
def matheel_invoice(items) do
Repo.transaction(fn ->
device = Repo.one!(from d in MatheelDevice, where: d.id == 1, lock: "FOR UPDATE")
%{status: 200, body: res} =
Req.post!("https://matheel.app/api/v1/invoices",
auth: {:bearer, System.fetch_env!("MATHEEL_KEY")},
receive_timeout: 60_000,
retry: false,
json: %{device_token: device.token, pdf: true, invoice: %{type: "simplified", line_items: items}}
)
device |> Ecto.Changeset.change(token: res["device_token"]) |> Repo.update!()
res # Base.decode64!(res["pdf"]) is the PDF
end)
end
٣. للإنتاج
- سجّل جهازك مرة (مفتاح الجهاز أو لينك التفعيل) وحط
device_tokenفي جدولmatheel_device. - لو المبلغ اللي معك شامل الضريبة، أرسل
"prices_include_vat": true. - احفظ
invoice_xml(القانوني) وpdfمع الطلب، والتطبيق يعرض الـ PDF من سيرفرك.
أسئلة شائعة
أحتاج مكتبة Elixir / Phoenix خاصة بزاتكا؟
لا. ماثل API عادي بـ JSON: طلب HTTP واحد. التوقيع والـ XML والشهادة والإرسال للهيئة كلها عند ماثل.
وين أحفظ مفتاح الجهاز؟
صف واحد في قاعدة بياناتك (جدول matheel_device). بعد كل رد 200 احفظ device_token الجديد في نفس الـ transaction.
أجرّب قبل الاشتراك؟
إيه، على بيئة المطورين بدون مفتاح: الطلب تحت يرجّع رد الهيئة الحقيقي والـ PDF.