Questa guida descrive l'applicazione dell'Application Response UBL 2.4 conforme agli standard UBL 2.4. La sua funzione principale è inoltrare stato dei documenti di fatturazione inviati alle autorità fiscali. Inviato da dell'autorità fiscale tramite fornitori di Google, il documento fornisce informazioni cruciali sulla stato di invio e può includere link a qualsiasi file binario delle fatture generato l'amministrazione fiscale.
Lo schema consente ai fornitori di riportare i risultati dell'invio di documenti a Google, che tratta:
- Stato di accettazione dei documenti.
- Problemi o errori identificati dall'autorità fiscale.
- Link ai file binari correlati per fatture o note di credito.
Questo protocollo di comunicazione strutturata garantisce un'interazione perfetta tra Google, fornitori e autorità fiscali, migliorando l'efficienza delle fatture l'elaborazione e il rispetto della conformità.
Analogamente al meccanismo di raggruppamento utilizzato per le richieste, la gestione in batch delle risposte consolida più documenti in un unico invio per una gestione efficace. Per informazioni dettagliate su questo meccanismo, consulta la raggruppamento delle risposte alle fatture .
La struttura dello schema, visualizzata nell'immagine, illustra la struttura del documento organizzazione e componenti critici, sottolineando l'approccio allo status report sull'invio di fatture:
1.0 Intestazione della risposta dell'applicazione
Descrive in dettaglio i metadati essenziali, come l'ID richiesta del fornitore Google, la data e l'ora in cui la risposta è stata inviata in UTC.
Elemento | Descrizione | Esempio |
---|---|---|
cbc:UUID |
ID richiesta fornitore Google fornito nella richiesta della fattura. | 123e4567-e89b-12d3-a456-426614174000 |
cbc:IssueDate |
Data di emissione della risposta. | 2023-06-02 |
cbc:IssueTime |
L'ora in cui è stata inviata la risposta, in UTC. | 08:20:00-08:00 |
Esempio
<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 Informazioni su mittente e destinatario
Questa sezione fornisce informazioni sul mittente e il destinatario dell' Risposta dell’applicazione, un campo obbligatorio secondo lo standard UBL. In questo contesto, il mittente deve essere il fornitore che inoltra la risposta il sistema governativo e il destinatario deve essere Google.
Elemento | Descrizione | Esempio |
---|---|---|
cac:SenderParty/cac:PartyName/cbc:Name |
Nome del fornitore che ha inoltrato la risposta al sistema governativo. | Vendor Company |
cac:ReceiverParty/cac:PartyName/cbc:Name |
Nome dell'entità che riceve la risposta. | Google |
Esempio
<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 Documentazione di risposta
Questa sezione fornisce dettagli sulla risposta al documento, che comprendono sia il stato della risposta ed eventuali riferimenti a documenti associati generati come risultato della corretta presentazione di documenti al governo.
Elemento | Descrizione | Esempio |
---|---|---|
cac:Response |
Obbligatorio. Contiene lo stato della risposta relativo all'invio della fattura. | Consulta la sezione 3.1 |
cac:DocumentReference |
(Facoltativo) Può includere zero o molti riferimenti ai documenti generati. | Consulta la sezione 3.2. |
Esempio
<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 Risposta
Ogni risposta dell'applicazione deve contenere un singolo cac:Response
con i dettagli
stato attuale, associato in modo univoco all'invio di un documento. Ciò garantisce
che ogni risultato dell'elaborazione dei documenti venga comunicato in modo chiaro.
Elemento | Descrizione | Esempio |
---|---|---|
cbc:ReferenceID |
Identificatore univoco restituito dal sistema fiscale per la fattura di riferimento. | BIL-123456 |
cbc:ReferenceID/@schemeID |
Sistema o standard che fornisce l'identificatore, chiarindone l'origine. | KSEF |
cac:Status/cbc:StatusReasonCode |
Codice che definisce il motivo della risposta o dello stato, in base al valore predefinito: list. | NON |
cac:Status/cbc:StatusReason |
Testo descrittivo che fornisce ulteriori dettagli sul codice di stato. | No Issue |
Esempio
<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 Riferimenti ai documenti
Questa sezione viene utilizzata per allegare riferimenti ai documenti generati a seguito di la procedura di invio delle fatture. È facoltativo e può contenere più a seconda del numero di documenti generati dall'autorità fiscale.
Elemento | Descrizione | Esempio |
---|---|---|
cbc:ID |
Numero di fattura locale | BIL-123456 |
cbc:ID/@schemeID |
Identificatore dell'emittente del riferimento della fattura | Vendor Company |
cbc:IssueDate |
Data di emissione della risposta da parte delle autorità fiscali | 2023-06-02 |
cbc:DocumentTypeCode |
Tipo di documento a cui si fa riferimento, espresso come codice (se la fattura è accettata) | 380 |
cbc:DocumentType |
Tipo di documento a cui si fa riferimento, espresso in formato testo | Invoice |
cac:Attachment/cac:ExternalReference/cbc:FormatCode |
Formato della fattura generata (XML, PDF, URL) | XML |
cac:Attachment/cac:ExternalReference/cbc:FileName |
Nome del file generato sul server SFTP (per i codici di formato XML e PDF) | invoice_GCEMEAD0000000001.pdf |
cac:Attachment/cac:ExternalReference/cbc:URI |
URL per recuperare il file generato (per il codice del formato dell'URL) | https://example.com/invoice/view |
Questi esempi illustrano come è possibile fare riferimento ai documenti nell'Applicazione Risposta. Il primo esempio riguarda i documenti trasferiti tramite SFTP, come mostrato in PDF e XML; il secondo esempio mostra un documento accessibile utilizzando URL, che semplifica l'accesso diretto senza bisogno di trasferire i file protocolli.
Esempio 1: PDF e Allegati delle fatture XML trasferiti tramite 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>
Esempio 2: documento accessibile tramite 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>