WordPress.org

ລາວ

ດາວໂຫລດ WordPress
WordPress.org

Plugin Directory

PWL DTE for Bsale

PWL DTE for Bsale

ໂດຍ PluginLatam
ດາວໂຫຼດ

ຄຳອະທິບາຍ

PWL DTE for Bsale ເຊື່ອມຕໍ່ຮ້ານຄ້າ WooCommerce ຂອງທ່ານກັບ Bsale, ເຊິ່ງເປັນແພລດຟອມໃບບິນເອເລັກໂຕຣນິກ ແລະ ລະບົບຂາຍໜ້າຮ້ານຊັ້ນນຳໃນຊີລີ. ເມື່ອຄຳສັ່ງຊື້ສຳເລັດ, ປລັກອິນຈະສ້າງເອກະສານພາສີທີ່ກ່ຽວຂ້ອງ (ໃບບິນ ຫຼື ໃບກຳກັບພາສີເອເລັກໂຕຣນິກ) ໂດຍອັດຕະໂນມັດ ແລະ ສົ່ງໃຫ້ SII.

ຄຸນສົມບັດເດັ່ນ

  • ໃບບິນເອເລັກໂຕຣນິກອັດຕະໂນມັດ — ສ້າງຂຶ້ນເມື່ອຄຳສັ່ງຊື້ສຳເລັດ (codeSii 39)
  • ໃບກຳກັບພາສີເອເລັກໂຕຣນິກ — ລູກຄ້າສາມາດເລືອກ “ຂ້ອຍຕ້ອງການໃບກຳກັບພາສີ” ໃນໜ້າຊຳລະເງິນ ແລະ ລະບຸ RUT ພ້ອມຊື່ບໍລິສັດ
  • ກວດສອບ RUT ແບບຮຽວທາມ — ກວດສອບຄວາມຖືກຕ້ອງຂອງຕົວເລກພ້ອມແຈ້ງເຕືອນທັນທີ
  • ຮອງຮັບການຊຳລະເງິນທັງແບບ Classic ແລະ Blocks — ໃຊ້ງານໄດ້ທັງການຊຳລະເງິນແບບໃຊ້ shortcode ແລະ ແບບ Blocks ໃໝ່ (WC 8.6+)
  • ຊິງຄ໌ສະຕັອກດ້ວຍຕົນເອງ — ອັບເດດສະຕັອກໃນ WooCommerce ຈາກ Bsale ດ້ວຍການກົດພຽງຄັ້ງດຽວ
  • ປ້ອງກັນການສ້າງຊ້ຳ — ໃຊ້ referenceId ເພື່ອຫຼີກເວັ້ນການອອກ DTE ໃບເດີມສອງຄັ້ງ
  • [pwl_dte] shortcode — ສະແດງເອກະສານພາສີໃນໜ້າຍືນຍັນຄຳສັ່ງຊື້ ຫຼື ໜ້າບັນຊີຂອງຂ້ອຍ
  • ໂໝດ Sandbox — ທົດສອບໂດຍບໍ່ມີຜົນກະທົບຕໍ່ເອກະສານ SII ຕົວຈິງ
  • ບັນທຶກກິດຈະກຳ — ລາຍລະອຽດການອອກ DTE ທຸກຄັ້ງ ພ້ອມສະຖານະ ແລະ ເລກທີເອກະສານ

ຄວາມຕ້ອງການຂອງລະບົບ

  • WordPress 6.0 ຫຼື ສູງກວ່າ
  • WooCommerce 8.0 ຫຼື ສູງກວ່າ
  • PHP 8.0 ຫຼື ສູງກວ່າ
  • ບັນຊີ Bsale ທີ່ໃຊ້ງານຢູ່ ພ້ອມກັບ API token

Lite ທຽບກັບ Pro

ເວີຊັນຟຣີ (Lite) ລວມມີ ໃບບິນ, ໃບກຳກັບພາສີ, ຫ້ອງຂໍ້ມູນໃນໜ້າຊຳລະເງິນ, ການຊິງຄ໌ສະຕັອກດ້ວຍຕົນເອງ, ແລະ shortcode ສຳລັບ DTE.

ເວີຊັນ Pro ເພີ່ມ: ການຊິງຄ໌ສະຕັອກອັດຕະໂນມັດຜ່ານ cron, ການກຳນົດສາຂາສະຕັອກ, ຮອງຮັບຫຼາຍສາຂາ (ຈັບຄູ່ການຈັດສົ່ງ ສາຂາ), ການລອງໃໝ່ອັດຕະໂນມັດສຳລັບ DTE ທີ່ຫຼົ້ມເຫຼວ, webhooks ແບບຮຽວທາມ, ແລະ ໃບຫຼຸດໜີ້ເມື່ອມີການຄືນເງິນ.

ບໍລິການພາຍນອກ

ປລັກອິນນີ້ເຊື່ອມຕໍ່ກັບ Bsale API ເພື່ອສ້າງ ແລະ ຈັດການເອກະສານພາສີເອເລັກໂຕຣນິກ (DTEs) ຕາມທີ່ກົດໝາຍພາສີຂອງຊີລີ (SII) ກຳນົດ.

ຂໍ້ມູນໃດຖືກສົ່ງໄປ ແລະ ສົ່ງຕອນໃດ

  • ເມື່ອຄຳສັ່ງຊື້ໃນ WooCommerce ສຳເລັດ, ລາຍລະອຽດຄຳສັ່ງຊື້ (ສິນຄ້າ, ຈຳນວນ, ລາຄາ, ແລະ ຂໍ້ມູນການອອກບິນຂອງລູກຄ້າ ເຊັ່ນ RUT ແລະ ຊື່ບໍລິສັດ) ຈະຖືກສົ່ງໄປຫາ Bsale ເພື່ອສ້າງເອກະສານພາສີ (ໃບບິນ ຫຼື ໃບກຳກັບພາສີເອເລັກໂຕຣນິກ).
  • ເມື່ອຜູ້ດູແລຮ້ານກົດຊິງຄ໌ສະຕັອກດ້ວຍຕົນເອງ, SKU ຂອງສິນຄ້າຈະຖືກສົ່ງໄປເພື່ອດຶງຂໍ້ມູນລະດັບສະຕັອກປັດຈຸບັນຈາກ Bsale.
  • ເມື່ອທົດສອບການເຊື່ອມຕໍ່ API ຈາກໜ້າການຕັ້ງຄ່າ, ຈະມີການສົ່ງຄຳຂໍແບບງ່າຍໆເພື່ອທົດສອບວ່າ token ຍັງໃຊ້ໄດ້ຢູ່ຫຼືບໍ່. ຈະບໍ່ມີການສົ່ງຂໍ້ມູນລູກຄ້າໃດໆ.

ຂໍ້ມູນການບໍລິການ

  • ເວັບໄຊທ໌ Bsale: https://www.bsale.cl/
  • ເອກະສານອ້າງອີງ Bsale API: https://docs.bsale.dev/
  • API hosts used by this plugin:
    • URL ພື້ນຖານຂອງ API ທີ່ໃຊ້ໂດຍຄລライອັນ: https://api.bsale.io/v1/
    • ການໃຊ້ງານ endpoint v2 ເພີ່ມເຕີມ (ສຳລັບການນຳເຂົ້າສິນຄ້າ ແລະ ການອ່ານຊັບພະຍາກອນ webhook): https://api.bsale.io/v2/
  • ຂໍ້ກຳນົດການໃຊ້ບໍລິການ: https://www.bsale.cl/sheet/condiciones-uso
  • ນະໂຍບາຍຄວາມເປັນສ່ວນຕົວ: https://www.bsale.cl/sheet/politica-privacidad

ຊອດໂຄດ ແລະ ເຄື່ອງມືໃນການບິວ

ປລັກອິນນີ້ລວມມີໄຟລ໌ Production ທີ່ສ້າງຂຶ້ນພາຍໃຕ້ assets/ (ຕົວຢ່າງ assets/admin/js/admin.js ແລະ assets/public/js/checkout*.js).

ຊອດໂຄດທີ່ຍັງບໍ່ທັນໄດ້ຄອມໄພລ໌ (non-compiled) ແມ່ນມີໃຫ້ສາທາລະນະໃນບ່ອນເກັບໂຄດຂອງໂຄງການ:

  • ບ່ອນເກັບຊອດໂຄດ: https://github.com/PluginLATAM/PWL-dte-for-bsale-lite
  • ໄຟລ໌ຊອດໂຄດ JavaScript/CSS: resources/admin/ ແລະ resources/public/
  • ການຕັ້ງຄ່າບິວ: package.json, vite.config.js, tailwind.config.js, postcss.config.js

ເພື່ອບິວ (build) ໄຟລ໌ໃນເຄື່ອງ:

  1. ຕິດຕັ້ງ dependencies: npm install
  2. ໂໝດພັດທະນາ (Watch mode): npm run dev
  3. ບິວໄຟລ໌ Production: npm run build

ການຕິດຕັ້ງ

  1. ອັບໂຫຼດປລັກອິນໄປທີ່ /wp-content/plugins/pwl-dte-for-bsale/ ຫຼື ຕິດຕັ້ງໂດຍກົງຈາກໄດເຣັກທໍຣີປລັກອິນຂອງ WordPress.
  2. ເປີດໃຊ້ງານປລັກອິນຈາກເມນູ Plugins ໃນ WordPress.
  3. ໄປທີ່ PWL DTE Settings ແລະ ປ້ອນ Bsale API token ຂອງທ່ານ.
  4. ເລືອກໂໝດ (Sandbox ຫຼື Production) ແລະ ສາຂາທີ່ອອກເອກະສານ.
  5. ກົດ Test Connection ເພື່ອທົດສອບວ່າ token ສາມາດໃຊ້ງານໄດ້.
  6. ສຳເລັດ! DTE ຈະຖືກສ້າງຂຶ້ນໂດຍອັດຕະໂນມັດເມື່ອຄຳສັ່ງຊື້ສຳເລັດ.

ຄຳຖາມທີ່ພົບເລື້ອຍ

ຂ້ອຍຈຳເປັນຕ້ອງມີບັນຊີ Bsale ບໍ່?

ແມ່ນແລ້ວ. ປລັກອິນນີ້ຕ້ອງການບັນຊີ Bsale ທີ່ຍັງໃຊ້ງານຢູ່ ແລະ API token ທີ່ມີສິດໃນການອອກເອກະສານ.

ມັນໃຊ້ງານໃນໂໝດ Sandbox ໄດ້ບໍ່?

ແມ່ນແລ້ວ. ໃນ ການຕັ້ງຄ່າ ການເຊື່ອມຕໍ່ ທ່ານສາມາດເປີດໃຊ້ໂໝດ Sandbox ເພື່ອທົດສອບໂດຍບໍ່ຕ້ອງອອກເອກະສານຕົວຈິງໄປຫາ SII.

ຈະເກີດຫຍັງຂຶ້ນຖ້າການສ້າງ DTE ຫຼົ້ມເຫຼວ?

ຂໍ້ຜິດພາດຈະຖືກບັນທຶກໄວ້ໃນ PWL DTE DTE Logs ພ້ອມກັບຂໍ້ຄວາມແຈ້ງເຕືອນຈາກ Bsale. ທ່ານສາມາດກົດລອງໃໝ່ດ້ວຍຕົນເອງໄດ້ຈາກເມຕາບັອກຄຳສັ່ງຊື້ໃນໜ້າຈັດການຂອງ WooCommerce.

ມັນຮອງຮັບການຊຳລະເງິນແບບ WooCommerce Blocks ບໍ່?

ແມ່ນແລ້ວ. ຫ້ອງຂໍ້ມູນ RUT, ຊື່ບໍລິສັດ, ແລະ ປະເພດທຸລະກິດ ສາມາດໃຊ້ງານໄດ້ທັງກັບໜ້າຊຳລະເງິນແບບດັ້ງເດີມ ([woocommerce_checkout]) ແລະ ແບບບລັອກ (WC 8.6+).

ປລັກອິນນີ້ຕັດສະຕັອກໃນ Bsale ບໍ່?

ແມ່ນແລ້ວ, ຖ້າເປີດໃຊ້ງານຕົວເລືອກໃນການຕັ້ງຄ່າ. ທ່ານສາມາດຄວບຄຸມສິ່ງນີ້ໄດ້ຜ່ານພາລາມິເຕີການສົ່ງເຄື່ອງ (dispatch) ໃນການຕັ້ງຄ່າເອກະສານ.

ສາມາດເບິ່ງ DTE ທີ່ສ້າງຂຶ້ນໄດ້ຢູ່ໃສ?

ແຕ່ລະຄຳສັ່ງຊື້ໃນ WooCommerce ຈະມີເມຕາບັອກ “Bsale — Tax Document” ທີ່ສະແດງປະເພດເອກະສານ, ເລກທີ, ສະຖານະ, ແລະ ລິງກ໌ໄປຫາ PDF ແລະ URL ສາທາລະນະ. ທ່ານຍັງສາມາດເບິ່ງປະຫວັດທັງໝົດໄດ້ໃນ PWL DTE DTE Logs.

ປລັກອິນນີ້ມີການແປເປັນພາສາສະເປນບໍ່?

ແມ່ນແລ້ວ. ອາສາສະໝັກໄດ້ເພີ່ມ ແລະ ອັບເດດການແປພາສາໃນ translate.wordpress.org. ຖ້າແຜງຄວບຄຸມ WordPress ຂອງທ່ານເປັນພາສາສະເປນ, ໜ້າຈໍຈັດການຂອງປລັກອິນກໍຈະສະແດງເປັນພາສາສະເປນຄືກັນກັບປລັກອິນອື່ນໆ.

ການຣີວິວ

ບໍ່ມີການຣີວິວສຳລັບປລັກອິນນີ້.

ຜູ້ຮ່ວມພັດທະນາ ແລະ ຜູ້ພັດທະນາ

“PWL DTE for Bsale” ແມ່ນຊອຟແວໂອເພັນຊອດ (Open Source). ບຸກຄົນຕໍ່ໄປນີ້ໄດ້ມີສ່ວນຮ່ວມໃນການພັດທະນາປລັກອິນນີ້.

ຜູ້ຮ່ວມພັດທະນາ

“PWL DTE for Bsale” ໄດ້ຖືກແປເປັນ 2 ພາສາທ້ອງຖິ່ນ. ຂໍຂອບໃຈ ທີມງານຜູ້ແປ ສຳລັບການປະກອບສ່ວນຂອງເຂົາເຈົ້າ.

ແປ “PWL DTE for Bsale” ເປັນພາສາຂອງເຈົ້າ.

ສົນໃຈຮ່ວມພັດທະນາບໍ່?

ເບິ່ງລະຫັດ, ກວດເບິ່ງ ຄັງເກັບ SVN, ຫຼື ຕິດຕາມ ບັນທຶກການພັດທະນາ ຜ່ານ RSS.

ບັນທຶກການປ່ຽນແປງ

2.0.10

  • Readme: ປັບປຸງຄຳຕອບ FAQ ກ່ຽວກັບການແປພາສາສະເປນໃຫ້ເຂົ້າໃຈງ່າຍຂຶ້ນ (ໃຊ້ຄຳເວົ້າສຳລັບຜູ້ໃຊ້ທົ່ວໄປ).

2.0.9

  • ແກ້ໄຂ: ກວດສອບ WooCommerce ໃນ plugins_loaded ເພື່ອບໍ່ໃຫ້ການໂຫລດປລັກອິນຕາມລຳດັບຕົວອັກສອນສະແດງການແຈ້ງເຕືອນ “ຕ້ອງການ WooCommerce” ທີ່ຜິດພາດ.
  • ແກ້ໄຂ: ໃຫ້ໂຫລດການແປພາສາທັນທີ (ຫຼີກເວັ້ນການໃຊ້ plugins_loaded hook ຊ້ອນກັນ) ແລະ ໃຫ້ກັບໄປໃຊ້ es_CL.mo ທີ່ມາກັບປລັກອິນສຳລັບພາສາສະເປນອື່ນໆ (ເຊັ່ນ es_ES) ຖ້າບໍ່ມີໄຟລ໌ສະເພາະທ້ອງຖິ່ນ.

2.0.8

  • i18n: ເພີ່ມຂໍ້ຄວາມຕົ້ນສະບັບພາສາອັງກິດ (msgid) ສຳລັບຜູ້ແປ; ເພີ່ມໄຟລ໌ພາສາສະເປນ (ຊີລີ) (es_CL) ທີ່ສົມບູນ ແລະ ອັບເດດໄຟລ໌ POT.
  • ປັບປຸງລາຍລະອຽດສ່ວນຫົວຂອງປລັກອິນໃຫ້ກົງກັບມາດຕະຖານ metadata ຂອງ WordPress.org.

2.0.7

  • ເອົາລະບົບປິດການໃຊ້ງານປລັກອິນອື່ນໂດຍອັດຕະໂນມັດອອກ ເພື່ອໃຫ້ສອດຄ່ອງກັບນະໂຍບາຍຂອງ WordPress.org (ຜູ້ໃຊ້ຕ້ອງຈັດການບັນຫາການຊ້ຳກັນລະຫວ່າງ Lite/Pro ດ້ວຍຕົນເອງ).
  • ປັບປຸງຄວາມຖືກຕ້ອງຂອງ metadata ແລະ ເອກະສານການ Release ໃນເວີຊັນ 2.0.7 ໃຫ້ສົມບູນ.

2.0.6

  • ແກ້ໄຂບັນຫາທີ່ພົບຈາກການສະແກນ Plugin Check ໂດຍການປັບປຸງການຈັດການ prepared-query ໃນການສອບຖາມຂໍ້ມູນ webhook event.
  • ປ່ຽນການບັນທຶກ log ແບບເກົ່າມາໃຊ້ການເຊື່ອມຕໍ່ກັບ WooCommerce logger ເພື່ອຄວາມປອດໄພຂອງ log ໃນລະບົບຕົວຈິງ.
  • ປັບປຸງຄວາມຕໍ່ເນື່ອງຂອງການ Release/Build ແລະ ການກວດສອບ metadata (ລວມເຖິງການປ້ອງກັນ URI ໃນສ່ວນຫົວຂອງປລັກອິນ ແລະ ຂັ້ນຕອນການຄົງເວີຊັນໄວ້).

2.0.5

  • ປັບປຸງໃຫ້ສອດຄ່ອງກັບການກວດສອບຂອງ WordPress.org ໃນເລື່ອງການທຳຄວາມສະອາດຂໍ້ມູນ (escaping), ການໂຫລດໄຟລ໌ໃນໜ້າຈັດການ, ແລະ ພຶດຕິກຳຂອງ i18n.
  • ເພີ່ມ Playwright Lite E2E workflow ທີ່ສາມາດລັນໄດ້ ແລະ ອັບເດດເອກະສານການທົດສອບເວີຊັນ Lite.

2.0.0

  • ປ່ຽນຊື່ປລັກອິນເປັນ PWL DTE for Bsale (slug: pwl-dte-for-bsale) ເພື່ອໃຫ້ສອດຄ່ອງກັບກົດລະບຽບເຄື່ອງໝາຍການຄ້າຂອງ WordPress.org.
  • ປ່ຽນ inline scripts ທັງໝົດມາໃຊ້ wp_add_inline_script() ຕາມມາດຕະຖານທີ່ດີທີ່ສຸດຂອງ WordPress.
  • ເພີ່ມສ່ວນບໍລິການພາຍນອກ (External Services) ໃນໄຟລ໌ readme ເພື່ອອະທິບາຍການໃຊ້ Bsale API.

1.0.5

  • ເວີຊັນເກົ່າ ກ່ອນທີ່ຈະປ່ຽນຊື່ປລັກອິນໃຫ້ສອດຄ່ອງກັບເຄື່ອງໝາຍການຄ້າ.

1.0.1

  • ແກ້ໄຂ: ໃນການຊຳລະເງິນແບບ Blocks (WC Blocks), ຫ້ອງຂໍ້ມູນ “ຂ້ອຍຕ້ອງການໃບກຳກັບພາສີເອເລັກໂຕຣນິກ” ຈະຖືກອ່ານຢ່າງຖືກຕ້ອງໂດຍໃຊ້ຄຳນຳໜ້າ _wc_other/ ທີ່ WooCommerce Blocks ໃຊ້ພາຍໃນ. ສິ່ງນີ້ແກ້ໄຂບັນຫາທີ່ມັກຈະສ້າງໃບບິນ (Boleta) ແທນທີ່ຈະເປັນໃບກຳກັບພາສີ (Factura) ເມື່ອໃຊ້ການຊຳລະເງິນແບບ Blocks.

1.0.0

  • ການເປີດຕົວຄັ້ງທຳອິດສູ່ສາທາລະນະ.
  • ສ້າງໃບບິນ ແລະ ໃບກຳກັບພາສີເອເລັກໂຕຣນິກອັດຕະໂນມັດເມື່ອຄຳສັ່ງຊື້ສຳເລັດ.
  • ຫ້ອງຂໍ້ມູນ RUT, ຊື່ບໍລິສັດ, ແລະ ປະເພດທຸລະກິດໃນໜ້າຊຳລະເງິນ (ທັງແບບ Classic ແລະ Blocks).
  • ກວດສອບ RUT ແບບຮຽວທາມຜ່ານ AJAX.
  • ຊິງຄ໌ສະຕັອກດ້ວຍຕົນເອງຈາກ Bsale.
  • Shortcode DTE ສຳລັບສະແດງເອກະສານໃນໜ້າເວັບ.
  • ໂໝດ Sandbox ສຳລັບການທົດສອບ.
  • ບັນທຶກກິດຈະກຳພ້ອມຕົວຕອງ.

ຂໍ້ມູນກຳກັບ (Meta)

ການໃຫ້ຄະແນນ

ຍັງບໍ່ມີການສົ່ງຄຳວິຈານເທື່ອ.

Your review

ເບິ່ງ ຄຳຄິດເຫັນ ທັງໝົດ

ຜູ້ຮ່ວມພັດທະນາ

ການຊ່ວຍເຫຼືອ

ມີຄຳຖາມ ຫຼື ຕ້ອງການຄວາມຊ່ວຍເຫຼືອບໍ່?

ເບິ່ງຟໍຣັມການຊ່ວຍເຫຼືອ