Ir al contenido
Facturalo

Guía de remisión transportista

Emite una Guía de Remisión Transportista (serie V..., tipo 31). El tipo se detecta automáticamente de la serie: V... = transportista. Requiere datos del destinatario, remitente, vehículo y chofer.

POSThttps://api.facturalo.pe/api/v3/guias/enviar
La serie V... activa automáticamente el modo transportista (tipo 31). La serie T... genera una guía remitente (tipo 09). No se necesita ningún campo adicional para diferenciarlos.

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 transportista.
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 V001–V999. La serie V... activa automáticamente el modo transportista (tipo 31).Ej: V001
correlativo
stringrequerido
Número correlativo.Ej: 1
motivoTraslado
stringrequerido
Código de motivo. Ver tabla Motivo de traslado.Ej: 01
observaciones
string | nullopcional
Texto libre que aparece en la guía.
destinatario
objectrequerido
Empresa o persona que recibe 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.
remitente
objectrequerido
Empresa o persona que envía la mercadería.
tipoDocumento
stringrequerido
6 = RUC · 1 = DNI.Ej: 6
numeroDocumento
stringrequerido
RUC o DNI del remitente.Ej: 20601476551
denominacion
stringrequerido
Razón social o nombre.Ej: EMPRESA REMITENTE SAC
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
datosVehiculo
objectrequerido
Datos del vehículo de transporte.
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
NIU = unidad · KGM = kg · ZZ = servicio.Ej: NIU
cantidad
numberrequerido
Cantidad de unidades.Ej: 5
documentosRelacionados
arrayopcional
Guías de remisión remitente asociadas.
tipoDocumento
stringrequerido
"09" = Guía de remisión remitente.Ej: 09
numeroDocumento
stringrequerido
Serie y correlativo de la guía.Ej: T001-00000001

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: "V001",
  correlativo: "1",
  motivoTraslado: "01",
  observaciones: "TRANSPORTE DE MERCADERÍA",
  destinatario: {
    tipoDocumento: "6",
    numeroDocumento: "20100070970",
    denominacion: "EMPRESA DISTRIBUIDORA SAC"
  },
  remitente: {
    tipoDocumento: "6",
    numeroDocumento: "20601476551",
    denominacion: "EMPRESA REMITENTE SAC"
  },
  datosTraslado: {
    fecha: "2026-06-14",
    pesoBrutoTotal: 150.5,
    pesoUnidadMedida: "KGM",
    numeroBultos: 10
  },
  datosVehiculo: {
    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: "09",
      numeroDocumento: "T001-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 Transportista número V001-00000001, ha sido aceptada.",
  "data": {
    "estado": "ACEPTADA",
    "entorno": "demo",
    "guia": {
      "id": "76198000-6805-11f1-8869-aba1fc00c9df",
      "estado": "ACEPTADA",
      "serie": "V001",
      "correlativo": "00000001",
      "tipo": "GUIA_TRANSPORTISTA"
    },
    "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 | 31 | V001 | 00000001 | 14/06/2026 | 20100070970 | Ed4eCyczP+Zr85qMjkNJYiocyQI= |"
  }
}