Seguimiento de una operacion GET

Devuelve el estado actual de la operacion. id es el idOperacion que devuelve la emision.

GET /v1/operaciones/{id}

Si la operacion no existe responde 404 (codigo 502).

curl -s "https://staging-api.mynexusapi.com/v1/operaciones/3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f" \
  -H "X-Api-Key: $ECUAFACT_API_KEY"
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", apiKey);

string json = await http.GetStringAsync(
    "https://staging-api.mynexusapi.com/v1/operaciones/3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f");
Console.WriteLine(json);
import os, requests

r = requests.get(
    "https://staging-api.mynexusapi.com/v1/operaciones/3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f",
    headers={"X-Api-Key": os.environ["ECUAFACT_API_KEY"]},
    timeout=30)
print(r.status_code, r.text)
const res = await fetch(
  'https://staging-api.mynexusapi.com/v1/operaciones/3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f',
  { headers: { 'X-Api-Key': process.env.ECUAFACT_API_KEY } });
console.log(res.status, await res.text());
<?php
$ch = curl_init('https://staging-api.mynexusapi.com/v1/operaciones/3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('ECUAFACT_API_KEY')],
]);
$respuesta = curl_exec($ch);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $estado . ' ' . $respuesta;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient cliente = HttpClient.newHttpClient();
HttpRequest peticion = HttpRequest.newBuilder()
    .uri(URI.create("https://staging-api.mynexusapi.com/v1/operaciones/3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f"))
    .header("X-Api-Key", System.getenv("ECUAFACT_API_KEY"))
    .GET()
    .build();
HttpResponse<String> respuesta = cliente.send(peticion, HttpResponse.BodyHandlers.ofString());
System.out.println(respuesta.statusCode() + " " + respuesta.body());
using Ecuafact.Sdk;
using Ecuafact.Sdk.Contracts;

// client: cliente EcuafactClient - ver SDK .NET
Operation operacion = await client.GetOperacionAsync(idOperacion);
Console.WriteLine(operacion.Estado);
from ecuafact import EcuafactClient

# client: cliente EcuafactClient - ver SDK Python
operacion = client.get_operacion(id_operacion)
print(operacion.estado)
import { EcuafactClient } from "@ecuafact/sdk";

// client: cliente EcuafactClient - ver SDK Node.js
const operacion = await client.getOperacion(idOperacion);
console.log(operacion.estado);
<?php
use Ecuafact\Sdk\EcuafactClient;

// $client: cliente EcuafactClient - ver SDK PHP
$operacion = $client->getOperacion($idOperacion);
echo $operacion->estado;
import com.ecuafact.sdk.EcuafactClient;

// client: cliente EcuafactClient - ver SDK Java
Operation operacion = client.getOperacion(idOperacion);
System.out.println(operacion.estado());
{
  "datos": {
    "idOperacion": "3f1c8c1e-6f2a-4b7e-9c3d-2a1b0c9d8e7f",
    "uid": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "ambiente": 1,
    "codDoc": "01",
    "estado": "enviado",
    "claveAcceso": "0709202601179212345600110010020000001231234567818",
    "codigoError": null,
    "fechaCreacion": "2026-09-07T15:04:05Z",
    "fechaActualizacion": "2026-09-07T15:04:20Z",
    "estadoAutorizacion": "autorizado",
    "fechaAutorizacion": "2026-09-07T15:04:18Z",
    "fechaConsulta": "2026-09-07T15:05:00Z",
    "codigoErrorConsulta": null
  }
}

ambiente es un codigo numerico (1 pruebas, 2 produccion). estado describe el ciclo de envio; estadoAutorizacion el resultado fiscal:

estado Significado
en_cola Registrada, aun no enviada
enviando En despacho
enviado Enviado para procesamiento fiscal
resultado_desconocido El resultado aun no se confirma
cancelado Operacion cancelada
desconocido Estado no reconocido
estadoAutorizacion Significado
no_disponible Aun sin resultado fiscal
pendiente En procesamiento por el SRI
autorizado Autorizacion confirmada
error Rechazo fiscal
desconocido Estado no reconocido

Un codigo de procesamiento intermedio del SRI no basta para considerar autorizado. El resultado fiscal final tambien llega por webhook.

Siguientes pasos#

No se pudo completar la operacion. Recargar ✕