תגובה לחשבונית הספק

המדריך הזה מתאר את היישום של תגובת UBL 2.4 שתואמת לתקני UBL 2.4. התפקיד העיקרי שלו הוא להעביר הסטטוס של הגשת מסמכי חיוב לרשויות המס. נשלח מ- לרשות המס באמצעות ספקים ל-Google, המסמך מספק מידע חיוני לגבי סטטוס השליחה, ועשוי לכלול קישורים לקבצים בינאריים של חשבוניות שנוצרו על ידי ברשות המס.

הסכימה עוזרת לספקים לדווח על התוצאות של שליחת מסמכים Google, כולל:

• סטטוס קבלת המסמכים.
• בעיות או שגיאות שזוהו על ידי רשות המס.
• קישורים לקבצים בינאריים קשורים של חשבוניות או תעודות זיכוי.

פרוטוקול התקשורת המובנה הזה מבטיח אינטראקציה חלקה בין המשתתפים Google, ספקים ורשויות מס, שיפור היעילות של חשבוניות עיבוד ותאימות.

בדומה למנגנון הקיבוץ של בקשות, קיבוץ התגובות יותר מאוחדת בהגשה אחת, ניהול יעיל. תובנות מפורטות על המנגנון הזה זמינות קיבוץ תגובות לחשבונית .

מבנה הסכימה, שניתן לראות בתמונה, ממחיש את הארגון והרכיבים הקריטיים, תוך הדגשת הגישה לסטטוס דיווח על שליחת חשבוניות:

1.0 כותרת תגובה לאפליקציה

כוללים פירוט של מטא-נתונים חיוניים, כמו מזהה בקשת הספק של Google והתאריך השעה שבה נשלחה התגובה לפי שעון UTC.

רכיב	תיאור	דוגמה
cbc:UUID	מזהה בקשת הספק של Google שצוין בבקשה לחשבונית.	123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate	התאריך שבו נשלחה התגובה.	2023-06-02
cbc:IssueTime	שעת שליחת התגובה, לפי שעון UTC.	08:20:00-08:00

דוגמה

<ApplicationResponse>
  <cbc:UUID>123e4567-e89b-12d3-a456-426614174000</cbc:UUID>
  <cbc:IssueDate>2023-06-02</cbc:IssueDate>
  <cbc:IssueTime>08:20:00-08:00</cbc:IssueTime>
  <cac:SenderParty>
    <!-- Sender party details -->
  </cac:SenderParty>
  <cac:ReceiverParty>
    <!-- Receiver party details -->
  </cac:ReceiverParty>
  <cac:DocumentResponse>
    <!-- Document Response content -->
  </cac:DocumentResponse>
</ApplicationResponse>

2.0 פרטי השולח והנמען

בקטע הזה מפורט מידע על השולח והמקבל של Application Response, שדה חובה בהתאם לתקן UBL. כאן ההקשר, השולח מצופה להיות הספק שמעביר את התשובה המערכת הממשלתית, והמקבל צריך להיות Google.

רכיב	תיאור	דוגמה
cac:SenderParty/cac:PartyName/cbc:Name	שם הספק שמעביר את התגובה מהמערכת הממשלתית.	Vendor Company
cac:ReceiverParty/cac:PartyName/cbc:Name	שם הישות שמקבלת את התגובה.	Google

דוגמה

<ApplicationResponse>
  ...
  <cac:SenderParty>
    <cac:PartyName>
      <cbc:Name>Vendor Company</cbc:Name>
    </cac:PartyName>
  </cac:SenderParty>

  <cac:ReceiverParty>
    <cac:PartyName>
      <cbc:Name>Google</cbc:Name>
    </cac:PartyName>
  </cac:ReceiverParty>
  ...
</ApplicationResponse>

תגובה למסמך 3.0

בקטע הזה מתוארים פרטים על התשובה שהתקבלה מהמסמך, כולל את הסטטוס של התשובה וכל הפניות למסמכים משויכים שנוצרו כתוצאה מכך שליחה מוצלחת של מסמכים לממשלה.

רכיב	תיאור	דוגמה
cac:Response	חובה. סטטוס התגובה שקשור לשליחת החשבונית.	למידע נוסף, יש לעיין בסעיף 3.1
cac:DocumentReference	זה שינוי אופציונלי. יכול לכלול אפס הפניות או מספר הפניות למסמכים שנוצרו.	למידע נוסף, יש לעיין בסעיף 3.2

דוגמה

<ApplicationResponse>
  ...
  <cac:DocumentResponse>
    <cac:Response>
      <!-- Response details -->
    </cac:Response>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>

3.1 תשובה

כל תגובה לבקשה צריכה להכיל cac:Response יחיד המפרט את הסטטוס הנוכחי, המשויך באופן ייחודי להגשת מסמך. כך אפשר להבטיח שכל תוצאה של עיבוד המסמך מוצגת באופן ברור.

רכיב	תיאור	דוגמה
cbc:ReferenceID	המזהה הייחודי שהוחזר על ידי מערכת המס עבור החשבונית הרלוונטית.	BIL-123456
cbc:ReferenceID/@schemeID	מערכת או תקן שמספקים את המזהה, וכך מבהירים את המקור שלו.	KSEF
cac:Status/cbc:StatusReasonCode	קוד שמגדיר את התגובה או את הסיבה לסטטוס, על סמך ערך מוגדר מראש: list.	NON
cac:Status/cbc:StatusReason	טקסט תיאורי שמספק פרטים נוספים על קוד הסטטוס.	No Issue

דוגמה

<ApplicationResponse>
  ...
  <cac:DocumentResponse>
    <cac:Response>
      <cbc:ReferenceID schemeID="Vendor Company">BIL-123456</cbc:ReferenceID>
      <cac:Status>
        <cbc:StatusReasonCode>NON</cbc:StatusReasonCode>
        <cbc:StatusReason>No Issue</cbc:StatusReason>
      </cac:Status>
    </cac:Response>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
    <cac:DocumentReference>
      <!-- Document Reference (if applicable) -->
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>

3.2 הפניה למסמך

הקטע הזה משמש לצירוף הפניות למסמכים שנוצרו כתוצאה תהליך שליחת החשבונית. שדה זה אופציונלי ויכול לכלול מספר בהתאם למספר המסמכים שרשות המס יצרה.

רכיב	תיאור	דוגמה
cbc:ID	מספר החשבונית המקומית	BIL-123456
cbc:ID/@schemeID	המזהה של מנפיק החשבונית	Vendor Company
cbc:IssueDate	התאריך שבו התשובה הזו נשלחה על ידי רשויות המס	2023-06-02
cbc:DocumentTypeCode	סוג המסמך שאליו מתבצעת ההפניה, מבוטא כקוד (אם החשבונית מתקבלת)	380
cbc:DocumentType	סוג המסמך שאליו מתבצעת ההפניה, מבוטא כטקסט	Invoice
cac:Attachment/cac:ExternalReference/cbc:FormatCode	הפורמט של החשבונית שנוצרה (XML, PDF, כתובת URL)	XML
cac:Attachment/cac:ExternalReference/cbc:FileName	שם הקובץ של הקובץ שנוצר בשרת SFTP (לקודים בפורמט XML ו-PDF)	invoice_GCEMEAD0000000001.pdf
cac:Attachment/cac:ExternalReference/cbc:URI	כתובת URL לאחזור הקובץ שנוצר (לקוד הפורמט של כתובת ה-URL)	https://example.com/invoice/view

הדוגמאות האלה ממחישות איך ניתן להתייחס למסמכים בטופס הבקשה תשובה. הדוגמה הראשונה קשורה למסמכים שהועברו באמצעות SFTP, שמוצגים ב בפורמט PDF ו-XML, ובדוגמה השנייה מוצג מסמך שאפשר לגשת אליו. באמצעות כתובת URL, מה שמפשט את הגישה הישירה ללא צורך בהעברת קבצים ופרוטוקולים.

דוגמה 1: PDF ו- קבצים מצורפים של חשבוניות XML שהועברו באמצעות SFTP

<ApplicationResponse>
  <!-- Sender and Receiver Details -->
  <cac:DocumentResponse>
    <cac:Response>
      <!-- Response Details -->
    </cac:Response>
    <cac:DocumentReference>
      <cbc:ID schemeID="Vendor Company">BIL-123456</cbc:ID>
      <cbc:IssueDate>2023-06-02</cbc:IssueDate>
      <cbc:DocumentTypeCode>380</cbc:DocumentTypeCode>
      <cbc:DocumentType>Invoice</cbc:DocumentType>
      <cac:Attachment>
        <cac:ExternalReference>
          <!-- PDF Document stored on SFTP -->
          <cbc:FormatCode>PDF</cbc:FormatCode>
          <cbc:FileName>invoice_GCEMEAD0000000001.pdf</cbc:FileName>
        </cac:ExternalReference>
      </cac:Attachment>
      <cac:Attachment>
        <cac:ExternalReference>
          <!-- XML Document stored on SFTP -->
          <cbc:FormatCode>XML</cbc:FormatCode>
          <cbc:FileName>invoice_GCEMEAD0000000001.xml</cbc:FileName>
        </cac:ExternalReference>
      </cac:Attachment>
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>

דוגמה 2: מסמך שאפשר לגשת אליו באמצעות כתובת URL

<ApplicationResponse>
  <!-- Sender and Receiver Details -->
  <cac:DocumentResponse>
    <cac:Response>
      <!-- Response Details -->
    </cac:Response>
    <cac:DocumentReference>
      <cbc:ID schemeID="Vendor Company">BIL-123456</cbc:ID>
      <cbc:IssueDate>2023-06-02</cbc:IssueDate>
      <cbc:DocumentTypeCode>380</cbc:DocumentTypeCode>
      <cbc:DocumentType>Invoice</cbc:DocumentType>
      <cac:Attachment>
        <cac:ExternalReference>
          <!-- Document accessible using URL -->
          <cbc:FormatCode>URL</cbc:FormatCode>
          <cbc:URI>https://example.com/invoice/view</cbc:URI>
        </cac:ExternalReference>
      </cac:Attachment>
    </cac:DocumentReference>
  </cac:DocumentResponse>
</ApplicationResponse>