tefacturo

Guía de Remisión Transportista

Servicio para emitir guías de remisión transportista electrónicas. La guía de remisión transportista es emitida por la empresa de transporte que presta el servicio de traslado de bienes para terceros.

Reglas de uso importantes

  • tipoIntegracion: las guías usan OFFLINE; tu propio ERP se encarga del correlativo, por lo que debes enviar datosDocumento.numero.
  • numero (en datosDocumento): no puede estar duplicado. Si el número ya fue utilizado, mapea/controla el correlativo para no reenviarlo.
  • fechaEmision: una guía de remisión se puede declarar con un máximo de 1 día de anterioridad.
  • Reemplaza el RUC fijo del ejemplo por el RUC emisor usado en la URL y el token; los tres deben coincidir.
  • Los valores de la respuesta 200, como serie, número, hash, firma e identificador, son ilustrativos; el API genera sus valores reales en cada solicitud.
POSThttps://jarvis.tefacturo.pe/guiatransportista-api/invoice2u/integracion/guia-remision/transportista/{ruc}

Emite una guía de remisión transportista electrónica. Reemplaza {ruc} con el RUC de la empresa transportista. Incluye datos del transportista, conductores, vehículos y bienes transportados.

Headers

HeaderValorDescripción
AuthorizationBearer {token}Token de autenticación obtenido del endpoint de login
Content-Typeapplication/jsonTipo de contenido del cuerpo de la solicitud

Cuerpo de la Solicitud

La guía de remisión transportista incluye datos del transportista (con registro MTC), múltiples conductores y vehículos, datos del remitente y destinatario, y el detalle de los bienes transportados:

El ejemplo completo está en el panel derecho para copiar rápidamente.

Diferencias con la Guía Remitente

AspectoGuía RemitenteGuía Transportista
Emitida porEl remitente de los bienesLa empresa transportista
Registro MTCNo requeridoObligatorio (registroMTC)
ConductoresUn conductorMúltiples conductores (principal + auxiliares)
VehículosUn vehículoMúltiples vehículos (principal + secundarios)
SerieInicia con "T"Inicia con "V"

Referencia de Campos

Objeto: transportista

CampoTipoRequeridoDescripción
correostringCorreo electrónico de la empresa transportista
nombreComercialstringNombre comercial del transportista
nombreLegalstringRazón social del transportista
numeroDocumentoIdentidadstringRUC de la empresa transportista
tipoDocumentoIdentidadstringTipo de documento: RUC
registroMTCstringNúmero de registro ante el Ministerio de Transportes y Comunicaciones

Objeto: conductores (array)

CampoTipoRequeridoDescripción
nombreLegalstringNombre completo del conductor
numeroDocumentoIdentidadstringDNI del conductor
tipoDocumentoIdentidadstringTipo de documento: DOC_NACIONAL_DE_IDENTIDAD
liscenciaConducirstringNúmero de licencia de conducir

Objeto: vehículos (array)

CampoTipoRequeridoDescripción
placastringPlaca del vehículo

Respuesta Exitosa (200)

La respuesta confirma que la guía de remisión transportista fue emitida correctamente y retorna el identificador, serie, número y tipo_documento SUNAT.

Revisa el panel derecho para ver y copiar la respuesta de ejemplo.

Manejo de Errores

CódigoEstadoDescripción
400Bad RequestErrores de validación. Verifique datos de transportista, conductores y vehículos.
401UnauthorizedToken de autenticación inválido o expirado.
403ForbiddenNo tiene permisos para emitir guías con el RUC indicado.
404Not FoundEl RUC proporcionado no está registrado en el sistema.
500Internal Server ErrorError interno del servidor. Intente nuevamente.

Endpoints Relacionados