Ir al contenido
Facturalo

Guía remitente — transporte privado

Guía de Remisión Remitente (serie T...) para transporte privado (tipoTransporte: '02'). En lugar de datos del transportista, se indican la placa del vehículo y los datos del chofer.

POSThttps://api.facturalo.pe/api/v3/guias/enviar
Para transporte privado: datosTransportista solo requiere numeroPlaca. Los datos del chofer van en datosChofer con DNI, número de licencia, nombres y apellidos. 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 body

Campo
Descripción
webhook
booleanopcional
Si es true, respuesta inmediata (EN_PROCESO) y resultado por webhook. Default: false (síncrono).Ej: false
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.Ej: 2026-06-13
serie
stringrequerido
Serie de la guía (T001–T999).Ej: T001
correlativo
stringrequerido
Número correlativo.Ej: 14
tipoTransporte
stringrequerido
"02" = Transporte privado.Ej: 02
motivoTraslado
stringrequerido
Código de motivo. Ver tabla Motivo de traslado.Ej: 01
observaciones
string | nullopcional
Texto libre que aparece en la guía.
cliente
objectrequerido
Destinatario de la mercadería.
tipoDocumento
stringrequerido
6 = RUC · 1 = DNI.Ej: 6
numeroDocumento
stringrequerido
RUC o DNI del destinatario.Ej: 20100070970
denominacion
stringrequerido
Razón social o nombre.Ej: EMPRESA DISTRIBUIDORA SAC
correo
string | nullopcional
Correo del destinatario.
datosTraslado
objectrequerido
Información del traslado.
fecha
stringrequerido
Fecha de inicio del traslado.Ej: 2026-06-14
pesoBrutoTotal
numberrequerido
Peso bruto total de la carga.Ej: 150.5
pesoUnidadMedida
stringrequerido
"KGM" = kilogramo · "TNE" = tonelada.Ej: KGM
numeroBultos
numberopcional
Número de bultos.Ej: 10
indicadorDeEnvio
stringopcional
"01" = Envío. Requerido si aplica.
datosTransportista
objectrequerido
Para transporte privado solo se requiere la placa del vehículo.
numeroPlaca
stringrequerido
Placa del vehículo: de 6 a 8 letras y números, sin guion ni espacios (regla SUNAT 2567). Facturalo quita guiones y espacios y la pasa a mayúsculas, así que "abc-123" se envía como "ABC123".Ej: ABC123
datosChofer
objectrequerido
Datos del conductor del vehículo.
tipoDocumento
stringrequerido
"1" = DNI.Ej: 1
numeroDocumento
stringrequerido
DNI del chofer.Ej: 45678901
numeroLicencia
stringrequerido
Número de licencia de conducir: de 9 a 10 letras y números (regla SUNAT 2573). Facturalo quita guiones y espacios y la pasa a mayúsculas.Ej: Q45678901
nombres
stringrequerido
Nombres del chofer.Ej: JUAN CARLOS
apellidos
stringrequerido
Apellidos del chofer.Ej: PÉREZ LÓPEZ
puntoPartida
objectrequerido
Dirección de origen de la carga.
ubigeo
stringrequerido
Código ubigeo INEI (6 dígitos).Ej: 150101
direccion
stringrequerido
Dirección completa.Ej: AV. INDUSTRIAL 123, LIMA
puntoLlegada
objectrequerido
Dirección de destino de la carga.
ubigeo
stringrequerido
Código ubigeo INEI (6 dígitos).Ej: 040101
direccion
stringrequerido
Dirección completa.Ej: JR. COMERCIO 456, AREQUIPA
items
arrayrequerido
Bienes transportados. Mínimo 1 ítem.
codigo
string | nullopcional
Código interno del producto.
descripcion
stringrequerido
Descripción del bien.Ej: TELEVISOR LED 55 PULGADAS
unidadMedida
stringrequerido
Código SUNAT: NIU = unidad · KGM = kg · ZZ = servicio.Ej: NIU
cantidad
numberrequerido
Cantidad de unidades.Ej: 5
documentosRelacionados
arrayopcional
Comprobantes de venta asociados al traslado.
tipoDocumento
stringrequerido
"01" = Factura · "03" = Boleta.Ej: 01
numeroDocumento
stringrequerido
Serie y correlativo del comprobante.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-13",
  serie: "T001",
  correlativo: "1",
  tipoTransporte: "02",
  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",
    pesoBrutoTotal: 150.5,
    pesoUnidadMedida: "KGM",
    numeroBultos: 10,
    indicadorDeEnvio: "01"
  },
  datosTransportista: {
    numeroPlaca: "ABC123"
  },
  datosChofer: {
    tipoDocumento: "1",
    numeroDocumento: "45678901",
    numeroLicencia: "Q45678901",
    nombres: "JUAN CARLOS",
    apellidos: "PÉREZ LÓPEZ"
  },
  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= |"
  }
}