Saltearse al contenido
Olympus

Otros comprobantes · Ecuador

Guías de remisión

POST /api/v1/waybills/issue · scope documents:write

La guía de remisión acompaña a la mercancía mientras viaja: quién la transporta, desde dónde, hasta cuándo y quién la recibe. Cada destinatario lleva lo que recibe y, opcionalmente, el comprobante que respalda el traslado (normalmente la factura de venta).

{
  "transportista": { "identificacion": "0992345678001", "razon_social": "TRANSPORTES DEL LITORAL S.A.", "placa": "GBA1234" },
  "direccion_partida": "Km 10,5 vía a Daule, Guayaquil",
  "fecha_inicio_transporte": "2026-09-25",
  "fecha_fin_transporte": "2026-09-26",
  "destinatarios": [
    {
      "identificacion": "1792060346001",
      "razon_social": "COMERCIAL ANDINA S.A.",
      "direccion": "Av. Amazonas N24-03, Quito",
      "motivo_traslado": "Venta",
      "factura": { "secuencial": "001-001-000000123" },
      "items": [{ "codigo": "PRD-001", "descripcion": "Cajas de repuestos", "cantidad": 12 }]
    }
  ]
}

Campos de primer nivel

Sección titulada «Campos de primer nivel»
CampoObligatorioPor defectoNotas
transportista✅—Identificación, razón social y placa
direccion_partida✅—Desde dónde sale la mercancía
fecha_inicio_transporte✅—YYYY-MM-DD
fecha_fin_transporte✅—No puede ser anterior al inicio
destinatarios✅—Uno por punto de entrega
referencia_externa——Envíala siempre. Única por negocio entre guías
fecha_emision—Hoy en EcuadorNo puede ser futura
establecimiento—El de la clave o el del negocio{ "codigo", "punto_emision" }
secuencial—El siguiente de la serie de guíasSolo si controlas la numeración

La guía no lleva enviar_email: no tiene una contraparte con correo. Para enviarla, usa POST /waybills/{id}/send-email con destinatarios.

transportista

Sección titulada «transportista»
{ "tipo_identificacion": "04", "identificacion": "0992345678001", "razon_social": "TRANSPORTES DEL LITORAL S.A.", "placa": "GBA1234" }

RUC o cédula del transportista (el tipo se deduce si falta) y la placa del vehículo.

destinatarios

Sección titulada «destinatarios»
{
  "identificacion": "1792060346001",
  "razon_social": "COMERCIAL ANDINA S.A.",
  "direccion": "Av. Amazonas N24-03, Quito",
  "motivo_traslado": "Venta",
  "factura": { "secuencial": "001-001-000000123" },
  "items": [{ "codigo": "PRD-001", "descripcion": "Cajas de repuestos", "cantidad": 12 }]
}
CampoObligatorioNotas
identificacion✅RUC, cédula o pasaporte de quien recibe
razon_social✅
direccion✅Dirección de destino
motivo_traslado✅«Venta», «Traslado entre bodegas», «Devolución», «Consignación»…
items✅Lo que recibe: descripcion, cantidad y, opcionalmente, codigo
factura—{ "id" } o { "secuencial" } de una factura de Olympus
documento_relacionado—Si el comprobante que respalda el traslado no es una factura de Olympus

factura es el camino fácil: Olympus rellena el documento sustento con el número de la factura, su número de autorización y su fecha. La factura tiene que estar autorizado; si no, 409 invoice_not_authorized.

documento_relacionado sirve cuando el comprobante es de otro sistema o de otro tipo:

{ "tipo": "01", "numero": "003-002-000000871", "numero_autorizacion": "2409202601…", "fecha_emision": "2026-09-24" }

Un destinatario puede llevar factura o documento_relacionado, no los dos. Y puede no llevar ninguno: un traslado entre bodegas propias no tiene comprobante que lo respalde.

Respuesta

Sección titulada «Respuesta»

202 Accepted:

{
  "id": "e5a1b9c3-7d2f-4e6a-b8c4-1f0d9e8a7b65",
  "tipo": "guia_remision",
  "estado": "pendiente",
  "secuencial": "001-001-000000045",
  "clave_acceso": "2509202606099999999900110010010000000451234567816",
  "transportista": { "tipo_identificacion": "04", "identificacion": "0992345678001", "razon_social": "TRANSPORTES DEL LITORAL S.A.", "placa": "GBA1234" },
  "direccion_partida": "Km 10,5 vía a Daule, Guayaquil",
  "fecha_inicio_transporte": "2026-09-25",
  "fecha_fin_transporte": "2026-09-26",
  "destinatarios": [
    {
      "identificacion": "1792060346001",
      "razon_social": "COMERCIAL ANDINA S.A.",
      "direccion": "Av. Amazonas N24-03, Quito",
      "motivo_traslado": "Venta",
      "documento_relacionado": { "tipo": "01", "numero": "001-001-000000123", "numero_autorizacion": "1209202601099999999900110010010000001231234567810", "fecha_emision": "2026-09-12" },
      "items": [{ "codigo": "PRD-001", "descripcion": "Cajas de repuestos", "cantidad": 12.0 }]
    }
  ],
  "urls": { "detalle": "https://olympus.atharix.com/api/v1/waybills/e5a1b9c3-…", "pdf": null, "xml": null, "publica": null }
}

Ejemplo completo

Sección titulada «Ejemplo completo»
Ventana de terminal
curl -X POST https://olympus.atharix.com/api/v1/waybills/issue \
  -H "X-API-Key: $OLYMPUS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: GR-2026-0045" \
  -d '{
    "referencia_externa": "GR-2026-0045",
    "transportista": { "identificacion": "0992345678001", "razon_social": "TRANSPORTES DEL LITORAL S.A.", "placa": "GBA1234" },
    "direccion_partida": "Km 10,5 vía a Daule, Guayaquil",
    "fecha_inicio_transporte": "2026-09-25",
    "fecha_fin_transporte": "2026-09-26",
    "destinatarios": [{
      "identificacion": "1792060346001",
      "razon_social": "COMERCIAL ANDINA S.A.",
      "direccion": "Av. Amazonas N24-03, Quito",
      "motivo_traslado": "Venta",
      "factura": { "secuencial": "001-001-000000123" },
      "items": [{ "codigo": "PRD-001", "descripcion": "Cajas de repuestos", "cantidad": 12 }]
    }]
  }'