/ Transporte

Guía de transportista

Emite la guía de remisión transportista (tipo 31) cuando eres la empresa que traslada la carga.

GRR o GRT

La guía de remisión transportista (GRT) la emite la empresa de transporte que traslada la mercadería por encargo de un remitente. Disponible desde el plan Negocio.

Situación	Documento
Envías tus propios bienes en vehículo propio	GRR (tipo 09)
Envías bienes contratando un transportista público	GRR con datos del transportista
Eres la empresa de transporte y recibes carga	GRT (tipo 31)
Subcontratas a otra empresa para el traslado	GRT con subcontratador

Crear guía transportista

POST/guias-remision-transportista

El emisor es tu empresa. La serie sigue el formato V más tres caracteres (por ejemplo V001) y debe estar registrada como serie de tipo guia_transportista.

Campos obligatorios

seriestringObligatorio: Formato V[A-Z0-9]{3}.
fecha_emisiondateObligatorio: yyyy-mm-dd.
remitenteobjectObligatorio: Quien envía la carga (tipo_doc, num_doc, razon_social). No puede ser tu propia empresa.
destinatarioobjectObligatorio: Quien recibe la carga.
doc_relacionadoobjectObligatorio: Comprobante que sustenta el traslado: tipo_codigo, numero, tipo_descripcion, ruc_emisor.
cod_trasladostringObligatorio: Motivo (catálogo 20).
mod_trasladostringObligatorio: 01 público o 02 privado.
fecha_trasladodateObligatorio: Igual o posterior a fecha_emision.
peso_totalnumberObligatorio: Con und_peso_total: KGM o TNE.
partida_ubigeo / partida_direccionstringObligatorio: Punto de partida.
llegada_ubigeo / llegada_direccionstringObligatorio: Punto de llegada.
vehiculo.placastringObligatorio: 6 a 8 caracteres alfanuméricos.
conductorobjectObligatorio: Conductor principal con licencia.
itemsarrayObligatorio: Al menos un ítem.
datos_subcontratadorobject: Si subcontratas: num_doc y razon_social.
datos_pagador_fleteobject: Quién paga el flete: { "tipo": "remitente" }.

curl -X POST "https://apifact.gavi-cloud.com/api/v1/guias-remision-transportista" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "V001",
    "fecha_emision": "2026-10-02",
    "remitente": {
      "tipo_doc": "6",
      "num_doc": "20555666777",
      "razon_social": "DISTRIBUIDORA EL SOL SAC"
    },
    "destinatario": {
      "tipo_doc": "6",
      "num_doc": "20123456789",
      "razon_social": "COMERCIAL AREQUIPA SAC"
    },
    "doc_relacionado": {
      "tipo_codigo": "01",
      "numero": "F001-100",
      "tipo_descripcion": "FACTURA",
      "ruc_emisor": "20555666777"
    },
    "cod_traslado": "01",
    "mod_traslado": "01",
    "fecha_traslado": "2026-10-03",
    "peso_total": 150.5,
    "und_peso_total": "KGM",
    "num_bultos": 5,
    "partida_ubigeo": "150101",
    "partida_direccion": "AV. PROCERES 100 - LIMA",
    "llegada_ubigeo": "040101",
    "llegada_direccion": "AV. EJERCITO 500 - AREQUIPA",
    "vehiculo": {
      "placa": "ABC123",
      "nro_circulacion": "TUC1234567890"
    },
    "conductor": {
      "tipo_doc": "1",
      "num_doc": "45678901",
      "tipo": "Principal",
      "nombres": "JUAN CARLOS",
      "apellidos": "PEREZ LOPEZ",
      "licencia": "Q45678901"
    },
    "items": [
      {
        "descripcion": "MERCADERIA VARIA SEGUN FACTURA F001-100",
        "cantidad": 5,
        "unidad": "NIU",
        "codigo": "REF-001"
      }
    ]
  }'

Respuesta201 Created

{
  "estado": "exito",
  "mensaje": "Guía de Remisión Transportista creada y encolada para envío a SUNAT.",
  "datos": {
    "numero_completo": "V001-000001",
    "tipo_documento": "31",
    "sunat_status": "enviado",
    "ticket": "20261002000000001"
  }
}

Consultar y descargar

Las guías transportista se consultan, descargan y reenvían con los mismos endpoints de guías de remisión: GET /guias-remision/{id}, /estado, /xml y /pdf.