SFV MODALIDAD ELECTRNICA POR CICLOS

Especificaciones Tcnicas para la Implementacin

de Servicios WEB de la modalidad de Facturacin
Electrnica por Ciclos
1. Introduccin
La modalidad de facturacin Electrnica por Ciclos definida por la Administracin Tributaria,
se trata de un Servicios Web que permite interactuar al Sistema de Facturacin Computarizado
del Contribuyente con el Sistema de Facturacin Virtual (SFV) de la Administracin Tributaria.
El presente documento tiene por objeto establecer aquellas consideraciones de orden tcnico
que le permitan al contribuyente interactuar con los Servicios Web del SFV para aplicar citada
modalidad de facturacin
La Modalidad de Facturacin Electrnica por Ciclos puede ser utilizada por los contribuyentes
que pertenezcan al Rgimen General y que cumplan con las disposiciones establecidas en la
correspondiente Resolucin Normativa de Directorio que reglamenta el Sistema de
Facturacin Virtual. La aplicacin de esta modalidad no restringe al contribuyente la
posibilidad de utilizar otras Modalidades de Facturacin.
Un Ciclo es aquel periodo de tiempo definido por la Administracin Tributaria en el cual el
contribuyente est autorizado a emitir sus facturas desde su propio sistema de facturacin
computarizado de manera desconectada de la Administracin Tributaria.
El Ciclo se inicia con una solicitud del contribuyente a travs del Servicio Web del SFV, recibe
como respuesta a esta solicitud los datos de la dosificacin de las facturas y se cierra con otro
llamado al Servicio Web del SFV por parte del contribuyente en el cual informa a la
Administracin Tributaria la facturacin realizada durante la duracin del Ciclo en un archivo
comprimido.
Para el inicio de un nuevo Ciclo es necesario que se finalice previamente el Ciclo anterior.
Durante el ciclo los contribuyentes de manera desconectada de la Administracin Tributaria
emiten facturas desde su sistema de facturacin computarizado haciendo uso de los datos de
dosificacin que recibieron del Servicio Web del SFV.
Para optar por la Modalidad de Facturacin Electrnica por Ciclos son requisitos contar:
a)
b)
c)
d)

Con un sistema de facturacin computarizado debidamente registrado en el SFV.

Con la Certificacin del Cdigo de Control emitido por el SFV.
Con el correspondiente Certificado Digital para el intercambio seguro de informacin.
Con conexin a Internet.

La aplicacin de esta Modalidad de Facturacin por Ciclos exige realizar previamente pruebas
que permitan asegurar el correcto intercambio de informacin entre la Administracin
Tributaria y el sistema de facturacin computarizado del contribuyente. Para ello el
1

SFV MODALIDAD ELECTRNICA POR CICLOS

contribuyente deber ingresar a la Oficina Virtual del SIN y en el Mdulo del SFV realizar los
siguientes pasos:

Suscripcin, el contribuyente elegir la suscripcin a la Modalidad de Facturacin

Electrnica por Ciclos.
Registro del Certificado Digital, permite al contribuyente descargar el certificado
pblico de la Administracin Tributaria y subir su respectivo certificado pblico.
Personalizacin, con este paso el contribuyente especifica las caractersticas especiales
de facturacin con las cuales desea emitir sus facturas cuando corresponda.

Una vez realizados estos 3 pasos se inicia la etapa de pruebas por el perodo que el
contribuyente requiera.
Las pruebas consisten en el intercambio de informacin a travs del Servicio Web del SFV
publicado por la Administracin Tributaria y el sistema de facturacin computarizado del
contribuyente.
Una vez concluida la etapa de pruebas de manera satisfactoria, el contribuyente debe realizar
la activacin de la Modalidad de Facturacin por Ciclos a travs del SFV en la Oficina Virtual
por nica vez.
Cualquier solicitud de inicio de ciclo posterior a la activacin ser considerada por la
Administracin Tributaria como oficial, debiendo el contribuyente cumplir con todos los
aspectos normativos relacionados al Sistema de Facturacin Virtual establecidos en la
normativa vigente.

1.1 Caractersticas Modalidad de facturacin por Ciclos

La dosificacin para esta modalidad es automtica, es decir al inicio del ciclo se envan
los datos de dosificacin.
Se debe considerar que la fecha lmite de emisin es la misma fecha de la transaccin.
La factura se desmaterializa, el emisor no est obligado a imprimir la factura, salvo
solicitud del cliente.
El emisor est obligado al envo de la factura digital al cliente a travs de medios
electrnicos que le permitan la impresin de la misma (Ej. formato PDF) o bien
comunicarle el lugar desde el cual pueda acceder a ella (Ej. Portal del Proveedor).
Permite la autorizacin por Terceros, debiendo el titular contar con su propio
Certificado Digital.
Utiliza certificados digitales de Verisign para el intercambio de informacin.

1.2 Certificado Digital

Obtenido del artculo de Daniel Aubareda, Certificados y factura digital: ms fcil, ms
seguro, y ms cmodo para todos.

El Certificado Digital es una herramienta que garantiza plenamente la seguridad en los

intercambios comerciales de la Red.

SFV MODALIDAD ELECTRNICA POR CICLOS

La Factura Electrnica, aplicacin directa del Certificado Digital, permite una

importante reduccin de costes y la integracin automtica de las facturas con los
sistemas informticos de las empresas.
Tanto Certificado Digital como Factura Electrnica suponen un instrumento para
aumentar la competitividad empresarial y hacer de la tramitacin algo ms sencillo
para todos.

La seguridad, se ha convertido en una de las mayores obsesiones de los usuarios en la Red. El

desarrollo empresarial, el comercio electrnico y el intercambio de informacin necesitan de
una respuesta tcnica segura, y el Certificado Digital es una herramienta vlida y cada vez ms
popular.
Un Certificado Digital es un bloque de caracteres que acompaa a un documento y que
certifica quin es su autor (autenticacin) y que no haya existido ninguna manipulacin de los
datos (integridad). Para firmar, el signatario utiliza una clave secreta que le vincula al
documento.
La validez de la firma podr ser comprobada por el destinatario que conoce la clave pblica del
autor validada por la entidad certificadora (Verisign).
Mediante la certificacin digital, al existir plena garanta de autenticacin e integridad, existe la
posibilidad de facturar electrnicamente. Entendemos por Factura Electrnica, al documento
tributario generado por medios informticos en formato electrnico, que reemplaza al
documento fsico en papel conservando su mismo valor legal. La Factura Electrnica es
transmitida por medios telemticos por el emisor y se conserva en soporte informtico que
permite su consulta e impresin en cualquier momento.
Con la utilizacin de la Factura Electrnica se consigue la supresin de los costes de emisin,
distribucin y conservacin de la factura en papel, as como una importante simplificacin de
los procesos administrativos, con una importante reduccin de tiempo y espacio. Pero lo que
realmente aporta valor, es la integracin automtica de las facturas con los sistemas
informticos de las empresas (emisoras/receptoras) as como el establecimiento de un nuevo
canal de interaccin entre socios de negocios. Estas circunstancias posibilitan la
desmaterializacin total de la factura, mientras que al mismo tiempo habilitan ms y mejores
mecanismos para desarrollar relaciones de negocios ms eficientes y productivas.

1.3 Caractersticas de los Certificados Digitales

Los Certificados Digitales con los cuales se trabajar para el intercambio de informacin con la
Administracin Tributaria, deben cumplir con las siguientes caractersticas:
Soportar Infraestructura PKI (Primary Key Index): llave privada y llave pblica.

Confidencialidad: el contenido de la comunicacin ha de ser intil para una tercera

parte que lo pudiera interceptar.
Autenticacin: el sistema ha de asegurarnos que una tercera parte no puede usurpar
la identidad de alguna de las dos partes que intervienen en la comunicacin.
Integridad: nos debe garantizar que la informacin transmitida, adems de no ser
interceptada, no pueda ser modificada por una tercera parte.

SFV MODALIDAD ELECTRNICA POR CICLOS

No repudio: debe garantizar que ninguno de los participantes en una comunicacin

pueda negar parte de la misma. Es un concepto ligado al de autenticacin, y as ser
considerado.

Uso del protocolo SSL/TLS: para asegurar la privacidad y autenticidad de las comunicaciones
digitales.

Certificados Digitales X.509

El formato de certificados X.509 se especifica en un sistema de notacin denominado sintaxis
abstracta uno (Abstract Sintax One o ASN1). Para la transmisin de los datos se aplica el DER
(Distinguished Encoding Rules o reglas de codificacin distinguible), que transforma el
certificado en formato ASN1 en una secuencia de octetos apropiada para la transmisin en
redes reales.
Versin. El campo de versin contiene el nmero de versin del certificado codificado.
Nmero de serie del certificado. Este campo es un entero asignado por la autoridad certificadora.
Cada certificado emitido por una CA debe tener un nmero de serie nico.
Identificador del algoritmo de firmado. Este campo identifica el algoritmo empleado para firmar
el certificado (como por ejemplo el RSA o el DSA).
Nombre del emisor. Este campo identifica la CA que ha firmado y emitido el certificado.
Periodo de validez. Este campo indica el periodo de tiempo durante el cual el certificado es vlido y
la CA est obligada a mantener informacin sobre el estado del mismo. El campo consiste en una fecha
inicial, la fecha en la que el certificado empieza a ser vlido y la fecha despus de la cual el certificado
deja de serlo.
Nombre del sujeto. Este campo identifica la identidad cuya clave pblica est certificada en el
campo siguiente. El nombre debe ser nico para cada entidad certificada por una CA dada, aunque
puede emitir ms de un certificado con el mismo nombre si es para la misma entidad.
Informacin de clave pblica del sujeto. Este campo contiene la clave pblica, sus parmetros y
el identificador del algoritmo con el que se emplea la clave.
Identificador nico del emisor. Este es un campo opcional que permite reutilizar nombres de
emisor.
Identificador nico del sujeto. Este es un campo opcional que permite reutilizar nombres de
sujeto.
Extensiones. Las extensiones del X.509 proporcionan una manera de asociar informacin adicional a
sujetos, claves pblicas, etc. Un campo de extensin tiene tres partes:
1.

Tipo de extensin. Es un identificador de objeto que proporciona la semntica y el tipo de

informacin (cadena de texto, fecha u otra estructura de datos) para un valor de extensin.

2.

Valor de la extensin. Este subcampo contiene el valor actual del campo.

3.

Indicador de importancia. Es un flag que indica a una aplicacin si es seguro ignorar el

campo de extensin si no reconoce el tipo. El indicador proporciona una manera de

SFV MODALIDAD ELECTRNICA POR CICLOS

implementar aplicaciones que trabajan de modo seguro con certificados y evolucionan
conforme se van aadiendo nuevas extensiones.

El ITU (International Telecommunication Union) y el ISO/IEC (International Organization

for standarization/International Electrotechnical Commission) han desarrollado y publicado un
conjunto de extensiones estndar en un apndice al X.509:
1.

Limitaciones bsicas. Este campo indica si el sujeto del certificado es una CA y el mximo
nivel de profundidad de un camino de certificacin a travs de esa CA.

2.

Poltica de certificacin. Este campo contiene las condiciones bajo las que la CA emiti el
certificado y el propsito del certificado.

3.

Uso de la clave. Este campo restringe el propsito de la clave pblica certificada, indicando,
por ejemplo, que la clave slo se debe usar para firmar, para la encriptacin de claves, para la
encriptacin de datos, etc. Este campo suele marcarse como importante, ya que la clave slo
est certificada para un propsito y usarla para otro no estara validado en el certificado.

1.4 Proveedor del certificado digital

Debido a la necesidad de estandarizar y simplificar los procesos de validacin y garantizar un mejor
control de los certificados digitales, se estableci que tanto la Administracin Tributaria, como los
contribuyentes que se adhieran a la Modalidad de Facturacin Electrnica por Ciclos, obtengan los
certificados de la misma entidad certificadora (CA), que para este caso ser:

Para mayor informacin de los proveedores de esta lnea de certificados puede acceder a la pgina de
informacin de VeriSign para Latinoamrica en la siguiente direccin

http://www.verisign.com/latinamerica/esp/verisign-worldwide/
https://www.verisign.es/
http://www.asoban.bo/index.php?option=com_content&view=article&id=11&Itemi
d=27
https://www.certisur.com/

1.5 Modelo de Seguridad

Con el objetivo de brindar la mayor seguridad y sobre todo lograr la mayor interoperabilidad con
nuestros contribuyentes, y facilitarles la adhesin a nuestra nueva Modalidad de Facturacin Electrnica
por Ciclos, la Administracin Tributaria se decidi por la utilizacin de los estndares actualmente
vigentes y recomendados por la entidad encargada de establecer las mejores prcticas para el uso de
estndares de servicios WEB que recibe el nombre de WSI (WEB Services Interoperatibility
Organization).

SFV MODALIDAD ELECTRNICA POR CICLOS

Para entender ms claro que es la WSI, exponemos el siguiente artculo obtenido de la Wikipedia, que
adems dar una clara idea de lo que se quiere lograr cuando nos referimos a interoperabilidad.

Dentro de la arquitectura SOA (Service Oriented Architecture) para la implementacin de Servicios

Web, la interoperabilidad es tal vez el principio ms importante. Como mtodo de implementacin de
SOA, Web Services debe ofrecer importantes beneficios de interoperabilidad, y permitir la ejecucin de
servicios Web distribuidos en mltiples plataformas de software y arquitecturas de hardware.
La Organizacin para la Interoperabilidad de Servicios Web (Web Services Interoperability
Organization) es un esfuerzo de la industria en este sentido. Su objetivo es fomentar y promover la
Interoperabilidad de Servicios Web (Web Services Interoperability WSI) sobre cualquier plataforma,
sobre aplicaciones, y sobre lenguajes de programacin. Su intencin es ser un integrador de estndares
para ayudar al avance de los servicios web de una manera estructurada y coherente. La WSI ha
organizado los estndares que afectan a la interoperabilidad de los servicios web en una pila basada en
funcionalidades.
Hay varios estndares que necesitan ser coordinados para llevar a buen trmino las cuestiones de
interoperabilidad de servicios. Dichos estndares se estn desarrollando en paralelo y de manera
independiente. Para superar estas cuestiones, la WSI ha desarrollado el concepto de
'perfil' (profile) La WSI define un perfil como:
Un conjunto de definiciones/especificaciones comnmente aceptadas por la industria y a partir del
apoyo a estndares basados en XML, junto con un conjunto de indicaciones que recomiendan cmo se
deben usar las especificaciones para desarrollar servicios web interoperables entre s.
Dado que dicha organizacin, de carcter abierto, est compuesta por las principales compaas de
desarrollo de software, como IBM, Microsoft o Sun Microsystems, hay un claro compromiso por incluir
todos estos estndares en el mundo de la programacin actual y futura.
Por lo que para poder revisar detalles acerca de la implementacin de los servicios WEB recomendamos
el acceso a su pgina web

2. Estructuras de mensajes
Informacin del contrato del Servicios Web:
http://190.181.4.251:80/SIN/Recaudacion/WsFacturacion/WsFacturacionContrato.
svc?wsdl

Existen tres mtodos en el Servicio Web:

a) IniciarCiclo
b) ConfirmarInicio
c) FinalizarCiclo
6

SFV MODALIDAD ELECTRNICA POR CICLOS

Los cuales sirven para la recepcin y envo de datos entre el Sistema de Facturacin
Computarizado del Contribuyente y el SFV de la Administracin Tributaria.

a) IniciarCiclo
Requerimiento
El mtodo IniciarCiclo, tiene como parmetros de entrada:

NIT, campo tipo numrico 12 dgitos, donde se enviar el Nmero de Identificacin

Tributaria del titular.
NIT Tercero, campo tipo numrico de 12 dgitos, donde se enviar el Nmero de
Identificacin Tributaria del tercero.
Usuario Certificado, campo tipo cadena de 30 caracteres, donde se enviar el
usuario de certificado registrado al momento de subir el certificado a travs de
Registro de certificados en la Oficina Virtual.
CodigoActividadEconomica, campo tipo Nmero de 5 dgitos, donde se enviara el
cdigo de la actividad econmica.
CodigoCaracteristica, campo tipo cadena de 5 caracteres, donde se enviar el
cdigo de la caracterstica de facturacin seleccionada en el proceso de
Personalizacin a travs de la Oficina virtual
CODIGO

DESCRIPCION

CSCF

Sin derecho a crdito fiscal

CVME

Venta de moneda extranjera

CVGD

Venta de gasolina y disel

CDCF

Con derecho a crdito fiscal

CFTT

Terceros

CFTC

Conjunta

CCEX

Comercial de exportacin

CEXL

Comercial de exportacin Libre Consignacin

CFTU

Turstica

CTCI

Tasa Cero IVA

CALQ

Alquileres

El mtodo IniciarCiclo retorna:

Mensajes, campo tipo vector de cadenas, donde se devolver la lista de mensajes de

error en caso de ser necesario.
Comprobante Electrnico (CE) campo tipo cadena de 50 caracteres, este valor es
sumamente importante ya que la Administracin Tributaria quedar a la espera de
7

SFV MODALIDAD ELECTRNICA POR CICLOS

que el comprobante electrnico sea enviado en el mensaje (ConfirmarInicio) como
constancia de que la comunicacin entre las dos partes ha sido satisfactoria.

Iniciar Ciclo (NIT, NIT Tercero ,UsuarioCertificado,CodigoActividadEconomica, CodigoCaracteristica)

SIN

Sistema Contribuyente

Comprobante Electrnico (CE)

b) ConfirmarInicio
Requerimiento
El mtodo ConfirmarInicio, tiene como parmetros de entrada:

NIT, campo tipo numrico de 12 dgitos, donde se enviar el Nmero de Identificacin

Tributaria del contribuyente (Titular).
Comprobante Electrnico (CE), campo tipo cadena de 50 caracteres , este valor
es el enviado por el SIN en el mtodo IniciarCiclo, es sumamente importante ya que es
con este valor se verificara si la operacin se realiz con xito.

El mtodo ConfirmarInicio retorna:

NumerodeAutorizacion, campo tipo numrico de 14 dgitos, donde se devolver el

nmero de autorizacin de la dosificacin.
Fecha fin de ciclo, campo tipo numrico de 8 dgitos, donde se devolver la fecha
de fin de ciclo en formato numrico.
Llave, campo tipo cadena de 200 caracteres, que permite al sistema de facturacin
computarizado del contribuyente generar el cdigo de control.
NumerodeFactura, campo tipo numrico de 10 dgitos, donde devolver el nmero
inicial para las facturas.
Mensajes, campo tipo vector de cadenas, donde se devolver la lista de mensajes de
error en caso de ser necesario.

ConfirmarCiclo(NIT, Comprobante electrnico)

Sistema
Contribuyente

SIN

(RangoDesde , NroAutorizacion ,Llave , FechaFin)

SFV MODALIDAD ELECTRNICA POR CICLOS

c) FinalizarCiclo
Requerimiento
El mtodo FinalizarCiclo, tiene como parmetros de entrada:

Comprobante Electrnico (CE),

campo de tipo cadena de 200 caracteres,
comprobante electrnico enviado por el SIN al contribuyente confirmando el inicio del
ciclo.
NIT, campo tipo numrico de 12 dgitos , donde se enviar el Nmero de
Identificacin Tributaria del contribuyente que emiti las facturas.
Total Facturas, campo tipo numrico de 12 dgitos donde se enviar la cantidad de
facturas emitidas hasta el fin de ciclo.
Monto Total, campo tipo numrico de 14 dgitos donde se enviar el monto total de
las facturas emitidas hasta el fin de ciclo. Permite punto decimal
Archivo, valor que debe contener el archivo con informacin relacionada a la emisin
de facturas durante el ciclo. Este archivo debe ser comprimido con aplicativo 7 ZIP, de
extensin *.7z

El archivo a enviar deber tener la siguiente estructura de informacin, diferenciada para

facturas segn caracterstica especial:
a. Especificacin, campo tipo numrico que identifica facturas por tipo: 1=CDCF, CALQ,
CFTT, CFTC; 2=CVGD; 3=CCEX, CEXL, 4=CSCF, CTCI, CFTU y 5=CVME.
b. Nmero de Autorizacin, campo tipo numrico donde se enviar el nmero de
autorizacin asociada a la dosificacin de facturas, que contiene la modalidad de
facturacin. Para facturas con especificaciones 1,2, 3, 4 y 5.
c. Nmero de Factura, campo tipo numrico donde se enviar el nmero correlativo de
la factura emitida en el ciclo. Para facturas con especificaciones 1,2, 3, 4 y 5.
d. Cdigo de Control, campo tipo alfanumrico donde se enviar el cdigo de control de
la factura emitida en el ciclo, separados los pares por guiones. Para facturas con
especificaciones 1,2, 3, 4 y 5.
e. CI/NIT Cliente, campo tipo alfanumrico donde se enviar el Nmero de
Identificacin Tributaria o Cdula de Identidad del comprador. Para facturas con
especificaciones 1,2, 3 , 4 y 5.
f. Nombre Cliente, campo tipo texto, que corresponde al nombre y apellidos o razn
social del cliente/comprador. Para facturas con especificaciones 1,2, 3 , 4 y 5.
g. Fecha Factura, campo tipo fecha donde se enviar el da, mes y ao en el que se
emiti la factura. Para facturas con especificaciones 1,2, 3, 4 y 5.
h. Importe Total, campo tipo numrico donde se enviar el importe de cobro que figura
en la factura, hasta dos decimales. Para facturas con especificaciones 1,2, 3, 4 y 5.
i. Importe ICE/IEHD/Tasas, campo tipo numrico donde se enviar el importe del ICE,
IEHD o Tasas contenido en las facturas emitidas, hasta dos decimales. Para facturas
con especificaciones 1 y 3.
j. Importe Exento, campo tipo numrico donde se enviar el importe exento del
impuesto, hasta dos decimales. Incluye exportaciones y otras operaciones exentas.
Para facturas con especificaciones 1 y 3.
k. Ventas Gravadas a Tasa Cero, campo tipo numrico donde se enviar el importe
consignado en la factura a tasa cero, hasta dos decimales. Para facturas con
especificaciones 1 y 3.

SFV MODALIDAD ELECTRNICA POR CICLOS

l.

a.
b.

c.

d.

e.

f.
g.

Descuentos, Bonificaciones, Rebajas, campo tipo numrico donde se enviar el

importe consignado en la factura como descuento, bonificacin o rebaja, hasta dos
decimales. Para facturas tipos 1,2 y 3.
Placa, campo tipo texto donde, se registrar la placa del vehculo automotor al que se
le vendi carburante, slo para estaciones de servicio. Para facturas tipo 2.
Pas de Origen de la Placa, campo tipo texto donde se registrar la nacionalidad de la
placa del vehculo automotor al que se le vendi carburante, slo para estaciones de
servicio. Para facturas con especificacin 2.
Tipo de Envase, campo tipo texto donde se registrar B para bidones, T para botellas,
O para otros, utilizado solo por estaciones de servicio. Para facturas con especificacin
2.
Tipo de Producto, campo tipo texto donde se registrar GE para gasolina especial, GP
para gasolina Premium, DI para Disel y GN para Gas Natural Vehicular, utilizado solo
por estaciones de servicio. Para facturas con especificacin 2.
Autorizacin de Venta, campo tipo texto donde se registra el nmero de autorizacin
de venta cuando supera los 121 litros, utilizado solo por estaciones de servicio. Para
facturas con especificacin 2.
Tipo de Cambio, campo tipo numrico donde se enviar el tipo de cambio de moneda
extranjera a moneda nacional, hasta dos decimales. Para facturas tipo 3 y 5.
Tipo de Moneda, campo de tipo texto donde se enviar la moneda oficial utilizada en
la transaccin (Bs.). Para facturas con especificaciones 3 y 5.
Los campos deben ser concatenados por pipes |.
Los campos que no consignen un valor deben ir con 0 (cero).

Respuesta
El mtodo FinalizarCiclo retorna:

Mensajes, campo tipo vector de cadenas, donde se devolver en caso de ocurrir

algn error la lista de mensajes de error.
Comprobante Electrnico, campo tipo cadena de 200 caracteres que confirma la
comunicacin con el SIN.
FinalizarCiclo(Comprobante Electrnico (CE),NIT,Total Facturas,
Monto Total, Archivo, NombreArchivo)
Sistema
Contribuyente

SIN

Comprobante Electrnico (CE)

10