Ten przewodnik opisuje zastosowanie odpowiedzi aplikacji UBL 2.4 zgodny ze standardami UBL 2.4. Jego główną funkcją jest przekazywanie stanu dokumentów rozliczeniowych przesłanych do organów podatkowych. Wysłane z urzędowi skarbowemu przez dostawców do Google, dokument ten zawiera istotne informacje może zawierać linki do wszelkich wygenerowanych plików binarnych faktur przez administracją podatkową.
Schemat ułatwia dostawcom raportowanie wyników przesyłania dokumentów Google obejmuje:
- Stan akceptacji dokumentów.
- Problemy lub błędy wykryte przez urząd skarbowy.
- Linki do powiązanych plików binarnych z fakturami lub notami kredytowymi.
Ten uporządkowany protokół komunikacyjny zapewnia płynną interakcję Google, dostawcy i urzędy skarbowe – zwiększenie skuteczności fakturowania przetwarzania danych i przestrzegania przepisów.
Podobnie jak w przypadku mechanizmu grupowania używanego w żądaniach, grupowanie odpowiedzi skutkuje konsolidacją wielu dokumentów w jednym zgłoszeniu, efektywne zarządzanie. Szczegółowe informacje na temat tego mechanizmu można znaleźć w grupowanie odpowiedzi na faktury .
Struktura schematu przedstawiona na ilustracji przedstawia organizacji i najważniejszych elementów, podkreślając podejście do stanu; raportowanie przesłanych faktur:
1.0 Nagłówek odpowiedzi aplikacji
Niezbędne metadane, takie jak identyfikator żądania dostawcy Google oraz data i czas wysłania odpowiedzi w strefie czasowej UTC.
Element | Opis | Przykład |
---|---|---|
cbc:UUID |
Identyfikator żądania dostawcy Google podany w żądaniu faktury. | 123e4567-e89b-12d3-a456-426614174000 |
cbc:IssueDate |
Data wysłania odpowiedzi. | 2023-06-02 |
cbc:IssueTime |
Czas wysłania odpowiedzi (w strefie czasowej UTC). | 08:20:00-08:00 |
Przykład
<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 Informacje o nadawcy i odbiorcy
Ta sekcja zawiera informacje o nadawcy i odbiorcy Application Response (Odpowiedź aplikacji) to obowiązkowe pole zgodne ze standardem UBL. W tym w kontekście procesu wysyłania odpowiedzi, oczekuje się, że będzie to dostawca, który przekazuje odpowiedź z systemu rządowego, a odbiorcą powinien być Google.
Element | Opis | Przykład |
---|---|---|
cac:SenderParty/cac:PartyName/cbc:Name |
Nazwa dostawcy, który przekazuje odpowiedź z systemu rządowego. | Vendor Company |
cac:ReceiverParty/cac:PartyName/cbc:Name |
Nazwa jednostki, która otrzymuje odpowiedź. | Google |
Przykład
<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 Odpowiedź na dokument
Ta sekcja zawiera szczegółowe informacje o odpowiedzi na dokument, obejmujące zarówno sekcję stan odpowiedzi i wszelkie powiązane odwołania do dokumentów wygenerowane w wyniku wyszukiwania. skutecznego przesłania dokumentów rządowi.
Element | Opis | Przykład |
---|---|---|
cac:Response |
Obowiązkowe. Zawiera stan odpowiedzi związany z przesłaniem faktury. | Więcej informacji znajdziesz w sekcji 3.1 |
cac:DocumentReference |
Opcjonalnie: Może zawierać zero lub wiele odwołań do wygenerowanych dokumentów. | Więcej informacji znajdziesz w sekcji 3.2. |
Przykład
<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 Odpowiedź
Każda odpowiedź aplikacji powinna zawierać pojedynczy element cac:Response
ze szczegółami
bieżący stan, jednoznacznie powiązany z przesłaniem dokumentu. Dzięki temu masz pewność,
aby każdy wynik przetwarzania dokumentu był jasno przedstawiony.
Element | Opis | Przykład |
---|---|---|
cbc:ReferenceID |
Unikalny identyfikator zwrócony przez system podatkowy dla wymienionej faktury. | BIL-123456 |
cbc:ReferenceID/@schemeID |
System lub standard, który dostarcza identyfikator, wyjaśniający jego źródło. | KSEF |
cac:Status/cbc:StatusReasonCode |
Kod określający przyczynę odpowiedzi lub stanu na podstawie wstępnie zdefiniowanej wartości: list. | NON |
cac:Status/cbc:StatusReason |
Tekst opisowy z dodatkowymi informacjami o kodzie stanu. | No Issue |
Przykład
<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 Odniesienie do dokumentów
Ta sekcja służy do dołączania odwołań do dokumentów wygenerowanych w wyniku procesu przesyłania faktur. Jest opcjonalny i może zawierać wiele elementów, odwołania w zależności od liczby dokumentów wygenerowanych przez urząd skarbowy.
Element | Opis | Przykład |
---|---|---|
cbc:ID |
Lokalny numer faktury | BIL-123456 |
cbc:ID/@schemeID |
Identyfikator wydawcy referencyjnego faktury | Vendor Company |
cbc:IssueDate |
Data wydania tej odpowiedzi przez organy podatkowe | 2023-06-02 |
cbc:DocumentTypeCode |
Typ dokumentu, którego dotyczy odwołanie, wyrażony jako kod (jeśli faktura została zaakceptowana). | 380 |
cbc:DocumentType |
Typ dokumentu, do którego odwołuje się odwołanie, wyrażony jako tekst | Invoice |
cac:Attachment/cac:ExternalReference/cbc:FormatCode |
Format wygenerowanej faktury (XML, PDF, URL) | XML |
cac:Attachment/cac:ExternalReference/cbc:FileName |
Nazwa pliku wygenerowanego na serwerze SFTP (w przypadku kodów XML i PDF) | invoice_GCEMEAD0000000001.pdf |
cac:Attachment/cac:ExternalReference/cbc:URI |
Adres URL do pobrania wygenerowanego pliku (dla kodu formatu adresu URL) | https://example.com/invoice/view |
Te przykłady pokazują, jak można odwoływać się do dokumentów w aplikacji Odpowiedź. Pierwszy przykład dotyczy dokumentów przesłanych za pomocą SFTP. Tutaj widać: PDF i XML. Drugi przykład przedstawia dokument dostępny do pobrania za pomocą adresu URL, co upraszcza bezpośredni dostęp bez konieczności przesyłania plików. protokoły API.
Przykład 1: PDF i Załączniki do faktur XML przeniesione za pomocą 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>
Przykład 2. Dokument dostępny za pomocą adresu 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>