Consumo y cuotas GET

Devuelve el cupo efectivo disponible, sumando el plan y los paquetes de documentos comprados. Coincide con lo que muestra el portal.

GET /v1/consumo

curl -s "https://staging-api.mynexusapi.com/v1/consumo" \
  -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/consumo");
Console.WriteLine(json);

import os, requests

r = requests.get(
    "https://staging-api.mynexusapi.com/v1/consumo",
    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/consumo', {
  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/consumo');
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/consumo"))
    .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
QuotaBucket cupo = await client.GetConsumoAsync("pruebas");
Console.WriteLine($"{cupo.Disponibles}/{cupo.LimiteDocumentos}");

from ecuafact import EcuafactClient

# client: cliente EcuafactClient - ver SDK Python
cupo = client.get_consumo()
print(cupo.disponibles, cupo.limite_documentos)

import { EcuafactClient } from "@ecuafact/sdk";

// client: cliente EcuafactClient - ver SDK Node.js
const cupo = await client.getConsumo();
console.log(cupo.disponibles, cupo.limiteDocumentos);

<?php
use Ecuafact\Sdk\EcuafactClient;

// $client: cliente EcuafactClient - ver SDK PHP
$cupo = $client->getConsumo();
echo $cupo->disponibles . '/' . $cupo->limiteDocumentos;

import com.ecuafact.sdk.EcuafactClient;

// client: cliente EcuafactClient - ver SDK Java
QuotaBucket cupo = client.getConsumo();
System.out.println(cupo.disponibles() + "/" + cupo.limiteDocumentos());

{
  "limiteDocumentos": 1500,
  "reservados": 14,
  "consumidos": 0,
  "disponibles": 1486,
  "vigenteHasta": "2027-01-01",
  "limiteExtra": 100,
  "reservadosExtra": 0,
  "consumidosExtra": 0,
  "disponiblesExtra": 100
}

Campo	Significado
`limiteDocumentos`	Cupo total disponible (plan + paquetes)
`reservados`	Documentos recibidos y aun no resueltos
`consumidos`	Documentos resueltos (autorizados o rechazados)
`disponibles`	Cupo utilizable
`vigenteHasta`	Vigencia del plan; sin plan se informa `9999-12-31`
`*Extra`	Desglose del paquete adicional

Reglas de cupo:

El cupo se descuenta al resolverse la operacion, sea autorizada o rechazada.
Un documento por comprobante: los reintentos no descuentan de nuevo.
Solo las operaciones que aun no se enviaron liberan el cupo.
Sin cupo disponible, la emision responde 429 (codigo 501).

Siguientes pasos#

Limite de request