xprl-efactura 💸

Clases útiles por la creación y publicación por XML de comprobantes electrónicos por los servicios SRI en Ecuador. Implementado en kotlin y empaquetado en una libraría Jar por Java 11+.

Con apoyo por las siguientes esquemas:

• Factura v1.0.0
• Factura v1.1.0
• NotaCrédito v1.0.0
• NotaCrédito v1.1.0
• NotaDébito v1.0.0
• LiquidaciónCompra v1.0.0
• LiquidaciónCompra v1.1.0
• GuíaRemisión v1.0.0
• GuíaRemisión v1.1.0
• ComprobanteRetención v1.0.0
• ComprobanteRetención v2.0.0

TODO:

Facturas por esquemas v2.0.0 o v2.1.0

Construir la libraría xprl-efactura 🛠️

Prerequisites:

• JDK >= Java 11

Dependencias Principales:

• uk.co.xprl.efactura:sri-efactura-core v0.1.2 - ver repositorio sri-efactura-core.

Steps:

1. Clone el repositorio y compílelo usando el script contenedor gradlew:

$ git clone https://github.com/xprl-gjf/xprl-efactura.git \
    && cd xprl-efactura
$ ./gradlew clean build

2. Si lo desea, publique la biblioteca en un repositorio local de Maven:

$ ./gradlew publishToMavenLocal

Este paso no es necesario si quiere usar la versión ya publicada en GitHub Packages.

Para usar la libraría xprl-efactura 🧩

Inclúyalo en su proyecto por Gradle en la manera siguiente:

// build.gradle.kts:

repositories {
    // Elija una de los siguientes opciones:
    // Opción 1: [MavenCentral](https://repo1.maven.org/maven2/uk/co/xprl/efactura/xprl-efactura
    mavenCentral()
    
    // Opción 2: Maven local cache
    mavenLocal {
        // if using mavenLocal, it is good practice to restrict it to only specific libs/groups
        content {
            includeGroup("uk.co.xprl.efactura")
        }
    }
}

dependencies {
    implementation("uk.co.xprl.efactura:xprl-efactura:0.3.1")
    // ...
}

Ejemplo de uso:

import uk.co.xprl.efactura.*
import uk.co.xprl.efactura.builders.InvalidBuilderOperation
import uk.co.xprl.efactura.jaxb.ComprobanteFirmaException
import uk.co.xprl.efactura.jaxb.ComprobanteFirmador
import uk.co.xprl.efactura.jaxb.JaxbComprobantePublisher
import uk.co.xprl.efactura.jaxb.JaxbValidationException
import java.io.File

fun main(args: Array<String>) {
    val firmaPath = args[0]
    val firmaContrasena = args[1]
    val firmador = ComprobanteFirmador(
        File(firmaPath).readBytes(), firmaContrasena
    )
    
    val factura: Factura = createFactura()
    val published: PublishedComprobante<Factura> = publishComprobante(
        factura, SchemaVersion.FacturaV110, firmador
    )
    println(published.xml)
}

@Throws(IllegalArgumentException::class, NumberFormatException::class, InvalidBuilderOperation::class)
private fun createFactura(): Factura {
    return FacturaBuilder()
        .setSecuencial(SecuencialValue.from(1))
        .setFechaEmision(Clock.System.now().toLocalDateTime(TimeZone.currentSystemDefault()).date)
        .setEmisor(EmisorBuilder()
            .setRUC(IdentityValue.RUC.from("9999999999001"))
            .setRazonSocial(TextValue.from("ACME Widgets Cia"))
        )
        //...
        .build()
}

@Throws(JaxbValidationException::class, ComprobranteFirmaException::class)
private fun <T: ComprobanteElectronico> publishComprobante(
    comprobante: T,
    schemaVersion: SchemaVersion<T>,
    firmador: ComprobanteFirmador? = null,
    ambiente: Ambiente = Ambiente.PRUEBAS
): PublishedComprobante<T> {
    val publisher = JaxbComprobantePublisher<T>(ambiente, validationEnabled=true)
    val published = publisher.publish(comprobante, schemaVersion)
    return firmador?.let { it.firmarComprobante(published) } ?: published
}