Decodificar clave de acceso GET

Valida el formato y el digito verificador de una clave de acceso, y devuelve sus segmentos.

GET /v1/consultas/comprobantes/decodificar/{claveAcceso}

No prueba la autorizacion fiscal. Una clave invalida responde 400 (301). La respuesta es plana.

Parametros#

Parametro	Donde	Regla
`claveAcceso`	ruta	Clave de acceso de 49 digitos

curl -s "https://staging-api.mynexusapi.com/v1/consultas/comprobantes/decodificar/0709202601179212345600110010020000001231234567818" \
  -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/consultas/comprobantes/decodificar/" + claveAcceso);
Console.WriteLine(json);

import os, requests
r = requests.get(
    "https://staging-api.mynexusapi.com/v1/consultas/comprobantes/decodificar/" + clave_acceso,
    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/consultas/comprobantes/decodificar/' + claveAcceso,
  { 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/consultas/comprobantes/decodificar/' . $claveAcceso);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('ECUAFACT_API_KEY')],
]);
$respuesta = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE) . ' ' . $respuesta;
curl_close($ch);

HttpClient cliente = HttpClient.newHttpClient();
HttpRequest peticion = HttpRequest.newBuilder()
    .uri(URI.create("https://staging-api.mynexusapi.com/v1/consultas/comprobantes/decodificar/" + claveAcceso))
    .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
ClaveAccesoDecodificada decodificada = await client.DecodificarClaveAccesoAsync(claveAcceso);
Console.WriteLine(decodificada.Tipo + " " + decodificada.FechaEmision);

from ecuafact import EcuafactClient

# client: cliente EcuafactClient - ver SDK Python
clave = client.decodificar_clave_acceso(clave_acceso)
print(clave.tipo, clave.fecha_emision)

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

// client: cliente EcuafactClient - ver SDK Node.js
const clave = await client.decodificarClaveAcceso(claveAcceso);
console.log(clave.tipo, clave.fechaEmision);

<?php
use Ecuafact\Sdk\EcuafactClient;

// $client: cliente EcuafactClient - ver SDK PHP
$clave = $client->decodificarClaveAcceso($claveAcceso);
echo $clave->tipo . ' ' . $clave->fechaEmision;

import com.ecuafact.sdk.EcuafactClient;

// client: cliente EcuafactClient - ver SDK Java
ClaveAccesoDecodificada clave = client.decodificarClaveAcceso(claveAcceso);
System.out.println(clave.tipo() + " " + clave.fechaEmision());

{
  "entrada": "0709202601176001321000110010010000000010000000119",
  "normalizada": "0709202601176001321000110010010000000010000000119",
  "valido": true, "longitud": 49,
  "fechaEmision": "2026-09-07", "tipo": "Factura", "rucEmisor": "1760013210001", "ambiente": "Produccion",
  "establecimiento": "001", "puntoEmision": "001", "secuencial": "000000123",
  "codigoNumerico": "12345678", "tipoEmision": "1", "tipoEmisionDescripcion": "Normal",
  "digitoVerificador": "9", "mensaje": "Clave de acceso decodificada correctamente."
}

Respuesta#

Campo	Significado
`entrada`	Clave enviada
`normalizada`	Clave sin separadores
`valido`	Si el formato y el digito verificador son validos
`longitud`	Longitud de la clave (49)
`fechaEmision`	Fecha de emision del comprobante
`tipo`	Tipo de comprobante
`rucEmisor`	RUC del emisor
`ambiente`	Ambiente fiscal de la clave
`establecimiento`, `puntoEmision`, `secuencial`	Serie del comprobante
`codigoNumerico`, `digitoVerificador`	Partes de control
`tipoEmision` / `tipoEmisionDescripcion`	Tipo de emision

Estados de este endpoint#

Codigo	HTTP	Cuando ocurre	Que hacer
`200`	200	Clave procesada	Revisa `valido` antes de usarla
`301`	400	Clave invalida	Corrige la clave
`104`	429	Limite de solicitudes	Espera y reintenta
`003` / `004`	502 / 504	Fuente caida o sin respuesta	Reintenta

El catalogo completo esta en Errores.

Esta consulta no consume cupo de documentos.

Siguientes pasos#

Errores