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.