SDK Kotlin

SDK generado con OpenAPI Generator (KotlinClientCodegen) v7.20.0. Diseñado para reducir el method count, lo que beneficia especialmente a los targets Android.

Maven Central: do.com.ssd.ecfx:ecf-dgii-sdk-kotlinGitHub

Requisitos

  • Kotlin 2.2.20+
  • Gradle 8.14+

Instalación

Agregue la dependencia a su build.gradle.kts:

Gradle (Kotlin DSL):

kotlin
implementation("do.com.ssd.ecfx:ecf-dgii-sdk-kotlin:1.0.0")

Maven:

xml
<dependency>
<groupId>do.com.ssd.ecfx</groupId>
<artifactId>ecf-dgii-sdk-kotlin</artifactId>
<version>1.0.0</version>
</dependency>

Uso rápido

python
import com.ecfx.sdk.EcfClient


val client = EcfClient(
  baseUrl = "https://api.test.ecfx.ssd.com.do",
  apiKey = "tu-api-key"
)


// Enviar ECF con polling automático
val result = client.sendEcf("rnc-empresa", ecfData)


println(result.impresionUrl)
println(result.codSec)
println(result.fechaFirma)

Cliente Frontend

El EcfFrontendClient acepta una función suspend como getToken y usa cache de archivo cifrado por defecto.

python
import com.ecfx.sdk.EcfFrontendClient


val frontend = EcfFrontendClient(
  baseUrl = "https://api.prod.ecfx.ssd.com.do",
  getToken = { fetchTokenFromBackend() }
)


// Consultar estado (solo lectura)
val status = frontend.getEcfStatus("track-id")

Compilar desde fuente

bash
gradle wrapper
./gradlew check assemble

APIs disponibles

El SDK expone las siguientes APIs con operaciones CRUD completas:

  • CompanyApi — Gestión de compañías y certificados
  • EcfApi — Envío y consulta de comprobantes
  • DgiiApi — Consultas directas a la DGII
  • RecepcionApi — Recepción de comprobantes
  • ApiKeyApi — Gestión de API Keys

Modelos: El SDK incluye 80+ clases de modelo autogeneradas que cubren todos los tipos de comprobantes y respuestas de la API.