Skip to main content

​
What is JSIFEN?

JSIFEN is a production-ready Java library that provides a REST API interface for integrating with Paraguay’s SIFEN (Sistema de Facturación Electrónica) electronic invoicing system. Built with Quarkus and following Clean Architecture principles, it simplifies the complex process of generating, signing, and submitting electronic invoices to the Paraguayan tax authority.

Generate Invoices

Create and digitally sign XML invoices compliant with SIFEN standards

Query Documents

Retrieve electronic document information using CDC codes

Validate RUC

Look up and validate taxpayer identification numbers

Monitor Health

Check SIFEN service availability and status

​
Key Features

JSIFEN provides everything you need to integrate with SIFEN:
  • Electronic Invoice Generation - Create and digitally sign XML invoices with automatic CDC (Control Code) generation
  • Document Queries - Retrieve electronic documents by CDC in both XML and JSON formats
  • RUC Validation - Query taxpayer information from the national registry
  • Batch Processing - Handle multiple document queries efficiently
  • Event Management - Cancel events and manage invoice lifecycle
  • Multi-Tenant Support - Configure multiple issuers with independent credentials
  • SIFEN Health Monitoring - Real-time monitoring of production and test environments
  • Clean Architecture - Well-structured codebase following industry best practices

​
Architecture

JSIFEN is built using Clean Architecture principles, which ensures:

Maintainability

Clear separation of concerns makes the codebase easy to understand and modify

Testability

Independent layers enable comprehensive unit and integration testing

Flexibility

Swap implementations without affecting business logic
The project structure follows these layers:
  • Presentation - REST API endpoints that receive HTTP requests
  • Application - Use cases that coordinate business operations
  • Domain - Core business logic and models
  • Infrastructure - External integrations including SOAP clients and XML processing
Learn more about the architecture in our Clean Architecture guide.

​
Use Cases

JSIFEN is ideal for:
  • ERP Systems - Integrate electronic invoicing into existing enterprise resource planning software
  • Point of Sale - Generate compliant invoices from POS systems
  • Accounting Software - Automate tax compliance for accounting applications
  • E-commerce Platforms - Issue electronic invoices for online transactions
  • Tax Compliance Services - Build services that help businesses comply with Paraguayan tax regulations

​
Technology Stack

Quarkus

Modern Java framework optimized for cloud-native applications

Java 21

Latest LTS version with improved performance and features

OpenAPI

Interactive API documentation with Swagger UI, Redoc, and more

SOAP Integration

Robust integration with SIFEN’s SOAP-based web services

​
Getting Started

Ready to integrate with SIFEN? Get started in minutes:

Quickstart

Get up and running with JSIFEN in under 5 minutes

Installation

Step-by-step installation and configuration guide

Configuration

Configure your SIFEN credentials and certificates

API Reference

Explore the complete API documentation

​
Requirements

Before you begin, ensure you have:
  • Java 17 or higher (Java 21 LTS recommended)
  • PKCS12 Certificate - Required for SIFEN authentication
  • SIFEN Credentials - CSC ID and CSC code from SIFEN
  • Available Port - Default port 8000 (configurable)

​
Support and Community

GitHub Repository

View source code, report issues, and contribute

License

MIT License - free for commercial and personal use

​
Next Steps

1

Follow the Quickstart

Get JSIFEN running locally and make your first API callGo to Quickstart →
2

Configure SIFEN

Set up your SIFEN credentials and certificatesConfigure SIFEN →
3

Generate Your First Invoice

Learn how to create and sign electronic invoicesGenerate XML Invoice →

Build docs developers (and LLMs) love

Get started for freeTalk to us