Carrier shipping guide
Service to issue electronic carrier shipping guides. Issued by the transportation company providing the service for third parties.
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/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
| 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 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.
Differences vs Sender Guide
| Aspect | Sender guide | Carrier guide |
|---|---|---|
| Issued by | Goods sender | Carrier company |
| Registro MTC | Not required | Required (registroMTC) |
| Drivers | One driver | Multiple drivers (main + assistants) |
| Vehicles | One vehicle | Multiple vehicles (main + secondary) |
| Serie | Inicia con "T" | Inicia con "V" |
Field Reference
Objeto: transportista
| Campo | Tipo | Requerido | Description |
|---|---|---|---|
| correo | string | Sí | Correo electrónico de la empresa transportista |
| nombreComercial | string | Sí | Nombre comercial del transportista |
| nombreLegal | string | Sí | Razón social del transportista |
| numeroDocumentoIdentidad | string | Sí | RUC de la empresa transportista |
| tipoDocumentoIdentidad | string | Sí | Tipo de documento: RUC |
| registroMTC | string | Sí | Número de registro ante el Ministerio de Transportes y Comunicaciones |
Objeto: conductores (array)
| Campo | Tipo | Requerido | Description |
|---|---|---|---|
| nombreLegal | string | Sí | Nombre completo del conductor |
| numeroDocumentoIdentidad | string | Sí | DNI del conductor |
| tipoDocumentoIdentidad | string | Sí | Tipo de documento: DOC_NACIONAL_DE_IDENTIDAD |
| liscenciaConducir | string | Sí | Número de licencia de conducir |
Objeto: vehículos (array)
| Campo | Tipo | Requerido | Description |
|---|---|---|---|
| placa | string | Sí | Placa del vehículo |
Successful Response (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.
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 transportista, conductores y vehículos. |
| 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. |