Sender shipping guide
Service to issue electronic sender shipping guides. Used when the sender organizes and performs the transport.
Important usage rules
tipoIntegracion: shipping guides useOFFLINE; your own ERP handles the correlative, so senddatosDocumento.numero.numero(indatosDocumento): it cannot be duplicated. If the number was already used, map/track the correlative so it is not resent.fechaEmision: a shipping guide can be declared with at most 1 day of backdating.- Replace the fixed example RUC with the issuer RUC used in the URL and token; all three must match.
- Response 200 values such as series, number, hash, signature, and identifier are illustrative; the API generates their actual values for each request.
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 | Value | Description |
|---|---|---|
| Authorization | Bearer {token} | Authentication token obtained from the login endpoint. |
| Content-Type | application/json | Content type for the request body. |
Request Body
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.
Field Reference
Datos del Traslado
| Campo | Tipo | Requerido | Description |
|---|---|---|---|
| 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 | Description |
|---|---|---|---|
| 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 | Description |
|---|---|---|---|
| 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 |
Successful Response (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.
Check the right panel to view and copy the sample response.
Error Handling
| Code | Status | Description |
|---|---|---|
| 400 | Bad Request | Errores de validación. Verifique datos de traslado, conductor y vehículo. |
| 401 | Unauthorized | Invalid or expired authentication token. |
| 403 | Forbidden | You do not have permission to issue shipping guides with the provided RUC. |
| 404 | Not Found | El RUC proporcionado no está registrado en el sistema. |
| 500 | Internal Server Error | Internal server error. Try again. |