Consultar guía

Retorna el estado y datos de una guía de remisión. El `{id}` es el ID retornado al emitir la guía.

GEThttps://api.facturalo.pe/api/v3/guias/{id}

Estados posibles

EN_PROCESO — La guía fue recibida y está siendo procesada por SUNAT.

ACEPTADA SUNAT aceptó la guía de remisión correctamente.

RECHAZADA — SUNAT rechazó la guía. Revisa sunat.codigo y sunat.mensaje.

OBSERVADA SUNAT aceptó la guía con observaciones. Revisa sunat.notas.

NO_ENVIADA — La guía aún no fue enviada a SUNAT.

Campos del response

Campo	Tipo	Requerido	Descripción
`data`	object	Sí	Datos de la guía.

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

API Request

$ npm install @facturalo-pe/node

import { FacturaloClient } from "@facturalo-pe/node";

const facturalo = new FacturaloClient({ token: process.env.FACTURALO_TOKEN! });

const result = await facturalo.guias.consultar("83ad82a0-680e-11f1-8e35-2d93ac0f2c84");
console.log(result.estado, result.guia);

SDK oficial @facturalo-pe/node · guía en /sdks

Response

Elige un ejemplo de respuesta:

application/json

200OK

{
  "success": true,
  "message": "Guía encontrada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "guia": {
      "id": "8b328c40-673d-11f1-b70c-456216ecc78b",
      "estado": "ACEPTADA",
      "serie": "T001",
      "correlativo": "00000001",
      "tipo": "GUIA_REMISION",
      "fechaEmision": "2026-06-14",
      "tipoTransporte": "PÚBLICO",
      "motivoTraslado": "01",
      "cliente": {
        "tipoDocumento": "6",
        "numeroDocumento": "20100070970",
        "denominacion": "EMPRESA DISTRIBUIDORA SAC",
        "correo": null
      },
      "datosTraslado": {
        "fecha": "2026-06-14",
        "pesoBrutoTotal": 150.5,
        "pesoUnidadMedida": "KGM",
        "numeroBultos": 10,
        "indicadorDeEnvio": null
      },
      "datosTransportista": {
        "tipoDocumento": "6",
        "numeroDocumento": "20415932376",
        "denominacion": "TRANSPORTES RÁPIDOS SAC",
        "numeroMTC": "MTC-123456"
      },
      "puntoPartida": {
        "ubigeo": "150101",
        "direccion": "AV. INDUSTRIAL 123, LIMA"
      },
      "puntoLlegada": {
        "ubigeo": "040101",
        "direccion": "JR. COMERCIO 456, AREQUIPA"
      },
      "items": [
        {
          "codigo": "PROD-001",
          "descripcion": "TELEVISOR LED 55 PULGADAS",
          "unidadMedida": "NIU",
          "cantidad": 5
        }
      ],
      "documentosRelacionados": [
        {
          "tipoDocumento": "01",
          "numeroDocumento": "F001-00000001"
        }
      ]
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Guia de Remision ha sido aceptada.",
      "notas": [],
      "ticket": "DEMO-20260613-043550",
      "nombreArchivo": "20601476551-09-T001-00000001"
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/guias/8b328c40-673d-11f1-b70c-456216ecc78b.pdf",
      "xml": "https://api.facturalo.pe/api/v3/guias/8b328c40-673d-11f1-b70c-456216ecc78b.xml",
      "cdr": "https://api.facturalo.pe/api/v3/guias/8b328c40-673d-11f1-b70c-456216ecc78b.cdr"
    },
    "hash": "MdDtBpTOHVP7B37uwiBvuaCG1H4=",
    "cadenaQr": "20601476551 | 09 | T001 | 00000001 | 14/06/2026 | 20100070970 | MdDtBpTOHVP7B37uwiBvuaCG1H4= |"
  }
}