/ Transporte

Guías de remisión

Emite guías de remisión electrónicas del remitente (tipo 09) con transporte público o privado.

Conceptos

La guía de remisión remitente la emite quien envía los bienes. Disponible desde el plan Negocio. SUNAT la procesa de forma asíncrona: tras crearla, consulta el estado con GET /guias-remision/{id}/estado o por webhook.

Modalidad de traslado (mod_traslado)

Código	Descripción	Datos requeridos
01	Transporte público (empresa de transporte)	`transportista`
02	Transporte privado	`vehiculo` y `conductor`

Motivos de traslado (cod_traslado)

Código	Motivo
01	Venta
02	Compra
04	Traslado entre establecimientos de la misma empresa
08	Importación
09	Exportación
13	Otros
14	Venta sujeta a confirmación del comprador
18	Traslado emisor itinerante CP
19	Traslado a zona primaria

Crear guía de remisión

POST/guias-remision

Campos obligatorios

seriestringObligatorio: 4 caracteres, normalmente T001.
fecha_emisiondateObligatorio: yyyy-mm-dd.
destinatarioobjectObligatorio: tipo_doc (1 DNI o 6 RUC), num_doc y razon_social.
cod_trasladostringObligatorio: Motivo del traslado.
mod_trasladostringObligatorio: 01 público o 02 privado.
fecha_trasladodateObligatorio: Fecha estimada del traslado.
peso_totalnumberObligatorio: Mayor que 0.
und_peso_totalstring: KGM o TNE.
partida_ubigeostringObligatorio: Ubigeo de 6 dígitos del punto de partida.
partida_direccionstringObligatorio: Máx. 500.
llegada_ubigeostringObligatorio: Ubigeo de 6 dígitos del punto de llegada.
llegada_direccionstringObligatorio: Máx. 500.
itemsarrayObligatorio: Cada ítem con descripcion, cantidad y unidad.

Según la modalidad

vehiculoobject: Transporte privado: placa y, opcional, secundarios.
conductorobject: Transporte privado: tipo_doc, num_doc, tipo, nombres, apellidos, licencia.
transportistaobject: Transporte público: tipo_doc, num_doc, razon_social, nro_mtc.
num_bultosinteger: Cantidad de bultos.

En traslados con vehículos de categoría M1 o L puedes omitir transportista y conductor, indicándolo con el indicador de SUNAT correspondiente.

curl -X POST "https://apifact.gavi-cloud.com/api/v1/guias-remision" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "T001",
    "fecha_emision": "2026-10-02",
    "destinatario": {
      "tipo_doc": "6",
      "num_doc": "20555666777",
      "razon_social": "ACME CORP SAC"
    },
    "cod_traslado": "01",
    "mod_traslado": "02",
    "fecha_traslado": "2026-10-04",
    "peso_total": 150.5,
    "und_peso_total": "KGM",
    "num_bultos": 5,
    "partida_ubigeo": "150101",
    "partida_direccion": "AV. LIMA 456",
    "llegada_ubigeo": "150135",
    "llegada_direccion": "AV. SAN BORJA SUR 123",
    "vehiculo": {
      "placa": "ABC-123"
    },
    "conductor": {
      "tipo_doc": "1",
      "num_doc": "12345678",
      "tipo": "Principal",
      "nombres": "JUAN CARLOS",
      "apellidos": "PEREZ LOPEZ",
      "licencia": "Q12345678"
    },
    "items": [
      {
        "codigo": "P001",
        "descripcion": "LAPTOP HP PAVILION 15",
        "cantidad": 2,
        "unidad": "NIU"
      }
    ]
  }'

Respuesta201 Created

{
  "estado": "exito",
  "mensaje": "Guía creada y encolada para envío a SUNAT.",
  "datos": {
    "id": 88,
    "tipo_documento": "09",
    "numero_completo": "T001-88",
    "mod_traslado": "02",
    "peso_total": "150.50",
    "sunat_status": "pendiente",
    "sunat_ticket": null
  }
}

Consultar, actualizar y descargar

Método	Ruta	Descripción
GET	/guias-remision	Lista. Filtros: `serie`, `correlativo`, `destinatario_doc`, `estado`, `mod_traslado`, `cod_traslado`, `desde`, `hasta`
GET	/guias-remision/{id}	Ver una guía
PUT	/guias-remision/{id}	Actualizar (solo si está pendiente o rechazada)
GET	/guias-remision/{id}/estado	Consultar el estado en SUNAT
GET	/guias-remision/{id}/xml	XML firmado
GET	/guias-remision/{id}/pdf	PDF
POST	/guias-remision/{id}/enviar	Enviar o reenviar a SUNAT

Una guía ya aceptada no se puede editar: emite una nueva.

curl "https://apifact.gavi-cloud.com/api/v1/guias-remision/88/estado" \
  -H "X-Api-Key: TU_API_KEY" \
  -H "X-Api-Secret: TU_API_SECRET"