Guía de Remisión Remitente
Servicio para emitir guías de remisión remitente electrónicas. La guía de remisión remitente es el documento que sustenta el traslado de bienes cuando el remitente es quien organiza y realiza el transporte.
Reglas de uso importantes
tipoIntegracion: las guías usanOFFLINE; tu propio ERP se encarga del correlativo, por lo que debes enviardatosDocumento.numero.numero(endatosDocumento): 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.
POST
https://jarvis.tefacturo.pe/guiaremitente-api/invoice2u/integracion/guia-remision/{ruc}Emite una guía de remisión remitente electrónica. Reemplaza {ruc} con el RUC del remitente. Incluye datos del traslado, conductor, vehículo y bienes transportados.
Headers
| Header | Valor | Descripción |
|---|---|---|
| Authorization | Bearer {token} | Token de autenticación obtenido del endpoint de login |
| Content-Type | application/json | Tipo de contenido del cuerpo de la solicitud |
Cuerpo de la Solicitud
La guía de remisión remitente requiere datos del traslado (origen, destino, motivo), datos del conductor y vehículo (para transporte privado), y el detalle de los bienes transportados:
El ejemplo completo está en el panel derecho para copiar rápidamente.
Referencia de Campos
Datos del Traslado
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| datosEnvio.motivoTraslado | string | Sí | VENTA, COMPRA, TRASLADO_ENTRE_ESTABLECIMIENTOS, CONSIGNACION, DEVOLUCION, etc. |
| datosEnvio.modalidadTraslado | string | Sí | TRANSPORTE_PRIVADO o TRANSPORTE_PUBLICO |
| datosEnvio.fechaTraslado | string | Sí | Fecha de inicio del traslado (YYYY-MM-DD) |
| datosEnvio.pesoBruto | number | Sí | Peso bruto total de los bienes en la unidad indicada |
| datosEnvio.unidadMedida | string | Sí | Unidad de peso: KGM (kilogramos), TNE (toneladas) |
| datosEnvio.numeroBultos | number | No | Cantidad de bultos o paquetes transportados |
Conductor y Vehículo (Transporte Privado)
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| vehiculos[].conductor.nombreLegal | string | Sí | Nombre completo del conductor |
| vehiculos[].conductor.numeroDocumentoIdentidad | string | Sí | Número de documento del conductor |
| vehiculos[].liscenciaConducir | string | Sí | Número de licencia de conducir del conductor |
| vehiculos[].placa | string | Sí | Placa del vehículo de transporte |
Puntos de Partida y Llegada
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| datosEnvio.puntoPartida.ubigeo | string | Sí | Ubigeo INEI del punto de partida |
| datosEnvio.puntoPartida.direccion | string | Sí | Dirección completa del punto de partida |
| datosEnvio.puntoLlegada.ubigeo | string | Sí | Ubigeo INEI del punto de llegada |
| datosEnvio.puntoLlegada.direccion | string | Sí | Dirección completa del punto de llegada |
Respuesta Exitosa (200)
La respuesta confirma que la guía de remisión remitente 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ódigo | Estado | Descripción |
|---|---|---|
| 400 | Bad Request | Errores de validación. Verifique datos de traslado, conductor y vehículo. |
| 401 | Unauthorized | Token de autenticación inválido o expirado. |
| 403 | Forbidden | No tiene permisos para emitir guías con el RUC indicado. |
| 404 | Not Found | El RUC proporcionado no está registrado en el sistema. |
| 500 | Internal Server Error | Error interno del servidor. Intente nuevamente. |