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/guia/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

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.Ej: ABC-123

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.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

Request bodyjson

{
  "webhook": false,
  "guia": {
    "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": "ABC-123"
    },
    "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"
      }
    ]
  }
}

200 — webhook: false (ACEPTADA)json

{
  "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",
      "fechaEmision": "2026-06-14",
      "tipoTransporte": "PÚBLICO",
      "motivoTraslado": "01",
      "cliente": {
        "tipoDocumento": "6",
        "numeroDocumento": "20100070970",
        "denominacion": "EMPRESA DISTRIBUIDORA SAC"
      },
      "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": []
    },
    "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= |",
    "codigoBarras": "20601476551 | 09 | T001 | 00000001 | 14/06/2026 | 20100070970 | Ed4eCyczP+Zr85qMjkNJYiocyQI= |"
  }
}

200 — webhook: true (EN_PROCESO)json

{
  "success": true,
  "message": "La Guía de Remisión T001-00000001 está siendo procesada. Recibirá una notificación en su webhook cuando SUNAT responda.",
  "data": {
    "entorno": "demo",
    "guia": {
      "id": "46ed7c66-2de8-450d-8a25-9fb2e9e09c41",
      "estado": "EN_PROCESO",
      "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"
      },
      "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": []
    },
    "enlaces": {
      "consulta": "https://api.facturalo.pe/api/v3/guias/46ed7c66-2de8-450d-8a25-9fb2e9e09c41"
    }
  }
}

422 — Error de validaciónjson

{
  "success": false,
  "message": "Los datos enviados no son válidos.",
  "errors": {
    "documento.cliente.numeroDocumento": [
      "El número de documento debe tener 11 dígitos para tipo RUC."
    ],
    "documento.items": [
      "El campo items es requerido."
    ]
  }
}

200 — Rechazada por SUNATjson

{
  "success": false,
  "message": "El documento fue rechazado por SUNAT.",
  "data": {
    "estado": "RECHAZADA",
    "entorno": "demo",
    "documento": {
      "id": "9c948140-674e-11f1-85b5-d764057e10c4",
      "serie": "F001",
      "correlativo": "1",
      "tipo": "FACTURA"
    },
    "sunat": {
      "codigo": "2800",
      "mensaje": "El número de RUC del emisor no existe.",
      "notas": []
    }
  }
}