Guía remitente — transporte privado

Guía de Remisión Remitente (serie T...) para transporte privado (tipoTransporte: '02'). En lugar de datos del transportista, se indican la placa del vehículo y los datos del chofer.

POSThttps://api.facturalo.pe/api/v3/guia/enviar

Para transporte privado: datosTransportista solo requiere numeroPlaca. Los datos del chofer van en datosChofer con DNI, número de licencia, nombres y apellidos.

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.

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 de la guía (T001–T999).Ej: T001

correlativo

stringrequerido

Número correlativo.Ej: 14

tipoTransporte

stringrequerido

"02" = Transporte privado.Ej: 02

motivoTraslado

stringrequerido

Código de motivo. Ver tabla Motivo de traslado.Ej: 01

observaciones

string | nullopcional

Texto libre que aparece en la guía.

cliente

objectrequerido

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

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

indicadorDeEnvio

stringopcional

"01" = Envío. Requerido si aplica.

datosTransportista

objectrequerido

Para transporte privado solo se requiere la placa del vehículo.

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

Código SUNAT: NIU = unidad · KGM = kg · ZZ = servicio.Ej: NIU

cantidad

numberrequerido

Cantidad de unidades.Ej: 5

documentosRelacionados

arrayopcional

Comprobantes de venta asociados al traslado.

tipoDocumento

stringrequerido

"01" = Factura · "03" = Boleta.Ej: 01

numeroDocumento

stringrequerido

Serie y correlativo del comprobante.Ej: F001-00000123

Request bodyjson

{
  "webhook": false,
  "guia": {
    "fechaEmision": "2026-06-13",
    "serie": "T001",
    "correlativo": "1",
    "tipoTransporte": "02",
    "motivoTraslado": "01",
    "observaciones": "ENTREGA DE MERCADERÍA SEGÚN ORDEN DE COMPRA",
    "cliente": {
      "tipoDocumento": "6",
      "numeroDocumento": "20100070970",
      "denominacion": "EMPRESA DISTRIBUIDORA SAC",
      "correo": "compras@empresa.com"
    },
    "datosTraslado": {
      "fecha": "2026-06-14",
      "pesoBrutoTotal": 150.5,
      "pesoUnidadMedida": "KGM",
      "numeroBultos": 10,
      "indicadorDeEnvio": "01"
    },
    "datosTransportista": {
      "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": "01",
        "numeroDocumento": "F001-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": []
    }
  }
}