Bu kılavuzda, UBL 2.4 Başvuru Yanıtı'nın uygulanması açıklanmaktadır. bir şema kullanmayı tercih edebilirsiniz. Birincil işlevi, vergi kurumlarına gönderilen faturalandırma belgesinin durumu. Şuradan gönderildi: yetkili merciler aracılığıyla Google’a ilettiğini, belgenin de tarafından oluşturulan fatura ikili dosyalarının bağlantılarını içerebilir. vergi dairesi.
Şema, tedarikçilerin belge gönderimlerinin sonuçlarını raporlamasına yardımcı olur. Google, aşağıdaki konuları kapsar:
- Belgelerin kabul durumu.
- Vergi dairesi tarafından belirlenen sorunlar veya hatalar.
- Faturalar veya kredi notları için ilgili ikili dosyaların bağlantıları.
Bu yapılandırılmış iletişim protokolü, iletişimin her gün veya olumsuz şekilde Google, satıcılar ve vergi kurumları ile fatura verimliliğini artırma ve bunlara uymayı da kapsıyor.
İstekler için kullanılan toplu işleme mekanizmasına benzer şekilde, yanıtları toplu olarak birden fazla belgeyi tek bir gönderimde birleştirerek etkili yönetim. Bu mekanizmayla ilgili ayrıntılı bilgileri şu adreste bulabilirsiniz: fatura yanıtı toplu hale getirme bölümüne ekleyin.
Resimde görselleştirilmiş şema yapısı, dokümanın durum yaklaşımının altını çizerek, kurumun ve kritik bileşenlerin fatura gönderimlerinin raporlanması:
1.0 Uygulama yanıtı başlığı
Google Tedarikçi Firma İstek Kimliği ve tarih ve saat gibi temel meta verileri yanıtın UTC saat diliminde verildiği tarih.
Öğe | Açıklama | Örnek |
---|---|---|
cbc:UUID |
Fatura isteğinde sağlanan Google Tedarikçi Firma İstek Kimliği. | 123e4567-e89b-12d3-a456-426614174000 |
cbc:IssueDate |
Yanıtın verildiği tarih. | 2023-06-02 |
cbc:IssueTime |
Yanıtın verildiği zaman (UTC). | 08:20:00-08:00 |
Örnek
<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 Gönderen ve alıcı bilgileri
Bu bölümde, e-postayı gönderen ve alan Application Response, UBL standardı uyarınca zorunlu bir alandır. Burada gönderenin yanıtı alıcı Google olmalıdır.
Öğe | Açıklama | Örnek |
---|---|---|
cac:SenderParty/cac:PartyName/cbc:Name |
Resmi sistemden yanıtı yönlendiren tedarikçinin adı. | Vendor Company |
cac:ReceiverParty/cac:PartyName/cbc:Name |
Yanıtı alan tüzel kişinin adı. | Google |
Örnek
<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 Belge yanıtı
Bu bölümde, dokümanın yanıtıyla ilgili ayrıntılar sağlanır ve yanıtın durumu ve sonuç olarak oluşturulan ilişkili doküman referansları devlete başarılı doküman gönderimi.
Öğe | Açıklama | Örnek |
---|---|---|
cac:Response |
Zorunludur. Fatura gönderimiyle ilgili yanıt durumunu içerir. | Bölüm 3.1'e bakın |
cac:DocumentReference |
İsteğe bağlı. Oluşturulan dokümanlara sıfır veya çok sayıda referans içerebilir. | Bölüm 3.2'ye bakın |
Örnek
<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 Yanıt
Her Başvuru yanıtı,cac:Response
benzersiz bir şekilde, doküman gönderimiyle ilişkilendirilir. Bu sayede
her belge işleme sonucunun açık bir şekilde iletildiğinden emin olun.
Öğe | Açıklama | Örnek |
---|---|---|
cbc:ReferenceID |
Söz konusu fatura için vergi sistemi tarafından döndürülen benzersiz tanımlayıcı. | BIL-123456 |
cbc:ReferenceID/@schemeID |
Tanımlayıcıyı sağlayan ve kaynağını netleştiren sistem veya standart. | KSEF |
cac:Status/cbc:StatusReasonCode |
Önceden tanımlanmış değere göre yanıt veya durum nedenini tanımlayan kod: list. | NON |
cac:Status/cbc:StatusReason |
Durum koduyla ilgili daha fazla ayrıntı sağlayan açıklayıcı metin. | No Issue |
Örnek
<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 Belge referansı
Bu bölüm, takip etmeniz gerekir. İsteğe bağlıdır ve birden fazla referansları, vergi dairesi tarafından oluşturulan belge sayısına göre belirlenir.
Öğe | Açıklama | Örnek |
---|---|---|
cbc:ID |
Yerel fatura numarası | BIL-123456 |
cbc:ID/@schemeID |
Fatura referansını veren kuruluşun tanımlayıcısı | Vendor Company |
cbc:IssueDate |
Bu yanıtın vergi kurumları tarafından verildiği tarih | 2023-06-02 |
cbc:DocumentTypeCode |
Referans verilen belgenin türü ve kod olarak ifade edilir (fatura kabul ediliyorsa) | 380 |
cbc:DocumentType |
Referans verilen dokümanın türü (metin olarak belirtilir) | Invoice |
cac:Attachment/cac:ExternalReference/cbc:FormatCode |
Oluşturulan faturanın biçimi (XML, PDF, URL) | XML |
cac:Attachment/cac:ExternalReference/cbc:FileName |
SFTP sunucusunda oluşturulan dosyanın adı (XML ve PDF biçimi kodları için) | invoice_GCEMEAD0000000001.pdf |
cac:Attachment/cac:ExternalReference/cbc:URI |
Oluşturulan dosyayı alma URL'si (URL biçim kodu için) | https://example.com/invoice/view |
Bu örnekler, Başvuru'da dokümanlara nasıl referans verilebileceğini göstermektedir Yanıt. İlk örnek, SFTP kullanılarak aktarılan ve PDF ve XML biçimlerinden oluşur, ikinci örnek ise URL kullanarak dosya aktarımına gerek kalmadan doğrudan erişimi basitleştirin çok önemlidir.
1. Örnek: PDF & SFTP kullanılarak aktarılan XML fatura ekleri
<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. Örnek: URL kullanılarak erişilebilen dokümana
<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>