Release Note
version 24.4
15 March 2025
Features
Enhancing API Key Security
getInvoice เวอร์ชันล่าสุด เพิ่มคุณสมบัติต่าง ๆ ของการใช้งาน API ตามมาตรฐานที่บริษัทชั้นนำใช้งาน (เช่น Microsoft) โดยการกำหนดให้มี วันหมดอายุ และการใช้งาน API Secert เพื่อส่ง Token เมื่อใช้งาน API โดยมีรายละเอียดดังนี้
(1.) การกำหนดวันหมดอายุของ API KEY
- สำหรับผู้ใช้งานระบบก่อนวันที่ 15 มีนาคม 2568 จะได้รับการตั้งค่าวันหมดอายุของ API เป็น “ไม่มีวันหมดอายุ” จนกว่าท่านจะขอเปลี่ยนแปลง (ใช้งานได้ตามปกติ)
- สำหรับผู้ใช้งานระบบหลังวันที่ 15 มีนาคม 2568 จะต้องเลือกวันหมดอายุของ API และกด generate API ดังกล่าว ก่อนเริ่มใช้งานระบบ
- การกำหนดวันหมดอายุของ API key สามารถกำหนดได้เองที่หน้าจอ admin โดยมีตัวเลือกต่างๆ เช่น 90 วัน 6 เดือน 1 ปี เป็นต้น, เมื่อกำหนดแล้ว ระบบจะแสดงหน้าจอให้ Regenerate key ใหม่เพื่อใช้งาน โดย key ใหม่นี้จะมีอายุการใช้งานตามที่เลือก (และ key เดิม จะหมดอายุภายใน 24 ชม.)
- ก่อน key หมดอายุ 30, 15, 1 วัน จะมี Email แจ้งเตือน จากระบบ getInvoice ไปยังผู้ใช้งาน (admin) รวม 3 email
ตัวอย่างหน้าจอการกำหนดวันหมดอายุของ API key
ตัวอย่างหน้าจอ การ Regenerate key
(2.) API secert
API secret คือการเปิดช่องทางพิเศษเพื่อส่ง token แต่ละครั้งเท่านั้น โดยช่องทางนี้จะปิดภายใน 15 นาที เพื่อป้องกันการถูกแทรกแซงจากภายนอก
หมายเหตุ: เมื่อ user เลือกเปิดใช้งาน API secret แล้ว จะไม่สามารถย้อนกลับได้, กรุณาปรึกษากับทีม App Support ของ getInvoice ก่อนเปิดใช้งาน
ตัวอย่างการเพิ่ม API secret เพื่อใช้งานร่วมกับ token
What’s New
(1.) สามารถ Customize ข้อความที่แสดงบน หน้าจอ เมื่อ “ผู้ซื้อ” เข้าใช้งานหน้าจอขอออกใบกำกับภาษีเต็มรูปแบบ และหน้าจอ ขอแก้ไขใบกำกับภาษี
- Reseller admin สามารถ เปิดและปิด หน้าจอยอมรับนโยบายคุ้มครองข้อมูลส่วนบุคคล (สำหรับผู้ซื้อ) ได้
- ลูกค้าท่านใด ต้องการสิทธิ์ในการเปิด/ปิด นี้ สามารถติดต่อกับทีม App support ของ getInvoice เพื่อให้เปิดสิทธิ์ดังกล่าว
- Corporate สามารถกำหนดข้อความที่ “ผู้ซื้อ” จะพบ เมื่อเข้าสู่หน้าจอขอออกใบกำกับภาษีเต็มรูปแบบ และหน้าจอขอแก้ไขใบกำกับภาษี)
- หน้าจอนี้ จะแสดงข้อความอธิบายเพื่อให้ “ผู้ซื้อ” กดยอมรับนโยบายคุ้มครองข้อมูลส่วนบุคคล จึงจะใช้งานต่อได้
(ข้อความที่แสดง สามารถแก้ไข และเพิ่ม HTML linkไปยัง “นโยบายคุ้มครองข้อมูลส่วนบุคคล” ได้ตามต้องการ, โปรดดูคู่มือการใช้งานประกอบ) - หากไม่เลือกกดยอมรับ จะไม่สามารถใช้งานต่อได้
ตัวอย่างหน้าจอ และตัวอย่างข้อความที่แสดงสำหรับ “ผู้ซื้อ” (กรอบสีแดง)
(2.) เพิ่ม Reference type ของ Cancel an Invoice เอกสารประเภท ABB Tax invoice และ Receipt / ABB Tax invoice
เมนู CREATE AN INVOICE, ตัวเลือก Reference Type สำหรับ cancel invoice
(3.) เพิ่มหน้าจอ pop up “ขอความยินยอมใช้ข้อมูลส่วนบุคคล”
เมื่อ User เข้าใช้งาน ระบบจะแสดงหน้าจอขอความยินยอมในการใช้ข้อมูลส่วนบุคคลของคุณ เพื่อวัตถุประสงค์ในการพัฒนาผลิตภัณฑ์ เช่น การวิเคราะห์และการจัดการผลิตภัณฑ์ ข้อมูลของคุณอาจถูกรวมกับข้อมูลประชากรและข้อมูลอื่น ๆ ที่เราได้รับทางออนไลน์หรือออฟไลน์ นอกจากนี้ เรายังใช้ข้อมูลเพื่อแจ้งข่าวสาร บทความ ข้อมูลผลิตภัณฑ์ บริการ และโปรโมชั่นพิเศษของ getInvoice และผลิตภัณฑ์อื่น ๆ ของบริษัทกิงโกะ ซอฟต์ จำกัด การยินยอมหรือไม่ยินยอมจะไม่ส่งผลต่อการใช้งานระบบหลักของคุณ
Fixed
- ลดเวลาในการสร้าง corporate ใหม่ และ add new user
และส่ง email แจ้ง new user (แจ้ง username และ password) - Fix SFTP connection error handling
- Fix case RD-response ก่อนขั้นตอน acknowledgment, ให้ถูกต้องตามลำดับ (acknowledgment ก่อน response)
Enhancing API Key Security
The latest version of getInvoice enhances API functionality to align with industry standards used by leading companies like Microsoft. Key updates include: API Key Expiration Date and API Secret for Token Generation. These improvements aim to provide users with a more secure and standardized API experience.
(1.) API Key Expiration Date
- For Users Before March 15, 2025: Your API keys will be set to “No Expiration Date” by default. You can continue using them as usual until you request a change.
- For Users After March 15, 2025: You must select an expiration date for your API keys and generate them before starting to use the system.
- API Key Expiration Management: You can set the expiration date of your API keys yourself on the admin dashboard. Options include 90 days, 6 months, 1 year, etc. Once set, the system will prompt you to regenerate a new key for use. The new key will have the selected lifespan, and the old key will expire within 24 hours.
- Expiration Reminders: You will receive email reminders from the getInvoice system 30, 15, and 1 day before your API key expires. These reminders will be sent to the admin user, totaling three emails.
A visual example of how to set the expiration date for your API keys within the system
(2.) API Key Expiration Date
The API secret feature opens a temporary channel to send tokens, which closes automatically after 15 minutes to prevent external interference.
Important Note: Once you enable the API secret feature, you cannot revert this setting. Please consult with the getInvoice App Support team before activating it.
A visual example of how to add an API secret to work in conjunction with tokens within the system.
What’s New
(1.) Users can customize the messages related to the personal data protection policy displayed on the full tax invoice request page and the tax invoice edit request page.
- Reseller admins can enable or disable the screen for accepting the personal data protection policy (for buyers).
- If you need permission to enable or disable this feature, please contact the getInvoice App Support team to have this permission granted.
- Corporations can define the messages that “buyers” will see when accessing the full tax invoice request page and the tax invoice edit request page.
- This screen will display explanatory text prompting “buyers” to accept the personal data protection policy before proceeding. (The displayed messages can be edited and include HTML links to the “Personal Data Protection Policy” as needed. Please refer to the user manual for more details.)
- If the buyer does not accept the policy, they will not be able to continue using the service.
A visual example of the screen and sample messages that will be displayed for buyers, highlighted in a red frame.
(2.) Added Reference Type for Canceling an Invoice, Document types: ABB Tax Invoice Receipt / ABB Tax Invoice.
CREATE AN INVOICE Menu: Reference Type Option for Canceling an Invoice.
(3.) Added Pop-up Screen for “Requesting Consent to Use Personal Data”
When users access our system, users will be prompted to consent to the use of your personal data for product development purposes, such as analysis and product management. Your data may be combined with demographic information and other data we collect online or offline. Additionally, we use your data to send news, articles, product information, services, and special promotions from getInvoice and other products of Gingko Soft Co., Ltd. Your decision to consent or not will not affect your primary use of the system.
Fixed
- Reduced time required to create new corporations and add new users. Enhanced email notification for new users, including their username and password.
- SFTP Connection Improvement:Fixed SFTP connection error handling. RD-Response Sequence Correction:
- Corrected the sequence of RD-response before the acknowledgment step to ensure that acknowledgment occurs before response, following the proper order.
