Consulta GRE Lista

Lista las Guías de Remisión Electrónicas de un periodo, con filtros y agregación automática de páginas.

Consideraciones

Debe indicarse periodo o el rango fecha_desde + fecha_hasta. Agrega automáticamente todas las páginas del rango, hasta un tope de seguridad.
No disponible en los planes gratuito y micro.
Consume 4 consultas de tu plan.

POST https://api.apiconsulta.xmlapi.pe/gre/lista Copiar

Headers

Name	Type	Description
Accept	String	application/json
Content-Type	string	application/json
Authorization	string	Bearer <token>. Genéralo desde tu panel, en `Api Tokens`.

Body

Name	Type	Description
ruc*	string	RUC del emisor (titular de la Clave SOL).
usuario*	string	Usuario SOL.
clave*	string	Clave SOL.
tipo_gre*	string	`09` (remitente) o `31` (transportista).
periodo	string	Mes completo a listar, formato `AAAA-MM`. Alternativa a fecha_desde/fecha_hasta.
fecha_desde	string	Fecha de emisión desde (AAAA-MM-DD). Alternativa a periodo.
fecha_hasta	string	Fecha de emisión hasta (AAAA-MM-DD). Alternativa a periodo.
estado	string	Código de estado SUNAT del comprobante. Vacío devuelve todos los estados.
ruc_receptor	string	Filtra por RUC del receptor de la guía.
serie	string	Filtra por serie de la guía.
numero	integer	Filtra por número de la guía.

Ejemplo de solicitud

Copiar

# https://apiconsulta.xmlapi.pe también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
URL_BASE="https://api.apiconsulta.xmlapi.pe"

curl -X POST "$URL_BASE/gre/lista" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20601234567","usuario":"USUARIO","clave":"CLAVE","tipo_gre":"09","periodo":"2026-07","fecha_desde":"...","fecha_hasta":"...","estado":"...","ruc_receptor":"...","serie":"T001","numero":123}'

Copiar

<?php

// https://apiconsulta.xmlapi.pe también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
$urlBase = 'https://api.apiconsulta.xmlapi.pe';

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $urlBase . '/gre/lista',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'ruc' => '20601234567',
        'usuario' => 'USUARIO',
        'clave' => 'CLAVE',
        'tipo_gre' => '09',
        'periodo' => '2026-07',
        'fecha_desde' => '...',
        'fecha_hasta' => '...',
        'estado' => '...',
        'ruc_receptor' => '...',
        'serie' => 'T001',
        'numero' => 123,
    ]),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

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

echo $response;

Copiar

// https://apiconsulta.xmlapi.pe también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
const URL_BASE = 'https://api.apiconsulta.xmlapi.pe';

const response = await fetch(`${URL_BASE}/gre/lista`, {
  method: 'POST',
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer TU_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    ruc: '20601234567',
    usuario: 'USUARIO',
    clave: 'CLAVE',
    tipo_gre: '09',
    periodo: '2026-07',
    fecha_desde: '...',
    fecha_hasta: '...',
    estado: '...',
    ruc_receptor: '...',
    serie: 'T001',
    numero: 123,
  }),
});

const data = await response.json();
console.log(data);

Copiar

import requests

# https://apiconsulta.xmlapi.pe también funciona (dominio legacy) anteponiendo /api a la ruta — ver Inicio
URL_BASE = 'https://api.apiconsulta.xmlapi.pe'

response = requests.post(
    f'{URL_BASE}/gre/lista',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'ruc': '20601234567',
        'usuario': 'USUARIO',
        'clave': 'CLAVE',
        'tipo_gre': '09',
        'periodo': '2026-07',
        'fecha_desde': '...',
        'fecha_hasta': '...',
        'estado': '...',
        'ruc_receptor': '...',
        'serie': 'T001',
        'numero': 123,
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "data": {
    "items": [
      {
        "ruc_emisor": "20601234567",
        "ruc_receptor": "10067888460",
        "tipo": "09",
        "tipo_desc": "Remitente",
        "serie": "T001",
        "numero": 858,
        "fecha_emision": "2026-07-22 07:36:00",
        "estado": "01",
        "estado_desc": "Emitido",
        "sub_estado": null,
        "sub_estado_desc": null
      }
    ],
    "total": 1
  }
}