Skip to main content

เงื่อนไขการระบุข้อมูลชำระเงิน

เพิ่มเงื่อนไขในการระบุข้อมูลการชำระเงิน (Payment Validation)

เนื่องด้วยปัจจุบันทาง FlowAccount พบว่ามีการรับข้อมูลที่ไม่ถูกตห้องผ่าน Open API สำหรับการบันทึกข้อมูลการชำระเงิน ซึ่งส่งผลกระทบต่อการเปลี่ยนสถานะ ของเอกสารและการลงบัญชี จึงได้มีการเพิ่มเงื่อนไขในการระบุข้อมูลการชำระเงิน (Payment Validation) โดยการเพิ่ม Required field ตามช่องทางการชำระเงินต่าง ๆ (Pyament Channel) และประเภทเอกสารขาย/ซื้อ

ผู้ใช้งานสามารถทดลองได้บน Sandbox และส่ง Feedback เพิ่มเติมได้ตั้งแต่วันที่ 26/04/2024 - 08/05/2024 Sandbox API url: https://openapi.flowaccount.com/test

เริ่มมีผลบน Production Environment: 09/05/2024 11:00

ข้อกำหนดเบื้องต้น :

  • การชำระเงินผ่านช่องทาง Cheque, Credit Card, Petty Cash และ Other Channels ผู้ใช้งานจำเป็นต้องการเพิ่มช่องทางการชำระเงินผ่านหน้าเว็บ UI ก่อน
  • การชำระเงินผ่านช่องทาง Transfer ผู้ใช้งานจำเป็นต้องเพิ่มช่องทางการชำระเงินโดยการสร้างบัญชีธนาคาร (Create Bank Account) ผ่านการเรียกใช้ API จาก My Company > Create Bank Account หรือหน้าเว็บ UI ก่อน

เอกสารขาย

  • Cash (PaymentMethod: 1)
  • Cheque (PaymentMethod: 3)
    • Required:
      • ChequeBankAccountId
      • ChequeDate
    • กรณีไม่ระบุ Required field ดังกล่าวจะ error
      • Message: "PaymentMethod Cheque requires ChequeBankAccountId" หรือ
      • Message: "PaymentMethod Cheque requires ChequeDate"
  • Transfer (paymentMethod: 5)
    • Required:
      • bankAccountId
    • กรณีไม่ระบุ required field ดังกล่าวจะ error
      • Message: "PaymentMethod Transfer requires bankAccountId"
  • Other channel (paymentMethod: 13)
    • Required:
      • otherChannelId
    • กรณีไม่ระบุ required field ดังกล่าวจะ error
      • Message: "PaymentMethod OtherChannel requires otherChannelId"

เอกสารซื้อ

  • Cash (PaymentMethod: 1)
  • Cheque (paymentMethod: 3)
    • Required:
      • ChequeDate
      • ChequeBankAccountId
      • bankAccountId
      • bankChequeId
    • กรณีไม่ระบุ required field ดังกล่าว error
      • message:"PaymentMethod Cheque requires ChequeBankAccountId" หรือ
      • message:"PaymentMethod Cheque requires ChequeDate" หรือ
      • message:"PaymentMethod Cheque requires bankAccountId" หรือ
      • message:"PaymentMethod Cheque requires bankChequeId"
  • Transfer (paymentMethod: 5)
    • Required:
      • bankAccountId
    • กรณีไม่ระบุ required field ดังกล่าวจะ error
      • message:"PaymentMethod Transfer requires bankAccountId"
  • Credit Card (paymentMethod: 7)
    • Required:
      • creditCardBankAccountId
      • creditCardId
    • กรณีไม่ระบุ required field ดังกล่าวจะ error
      • message:"PaymentMethod CreditCard requires
    • creditCardBankAccountId"
      • message:"PaymentMethod CreditCard requires creditCardId"
  • Petty Cash (paymentMethod: 11)
    • Required:
      • pettyCashId
    • กรณีไม่ระบุ required field ดังกล่าวจะ error
      • message:"PaymentMethod PettyCash requires pettyCashId"
  • Other channel (paymentMethod: 13)
    • Required:
      • otherChannelId
    • กรณีไม่ระบุ required field ดังกล่าวจะ error
      • message:"PaymentMethod OtherChannel requires otherChannelId"

สำหรับข้อมูล Required field ที่เพิ่มเข้ามา ผู้ใช้งานสามารถ Get มาได้จาก My Company > Bank Channel และเลือก APIs ตามช่องทางการชำระเงินที่ต้อง (Ref. https://developers.flowaccount.com/#tag/Bank-Channel)

APIs ที่จะได้รับผลกระทบ (as of 25/4/2024)

  • POST /tax-invoices/{id}/payment
  • POST /cash-invoices/{id}/payment
  • POST /receipts/{id}payment
  • POST /purchases/{id}/payment
  • POST /expenses/{id}/payment
  • POST /tax-invoices/with-payment
  • POST /cash-invoices/with-payment
  • POST /purchases/with-payment
  • POST /expenses/with-payment
  • POST /tax-invoices/inline/with-payment
  • POST /cash-invoices/inline/with-payment
  • POST /purchases/inline/with-payment

APIs ที่จะได้รับผลกระทบในอนาคต (TBC)

  • POST /receipts/with-payment
  • POST /receipts/inline/with-payment
  • POST /expenses/inline/with-payment
  • POST /upgrade/tax-invoices/with-payment
  • POST /upgrade/cash-invoices/with-payment
  • POST /upgrade/receipts/with-payment
  • POST /upgrade/purchases/with-payment
  • POST /upgrade/expenses/with-payment
  • POST /upgrade/tax-invoices/inline/with-payment
  • POST /upgrade/cash-invoices/inline/with-payment
  • POST /upgrade/receipts/inline/with-payment
  • POST /upgrade/purchases/inline/with-payment
  • POST /upgrade/expenses/inline/with-payment