rshk-jsifenlib es una librería de código abierto, sin dependencias externas, para interactuar con SIFEN (Sistema
Integrado de Factura Electrónica Nacional) a través de un SDK para el lenguaje Java versión 8.
<dependencies>
<dependency>
<groupId>com.roshka.sifen</groupId>
<artifactId>rshk-jsifenlib</artifactId>
<version>0.2.4</version>
</dependency>
</dependencies>repositories {
mavenCentral()
}
dependencies {
implementation 'com.roshka.sifen:rshk-jsifenlib:0.2.4'
}- Consulta de RUC
- Recepción de Documento Electrónico - Síncrono
- Consulta de Documentos Electrónicos
- Recepción de Lote de Documentos Electrónicos - Asíncrono
- Consulta de Estado de Documentos Electrónicos (Lote)
- Recepción de Eventos
Importante: Leer el Manual Técnico de Sifen y entender el funcionamiento básico antes de continuar con la guía de uso de esta librería.
Para utilizar las funciones ofrecidas por RSHK jsifenlib es necesario configurar los siguientes ítems:
- Tipo de Ambiente (Desarrollo o Producción)
- Certificado y Tipo de Certificado (Solo PFX está soportado actualmente)
- Código de Seguridad (CSC)
Para esto, crear una nueva instancia de la clase SifenConfig utilizando alguno de los constructores:
public class MiClase {
public static void main(String[] args) {
// Constructor vacío. Los valores se deben agregar por medio de los *setters* de la clase.
SifenConfig config = new SifenConfig();
// Constructor con el tipo de ambiente, tipo de certificado, la ruta del certificado y la contraseña.
SifenConfig config = new SifenConfig(
SifenConfig.TipoAmbiente.PROD,
SifenConfig.TipoCertificadoCliente.PFX,
"C:\\Users\\Roshka\\Documents\\certificado.pfx",
"password"
);
}
}
public class MiClase {
public static void main(String[] args) {
// Constructor vacío. Los valores se deben agregar por medio de los *setters* de la clase.
SifenConfig config = new SifenConfig();
// Constructor igual al anterior, con el CSC y su ID.
SifenConfig config = new SifenConfig(
SifenConfig.TipoAmbiente.PROD,
"0002", // ID CSC
"EFGH0000000000000000000000000000", // CSC
SifenConfig.TipoCertificadoCliente.PFX,
"C:\\Users\\Roshka\\Documents\\certificado.pfx",
"password"
);
}
}La clase SifenConfig también se puede crear a partir de un método de construcción que toma los datos de un
archivo de propiedades de la siguiente manera:
SifenConfig sifenConfig = SifenConfig.loadFromFileName("conf/sifen.properties");Este archivo debe tener el siguiente formato, dependiendo de las necesidades:
# Esto puede ser:
# DEV (apunta al ambiente de desarrollo/test de SIFEN)
# PROD (apunta al ambiente de producción de SIFEN)
sifen.ambiente=DEV
# NO modificar a menos que uno sepa bien lo que está haciendo
# sifen.url_base=
# Si se va a usar el certificado cliente.
# Este valor en el 99.99% de las veces va a ser true
# a menos que uno sepa bien lo que está haciendo
sifen.certificado_cliente.usar=true
# Por ahora, el único valor aceptado es PFX
sifen.certificado_cliente.tipo=PFX
## RUTA APUNTANDO AL ARCHIVO PFX
sifen.certificado_cliente.archivo=/home/charly/garcia.pfx
## PASSWORD del ARCHIVO PFX
sifen.certificado_cliente.contrasena=my_password
## Nota técnica 13 (23/04/2023)
## Para habilitar los campos nuevos de esta nota técnica, cambiar a true
sifen.habilitar_nota_tecnica_13=false
## CSC
sifen.csc=ABCD0000000000000000000000000000
sifen.csc.id=0001Luego de preparar la configuración, establecer la misma para usarla con las diferentes consultas.
Sifen.setSifenConfig(config);Esto solo debe realizarse una vez al principio, antes de ejecutar alguna acción. Si la configuración necesita ser actualizada, simplemente invocar de vuelta.
El uso del servicio web de Consulta de RUC se puede realizar de la siguiente forma:
RespuestaConsultaRUC respuesta = Sifen.consultaRUC("80089752");El parámetro es el RUC del contribuyente a consultar, sin el DV (Dígito Verificador).
Para ver la estructura de la respuesta a esta consulta, revisar el Manual Técnico de Sifen, cuyo enlace se encuentra al principio de esta sección.
La Nota Técnica Nº 13 establece cambios en los campos de IVA de los documentos electrónicos. Las fechas de implementación de estos campos son las siguientes:
- Ambiente de desarrollo: 21/04/2023
- Ambiente de producción: 21/05/2023
Para esto se agrega una propiedad en el archivo de configuración sifen.habilitar_nota_tecnica_13. Esta propiedad es booleana,
si el valor es verdadero, entonces se agregará el nuevo elemento XML al documento electrónico correspondiente. Lo lógico sería
que este valor luego de la fecha de puesta en producción, sea siempre true.
La Nota Técnica Nº 14 aun no está soportada en esta versión.
Si tenés alguna duda o consulta, o encontraste un comportamiento incorrecto dentro de la librería, no dudes en crear un issue.
Cualquier contribución es siempre bienvenida. Por favor, crear primero un issue para discutir los cambios a ser realizados.
RSHK jsifenlib está licenciada bajo el MIT License. Ver el archivo LICENCIA.md para más detalles.
Algunas empresas que utilizan esta librería en producción para sus implementaciones de SIFEN (*) son:
- Taxare S.A. para su producto TAXit! (2021-05)
- NEXO S.A.E.C.A (2022-03)
- Roshka S.A. (2022-04)
- SIFAMERICA S.A. (2022-11)
- Despachos Aduaneros Cacavelos (2022-11)
- Biggie S.A. (2023-01)
- Banco de la Nación Argentina (2023-01)
- VIDRIO LUZ SRL (2023-01)
- UNION SRL (2023-04)
(*) ¿Querés agregar la tuya? Envianos un email para incluirla.
- Pablo Santa Cruz (github/pablo)
- Martin Zarza (github/martinzarza)
- David Ayala (github/david-ayala)
