Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
ALCANCE
El presente documento permite definir los elementos que deben conocer los sujetos pasivos
que van a interaccionar con el sistema, quedando a su potestad los desarrollos,
integraciones con sus Software administrativos y/o Sistemas de Facturación e implantación
del ensamblado de los documentos XML y su respectiva Firma Electrónica. El presente
Anexo, tiene por objetivo proveer la información necesaria para que su equipo de desarrollo
implemente estas adiciones.
El presente documento está diseñado para la fase 1 del Piloto de Facturación Electrónica e
imprenta digital y por ello sólo contempla la generación de facturas. Conforme avancen las
fases del proyecto, se irán adicionando el resto de los documentos posibles (por ejemplo
notas de débito y crédito, comprobantes de retención y otros)
Los sujetos pasivos prestadores de servicio masivos, deberán estructurar los documentos
electrónicos, atendiendo a los siguientes campos:
Factura
DOCUMENTO “1” FACTURA
CONDICIÓN DEL
TIPO VALOR FORMATO CONDICIONES
CAMPO
Código de Verificación Información no editable
Suministrado por la Alfanumérico. Valor generado (Hash) enviada por la Imprenta
Imprenta Digital Digital
Información no editable
Fecha de Asignación del Diez (10) caracteres
Alfanumérico enviada por la Imprenta
Código de Verificación DD/MM/AAAA
Digital
Información no editable
Hora de Asignación del Diez (10) caracteres
Alfanumérico enviada por la Imprenta
Código de Verificación hh:mm:ssam
Digital
Salida Factura Alfanumérico Documento tipo 1 Obligatorio
Cuando los contribuyentes hayan estructurado los comprobantes los mismos deberán ser
enviados a través de una estructura XML a la Imprenta Digital. Recibida la información el
mismo deberá devolver por la misma vía respetando la estructura original, pero agregando
los siguientes campos a los documentos
CONDICIÓN DEL
TIPO VALOR FORMATO CONDICIONES
CAMPO
Consideraciones Generales:
● Una vez que los comprobantes contengan la información agregada por la Imprenta
Digital, y sean remitidos al contribuyente, los mismos no podrán ser objetos de
modificaciones.
● El código de Verificación agregado por la Imprenta Digital es único para cada
comprobante electrónico. Es un número único (aleatorio) pero no necesariamente
consecutivo, bajo estándar el UUID (Identificador Único Universal) de de 16 bytes
(128 bits) normalizado para sistemas abiertos
● El documento contiene de manera obligatoria la firma electrónica del emisor y de la
Imprenta Digital.
● Cuando el emisor envía la información de los comprobantes para ser procesados por
la Imprenta Digital, y este detecta errores e inconsistencias en la data, sin haber
complementado los campos a los que esté obligado, devolverá la data al emisor
para que se proceda a su reprocesamiento.
Estándares Técnicos
Principales Estándares de Tecnología Utilizados para la Imprenta Digital
Característica Descripción
Protocolo de Anulación:
Contingencia de la Operación
Para Imprenta Digital, el envío del XML dependerá de la disponibilidad del medio, en caso
de que haya una falla en el servicio de internet, el sistema instalado en el software
administrativo del contribuyente será el encargado de transmitir la data cuando haya
disponibilidad. Además el XML base tendrá hasta 72 horas para ser entregado a la
Imprenta digital, lo cual lo hace el modelo más robusto.
Si debido a alguna razón técnica el sistema del contribuyente no permita la generación del
XML Base y deba generarse la factura en menos del tiempo tolerado, la facturación debe
ser realizada manual y posteriormente deben ser generadas las facturas de contingencia
con la misma numeración usada. Se debe entregar previamente una numeración
autorizada para las facturas electrónicas de contingencia diferente a la usada para las
facturas electrónicas de venta.
En la siguiente tabla se muestran los tiempos autorizados para la transmisión según la
cantidad de documentos pendientes por transmitir.
Cantidad de documentos
Plazo de envío
emitidos durante la contingencia
CONSIDERACIONES GENERALES
● Se considerará emitida la factura cuando la Imprenta Digital coloca todos los datos
requeridos.
ESPECIFICACIONES DEL DOCUMENTO XML
Precio de la Numérico Veinte (20) dígitos Valor del bien descrito en <fe:Price>
Operación enteros y dos (02) la operación. <cbc:PriceAmount
decimales Obligatorio currencyID="VEF">0.00</cbc:Pr
iceAmount>
</fe:Price>
Monto del Numérico Veinte (20) dígitos Valor de descuento del <cac:AllowanceCharge>
Descuento enteros y dos (02) bien o servicio descrito en <cbc:ChargeIndicator>true</cbc
decimales la operación. Opcional :ChargeIndicator>
(campo por defecto 0) <cbc:Amount
currencyID="VEF">0.00</cbc:A
mount>
</cac:AllowanceCharge>
Descripción del Alfanumérico Doscientos Concepto o motivo del <cac:AllowanceCharge>
Descuento cincuenta y cinco descuento. Obligatorio <cbc:ChargeIndicator>true</cbc
(255) :ChargeIndicator>
caracteres <cbc:AllowanceChargeReason>
Descripcion </cbc:
AllowanceChargeReason>
</cac:AllowanceCharge>
Monto de Numérico Veinte (20) dígitos Valor de Bonificación del <cac:AllowanceCharge>
Bonificación enteros y dos (02) bien o servicio descrito en <cbc:ChargeIndicator>false</cb
decimales la operación. Opcional c:ChargeIndicator>
(campo por defecto 0) <cbc:Amount
currencyID="VEF">0.00</cbc:A
mount>
</cac:AllowanceCharge>
Descripción de la Alfanumérico Doscientos Concepto o motivo de la <cac:AllowanceCharge>
Bonificación cincuenta y cinco bonificación. <cbc:ChargeIndicator>true</cbc
(255) Opcional :ChargeIndicator>
caracteres <cbc:AllowanceChargeReason>
Descripcion </cbc:
AllowanceChargeReason>
</cac:AllowanceCharge>
Monto Total por Numérico Veinte (20) dígitos Valor total por base <cbc:TaxAmount
Base enteros y dos (02) imponible de la alícuota currencyID="VEF">0.00</cbc:T
Imponible decimales del IVA del bien o servicio axAmount>
descrito en la operación.
Obligatorio (valores
positivos > 0)
Valor de las Numérico Dos (2) enteros y Porcentaje de las <cbc:Percent>12.00</cbc:Perce
Alícuotas dos (02) decimales Alícuotas Enlazado con el nt>
Código de la Operación
8% Reducida = (R)
12% General = (G)
15% Adicional = (A)
0%
Obligatorio
Monto Total Exento, Numérico Veinte (20) dígitos Valor total Exento, <cbc:TaxAmount
Exonerado o enteros y dos (02) Exonerado o Percibido. currencyID="VEB">0.00</cbc:T
Percibido decimales Obligatorio axAmount>
Monto Impuesto al Numérico Veinte (20) dígitos Valor del Impuesto por <fe:TaxSubtotal><cbc:TaxAmou
Valor Agregado por enteros y dos (02) alícuota Opcional nt
Alícuota decimales condicionado por el currencyID="VEB">0.00</cbc:
campo valor de las TaxAmount></fe:TaxSubtotal>
alícuotas, opción distinta
de 0%
Obligatorio
Monto Total del IVA Numérico Veinte (20) dígitos Valor total del impuesto <cbc:TaxInclusiveAmount
enteros y dos (02) Obligatorio currencyID="VEB">0.00</cbc:
decimales TaxInclusiveAmount>
Monto Total de la Numérico Veinte (20) dígitos Valor total de la venta <cbc:PayableAmount
Venta enteros y dos (02) Obligatorio currencyID="VEB">0.00</cbc:P
decimales ayableAmount>
Denominación de la Alfanumérico Veinte (20) Indica el tipo de divisa <cbc:SourceCurrencyCode>US
Divisa caracteres Opcional D</cbc:SourceCurrencyCode>
Variables:
*Interna
*Exportación (INCOTERM):
-FOB Selección de un campo
Tipo de Venta Campo -CIF
-EXW Obligatorio
-Entre otros
Dirección
Doscientos cincuenta y cinco
Domicilio Fiscal del Receptor Alfanumérico Obligatorio
(255) caracteres
Incluyendo el @ y el dominio
Correo Electrónico del Máximo cincuenta (50)
Alfanumérico Obligatorio
Receptor caracteres
Campo no editable
Selección múltiple
Cantidad de Bienes y/o Ocho (08) dígitos enteros y Relacionado con la cantidad de
Numérico
Servicios dos (02) decimales productos y/o servicios que se
describen en la operación
Obligatorio
Campo no editable
Veinte (20) dígitos enteros y
Precio de la Operación Numérico Valor del bien descrito en la
dos (02) decimales
operación
Obligatorio
Selección múltiple
Variables: Dada la selección de este campo, el
*Precio de los bienes sistema debe habilitar el campo
*Variación de precio monto dependiendo de la opción
Variaciones Combo *Descuento El recargo solo aplica para notas de
*Bonificación débito (documento 2)
*Recargos Especificar las condiciones de la
*Otros Ajustes selección otros ajustes
Opcional
Dada la selección del campo
Veinte (20) dígitos enteros y
Precio de los Bienes Numérico variación
dos (02) decimales
Opcional
Campo editable
Variable:
Porcentaje de las Alícuotas
*8% Reducida
Enlazado con el Código de la
*12% General
Valor de las Alícuotas Combo Operación
*15% Adicional
Habilitar opción dada la selección del
*Exento o Exonerado
campo variación
*Percibido
Obligatorio
Se puede modificar o agregar,
dependiendo de la cantidad de
productos que aparecen en la nota
Valor total Exento o Exonerado
Monto Total Exento, Veinte (20) dígitos enteros y
Numérico Opcional condicionado por el campo
Exonerado o Percibido dos (02) decimales
valor de las alícuotas, opción 0%
Valor del Impuesto por alícuota
Opcional condicionado por el campo
Monto Impuesto al Valor Veinte (20) dígitos enteros y
Numérico valor de las alícuotas, opción distinta
Agregado por Alícuota dos (02) decimales
de 0%
Obligatorio
Veinte (20) dígitos enteros y Valor total del Impuesto
Monto Total del IVA Numérico
dos (02) decimales Obligatorio
Variables:
Selección simple
Tipo de Producto Combo *Alcohol
Opcional
*Cigarrillos
Nombre y Apellido del Doscientos cincuenta y cinco El sistema debe habilitar otro campo
Alfanumérico
Conductor (255) caracteres en el caso de la existencia de otro
conductor
Obligatorio
Número de RIF de la
Alfanumérico Doce (12) caracteres Obligatorio
Imprenta Digital
Monto Total de la Factura o Veinte (20) dígitos enteros y Valor total de la Venta
Numérico
Nota de Débito Recibida dos (02) decimales Obligatorio
Monto Total del Impuesto al Veinte (20) dígitos enteros y Valor total del Impuesto
Numérico
Valor Agregado dos (02) decimales Obligatorio
Campo condicionado con el Monto
Variables:
Monto del Impuesto Total del Impuesto al Valor Agregado
Alfanumérico 75%
Retenido Selección de una Variable
100%
Obligatorio
Firma Electrónica de la
Alfanumérico N/A
Imprenta Digital Obligatorio
Número de RIF de la
Alfanumérico Doce (12) caracteres Obligatorio
Imprenta Digital
Razón Social de la Imprenta Identificación de la Imprenta Digital
Alfanumérico Cien (100) caracteres
Digital Obligatorio
Firma Electrónica de la
Alfanumérico N/A Obligatorio
Imprenta Digital
Dentro de la norma UBL 2.0 existen un número de campos que no se utilizan para contener
los parámetros obligatorios de la factura (campos extensibles). Estos campos están
disponibles para ser utilizados para agregar información adicional que necesite el
contribuyente y no sea relevante para el SENIAT.
En resumen toda esta normativa, especifica que el Certificado Electrónico que se debe
utilizar en cualquier caso en el ámbito de la Imprenta Digital y de los Emisores de
Facturación y demás documentos debe cumplir con las siguientes características:
● Haber sido emitido por un proveedor de servicios de certificación que haya sido
correctamente acreditado ante el ente regulador (Superintendencia de Servicios de
Certificación Electrónica SUSCERTE) y su acreditación esté vigente.
● Debe realizarse el proceso de solicitud, validación uso y resguardo del Certificado
Electrónico de la manera especificada en las Políticas de Certificación y Declaración
de Prácticas de Certificación del ente emisor y de la entidad Raíz (SUSCERTE).
● Los Certificados Electrónicos tienen una vigencia máxima de 12 meses para
software (contenedor PKCS#12) y 24 meses para Hardware.
● El algoritmo de firma es el algoritmo SHA256 para los Certificados Electrónicos de
Entidad Final con longitud de cifrado de 2048bits (tamaño de la clave privada).
● Las Políticas de Certificados más adecuadas (tipos de certificados) para aplicarlas a
este respecto serían las de Certificado de Persona Jurídica, Certificado Profesional
Titulado, Representante o Empleado de Empresa (Pública o Privada), Facturación
Electrónica o con estructura similar, aprobado por la SUSCERTE
● Estructura y campo descritos en las diversas normas.
REPRESENTACIÓN GRÁFICA IMPRESA DEL DOCUMENTO
La representación Gráfica impresa es un documento intermedio que permite
otorgarle al usuario final un elemento de consulta de su transacción de manera fácil y visual,
que se plantea mantenga la estructura y disposición de una factura física convencional para
facilitar la lectura por parte de usuarios finales no familiarizados con los XML, tiene poca
validez jurídica y fiscal.
Se plantea que se estructure en documentos del tipo PDF, formato que cumpla las
necesidades del contribuyente para facilitar el manejo de la información y ubicación de los
campos, el único requisito que debe cumplir es la inclusión de un código bidireccional QR el
cual debe ir en cada una de las páginas en las versiones digital e impresa, según se indica
a continuación:
Código QR
Se debe incluir en esta representación gráfica un código del tipo QR (del inglés Quick
Response code, "código de respuesta rápida"). Un Código QR es la evolución del código de
barras. Es un módulo para almacenar información en una matriz de puntos o en un código
de barras bidimensional. La matriz se lee en el dispositivo móvil por un lector específico
(lector de QR). Está basado en la norma ISO/IEC 18004:2015 “Information – Automatic
identification and data capture techniques – QR Code barcode symbology specification”
Debe tener un tamaño mínimo de 2 cm para facilitar la lectura desde diferentes dispositivos
y debe ir en cada una de las páginas en las versiones digital e impresa. El código QR sea
generado a partir de los campos de la siguiente tabla:
1. Tipo de documento
2. Número de documento
3. Fecha y hora de emisión de documento
4. RIF del emisor
5. Total de venta (Base imponible + Impuestos)
6. Total de IVA
7. Número de la imprenta digital autorizada
8. Código de Verificación (UUID)
SERVICIOS WEB
Un servicio web (en inglés, web service o web services) es una tecnología que utiliza un
conjunto de protocolos y estándares que sirven para intercambiar datos entre aplicaciones.
Distintas aplicaciones de software desarrolladas en lenguajes de programación diferentes, y
ejecutadas sobre cualquier plataforma, pueden utilizar los servicios web para intercambiar
datos en redes de ordenadores como Internet. La interoperabilidad se consigue mediante la
adopción de estándares abiertos. Las organizaciones OASIS y W3C son los comités
responsables de la arquitectura y reglamentación de los servicios Web.
En la arquitectura de servicios web existen tres partes: proveedor de servicios web, el que
pide el servicio web y el publicador. El proveedor de servicios envía al publicador del
servicio un fichero WSDL con la definición del servicio web. El que pide el servicio contacta
con el publicador y descubre quien es el proveedor (protocolo WSDL) y contacta con el
proveedor (protocolo SOAP). El proveedor valida la petición de servicio y envía el dato
estructurado en formato XML utilizando el protocolo SOAP. El fichero XML es validado de
nuevo por el que pide el servicio utilizando un fichero XSD.
En el caso del sistema en cuestión el sujeto pasivo debe desarrollar un módulo de software
en cualquier mensaje de programación que sea capaz de consultar y extraer la data de
cada transacción del sistema propio del sujeto pasivo la encapsule en un XML siguiendo la
estructura establecida en el presente documento, y por medio del fijado del link WSDL que
contiene la información característica del servicio.
El servicio al descargar los métodos trae la información a incluir y debe ser consumido por
el código fuente. En este caso, se debe convertir el XML ya construido y firmado
electrónicamente, en un formato codificado llamado Base64 (la mayoría de los lenguajes de
programación ya tienen esto implementado) e incluirlo en uno de los nodos de la solicitud
SOAP, así como la fecha de emisión (debe coincidir con la establecida en el contenido del
XML), el número de identificación del emisor del documento (RIF del sujeto pasivo en
formato Letra+Número, ejemplo J123455678) y la numeración interna correlativa que el
sistema del sujeto Pasivo le asignó al documento (ejemplo PRUE00000001). No confundir
esta numeración interna con el Código de Validación que retorna la imprenta digital al
validar el documento.
La consignación del token se realiza sabiendo que el consumo del WS se realiza en base a
un protocolo de fondo parecido al de las páginas Web, como lo es el HTML. En este caso, el
token se agrega como un header llamado “token” y valor (donde se coloca ese código tipo
contraseña) en la petición HTML que es la base de la consignación de la petición SOAP.
Tanto la dirección WSDL como el token se le proporcionan al sujeto pasivo al cumplir las
condiciones requeridas por el SENIAT y haber contratado los servicios de la Imprenta Digital
Autorizada.