Ce guide décrit le champ d'application de la réponse à la demande UBL 2.4 Application Response , conforme à la norme UBL 2.4. Sa fonction principale est de relayer l'état des documents de facturation envoyés aux autorités fiscales ; Envoyé par le de l'administration fiscale par le biais de fournisseurs à Google, le document fournit des informations essentielles l'état de l'envoi et peut inclure des liens vers les fichiers binaires de facture générés par à l'administration fiscale.
Le schéma permet aux fournisseurs de créer facilement des rapports sur les résultats des envois de documents Google, couvrant les sujets suivants:
- État d'acceptation des documents.
- Problèmes ou erreurs identifiés par l'administration fiscale.
- Liens vers les fichiers binaires associés aux factures ou notes de crédit
Ce protocole de communication structuré assure une interaction transparente entre Google, les fournisseurs et les autorités fiscales, pour améliorer l'efficacité des factures de traitement et de conformité.
Semblable au mécanisme de traitement par lot utilisé pour les requêtes, le traitement par lot des réponses regroupe plusieurs documents en une seule fois une gestion efficace. Pour en savoir plus sur ce mécanisme, consultez le traitement par lot des réponses aux factures .
La structure du schéma, illustrée sur l'image, illustre l'organisation et ses composants critiques, ce qui souligne l'approche pour l'envoi de factures:
1.0 En-tête de réponse de l'application
Elle détaille les métadonnées essentielles telles que l'ID de demande de fournisseur Google, la date et Heure à laquelle la réponse a été émise en UTC.
Élément | Description | Exemple |
---|---|---|
cbc:UUID |
Identifiant de la demande de fournisseur Google fourni dans la demande de facture. | 123e4567-e89b-12d3-a456-426614174000 |
cbc:IssueDate |
Date à laquelle la réponse a été émise. | 2023-06-02 |
cbc:IssueTime |
Heure à laquelle la réponse a été émise, en UTC. | 08:20:00-08:00 |
Exemple
<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 Informations sur l'expéditeur et le destinataire
Cette section fournit des informations sur l'expéditeur et le destinataire Réponse de la demande, un champ obligatoire conformément à la norme UBL. Dans ce l'expéditeur doit être le fournisseur qui transmet la réponse le système gouvernemental et le destinataire devrait être Google.
Élément | Description | Exemple |
---|---|---|
cac:SenderParty/cac:PartyName/cbc:Name |
Nom du fournisseur qui transmet la réponse du système gouvernemental. | Vendor Company |
cac:ReceiverParty/cac:PartyName/cbc:Name |
Nom de l'entité recevant la réponse. | Google |
Exemple
<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 Documenter la réponse
Cette section fournit des détails sur la réponse du document, englobant à la fois les l'état de la réponse et toutes les références de document associées générées en conséquence de l'envoi réussi du document au gouvernement.
Élément | Description | Exemple |
---|---|---|
cac:Response |
Obligatoire. Contient l'état de la réponse liée à l'envoi de la facture. | Voir section 3.1 |
cac:DocumentReference |
Facultatif. Peut inclure plusieurs références aux documents générés, ou aucune. | Voir section 3.2 |
Exemple
<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 Réponse
Chaque réponse d'application doit contenir un seul élément cac:Response
détaillant les
état actuel, associé exclusivement à l'envoi d'un document. Cela garantit
que le résultat du traitement de chaque document est clairement communiqué.
Élément | Description | Exemple |
---|---|---|
cbc:ReferenceID |
Identifiant unique renvoyé par le système fiscal pour la facture indiquée. | BIL-123456 |
cbc:ReferenceID/@schemeID |
Système ou norme qui fournit l'identifiant, clarifiant sa source. | KSEF |
cac:Status/cbc:StatusReasonCode |
Code qui définit le motif de la réponse ou de l'état, en fonction d'une valeur prédéfinie: list. | NON |
cac:Status/cbc:StatusReason |
Texte descriptif fournissant plus de détails sur le code d'état. | No Issue |
Exemple
<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 Référence de document
Cette section permet de joindre des références aux documents générés suite à lors du processus d'envoi de facture. Il est facultatif et peut contenir plusieurs en fonction du nombre de documents générés par l'administration fiscale.
Élément | Description | Exemple |
---|---|---|
cbc:ID |
Numéro de facture locale | BIL-123456 |
cbc:ID/@schemeID |
Identifiant de l'émetteur de la référence de facture | Vendor Company |
cbc:IssueDate |
Date à laquelle cette réponse a été envoyée par les autorités fiscales | 2023-06-02 |
cbc:DocumentTypeCode |
Type de document référencé, sous forme de code (si la facture est acceptée) | 380 |
cbc:DocumentType |
Type de document référencé, sous forme de texte | Invoice |
cac:Attachment/cac:ExternalReference/cbc:FormatCode |
Format de la facture générée (XML, PDF, URL) | XML |
cac:Attachment/cac:ExternalReference/cbc:FileName |
Nom du fichier généré sur le serveur SFTP (pour les codes au format XML et PDF) | invoice_GCEMEAD0000000001.pdf |
cac:Attachment/cac:ExternalReference/cbc:URI |
URL pour récupérer le fichier généré (pour le code de format d'URL) | https://example.com/invoice/view |
Ces exemples illustrent la manière dont les documents peuvent être référencés dans la Demande Réponse. Le premier exemple concerne des documents transférés à l'aide du protocole SFTP (voir PDF et XML, et le deuxième exemple illustre un document accessible à l'aide d'URL, ce qui simplifie l'accès direct sans avoir à transférer les fichiers protocoles.
Exemple 1: PDF et Factures XML en pièce jointe transférées via 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>
Exemple 2: Document accessible via une 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>