VerifactuQr 1.0.1

dotnet add package VerifactuQr --version 1.0.1                
NuGet\Install-Package VerifactuQr -Version 1.0.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="VerifactuQr" Version="1.0.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add VerifactuQr --version 1.0.1                
#r "nuget: VerifactuQr, 1.0.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install VerifactuQr as a Cake Addin
#addin nuget:?package=VerifactuQr&version=1.0.1

// Install VerifactuQr as a Cake Tool
#tool nuget:?package=VerifactuQr&version=1.0.1                

Especificaciones Técnicas del Código QR para Facturas

Versión: 0.4.7
Fecha: 17/10/2024
Autor: Agencia Estatal de Administración Tributaria (AEAT)

Descripción

Este documento define las especificaciones técnicas para la implementación del código QR en facturas, así como la URL para el servicio de cotejo o remisión de información, en conformidad con el Real Decreto 1007/2023 y otras normativas vigentes. La aplicación del sistema VERI*FACTU permite verificar la validez de las facturas y facilitar la remisión de información.

Índice

  1. Introducción
  2. Especificaciones del Código QR
  3. Ubicación y Presentación del Código QR
  4. URL del Código QR
  5. Parámetros de la URL
  6. Ejemplos de URL válidas
  7. Ejemplos de Respuestas del Servicio
  8. Códigos de Error de Validación
  9. Normativa Legal
  10. Anexo

Introducción

El objetivo es detallar los aspectos técnicos necesarios para cumplir con los requisitos de facturación, estableciendo las condiciones para la integración del código QR en facturas emitidas por VERI*FACTU. Este sistema permite la validación de la autenticidad de una factura en la sede electrónica de la AEAT.

Especificaciones del Código QR

  • Tamaño: Entre 30x30 y 40x40 mm.
  • Norma: ISO/IEC 18004:2015.
  • Nivel de Corrección: Nivel M (medio).
  • Contenido:
    • URL de cotejo o remisión de información.
    • Datos de la factura: NIF del emisor, número de serie, fecha de emisión e importe total.

Ubicación y Presentación del Código QR

  1. Posición en la Factura: Preferentemente en la esquina superior izquierda, con un margen en blanco alrededor de al menos 2 mm (recomendado: 6 mm).
  2. Texto Identificativo: "QR tributario" debe aparecer encima del código QR.
  3. Frase Complementaria: En sistemas VERI*FACTU, incluir "Factura verificable en la sede electrónica de la AEAT".

URL del Código QR

La URL depende del tipo de sistema y del entorno (pruebas o producción):

  • Facturas verificables (VERI*FACTU):
    • Pruebas: https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=XXXXXXXXY&numserie=YYYY...YYYY&fecha=DD-MM-AAAA&importe=NNNNNNNNN.DD
    • Producción: https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQR?nif=XXXXXXXXY&numserie=YYYY...YYYY&fecha=DD-MM-AAAA&importe=NNNNNNNNN.DD
  • Facturas no verificables:
    • Pruebas: https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQRNoVerifactu?nif=XXXXXXXXX&numserie=YYYYYYYY&fecha=DD-MM-AAAA&importe=NNNNNNNN.DD
    • Producción: https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQRNoVerifactu?nif=XXXXXXXXX&numserie=YYYYYYYY&fecha=DD-MM-AAAA&importe=NNNNNNNN.DD

Parámetros de la URL

La URL debe incluir los siguientes parámetros:

Parámetro Descripción Formato
nif NIF del emisor de la factura NIF (9 caracteres)
numserie Número de serie y factura Texto, máx. 60
fecha Fecha de emisión DD-MM-AAAA
importe Importe total de la factura Numérico, decimales

Ejemplos de URL válidas

  • Pruebas (Facturas Verificables):
    https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=89890001K&numserie=12345678-G33&fecha=01-09-2024&importe=241.4

  • Producción (Facturas No Verificables):
    https://www2.agenciatributaria.gob.es/wlpl/TIKE-CONT/ValidarQRNoVerifactu?nif=89890001K&numserie=12345678-G33&fecha=01-09-2024&importe=241.4

  • Artículos 20 y 21 del Real Decreto 1007/2023.
  • Orden XXXXXXXXXX para la regulación de procesos de facturación electrónica.

Anexo

Se incluyen ejemplos de códigos QR en diferentes formatos de factura y orientaciones.

Enlace documentación AEAT https://www.agenciatributaria.es/static_files/AEAT_Desarrolladores/EEDD/IVA/VERI-FACTU/DetalleEspecificacTecnCodigoQRfactura.pdf

Este README resume las principales especificaciones del sistema VERI*FACTU para el manejo de códigos QR en facturas, facilitando la validación y autenticación de la información de facturación ante la AEAT.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.1 41 11/23/2024
1.0.0 36 11/23/2024