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.

Guía de remitente con transporte privadoPetición
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ón
  • Transporte 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 modalidad
  • Lo que se puede deducir, no se pide

    Donde las reglas de SUNAT no dejan duda, Emitay completa el dato por ti.

    Lo que Emitay completa
  • SUNAT 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 webhooks
  • El 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.