Freeable 3.15.0 — เปิด API ให้ระบบภายนอกสร้างเอกสารได้

รีลีสนี้เปิดประตูให้ระบบภายนอก — บอตอัตโนมัติ อุปกรณ์หน้างาน หรือระบบของคู่ค้า — เข้ามาสร้างเอกสารในระบบได้โดยตรง

สร้างเอกสารผ่าน API ได้ 4 ชนิด

ระบบภายนอกส่งข้อมูลเข้ามาสร้างเอกสารได้ ครอบคลุมทั้งใบสั่งขาย ใบเสนอราคา และเอกสารขายอีกสองชนิด

ทดสอบจริงบนเครื่องพัฒนาครบทุกช่องทางแล้ว โดยสร้างเอกสารจริงและตรวจว่าเลขที่เอกสารออกถูกชุด

สิทธิ์ต่อกุญแจ

แต่ละกุญแจกำหนดได้ว่าทำอะไรได้บ้าง กับข้อมูลของกิจการไหน ไม่ใช่ให้สิทธิ์เต็มทุกใบเหมือนที่หลายระบบทำ

สิทธิ์ระบุเป็นคู่ของ “การกระทำ” กับ “สิ่งที่กระทำ” เช่นกุญแจของอุปกรณ์สแกนหน้าคลังอาจอ่านข้อมูลสินค้าได้อย่างเดียว ส่วนกุญแจของระบบขายหน้าร้านสร้างใบสั่งขายได้แต่ยุ่งกับข้อมูลบัญชีไม่ได้

กันสร้างซ้ำ

ถ้าระบบปลายทางส่งคำขอซ้ำเพราะเน็ตหลุดหรือหมดเวลารอ ระบบจะรู้ว่าเป็นคำขอเดิมและไม่สร้างเอกสารซ้ำ แต่ตอบผลลัพธ์เดิมกลับไป

เรื่องนี้จำเป็นมากสำหรับ API ที่สร้างเอกสารทางการเงิน เพราะการส่งซ้ำเป็นเรื่องปกติของการเชื่อมต่อผ่านเครือข่าย และเอกสารซ้ำแปลว่าตัวเลขทางบัญชีผิด

ทะเบียนอุปกรณ์หน้างาน

ลงทะเบียนเครื่องที่หน้าร้านหรือหน้าคลังไว้ พร้อมหน้าจัดการอุปกรณ์ ทำให้รู้ว่าเอกสารแต่ละใบมาจากเครื่องไหน ซึ่งจำเป็นทั้งตอนไล่ปัญหาและตอนตรวจสอบย้อนหลัง

ยิงบาร์โค้ดผ่าน API

• ค้นสินค้าจากบาร์โค้ดหรือรหัส แล้วได้ข้อมูลสินค้ากลับมา
• บันทึกการรับสินค้า เข้าระบบได้จากอุปกรณ์หน้าคลังโดยตรง
• ชุดเครื่องมือสแกนบนเว็บ — รองรับเครื่องสแกนแบบที่ทำงานเหมือนแป้นพิมพ์ ซึ่งเป็นแบบที่ใช้กันมากที่สุดเพราะเสียบแล้วใช้ได้เลย

งานจัดระเบียบที่ตามมา

• แยกส่วนบันทึกเอกสารขายออกเป็นชิ้นอิสระ — เพราะทั้งหน้าเว็บและ API ต้องใช้ตรรกะเดียวกัน ถ้าไม่แยกจะกลายเป็นโค้ดสองชุดที่ต้องแก้คู่กันตลอดไป
• แปลงรหัสสินค้าที่ส่งมาให้ตรงกับที่เก็บจริง — ระบบเดิมเก็บรหัสสินค้าแบบเติมช่องว่างให้ครบความยาว ถ้าไม่แปลงก่อนก็หาสินค้าไม่เจอ
• จัดลำดับการตรวจสอบให้ถูก — ตรวจสิทธิ์ก่อนตรวจความครบถ้วนของคำขอ เพื่อไม่ให้บอกใบ้ข้อมูลกับผู้เรียกที่ไม่มีสิทธิ์
• ชุดทดสอบใหม่ 24 เคส สำหรับระบบสิทธิ์และการกันสร้างซ้ำ

ระหว่างทางยังพบปัญหาข้อมูลสต๊อกซ้ำที่เกิดจากการเทียบรหัสสินค้าแบบตัดช่องว่าง ซึ่งแยกไปแก้ในรีลีสถัดไป