Phản hồi hoá đơn của nhà cung cấp

Hướng dẫn này mô tả việc áp dụng Phản hồi ứng dụng UBL 2.4 theo tiêu chuẩn UBL 2.4. Chức năng chính của nó là chuyển tiếp trạng thái của việc gửi chứng từ thanh toán cho cơ quan thuế. Được gửi từ cơ quan thuế thông qua các nhà cung cấp cho Google, tài liệu này cung cấp thông tin quan trọng về trạng thái gửi và có thể bao gồm các liên kết tới bất kỳ tệp nhị phân của hóa đơn được tạo bởi việc quản lý thuế.

Giản đồ hỗ trợ nhà cung cấp trong việc báo cáo kết quả của việc gửi tài liệu cho Google, bao gồm:

  • Trạng thái chấp nhận chứng từ.
  • Các vấn đề hoặc lỗi do cơ quan thuế xác định.
  • Đường liên kết đến các tệp nhị phân có liên quan cho hoá đơn hoặc thư báo ghi có.

Giao thức liên lạc có cấu trúc này đảm bảo tương tác liền mạch giữa Google, nhà cung cấp và cơ quan thuế, từ đó nâng cao hiệu quả của hoạt động lập hoá đơn tuân thủ quy trình xử lý và tuân thủ.

Tương tự như cơ chế phân lô được dùng cho các yêu cầu, việc phân lô phản hồi kết hợp nhiều tài liệu vào một lần gửi để quản lý hiệu quả. Bạn có thể tìm thấy thông tin chi tiết về cơ chế này trong gửi hàng loạt phản hồi hoá đơn .

Cấu trúc giản đồ (như minh hoạ trong hình ảnh) minh hoạ giá trị của tài liệu tổ chức và các thành phần quan trọng, nhấn mạnh cách tiếp cận trạng thái báo cáo về việc gửi hoá đơn:

Sơ đồ minh hoạ cấu trúc của giản đồ phản hồi khi sử dụng hoá đơn điện tử

1.0 Tiêu đề phản hồi của ứng dụng

Thông tin chi tiết về siêu dữ liệu thiết yếu như Mã yêu cầu của nhà cung cấp của Google cùng ngày tháng và thời điểm phản hồi được đưa ra theo giờ UTC.

Yếu tố Nội dung mô tả Ví dụ
cbc:UUID Mã yêu cầu của nhà cung cấp Google được cung cấp trong yêu cầu hoá đơn. 123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate Ngày gửi câu trả lời. 2023-06-02
cbc:IssueTime Thời điểm đưa ra câu trả lời, theo giờ UTC. 08:20:00-08:00

Ví dụ

<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 Thông tin người gửi và người nhận

Phần này cung cấp thông tin về người gửi và người nhận Phản hồi của ứng dụng, một trường bắt buộc theo tiêu chuẩn UBL. Trong phần này ngữ cảnh, người gửi được mong đợi là nhà cung cấp sẽ chuyển tiếp phản hồi từ hệ thống chính phủ và người nhận phải là Google.

Yếu tố Nội dung mô tả Ví dụ
cac:SenderParty/cac:PartyName/cbc:Name Tên của nhà cung cấp chuyển tiếp phản hồi từ hệ thống chính phủ. Vendor Company
cac:ReceiverParty/cac:PartyName/cbc:Name Tên của thực thể nhận phản hồi. Google

Ví dụ

<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 Phản hồi tài liệu

Phần này cung cấp thông tin chi tiết về phản hồi của tài liệu, bao gồm cả trạng thái của phản hồi và mọi tệp tham chiếu tài liệu có liên quan được tạo ra khi tài liệu được gửi thành công cho chính phủ.

Yếu tố Nội dung mô tả Ví dụ
cac:Response Bắt buộc. Chứa trạng thái phản hồi liên quan đến việc gửi hoá đơn. Tham khảo phần 3.1
cac:DocumentReference Không bắt buộc. Có thể bao gồm không hoặc có nhiều tệp đối chiếu đến các tài liệu đã tạo. Tham khảo phần 3.2

Ví dụ

<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 Phản hồi

Mỗi Phản hồi của ứng dụng phải chứa một cac:Response duy nhất nêu chi tiết trạng thái hiện tại, được liên kết riêng với một tài liệu đã gửi. Điều này giúp đảm bảo mỗi kết quả xử lý tài liệu đều được thông báo rõ ràng.

Yếu tố Nội dung mô tả Ví dụ
cbc:ReferenceID Mã nhận dạng duy nhất do hệ thống thuế trả về cho hoá đơn được tham chiếu. BIL-123456
cbc:ReferenceID/@schemeID Hệ thống hoặc tiêu chuẩn cung cấp giá trị nhận dạng, làm rõ nguồn của giá trị đó. KSEF
cac:Status/cbc:StatusReasonCode Mã xác định lý do của phản hồi hoặc trạng thái, dựa trên giá trị được xác định trước: list. NON
cac:Status/cbc:StatusReason Văn bản mô tả cung cấp thêm chi tiết về mã trạng thái. No Issue

Ví dụ

<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 Tài liệu tham khảo

Phần này được sử dụng để đính kèm tham chiếu tới các tài liệu được tạo ra do quá trình gửi hoá đơn. Trường này là không bắt buộc và có thể chứa nhiều số lượng tài liệu tham chiếu khác nhau tuỳ theo số lượng tài liệu do cơ quan thuế tạo.

Yếu tố Nội dung mô tả Ví dụ
cbc:ID Số hóa đơn địa phương BIL-123456
cbc:ID/@schemeID Mã nhận dạng của bên phát hành tham chiếu hoá đơn Vendor Company
cbc:IssueDate Ngày cơ quan thuế đưa ra phản hồi này 2023-06-02
cbc:DocumentTypeCode Loại chứng từ đang được tham chiếu, được thể hiện dưới dạng mã (nếu hóa đơn được chấp nhận) 380
cbc:DocumentType Loại tài liệu đang được tham chiếu, được thể hiện dưới dạng văn bản Invoice
cac:Attachment/cac:ExternalReference/cbc:FormatCode Định dạng của hoá đơn được tạo (XML, PDF, URL) XML
cac:Attachment/cac:ExternalReference/cbc:FileName Tên tệp của tệp đã tạo trên máy chủ SFTP (đối với mã định dạng XML và PDF) invoice_GCEMEAD0000000001.pdf
cac:Attachment/cac:ExternalReference/cbc:URI URL để truy xuất tệp đã tạo (đối với mã định dạng URL) https://example.com/invoice/view

Những ví dụ này minh hoạ cách tài liệu có thể được tham chiếu trong Ứng dụng Phản hồi. Ví dụ đầu tiên liên quan đến các tài liệu được chuyển bằng giao thức truyền tệp bảo mật, thể hiện trong PDF và XML, và ví dụ thứ hai minh hoạ một tài liệu có thể truy cập được bằng URL để đơn giản hoá việc truy cập trực tiếp mà không cần chuyển tệp giao thức.

Ví dụ 1: PDF và Tệp đính kèm hoá đơn XML được chuyển bằng giao thức truyền tệp bảo mật

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

Ví dụ 2: Tài liệu có thể truy cập được bằng 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>