Python SDK v1.0.2

Fixes

• Responses that omit null fields (the API's normal serialization, e.g. fileName, codSec, estatus) no longer raise KeyError; those properties are UNSET. In 1.0.1 every send_ecfXX failed to parse the API's 200 response.

Python SDK v1.0.1

Fixes

• 1.0.0 could not be imported: the ecf_dgii.generated.api.ecf package was missing from the wheel.
• send_ecfXX_and_poll now stops on the real progress states (Finished / Error), polls by messageId and raises EcfProcessingError on Error.
• Network and timeout failures raise EcfConnectionError; HTTP 429 raises EcfRateLimitError; non-JSON error pages raise the typed status error.
• README examples updated to the real API.

iOS/Swift SDK v1.0.0

iOS/Swift SDK v1.0.0

Regenerated SDK from updated OpenAPI spec

BREAKING CHANGES

• The unified ECF model is replaced with per-eCF-type models (Ecf31ECF, ..., Ecf47ECF).
• EcfClient.sendEcf(_:) now takes a typed Swift overload — one per e-CF type — that routes to the correct EcfAPI.recepcionEcfNN(...) and polls until completion.
• New AprobacionComercialAPI. Aprobación Comercial moved to POST /recepcion/{messageId}/acecf.
• /recepcion/... path renames flow through to RecepcionAPI (search/get reception requests now keyed by messageId).
• EcfFrontendClient.swift switched its withAuth/public methods from throws(ErrorResponse) to plain throws (typed throws across closure boundaries failed to type-check under Swift 6).

Install (SwiftPM)

.package(url: "https://github.com/SSD-Smart-Software-Development-SRL/ecf_dgii.git", from: "1.0.0")

React Hooks SDK v1.0.0

React Hooks SDK v1.0.0

Regenerated types from updated OpenAPI spec

BREAKING CHANGES

• The unified ECF schema is replaced with per-eCF-type schemas (Ecf31ECF, ..., Ecf47ECF) — typed paths/bodies flow through the regenerated paths/components.
• Endpoint renames: /recepcion/ecf → /recepcion, /recepcion/{rnc}/ecf → /recepcion/{rnc}, /recepcion/{rnc}/ecf/{messageId} → /recepcion/{rnc}/{messageId}.
• Aprobación Comercial moved to POST /recepcion/{messageId}/acecf.
• /recepcion/{rnc}/acecf* removed (use unscoped /recepcion/acecf and /recepcion/acecf/{messageId}).

Install

pnpm add @ssddo/ecf-react@1.0.0

Python SDK v1.0.0

Python SDK v1.0.0

Regenerated SDK from updated OpenAPI spec

BREAKING CHANGES

• The unified ECF schema is replaced with per-eCF-type schemas (Ecf31ECF, ..., Ecf47ECF).
• EcfClient.send_ecf(ecf, ecf_type) removed. Use the per-type methods: send_ecf31, send_ecf32, ..., send_ecf47 (each with an _and_poll variant).
• aprobacion_comercial(rnc, body) → send_aprobacion_comercial(message_id, body). Endpoint moved to POST /recepcion/{messageId}/acecf.
• ACECF list/get re-keyed to messageId only; search_acecf_reception_requests_by_rnc removed.
• get_ecf_reception_request(rnc, message_id) → get_ecf_reception_request(message_id). Use the new get_ecf_receptor_by_message_id for /recepcion/{rnc}/{messageId}.
• Renamed types: FirmarSemillaRequest → FirmarSemillaBody, AllTipoECFTypesType1 → AllTipoECFTypes. Added EcfReceptorDto.

Install

pip install ecf-dgii==1.0.0

TypeScript SDK v1.0.0

Regenerated from updated OpenAPI spec. See main branch CHANGELOG. Breaking: per-eCF-type schemas, /recepcion endpoint renames, aprobacionComercial moved to /recepcion/{messageId}/acecf.

Java + Kotlin SDKs v2.0.0

Java + Kotlin SDKs v2.0.0

Both SDKs regenerated from the updated OpenAPI spec. Bumped to 2.0.0 because 1.0.0 is already on Maven Central.

Coordinates

• Java: do.com.ssd.ecfx:ecf-dgii-sdk-java:2.0.0
• Kotlin: do.com.ssd.ecfx:ecf-dgii-sdk-kotlin:2.0.0

BREAKING CHANGES

• The unified ECF model is replaced with per-eCF-type models (Ecf31ECF, ..., Ecf47ECF).
• EcfClient.sendEcf(ECF, ...) removed. Use the typed overloads — one per e-CF type — sendEcf(Ecf31ECF) ... sendEcf(Ecf47ECF).
• New AprobacionComercialApi. Aprobación Comercial moved to POST /recepcion/{messageId}/acecf.
• /recepcion/... path renames flow through to the regenerated apis (search/get reception requests now keyed by messageId).
• searchEcfs/searchAllEcfs accept new optional progresses and dgiiEstados filters before page/limit (Java only — breaking signature change).

Install

Java (Maven):

<dependency>
  <groupId>do.com.ssd.ecfx</groupId>
  <artifactId>ecf-dgii-sdk-java</artifactId>
  <version>2.0.0</version>
</dependency>

Kotlin (Gradle):

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

.NET SDK v4.0.0

.NET SDK v4.0.0

Regenerated client from updated OpenAPI spec

BREAKING CHANGES

• Removed unified ECF model. Replaced with per-eCF-type schemas: Ecf31ECF, Ecf32ECF, Ecf33ECF, Ecf34ECF, Ecf41ECF, Ecf43ECF, Ecf44ECF, Ecf45ECF, Ecf46ECF, Ecf47ECF. Each has its own typed Encabezado, IdDoc, Emisor, Comprador, etc.
• EcfClient.SendEcfAsync(ECF, ...) removed. Use the typed overloads — one per e-CF type — which dispatch to the correct endpoint based on the C# type:

  await client.SendEcfAsync(new Ecf31ECF { ... });
  await client.SendEcfAsync(new Ecf32ECF { ... });

• Some recepcion request builders restructured (e.g. Aprobacioncomercial removed, WithMessageItem paths consolidated).

Install

dotnet add package SSDDO.ECF_DGII.SDK --version 4.0.0

.NET SDK v3.1.1

.NET SDK v3.1.1

Changes

• Add netstandard2.0 and netstandard2.1 targets — broadens reach to .NET Framework 4.6.1+, Mono, Xamarin, Unity, while keeping existing net5–net9 TFMs.
• Remove unused Microsoft.Kiota.Authentication.Azure dependency. Bearer auth now relies solely on BaseBearerTokenAuthenticationProvider from Microsoft.Kiota.Bundle.

Install

dotnet add package SSDDO.ECF_DGII.SDK --version 3.1.1

React SDK v0.3.0

Novedades

• Token management automático: createEcfFrontendReactClient ahora acepta getToken/cacheToken callbacks
• Cache en localStorage por defecto, retry automático en 401
• Diagrama de arquitectura y flujo detallado en README

Instalación

npm install @ssddo/ecf-react@0.3.0 @tanstack/react-query