קבלה על תרומה (סעיף 46) לכל תרומה שהושלמה ב-GiveWP.
התקנה (5 דקות)#
- ודאו שהעסק ב-SLK Invoices מוגדר כעמותה מוכרת. קבלה על תרומה זמינה רק לעמותות.
- התקינו את התוסף לפי ההוראות הכלליות והדביקו את מפתח ה-API בלשונית חיבור.
- פתחו את הלשונית GiveWP, סמנו הפעלת האינטגרציה ושמרו. סוג המסמך קבוע: קבלה על תרומה.
- אם בטופס התרומה יש שדה מותאם עם ת.ז. או ח.פ. התורם, הזינו את שם מפתח המטא שלו בשדה שדה מטא של תרומה (מתקדם).
- בצעו תרומת בדיקה. הקבלה מופקת בשם התורם, עם שם טופס התרומה כשורה.
לקבלה על תרומה אין מע"מ. תרומה שהוחזרה לא מזוכה אוטומטית: ביומן תופיע שורה שמזכירה להפיק חשבונית זיכוי ידנית, כי ביטול קבלה לפי סעיף 46 הוא החלטה של רואה החשבון.
Developer reference#
| Item | Value |
|---|---|
| Plugin class | includes/integrations/class-slk-integration-givewp.php |
| Host guard | class_exists('Give') |
| Hook | give_update_payment_status( $donation_id, $new_status, $old_status ) — https://github.com/impress-org/givewp/discussions/7142 ; donation API https://givewp.com/documentation/developers/give-api-reference/ |
| Trigger | $new_status === 'publish' (GiveWP's completed status) and $old_status !== 'publish' |
| Refunded | $new_status === 'refunded' writes a skipped log line only |
| apiIdentifier | give-<host>-<donation id> |
| Idempotency | option slk_invoices_issued_give, keyed by donation id |
Document: docType: 11, taxIncluded: false, vatBp: 0 on the document and the line (the engine forces
VAT 0 on type 11), one line named after the donation form (Give_Payment::form_title), quantity 1,
unit price = donation total in agorot. Customer: donor first/last name, email; customerUniqueId
from the optional donation meta key. Payment row: total, type mapped to the values that have an Israeli
Tax Authority Payment_method counterpart on a donation receipt: offline 3 (transfer), manual 4
(cash), paypal* 10, default 1 (card). See docs/specs/donations.md.
Troubleshooting#
- ההפקה נכשלת עם שגיאת עמותה: העסק ב-SLK Invoices לא מוגדר כעמותה מוכרת. עדכנו בהגדרות העסק.
- שגיאת זהות תורם: אם ה-SLK Invoices מדווח לרשות המסים, מספר זהות שגוי נדחה. בדקו את שדה המטא של הת.ז.
- תרומה שלא הופקה לה קבלה: ודאו שהסטטוס שלה "הושלמה" ושהאינטגרציה מסומנת. תרומות שהושלמו לפני ההפעלה לא מופקות רטרואקטיבית.
- כשל 401/403: ראו פתרון תקלות כלליות.