حالات الاستخدام

التحقق من تطابق العنوان مع رمزه البريدي المذكور قبل الدفع

المتسوق الذي يملأ نموذج الدفع تلقائيًا من إدخال محفوظ في المتصفح، أو ينسخ عنوانًا من رسالة بريد إلكتروني قديمة، ينتهي أحيانًا برمز بريدي من موقع مقترن باسم مدينة من موقع آخر، وهو خطأ يسهل الوقوع فيه ويسهل أن يفوت عند قراءة نموذج مملوء على عجل قبل النقر على زر الإرسال. وجد متجر إلكتروني يشحن سلعًا مادية أن عدم التطابق هذا بالتحديد يقف وراء تدفق ثابت ومنخفض من عمليات التوصيل الخاطئة أو المتأخرة، كل منها صغير بمفرده، لكنها مجتمعة تمثل تكلفة حقيقية في إعادة الشحن وإحباط العملاء.

كان الحل فحصًا متقاطعًا يعمل تلقائيًا عند إتمام الشراء، قبل تأكيد الطلب. كان الرمز البريدي المدخل في النموذج يُرسل إلى /v1/postcode، الذي يحدد الموقع الذي يقابله ذلك الرمز فعليًا. وكان المتجر يقارن الموقع المحلول بالمدينة والمنطقة اللتين أدخلهما المتسوق أيضًا في النموذج نفسه، وعندما يختلفان بوضوح، وبدلًا من تمرير الطلب واكتشاف عدم التطابق فقط بعد ذهاب التوصيل إلى المكان الخطأ، كان مسار الدفع يتوقف مع رسالة بسيطة تطلب من المتسوق مراجعة الرمز البريدي والمدينة قبل المتابعة.

أجرى المتجر أيضًا العنوان المدخل كاملًا عبر /v1/forward كطبقة ثانية، لأن العنوان قد يجتاز الفحص المتقاطع للرمز البريدي والمدينة ومع ذلك تكون فيه مشكلة حقيقية في موضع آخر، كشارع لا يوجد بذلك الاسم أو رقم خارج النطاق المعقول لذلك الشارع، ومنحت الثقة في التطابق التي يعيدها استدعاء الترميز الجغرافي الأمامي مسار الدفع مؤشرًا ثانيًا يوازنه مع مقارنة الرمز البريدي، فيعلّم التطابقات الضعيفة بوضوح لرسالة التأكيد السريعة نفسها.

تعمّد المتجر ضبط مقدار الاحتكاك الذي يضيفه ذلك. اجتازت معظم الطلبات الفحصين فورًا ومرت عبر الدفع دون أي تغيير مرئي على الإطلاق، لأن الغالبية العظمى من المتسوقين يدخلون عناوينهم بشكل صحيح من المرة الأولى. ولم يرَ رسالة التأكيد سوى العدد الأصغر من الطلبات التي فيها عدم تطابق حقيقي، وحتى حينها لم تستغرق من المتسوق سوى بضع ثوانٍ للمراجعة والتصحيح، أو لتأكيد أن العنوان صحيح كما أُدخل، لأن عنوانًا غير مألوف ولكنه مشروع قد يثير الفحص أحيانًا دون أن يكون خاطئًا.

يغطي هذا النوع من الفحوص تكلفته تحديدًا لأن تكلفة اكتشاف عدم التطابق قبل الشحن أصغر بكثير من تكلفة طلب شُحن بالفعل إلى المكان الخطأ، أي إعادة شحن، مع توصيل أصلي متأخر أو ضائع، ومعهما في الغالب عميل محبط صار أقل ميلًا إلى الشراء مرة أخرى. إصلاح المشكلة في الثواني القليلة قبل تقديم الطلب، بدلًا من الأيام التي يستغرقها اكتشاف مشكلة الشحن وتصحيحها بعد وقوعها، نقل تلك التكلفة من كبيرة إلى ما يقارب الصفر.

كان كل طلب شراء يطلق فحصًا واحدًا للرمز البريدي وفحصًا واحدًا للعنوان، وهو عبء عمل يتناسب مباشرة مع حجم المبيعات وبقي ضمن الحصة اليومية المجانية لمتجر متوسط الحجم معظم أيام السنة، مع رصيد مسبق الدفع يغطي الفترات الأكثر ازدحامًا دون الحاجة إلى أي تخطيط خاص مسبق.

يتوفر توثيق نقطتي النهاية في /docs/postal-code-lookup/ و/docs/forward-geocoding/، ويتناول /docs/errors/ السلوك العام لمعالجة الأخطاء في كلتيهما.