คู่มือนี้อธิบายถึงการใช้การตอบกลับแอปพลิเคชัน 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 |
ตัวอย่างเหล่านี้แสดงให้เห็นวิธีที่อาจมีการอ้างอิงเอกสารในแอปพลิเคชัน คำตอบ ตัวอย่างที่ 1 เกี่ยวข้องกับเอกสารที่โอนโดยใช้ SFTP ซึ่งแสดงใน PDF และ XML และตัวอย่างที่ 2 แสดงว่ามีเอกสารที่เข้าถึงได้ ใช้ 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>