Consultar estado

Estado registrado de un comprobante, para cualquier tipo. Es solo lectura: no consulta a SUNAT.

Autenticación: token Bearer de empresa (cpe:sign).

Consideraciones

• Aplica a todos los tipos: facturas, boletas, notas, resúmenes (RC/RA/RR) y guías (09/31).
• También acepta el entorno declarado en la ruta (/api/pro/demo/cpe/consultar/…). La respuesta incluye entorno, que es el del comprobante: lo emitido en demo sigue diciendo demo aunque la empresa ya esté en producción.
• Para facturas, boletas y notas devuelve el estado registrado y el CDR si ya llegó.
• Trae success, connection y sunat_success — el veredicto está en sunat_success (true/false/null), nunca en el HTTP. Los tres viajan siempre, también en null. Ver Cómo leer la respuesta.
• Si tu empresa está en modo esperar, normalmente no necesitas llamar aquí: el CDR viene en la respuesta del envío. Sigue sirviendo por si SUNAT tardó de más.
• Es solo lectura: no envía ni reenvía nada.
• resuelto: false significa que sigue en camino. Vuelve a consultar en unos segundos.
• Variantes: POST /api/cpe/consultar (con external_id o nombre_archivo en el body) y POST /api/cpe/consultar/external_id.
• Alias de entorno: GET /api/cpe/consultar-demo/{filename}.

Headers

Parámetros de URL

Ejemplo de solicitud

curl -X GET https://api.xmlperu.dev/api/cpe/consultar/20123456789-RC-20260809-1 \
  -H "Authorization: Bearer $TOKEN_EMPRESA" \
  -H "Accept: application/json"

<?php
$token_empresa = 'pega-aqui-tu-token';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.xmlperu.dev/api/cpe/consultar/20123456789-RC-20260809-1');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $token_empresa,
    'Accept: application/json',
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);

const TOKEN_EMPRESA = 'pega-aqui-tu-token';

const res = await fetch('https://api.xmlperu.dev/api/cpe/consultar/20123456789-RC-20260809-1', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${TOKEN_EMPRESA}`,
    Accept: 'application/json',
  },
});

const data = await res.json();

import requests

TOKEN_EMPRESA = "pega-aqui-tu-token"

headers = {
    "Authorization": f"Bearer {TOKEN_EMPRESA}",
    "Accept": "application/json",
}

res = requests.get("https://api.xmlperu.dev/api/cpe/consultar/20123456789-RC-20260809-1", headers=headers)
data = res.json()

Respuesta

{
  "success": true,
  "connection": true,
  "sunat_success": true,
  "llego_a_sunat": true,
  "resuelto": true,
  "estado": 200,
  "state_type_id": "05",
  "code": "0",
  "mensaje": "La Factura numero F001-42, ha sido aceptada",
  "message": "La Factura numero F001-42, ha sido aceptada",
  "external_id": "9c2f1b7e-…",
  "cdr": "UEsDBBQAAA…",
  "time": 0.05
}

{
  "success": true,
  "connection": null,
  "sunat_success": null,
  "llego_a_sunat": null,
  "resuelto": false,
  "estado": "03",
  "state_type_id": "03",
  "mensaje": "Enviado a SUNAT, esperando respuesta.",
  "message": "Enviado a SUNAT, esperando respuesta.",
  "external_id": "9c2f1b7e-…",
  "cdr": null,
  "time": 0.04
}

{
  "success": false,
  "message": "El comprobante no está registrado."
}