SDKs

Ademas de llamar la API directamente, puedes usar un cliente oficial que resuelve las tareas repetitivas de la integracion.

Disponibles para .NET, Node.js, Python, Java y PHP.

Que resuelve el SDK#

Coloca la API Key y las cabeceras necesarias en cada peticion.
Genera la Idempotency-Key y la reutiliza en los reintentos.
Reintenta fallos transitorios (timeout, 429 y 5xx) con espera, respetando Retry-After.
Expone los errores como una excepcion con codigo, mensaje y errores.
Verifica la firma de los webhooks entrantes.

Ejemplo#

using Ecuafact.Sdk;

EcuafactClient client = EcuafactClient.Create(new EcuafactClientOptions
{
    BaseAddress = new Uri("https://staging-api.mynexusapi.com/"),
    ApiKey = Environment.GetEnvironmentVariable("ECUAFACT_API_KEY")!,
    Identificacion = "1790012345001"
});

// comprobante: la Estructura del comprobante (ver [Factura](/v1/guias/emision-01)).
EmisionResultado resultado = await client.EmitirAsync(comprobante);
Console.WriteLine(resultado.Admission.IdOperacion);

El resultado trae Admission con idOperacion, codigo, mensaje, urlEstado y uid; y IdempotencyKey con la clave usada.

Que puedes hacer con el SDK#

Accion	Metodo (varia por lenguaje)
Emitir un comprobante	`EmitirAsync` / `emitir` / `emitirEn` / `emitir_en`
Consultar el seguimiento de la operacion	`GetOperacionAsync` / `getOperacion` / `get_operacion`
Obtener el contexto de tu API Key	`GetContextoAsync` / `getContexto` / `get_contexto`
Ver el cupo disponible	`GetConsumoAsync` / `getConsumo` / `get_consumo`
Listar emitidos	`ListarEmitidosAsync`
Consultar datos del SRI	`ConsultarContribuyenteAsync`, `BuscarContribuyentesAsync`, `ListarEstablecimientosAsync`, `ValidarIdentificacionAsync`, `DecodificarClaveAccesoAsync`
Reenviar el correo	`EnviarCorreoAsync` / `enviarCorreo` / `enviar_correo`
Leer un catalogo	`ListarCatalogoAsync` / `listarCatalogo` / `listar_catalogo`
Subir el logo	HTTP o `ActualizarLogoAsync` (.NET)
Verificar un webhook	`WebhookSignature.Verify` (nombre segun lenguaje)
Fijar un contribuyente	`Para` / `para`

Paginas por lenguaje#

Siguientes pasos#

Autenticacion: obten y usa tu API Key.
Emision: emite tu primer comprobante.
Verificacion de firma: valida los webhooks entrantes.