Respons invoice vendor

Panduan ini menjelaskan penerapan Respons Aplikasi UBL 2.4 skema, sesuai dengan standar UBL 2.4. Fungsi utamanya adalah untuk menyampaikan status pengiriman dokumen penagihan ke otoritas pajak. Dikirim dari otoritas pajak melalui vendor ke Google, dokumen tersebut memberi informasi penting tentang status pengiriman dan dapat menyertakan link ke file biner invoice yang dibuat paling lambat administrasi pajak.

Skema ini memfasilitasi vendor dalam melaporkan hasil pengiriman dokumen ke Google, yang mencakup:

  • Status penerimaan dokumen.
  • Masalah atau error yang diidentifikasi oleh otoritas pajak.
  • Link ke file biner terkait untuk invoice atau catatan kredit.

Protokol komunikasi terstruktur ini memastikan interaksi yang mulus antara Google, vendor, dan otoritas pajak, meningkatkan efisiensi invoice pemrosesan dan kepatuhan.

Mirip dengan mekanisme pengelompokan yang digunakan untuk permintaan, pengelompokan respons mengonsolidasikan beberapa dokumen dalam satu pengajuan untuk manajemen proyek yang efektif. Wawasan mendetail tentang mekanisme ini dapat ditemukan di pengelompokan respons invoice bagian.

Struktur skema, yang divisualisasikan dalam gambar, mengilustrasikan kemampuan organisasi dan komponen penting, menggarisbawahi pendekatan terhadap status pelaporan pengiriman faktur:

Diagram yang menggambarkan struktur skema respons e-invoicing

1.0 Header respons aplikasi

Memerinci metadata penting seperti ID Permintaan Vendor Google serta tanggal dan waktu respons dikeluarkan dalam UTC.

Elemen Deskripsi Contoh
cbc:UUID ID Permintaan Vendor Google yang diberikan dalam permintaan invoice. 123e4567-e89b-12d3-a456-426614174000
cbc:IssueDate Tanggal respons diberikan. 2023-06-02
cbc:IssueTime Waktu respons dikeluarkan, dalam UTC. 08:20:00-08:00

Contoh

<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 Informasi pengirim dan penerima

Bagian ini memberikan informasi tentang pengirim dan penerima Respons Aplikasi, kolom wajib sesuai standar UBL. Di sini konteks, pengirim diharapkan menjadi vendor yang meneruskan respons dari sistem pemerintah, dan penerima harusnya Google.

Elemen Deskripsi Contoh
cac:SenderParty/cac:PartyName/cbc:Name Nama vendor yang meneruskan tanggapan dari sistem pemerintah. Vendor Company
cac:ReceiverParty/cac:PartyName/cbc:Name Nama entitas yang menerima respons. Google

Contoh

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

Bagian ini memberikan detail tentang respons dokumen, yang mencakup status respons Anda dan semua referensi dokumen terkait yang dihasilkan keberhasilan pengiriman dokumen ke pemerintah.

Elemen Deskripsi Contoh
cac:Response Wajib. Berisi status respons yang terkait dengan pengiriman invoice. Lihat bagian 3.1
cac:DocumentReference Opsional. Dapat menyertakan nol atau banyak referensi ke dokumen yang dibuat. Lihat bagian 3.2

Contoh

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

Setiap Respons Aplikasi harus berisi satu cac:Response yang menguraikan status saat ini, yang secara unik terkait dengan kiriman dokumen. Hal ini memastikan bahwa setiap hasil pemrosesan dokumen dikomunikasikan dengan jelas.

Elemen Deskripsi Contoh
cbc:ReferenceID ID unik yang ditampilkan oleh sistem pajak untuk invoice yang direferensikan. BIL-123456
cbc:ReferenceID/@schemeID Sistem atau standar yang menyediakan ID, yang memperjelas sumbernya. KSEF
cac:Status/cbc:StatusReasonCode Kode yang menentukan alasan respons atau status, berdasarkan nilai yang telah ditentukan sebelumnya: list. NON
cac:Status/cbc:StatusReason Teks deskriptif yang memberikan detail selengkapnya tentang kode status. No Issue

Contoh

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

Bagian ini digunakan untuk melampirkan referensi ke dokumen yang dibuat sebagai akibat dari proses pengiriman faktur. Bersifat opsional dan dapat berisi beberapa referensi tergantung pada jumlah dokumen yang dibuat oleh otoritas pajak.

Elemen Deskripsi Contoh
cbc:ID Nomor invoice lokal BIL-123456
cbc:ID/@schemeID ID penerbit referensi invoice Vendor Company
cbc:IssueDate Tanggal saat respons ini dikeluarkan oleh otoritas pajak 2023-06-02
cbc:DocumentTypeCode Jenis dokumen yang dirujuk, dinyatakan sebagai kode (jika invoice diterima) 380
cbc:DocumentType Jenis dokumen yang dirujuk, dinyatakan sebagai teks Invoice
cac:Attachment/cac:ExternalReference/cbc:FormatCode Format invoice yang dibuat (XML, PDF, URL) XML
cac:Attachment/cac:ExternalReference/cbc:FileName Nama file dari file yang dihasilkan di server SFTP (untuk kode format XML dan PDF) invoice_GCEMEAD0000000001.pdf
cac:Attachment/cac:ExternalReference/cbc:URI URL untuk mengambil file yang dihasilkan (untuk kode format URL) https://example.com/invoice/view

Contoh-contoh ini mengilustrasikan bagaimana dokumen mungkin dirujuk dalam Aplikasi Respons. Contoh pertama melibatkan dokumen yang ditransfer menggunakan SFTP, yang ditunjukkan di format PDF dan XML, dan contoh kedua menunjukkan dokumen yang dapat diakses menggunakan URL, yang menyederhanakan akses langsung tanpa perlu mentransfer file protokol yang sama.

Contoh 1: PDF & Lampiran invoice XML yang ditransfer menggunakan 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>

Contoh 2: Dokumen dapat diakses menggunakan 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>