Casos de uso · Transporte y logística
Guías de remisión electrónicas desde tu sistema
Tu sistema conoce el traslado: qué bienes, de dónde, a dónde y quién los lleva. Emitay arma la guía, la firma, la envía a SUNAT y te avisa cuando responde.
curl https://api.emitay.com/v1/despatch_advices \
-H "Authorization: Bearer $EMITAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"series": "T001",
"recipient": {
"document_type": "6",
"document_number": "20100066603",
"name": "CLIENTE S.A."
},
"reason_code": "01",
"transport_mode": "02",
"start_date": "2030-01-15",
"gross_weight": "12.500",
"packages": 4,
"origin": { "ubigeo": "150101", "address": "AV. AREQUIPA 123, LIMA" },
"destination": { "ubigeo": "150122", "address": "AV. LARCO 456, MIRAFLORES" },
"vehicles": [{ "plate": "ABC123" }],
"drivers": [
{
"document_type": "1",
"document_number": "45678912",
"first_name": "JUAN",
"last_name": "PÉREZ ROJAS",
"license": "Q45678912"
}
],
"related_documents": [{ "type": "01", "number": "F001-1" }],
"items": [{ "description": "Caja de repuestos", "quantity": 4 }]
}'Lo que este caso necesita
Remitente y transportista, una misma ruta
La guía de remitente (09) y la de transportista (31) se emiten con la misma petición; la serie indica cuál es.
Guías de remisiónTransporte privado y público
Cada modalidad exige datos distintos, y la API dice cuál falta antes de numerar la guía.
Qué exige cada modalidadLo que se puede deducir, no se pide
Donde las reglas de SUNAT no dejan duda, Emitay completa el dato por ti.
Lo que Emitay completaSUNAT responde después, y te enteras
El envío de una guía siempre es asíncrono. El resultado llega a tu servidor por un webhook firmado.
Recibir webhooksEl modo de prueba dice lo que no puede probar
SUNAT no tiene ambiente de pruebas para guías: en modo de prueba la aceptación llega marcada como simulada.
Guías en modo de prueba
Empieza en modo de prueba
Con una llave de prueba la petición de arriba funciona de inmediato, sin certificado digital ni usuario SOL. Cuando tu integración esté lista, cambias la llave por una de producción.
Otros casos:Tienda en línea · Punto de venta · Software y ERP. ¿Dudas? Están en las preguntas frecuentes.