Guía de remisión

Guía de remisión remitente electrónica (GRE).

Para emitir guías, el RUC necesita las credenciales de la API de guías de SUNAT (greClientId y greClientSecret) además del usuario SOL y el certificado. Ver Emisores.

Transporte privado

bash

curl https://api.apisunat.net/api/v1/issuer/guides \
  -H "X-API-Key: $APISUNAT_KEY" \
  -H "Idempotency-Key: guia-000310" \
  -H "Content-Type: application/json" \
  -d '{
    "issueDate": "2026-10-27",
    "transferDate": "2026-10-28",
    "motiveCode": "01",
    "transportMode": "02",
    "customer": { "documentType": "6", "documentNumber": "20100066603", "name": "CLIENTE S.A.C." },
    "startAddress": "Av. Argentina 1520, Lima",
    "startUbigeo": "150101",
    "arrivalAddress": "Av. Larco 123, Miraflores",
    "arrivalUbigeo": "150122",
    "vehiclePlate": "ABC123",
    "driverName": "JUAN CARLOS",
    "driverLastName": "PÉREZ GARCÍA",
    "driverDocument": "12345678",
    "driverLicense": "Q12345678",
    "weightKg": 25,
    "packages": 2,
    "items": [
      { "code": "POLO-M", "description": "Polo talla M", "quantity": 20, "unitCode": "NIU" }
    ]
  }'

Responde 202 con un documento de tipo 09. Consúltalo después con GET /guides/{id}.

Transporte público

Con transportMode: "01" envía los datos del transportista en lugar del conductor:

json

{
  "transportMode": "01",
  "carrierRuc": "20555555551",
  "carrierName": "TRANSPORTES RÁPIDOS S.A.C.",
  "carrierMtcNumber": "MTC-123456"
}

Reglas que valida la API

Serie que empieza con T, ubigeos de 6 dígitos y peso bruto (weightKg) mayor que 0.
Transporte privado: placa de 6 a 8 caracteres, conductor con documento, nombres, apellidos y licencia de 9 o 10 caracteres. Con vehículos M1 o L (vehicleCategoryM1) no se informan placa ni conductor.
Transporte público: RUC y razón social del transportista. No se informan placa ni conductor.
transferDate no puede ser anterior a issueDate.
Motivo 04: códigos de establecimiento SUNAT de partida (startEstablishmentCode, por defecto 0000) y llegada (arrivalEstablishmentCode).

Motivos de traslado

Código	Motivo
`01`	Venta
`02`	Compra
`04`	Traslado entre establecimientos de la misma empresa
`06`	Devolución
`13`	Otros (requiere `motiveDescription`)

Campos

Campo	Obligatorio	Descripción
`issueDate`	Sí	Fecha de emisión.
`motiveCode`	Sí	Motivo de traslado.
`transportMode`	Sí	`01` público, `02` privado.
`customer`	Sí	Destinatario.
`startAddress`, `startUbigeo`	Sí	Punto de partida.
`arrivalAddress`, `arrivalUbigeo`	Sí	Punto de llegada.
`items`	Sí	Bienes: `description`, `quantity`, `unitCode` y `code`.
`transferDate`	No	Fecha de inicio del traslado. Por defecto, la de emisión.
`weightKg`, `packages`	No	Peso bruto total y número de bultos.
`vehiclePlate`, `driverName`, `driverLastName`, `driverDocument`, `driverDocumentType`, `driverLicense`	No	Vehículo y conductor principal (transporte privado). Si no envías `driverLastName`, se toman los apellidos de `driverName`.
`startEstablishmentCode`, `arrivalEstablishmentCode`	No	Establecimientos SUNAT de partida y llegada (motivo 04).
`carrierRuc`, `carrierName`, `carrierMtcNumber`	No	Transportista (transporte público).
`secondaryDrivers`, `secondaryVehicles`, `secondaryVehiclePlates`	No	Hasta 2 conductores y vehículos adicionales.
`remitter`, `consignee`	No	Remitente y destinatario cuando son distintos del emisor o del cliente.
`relatedDocument`, `relatedDocuments`, `affectedDocument`	No	Documentos relacionados con el traslado.
`transshipmentIndicator`, `portCode`, `containerNumber`	No	Transbordo, puerto y contenedor.
`vehicleCategoryM1`	No	Vehículo de categoría M1 o L.
`legends`	No	Leyendas: `{ "code", "value" }`.
`actions`	No	Envío por correo al emitir: `{ "sendEmail": true, "recipient", "pdfFormat" }`.

La referencia completa con todos los tipos está en Referencia API.