# roshkadev/rshk-jsifenlib architecture

> Architecture diagram of the GitHub repository roshkadev/rshk-jsifenlib, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roshkadev/rshk-jsifenlib
- Repository: https://github.com/roshkadev/rshk-jsifenlib

## Overview

RSHK jsifenlib is a Java SDK for SIFEN. An application configures the SDK, then calls its public API to submit or query electronic documents, batches, events, or taxpayer RUC data; results are exposed as typed responses. The graph retains these documented service branches and the sampled SOAP/request/response layers. Several request implementations are unsampled, so only relationships supported by the README or SOURCE INDEX are shown; the batch request provides the clearest sampled transport path.

Main entry points: [`src/main/java/com/roshka/sifen/Sifen.java`](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/Sifen.java) (Sifen API), [`src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java`](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java) (Batch reception), [`src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java`](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java) (Electronic document), [`src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java`](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java) (SOAP transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["SDK entry and configuration"]
  node_sifen["Sifen API<br/>[Sifen.java]"]
  node_config["SIFEN configuration<br/>[SifenConfig.java]"]
  node_generation["Generation context<br/>[GenerationCtx.java]"]
end

subgraph group_domain["Document and event models"]
  node_document["Electronic document"]
  node_document_fields["Document fields<br/>[TdDatGralOpe.java]"]
  node_event_fields["Event fields<br/>[TrGeVeTr.java]"]
  node_types["SIFEN value types<br/>[TTiDE.java]"]
end

subgraph group_requests["SIFEN service requests"]
  node_ruc_request["RUC query<br/>[ReqConsRuc.java]"]
  node_document_query["Document query<br/>[ReqConsDe.java]"]
  node_batch_query["Batch status query<br/>[ReqConsLoteDe.java]"]
  node_document_receive["Document reception<br/>[ReqRecDe.java]"]
  node_event_receive["Event reception"]
  node_batch_receive["Batch reception<br/>[ReqRecLoteDe.java]"]
end

subgraph group_transport["SOAP and response processing"]
  node_soap["SOAP transport<br/>[SoapHelper.java]"]
  node_ssl["TLS certificate setup"]
  node_soap_response["SOAP response envelope<br/>[SOAPResponse.java]"]
  node_response_util["Response XML utilities<br/>[ResponseUtil.java]"]
  node_response_factory["Response object mapper"]
  node_base_response["Response base model<br/>[BaseResponse.java]"]
  node_response_ruc["RUC response"]
  node_response_doc["Document response"]
  node_response_batch["Batch response"]
end

node_application(("Java application"))
node_sifen_service{{"SIFEN web services"}}

node_application -->|"calls"| node_sifen
node_application -->|"configures"| node_config
node_sifen -->|"uses"| node_config
node_generation -->|"reads settings"| node_config
node_sifen -->|"creates context"| node_generation
node_sifen -->|"accepts documents"| node_document
node_document -->|"generates with"| node_generation
node_document -->|"uses fields"| node_document_fields
node_document -->|"uses types"| node_types
node_sifen -->|"dispatches query"| node_ruc_request
node_sifen -->|"dispatches query"| node_document_query
node_sifen -->|"dispatches query"| node_batch_query
node_sifen -->|"dispatches reception"| node_document_receive
node_sifen -->|"dispatches events"| node_event_receive
node_sifen -->|"dispatches batch"| node_batch_receive
node_batch_receive -->|"serializes documents"| node_document
node_batch_receive -->|"sends SOAP"| node_soap
node_soap -->|"configures TLS"| node_ssl
node_soap -->|"returns envelope"| node_soap_response
node_soap -->|"posts request"| node_sifen_service
node_batch_receive -->|"maps response"| node_response_factory
node_batch_receive -->|"parses response"| node_response_util
node_response_factory -->|"populates model"| node_base_response
node_base_response -->|"reads XML values"| node_response_util
node_sifen -->|"returns typed result"| node_response_ruc
node_sifen -->|"returns typed result"| node_response_doc
node_sifen -->|"returns typed result"| node_response_batch
node_event_receive -.->|"accepts event data"| node_event_fields

click node_sifen "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/Sifen.java"
click node_config "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/SifenConfig.java"
click node_generation "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/ctx/GenerationCtx.java"
click node_document "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java"
click node_document_fields "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/fields/request/de/TdDatGralOpe.java"
click node_event_fields "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/fields/request/event/TrGeVeTr.java"
click node_types "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/types/TTiDE.java"
click node_ruc_request "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqConsRuc.java"
click node_document_query "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqConsDe.java"
click node_batch_query "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqConsLoteDe.java"
click node_document_receive "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecDe.java"
click node_event_receive "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecEventoDe.java"
click node_batch_receive "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java"
click node_soap "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java"
click node_ssl "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/helpers/SSLContextHelper.java"
click node_soap_response "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/SOAPResponse.java"
click node_response_util "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/util/ResponseUtil.java"
click node_response_factory "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/response/SifenObjectFactory.java"
click node_base_response "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/response/BaseResponse.java"
click node_response_ruc "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaRUC.java"
click node_response_doc "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaDE.java"
click node_response_batch "https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaLoteDE.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_sifen,node_config,node_generation toneBlue
class node_document,node_document_fields,node_event_fields,node_types toneAmber
class node_ruc_request,node_document_query,node_batch_query,node_document_receive,node_event_receive,node_batch_receive toneMint
class node_soap,node_ssl,node_soap_response,node_response_util,node_response_factory,node_base_response,node_response_ruc,node_response_doc,node_response_batch toneRose
class node_application,node_sifen_service toneIndigo
```

## Components

### SDK entry and configuration

- [Sifen API](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/Sifen.java): `src/main/java/com/roshka/sifen/Sifen.java`
- [SIFEN configuration](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/SifenConfig.java): `src/main/java/com/roshka/sifen/core/SifenConfig.java`
- [Generation context](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/ctx/GenerationCtx.java): `src/main/java/com/roshka/sifen/internal/ctx/GenerationCtx.java`

### Document and event models

- [Electronic document](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java): `src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java`
- [Document fields](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/fields/request/de/TdDatGralOpe.java): `src/main/java/com/roshka/sifen/core/fields/request/de/TdDatGralOpe.java`
- [Event fields](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/fields/request/event/TrGeVeTr.java): `src/main/java/com/roshka/sifen/core/fields/request/event/TrGeVeTr.java`
- [SIFEN value types](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/types/TTiDE.java): `src/main/java/com/roshka/sifen/core/types/TTiDE.java`

### SIFEN service requests

- [RUC query](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqConsRuc.java): `src/main/java/com/roshka/sifen/internal/request/ReqConsRuc.java`
- [Document query](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqConsDe.java): `src/main/java/com/roshka/sifen/internal/request/ReqConsDe.java`
- [Batch status query](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqConsLoteDe.java): `src/main/java/com/roshka/sifen/internal/request/ReqConsLoteDe.java`
- [Document reception](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecDe.java): `src/main/java/com/roshka/sifen/internal/request/ReqRecDe.java`
- [Event reception](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecEventoDe.java): `src/main/java/com/roshka/sifen/internal/request/ReqRecEventoDe.java`
- [Batch reception](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java): `src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java`

### SOAP and response processing

- [SOAP transport](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java): `src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java`
- [TLS certificate setup](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/helpers/SSLContextHelper.java): `src/main/java/com/roshka/sifen/internal/helpers/SSLContextHelper.java`
- [SOAP response envelope](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/SOAPResponse.java): `src/main/java/com/roshka/sifen/internal/SOAPResponse.java`
- [Response XML utilities](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/util/ResponseUtil.java): `src/main/java/com/roshka/sifen/internal/util/ResponseUtil.java`
- [Response object mapper](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/response/SifenObjectFactory.java): `src/main/java/com/roshka/sifen/internal/response/SifenObjectFactory.java`
- [Response base model](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/internal/response/BaseResponse.java): `src/main/java/com/roshka/sifen/internal/response/BaseResponse.java`
- [RUC response](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaRUC.java): `src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaRUC.java`
- [Document response](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaDE.java): `src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaDE.java`
- [Batch response](https://github.com/roshkadev/rshk-jsifenlib/blob/master/src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaLoteDE.java): `src/main/java/com/roshka/sifen/core/beans/response/RespuestaConsultaLoteDE.java`

### Other components

- **Java application**
- **SIFEN web services**

## Connections

- Java application → Sifen API: calls (evidence: `README.md`)
- Java application → SIFEN configuration: configures (evidence: `README.md`)
- Sifen API → SIFEN configuration: uses (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Generation context → SIFEN configuration: reads settings (evidence: `src/main/java/com/roshka/sifen/internal/ctx/GenerationCtx.java`)
- Sifen API → Generation context: creates context (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Electronic document: accepts documents (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Electronic document → Generation context: generates with (evidence: `src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java`)
- Electronic document → Document fields: uses fields (evidence: `src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java`)
- Electronic document → SIFEN value types: uses types (evidence: `src/main/java/com/roshka/sifen/core/beans/DocumentoElectronico.java`)
- Sifen API → RUC query: dispatches query (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Document query: dispatches query (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Batch status query: dispatches query (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Document reception: dispatches reception (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Event reception: dispatches events (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Batch reception: dispatches batch (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Batch reception → Electronic document: serializes documents (evidence: `src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java`)
- Batch reception → SOAP transport: sends SOAP (evidence: `src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java`)
- SOAP transport → TLS certificate setup: configures TLS (evidence: `src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java`)
- SOAP transport → SOAP response envelope: returns envelope (evidence: `src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java`)
- SOAP transport → SIFEN web services: posts request (evidence: `src/main/java/com/roshka/sifen/internal/helpers/SoapHelper.java`)
- Batch reception → Response object mapper: maps response (evidence: `src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java`)
- Batch reception → Response XML utilities: parses response (evidence: `src/main/java/com/roshka/sifen/internal/request/ReqRecLoteDe.java`)
- Response object mapper → Response base model: populates model (evidence: `src/main/java/com/roshka/sifen/internal/response/SifenObjectFactory.java`)
- Response base model → Response XML utilities: reads XML values (evidence: `src/main/java/com/roshka/sifen/internal/response/BaseResponse.java`)
- Sifen API → RUC response: returns typed result (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Document response: returns typed result (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Sifen API → Batch response: returns typed result (evidence: `src/main/java/com/roshka/sifen/Sifen.java`)
- Event reception → Event fields: accepts event data
