این راهنما کاربرد طرح پاسخ برنامه 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 است. در این زمینه، از فرستنده انتظار می رود فروشنده ای باشد که پاسخ را از سیستم دولتی فوروارد می کند و گیرنده باید گوگل باشد.
عنصر | توضیحات | مثال |
---|---|---|
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 |
این مثالها نشان میدهند که چگونه اسناد ممکن است در Application Response ارجاع شوند. مثال اول شامل اسناد منتقل شده با استفاده از 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>