Ir al contenido
Facturalo

Guía remitente — transporte público

Emite una Guía de Remisión Remitente (serie T..., tipo 09) para transporte público. Requiere datos de la empresa transportista (RUC) y la fecha de entrega de bienes.

POSThttps://api.facturalo.pe/api/v3/guias/enviar
En demo (token sk_test_) SUNAT no ofrece un ambiente de pruebas para guías: Facturalo valida la guía con las reglas oficiales de SUNAT y responde ACEPTADA o RECHAZADA con el mismo código de error que daría SUNAT en producción. Usa datos con formato real (placa, licencia, ubigeo, código de producto del catálogo 25).

Parámetros del request

Campo
Descripción
webhook
booleanopcional
true = respuesta asíncrona vía webhook (recomendado). false = espera la respuesta de SUNAT en el mismo request (puede tardar varios segundos). Default: false.Ej: true
guia
objectrequerido
Datos de la guía de remisión.
enviarCorreo
booleanopcional
Si es true, envía el PDF y XML al correo del destinatario tras la aceptación. Default: false.Ej: true
fechaEmision
stringrequerido
Fecha de emisión en formato YYYY-MM-DD.Ej: 2026-06-14
serie
stringrequerido
Serie de 4 caracteres. T... = Guía Remitente (tipo 09).Ej: T001
correlativo
stringrequerido
Correlativo numérico.Ej: 128
tipoTransporte
stringrequerido
"01" = Transporte público · "02" = Transporte privado.Ej: 01
motivoTraslado
stringrequerido
"01" = Venta · "02" = Compra · "04" = Traslado entre almacenes · "08" = Importación · "09" = Exportación.Ej: 01
observaciones
string | nullopcional
Observaciones del traslado.Ej: ENTREGA DE MERCADERÍA SEGÚN ORDEN DE COMPRA
cliente
objectrequerido
Datos del destinatario de los bienes.
tipoDocumento
stringrequerido
"6" = RUC · "1" = DNI.Ej: 6
numeroDocumento
stringrequerido
RUC (11 dígitos) o DNI (8 dígitos).Ej: 20100070970
denominacion
stringrequerido
Razón social o nombre.Ej: EMPRESA DISTRIBUIDORA SAC
correo
string | nullopcional
Correo del destinatario.Ej: compras@empresa.com
datosTraslado
objectrequerido
Datos del traslado.
fecha
stringrequerido
Fecha de inicio del traslado. YYYY-MM-DD.Ej: 2026-06-14
fechaEntregaBienes
string | nullopcional
Requerida si tipoTransporte = 01 (público).Ej: 2026-06-14
pesoBrutoTotal
numberrequerido
Peso bruto total de los bienes.Ej: 150.5
pesoUnidadMedida
stringrequerido
"KGM" = kilogramos · "TNE" = toneladas.Ej: KGM
numeroBultos
numberrequerido
Número total de bultos o paletas.Ej: 10
indicadorDeEnvio
string | nullopcional
Indicador de envío.Ej: 01
datosTransportista
objectrequerido
Datos de la empresa transportista. Requiere RUC.
tipoDocumento
stringrequerido
Debe ser "6" (RUC).Ej: 6
numeroDocumento
stringrequerido
RUC del transportista (11 dígitos).Ej: 20415932376
denominacion
stringrequerido
Razón social del transportista.Ej: TRANSPORTES RÁPIDOS SAC
numeroMTC
string | nullopcional
Número de registro MTC del transportista.Ej: MTC-123456
puntoPartida
objectrequerido
Punto de origen del traslado.
ubigeo
stringrequerido
Código INEI de 6 dígitos.Ej: 150101
direccion
stringrequerido
Dirección del punto de partida.Ej: AV. INDUSTRIAL 123, LIMA
puntoLlegada
objectrequerido
Punto de destino del traslado.
ubigeo
stringrequerido
Código INEI de 6 dígitos.Ej: 040101
direccion
stringrequerido
Dirección del punto de llegada.Ej: JR. COMERCIO 456, AREQUIPA
items
arrayrequerido
Bienes trasladados.
codigo
stringrequerido
Código del producto.Ej: PROD-001
descripcion
stringrequerido
Descripción del bien.Ej: TELEVISOR LED 55 PULGADAS
unidadMedida
stringrequerido
Código SUNAT de unidad.Ej: NIU
cantidad
numberrequerido
Cantidad de unidades trasladadas.Ej: 5
documentosRelacionados
array | nullopcional
Comprobantes relacionados al traslado (facturas, boletas, guías).
tipoDocumento
stringrequerido
"01" = Factura · "03" = Boleta · "09" = Guía remitente · "31" = Guía transportista.Ej: 01
numeroDocumento
stringrequerido
Número completo del documento.Ej: F001-00000123

Language

Credentials

Header

Authorization

Ejemplos con el SDK oficial en Node, PHP y Python

Idempotencia

Header

Idempotency-Key

Misma clave + mismo cuerpo = misma respuesta (24 h). Ver /idempotencia.

API Request
$ npm install @facturalo-pe/node
import { FacturaloClient } from "@facturalo-pe/node";

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

const envio = await facturalo.guias.enviar({
  fechaEmision: "2026-06-14",
  serie: "T001",
  correlativo: "1",
  tipoTransporte: "01",
  motivoTraslado: "01",
  observaciones: "ENTREGA DE MERCADERÍA SEGÚN ORDEN DE COMPRA",
  cliente: {
    tipoDocumento: "6",
    numeroDocumento: "20100070970",
    denominacion: "EMPRESA DISTRIBUIDORA SAC",
    correo: "compras@empresa.com"
  },
  datosTraslado: {
    fecha: "2026-06-14",
    fechaEntregaBienes: "2026-06-14",
    pesoBrutoTotal: 150.5,
    pesoUnidadMedida: "KGM",
    numeroBultos: 10,
    indicadorDeEnvio: "01"
  },
  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"
    }
  ]
}, {
  idempotencyKey: "guia-orden-1042"
});
console.log(envio.estado, envio.enlaces?.pdf);
SDK oficial @facturalo-pe/node · guía en /sdks
Response

Elige un ejemplo de respuesta:

application/json
200Aceptada
{
  "success": true,
  "message": "La Guía de Remisión número T001-00000001, ha sido aceptada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "guia": {
      "id": "76198000-6805-11f1-8869-aba1fc00c9df",
      "estado": "ACEPTADA",
      "serie": "T001",
      "correlativo": "00000001",
      "tipo": "GUIA_REMISION"
    },
    "sunat": {
      "estado": "ACEPTADA",
      "codigo": "0",
      "mensaje": "La Guia de Remision ha sido aceptada.",
      "notas": [],
      "ticket": "DEMO-20260614-040795"
    },
    "enlaces": {
      "pdf": "https://api.facturalo.pe/api/v3/guias/76198000-6805-11f1-8869-aba1fc00c9df.pdf",
      "xml": "https://api.facturalo.pe/api/v3/guias/76198000-6805-11f1-8869-aba1fc00c9df.xml",
      "cdr": "https://api.facturalo.pe/api/v3/guias/76198000-6805-11f1-8869-aba1fc00c9df.cdr"
    },
    "hash": "Ed4eCyczP+Zr85qMjkNJYiocyQI=",
    "cadenaQr": "20601476551 | 09 | T001 | 00000001 | 14/06/2026 | 20100070970 | Ed4eCyczP+Zr85qMjkNJYiocyQI= |"
  }
}