Esta guía describe la aplicación de la Respuesta a la solicitud de UBL 2.4 de Kubernetes, de acuerdo con los estándares UBL 2.4. Su función principal es retransmitir la estado de los envíos de documentos de facturación a las autoridades fiscales. Enviado desde autoridad fiscal a través de proveedores para Google, el documento es fundamental para la estado de envío y puede incluir vínculos a los archivos binarios de facturas generadas por la administración tributaria.
El esquema facilita a los proveedores la tarea de informar los resultados de los documentos enviados a Google, que abarca lo siguiente:
- Estado de aceptación de los documentos.
- Problemas o errores identificados por la autoridad fiscal.
- Vínculos a archivos binarios relacionados de facturas o notas de crédito.
Este protocolo de comunicación estructurado garantiza una interacción fluida entre Google, los proveedores y las autoridades fiscales, lo que mejora la eficiencia de las facturas procesamiento y cumplimiento.
Al igual que el mecanismo de lotes que se usa para las solicitudes, la agrupación de respuestas consolida múltiples documentos en un único envío para obtener más una administración eficaz. Puede encontrar información detallada sobre este mecanismo en la agrupación en lotes de respuestas de facturas sección.
La estructura del esquema, visualizada en la imagen, ilustra la estructura del documento la organización y los componentes fundamentales, lo que destaca el enfoque hacia el estado informe de envíos de facturas:
1.0 Encabezado de respuesta de la aplicación
Detalla los metadatos esenciales, como el ID de solicitud del proveedor de Google, la fecha y la hora en que la respuesta se emitió en UTC.
Elemento | Descripción | Ejemplo |
---|---|---|
cbc:UUID |
Es el ID de solicitud del proveedor de Google que se proporciona en la solicitud de factura. | 123e4567-e89b-12d3-a456-426614174000 |
cbc:IssueDate |
Es la fecha en la que se emitió la respuesta. | 2023-06-02 |
cbc:IssueTime |
Hora en que se emitió la respuesta, en UTC. | 08:20:00-08:00 |
Ejemplo
<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 Información del remitente y del receptor
En esta sección, se proporciona información sobre el remitente y el destinatario de la Respuesta a la aplicación, un campo obligatorio según el estándar UBL En este contexto, se espera que el remitente sea el proveedor que reenvía la respuesta el sistema gubernamental, y el receptor debe ser Google.
Elemento | Descripción | Ejemplo |
---|---|---|
cac:SenderParty/cac:PartyName/cbc:Name |
El nombre del proveedor que envía la respuesta del sistema gubernamental. | Vendor Company |
cac:ReceiverParty/cac:PartyName/cbc:Name |
Nombre de la entidad que recibe la respuesta. | Google |
Ejemplo
<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 Respuesta del documento
En esta sección, se proporcionan detalles sobre la respuesta del documento, que abarca el estado de la respuesta y las referencias a documentos asociadas que se generaron como resultado de la presentación exitosa de documentos al Gobierno.
Elemento | Descripción | Ejemplo |
---|---|---|
cac:Response |
Obligatoria. Contiene el estado de la respuesta relacionado con el envío de la factura. | Consulta la sección 3.1 |
cac:DocumentReference |
Opcional. Puede incluir cero o muchas referencias a los documentos generados. | Consulta la sección 3.2 |
Ejemplo
<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 Respuesta
Cada respuesta a la aplicación debe contener una sola cac:Response
que detalle la
estado actual, asociado de forma inequívoca con el envío de un documento. Esto garantiza
que cada resultado de procesamiento de documentos se comunique claramente.
Elemento | Descripción | Ejemplo |
---|---|---|
cbc:ReferenceID |
Es el identificador único que devuelve el sistema impositivo para la factura a la que se hace referencia. | BIL-123456 |
cbc:ReferenceID/@schemeID |
Es el sistema o estándar que proporciona el identificador y aclara su fuente. | KSEF |
cac:Status/cbc:StatusReasonCode |
Código que define el motivo de la respuesta o del estado, según el valor predefinido: list. | NON |
cac:Status/cbc:StatusReason |
Es un texto descriptivo que proporciona más detalles sobre el código de estado. | No Issue |
Ejemplo
<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 Referencia de documentos
Esta sección se utiliza para adjuntar referencias a documentos generados como resultado de el proceso de envío de facturas. Es opcional y puede contener varias en función de la cantidad de documentos generados por la autoridad fiscal.
Elemento | Descripción | Ejemplo |
---|---|---|
cbc:ID |
Número de factura local | BIL-123456 |
cbc:ID/@schemeID |
Identificador de la entidad emisora de referencia de la factura | Vendor Company |
cbc:IssueDate |
Fecha en la que las autoridades tributarias emitieron esta respuesta | 2023-06-02 |
cbc:DocumentTypeCode |
Tipo de documento al que se hace referencia, expresado como código (si se acepta la factura) | 380 |
cbc:DocumentType |
Tipo de documento al que se hace referencia, expresado como texto | Invoice |
cac:Attachment/cac:ExternalReference/cbc:FormatCode |
Formato de la factura generada (XML, PDF, URL) | XML |
cac:Attachment/cac:ExternalReference/cbc:FileName |
Es el nombre del archivo generado en el servidor SFTP (para códigos de formato XML y PDF). | invoice_GCEMEAD0000000001.pdf |
cac:Attachment/cac:ExternalReference/cbc:URI |
URL para recuperar el archivo generado (para el código de formato de URL) | https://example.com/invoice/view |
Estos ejemplos ilustran cómo se puede hacer referencia a los documentos en la Solicitud Respuesta. El primer ejemplo involucra los documentos transferidos a través de SFTP, que se muestra en en formato PDF y XML, y en el segundo ejemplo se muestra un documento al que se puede acceder mediante una URL, lo que simplifica el acceso directo sin necesidad de transferir archivos protocolos.
Ejemplo 1: PDF & Archivos adjuntos de facturas en formato XML transferidos a través de 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>
Ejemplo 2: Se puede acceder a un documento mediante una 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>