Guías de remisión

La guía de remisión (06) acompaña a la mercadería cuando se traslada: por una venta, una devolución, una consignación o entre tus propios locales. Dice desde dónde sale, quién la lleva, en qué vehículo y a quién llega. No lleva valores. El ciclo es el mismo de las facturas (pending → authorized/rejected).

curl https://api.chaski.ec/v1/delivery-guides \
  -H "Authorization: Bearer $CHASKI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: guia-pedido-778" \
  -d '{
    "issuer": "iss_01jbx3k9q2f8m4tn6vwz0yh5ce",
    "emission_point": "001-002",
    "departure_address": "Bodega norte, Km 12 vía a Daule, Guayaquil",
    "carrier": { "id_type": "cedula", "id": "1710034065", "name": "Juan Pérez" },
    "plate": "GBA-1234",
    "transport_end": "2026-11-05",
    "recipients": [{
      "id": "0992339411001",
      "name": "Distribuidora del Pacífico S.A.",
      "address": "Km 10 vía a Daule, Guayaquil",
      "email": "[email protected]",
      "reason": "Venta",
      "supporting_document": { "invoice": "inv_01jbx3k9q2f8m4tn6vwz0yh5ce" },
      "items": [
        { "code": "CAJ-40", "description": "Caja de cartón 40x40", "quantity": "10" },
        { "description": "Cinta adhesiva", "quantity": "3" }
      ]
    }]
  }'

Transportista y traslado

• carrier: quien lleva la mercadería (puede ser tu propio RUC). id_type es ruc, cedula, passport o foreign; no puede ser consumidor final. Si tiene RISE, va en rise.
• plate: placa del vehículo.
• departure_address: desde dónde sale.
• transport_start (AAAA-MM-DD): por defecto, hoy. La guía se emite antes de empezar el traslado, así que no puede ser anterior a la fecha de emisión.
• transport_end: no puede ser anterior al inicio.

Destinatarios

Una guía puede tener hasta 50 destinatarios. Cada uno lleva:

• id, name y address (el punto de llegada).
• reason: el motivo del traslado, en texto (“Venta”, “Devolución”, “Traslado entre establecimientos”…).
• items: lo que se traslada, con description y quantity (hasta 6 decimales). Sin precios.
• supporting_document (opcional): el comprobante de venta.
  • Con { "invoice": "inv_…" } Chaski usa una factura que emitiste aquí: toma su número, su clave de acceso y su fecha. La factura tiene que estar autorizada (si no: 409 invoice_not_authorized).
  • Si la factura no es de Chaski, indica type (01 factura), number, authorization_number e issue_date.
• Opcionales: customs_document, destination_establishment (3 dígitos, en traslados entre tus locales) y route.

El RIDE y el XML se envían al primer destinatario que tenga email cuando el SRI autoriza la guía (por defecto en live; en test solo con send_email: true).

Las guías se consultan, descargan y reenvían igual que las facturas, en /v1/delivery-guides. Para ver las de un destinatario: GET /v1/delivery-guides?recipient=0992339411001. Los webhooks son delivery_guide.authorized, delivery_guide.rejected y delivery_guide.failed. En producción, cada guía consume cuota igual que una factura.