الردّ على فاتورة المورّد

يوضح هذا الدليل طريقة تطبيق استجابة طلب 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 معلومات المرسِل والمستلِم

يقدم هذا القسم معلومات عن مُرسِل ومُستلم استجابة التطبيق، وهو حقل إلزامي وفقًا لمعيار 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 & مرفقات الفواتير التي تمّ نقلها باستخدام بروتوكول النقل الآمن للملفات (SFTP) بتنسيق XML

<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>