ربط زاتكا بـ 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

٣. للإنتاج

أسئلة شائعة

أحتاج مكتبة Elixir / Phoenix خاصة بزاتكا؟

لا. ماثل API عادي بـ JSON: طلب HTTP واحد. التوقيع والـ XML والشهادة والإرسال للهيئة كلها عند ماثل.

وين أحفظ مفتاح الجهاز؟

صف واحد في قاعدة بياناتك (جدول matheel_device). بعد كل رد 200 احفظ device_token الجديد في نفس الـ transaction.

أجرّب قبل الاشتراك؟

إيه، على بيئة المطورين بدون مفتاح: الطلب تحت يرجّع رد الهيئة الحقيقي والـ PDF.

جرّبه الحين على بيئة المطورين

بدون مفتاح ولا تسجيل: الرد رد الهيئة الحقيقي، ومعه الفاتورة PDF عربي وإنجليزي ورمز QR.

ابدأ الأسعار