Consulta GRE

Detalle de una Guía de Remisión específica. Funciona para cualquier RUC emisor, no solo el propio.

Consideraciones

No disponible en el plan gratuito. Consume 1 consulta de tu plan.

POST https://api.apiperu.dev/gre/consulta 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 que consulta).
usuario*	string	Usuario SOL.
clave*	string	Clave SOL.
tipo_gre*	string	`09` (remitente) o `31` (transportista).
serie*	string	Serie de la guía. Ejemplo: `T001`.
numero*	integer	Número correlativo de la guía.
ruc_emisor	string	RUC del emisor de la guía a consultar, si es distinto al RUC de la sesión (la consulta funciona para cualquier RUC).

Ejemplo de solicitud

Copiar

curl -X POST https://api.apiperu.dev/gre/consulta \
  -H "Accept: application/json" \
  -H "Authorization: Bearer TU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ruc":"20601234567","usuario":"USUARIO","clave":"CLAVE","tipo_gre":"09","serie":"T001","numero":123,"ruc_emisor":"..."}'

Copiar

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.apiperu.dev/gre/consulta',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'ruc' => '20601234567',
        'usuario' => 'USUARIO',
        'clave' => 'CLAVE',
        'tipo_gre' => '09',
        'serie' => 'T001',
        'numero' => 123,
        'ruc_emisor' => '...',
    ]),
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Authorization: Bearer TU_TOKEN',
        'Content-Type: application/json',
    ],
]);

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

echo $response;

Copiar

const response = await fetch('https://api.apiperu.dev/gre/consulta', {
  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',
    serie: 'T001',
    numero: 123,
    ruc_emisor: '...',
  }),
});

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

Copiar

import requests

response = requests.post(
    'https://api.apiperu.dev/gre/consulta',
    headers={
        'Accept': 'application/json',
        'Authorization': 'Bearer TU_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'ruc': '20601234567',
        'usuario': 'USUARIO',
        'clave': 'CLAVE',
        'tipo_gre': '09',
        'serie': 'T001',
        'numero': 123,
        'ruc_emisor': '...',
    },
)

print(response.json())

Respuesta

200 OK application/json

{
  "success": true,
  "data": {
    "tipo_gre": "09",
    "serie": "T001",
    "numero": "123",
    "estado": "ACEPTADO",
    "fecha_emision": "2026-07-20"
  }
}