Comprobantes emitidos GET

Devuelve los comprobantes emitidos por el contribuyente, paginados.

GET /v1/contribuyentes/{identificacion}/comprobantes/emitidos

Parametros#

Parametro Regla
desde, hasta yyyy-MM-dd. Rango maximo 366 dias. Sin fechas: ultimos 30 dias
codDoc Filtra por tipo (01, 03, 04, 05, 06, 07)
buscar Hasta 100 caracteres
pagina 1 a 10000
tamanoPagina 1 a 100

Fuera de esos limites la API responde 400 (codigo 303).

curl -s "https://staging-api.mynexusapi.com/v1/contribuyentes/0123456789/comprobantes/emitidos?desde=2026-01-01&hasta=2026-01-31&pagina=1&tamanoPagina=20" \
  -H "X-Api-Key: $ECUAFACT_API_KEY"
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("X-Api-Key", apiKey);

string url = "https://staging-api.mynexusapi.com/v1/contribuyentes/0123456789/comprobantes/emitidos"
    + "?desde=2026-01-01&hasta=2026-01-31&pagina=1&tamanoPagina=20";
string json = await http.GetStringAsync(url);
Console.WriteLine(json);
import os, requests

params = {"desde": "2026-01-01", "hasta": "2026-01-31", "pagina": 1, "tamanoPagina": 20}
r = requests.get(
    "https://staging-api.mynexusapi.com/v1/contribuyentes/0123456789/comprobantes/emitidos",
    headers={"X-Api-Key": os.environ["ECUAFACT_API_KEY"]},
    params=params, timeout=30)
print(r.status_code, r.text)
const url = new URL('https://staging-api.mynexusapi.com/v1/contribuyentes/0123456789/comprobantes/emitidos');
url.search = new URLSearchParams({ desde: '2026-01-01', hasta: '2026-01-31', pagina: '1', tamanoPagina: '20' });

const res = await fetch(url, { headers: { 'X-Api-Key': process.env.ECUAFACT_API_KEY } });
console.log(res.status, await res.text());
<?php
$url = 'https://staging-api.mynexusapi.com/v1/contribuyentes/0123456789/comprobantes/emitidos'
     . '?desde=2026-01-01&hasta=2026-01-31&pagina=1&tamanoPagina=20';
$ch = curl_init($url);
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/contribuyentes/0123456789/comprobantes/emitidos"
        + "?desde=2026-01-01&hasta=2026-01-31&pagina=1&tamanoPagina=20"))
    .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
PaginaComprobantes pagina = await client.ListarEmitidosAsync(new ListadoRequest
{
    Desde = new DateTime(2026, 1, 1),
    Hasta = new DateTime(2026, 1, 31),
    Pagina = 1,
    TamanoPagina = 20
});
Console.WriteLine(pagina.HayMas);
from ecuafact import EcuafactClient, ListadoRequest

# client: cliente EcuafactClient - ver SDK Python
pagina = client.listar_emitidos(ListadoRequest(desde="2026-01-01", hasta="2026-01-31", pagina=1, tamano_pagina=20))
print(pagina.hay_mas)
import { EcuafactClient } from "@ecuafact/sdk";

// client: cliente EcuafactClient - ver SDK Node.js
const pagina = await client.listarEmitidos({ desde: '2026-01-01', hasta: '2026-01-31', pagina: 1, tamanoPagina: 20 });
console.log(pagina.hayMas);
<?php
use Ecuafact\Sdk\EcuafactClient;
use Ecuafact\Sdk\ListadoRequest;

// $client: cliente EcuafactClient - ver SDK PHP
$pagina = $client->listarEmitidos(
    (new ListadoRequest())->desde('2026-01-01')->hasta('2026-01-31')->pagina(1)->tamanoPagina(20)
);
echo $pagina->hayMas ? 'true' : 'false';
import com.ecuafact.sdk.EcuafactClient;
import com.ecuafact.sdk.ListadoRequest;

// client: cliente EcuafactClient - ver SDK Java
PaginaComprobantes pagina = client.listarEmitidos(
    new ListadoRequest().desde("2026-01-01").hasta("2026-01-31").pagina(1).tamanoPagina(20));
System.out.println(pagina.hayMas());
{
  "datos": {
    "comprobantes": [
      {
        "claveAcceso": "0709202601179212345600110010020000001231234567818",
        "numeroDocumento": "002-001-000000123",
        "codDoc": "01",
        "fechaEmision": "07/09/2026",
        "identificacionContraparte": "0123456789",
        "razonSocialContraparte": "CONTRIBUYENTE DE EJEMPLO",
        "total": 115.00,
        "estadoAutorizacion": "autorizado",
        "fechaAutorizacion": "2026-09-07T10:35:12-05:00",
        "codigoError": null
      }
    ],
    "pagina": 1,
    "tamanoPagina": 20,
    "hayMas": false
  }
}

Respuesta#

Campo Significado
claveAcceso Clave de acceso del comprobante (49 digitos)
numeroDocumento Numero en formato estab-ptoEmi-secuencial
codDoc Tipo de comprobante
fechaEmision Fecha de emision (dd/MM/yyyy)
identificacionContraparte Identificacion del receptor
razonSocialContraparte Nombre o razon social del receptor
total Importe total
estadoAutorizacion Resultado del SRI (autorizado, pendiente, error, etc.)
fechaAutorizacion Fecha de autorizacion (si aplica)
codigoError Codigo de error (si el comprobante fallo)
pagina Pagina actual
tamanoPagina Filas por pagina
hayMas true si quedan mas resultados

fechaEmision es la fecha del comprobante. Una pagina puede quedar vacia con hayMas=true; en ese caso, pide la siguiente pagina.

Estados de este endpoint#

Codigo HTTP Cuando ocurre Que hacer
200 200 Consulta exitosa Lee comprobantes y hayMas
303 400 Filtros fuera de rango (desde/hasta, pagina, tamanoPagina, buscar) Ajusta los filtros
103 403 Contribuyente o servicio de emitidos no habilitado Habilita el contribuyente
101 401 API Key invalida Revisa la API Key

El catalogo completo esta en Errores.

Siguientes pasos#

No se pudo completar la operacion. Recargar ✕