![](/style/images/good.png)
![](/style/images/bad.png)
Github GitHub - roshkadev/rshk-jsifenlib: Librería de código abierto para intera...
source link: https://github.com/roshkadev/rshk-jsifenlib
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
RSHK jsifenlib
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 lenguaje Java (en sus versiones 1.8 en adelante).
Instalación
Maven
<dependencies> <dependency> <groupId>com.roshka.sifen</groupId> <artifactId>rshk-jsifenlib</artifactId> <version>0.1.8</version> </dependency> </dependencies>
Gradle
repositories { mavenCentral() } dependencies { implementation 'com.roshka.sifen:rshk-jsifenlib:0.1.8' }
Servicios Web de SIFEN
- 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.
Configuración
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:
// 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" ); // 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" );
Luego 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.
Consulta de RUC
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.
Sugerencias
Si tenés alguna duda o consulta, o encontraste un comportamiento incorrecto dentro de la librería, no dudes en crear un issue.
Contribución
Cualquier contribución es siempre bienvenida. Por favor, crear primero un issue para discutir los cambios a ser realizados.
Licencia
RSHK jsifenlib
está licenciada bajo el MIT License. Ver el archivo LICENCIA.md para más detalles.
Empresas usuarias de jsifenlib
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)
(*) ¿Querés agregar la tuya? Envianos un email para incluirla.
Autores y Responsables
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK