Liquidaciones de compra

La liquidación de compra (03) la emites tú cuando le compras a alguien que no puede darte factura: una persona natural sin RUC (por ejemplo, un agricultor que te vende su cosecha) o un proveedor del exterior. En Chaski tu emisor es el comprador y supplier es el proveedor. Funciona como una factura al revés: los ítems, el IVA, los descuentos y los pagos se calculan igual, sin propina. El ciclo es el mismo de las facturas (pending → authorized/rejected).

curl https://api.chaski.ec/v1/purchase-settlements \
  -H "Authorization: Bearer $CHASKI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: compra-cacao-112" \
  -d '{
    "issuer": "iss_01jbx3k9q2f8m4tn6vwz0yh5ce",
    "emission_point": "001-002",
    "supplier": {
      "id_type": "cedula", "id": "1710034065", "name": "Juan Pérez",
      "address": "Recinto La Unión, Quevedo", "email": "[email protected]"
    },
    "items": [{
      "code": "CACAO-QQ",
      "description": "Quintal de cacao CCN-51",
      "unit_of_measure": "quintal",
      "quantity": "12",
      "unit_price": "120.00",
      "taxes": [{ "type": "iva", "rate": "0" }]
    }],
    "payments": [{ "method": "other_financial_system" }]
  }'

La respuesta trae los totales calculados (totals.subtotal, totals.taxes, totals.total), igual que una factura.

El proveedor

supplier.id_type: cedula, passport, foreign o ruc. No puede ser consumidor final.
supplier.name y, si quieres, supplier.address.
Con supplier.email, el RIDE y el XML se envían al proveedor cuando el SRI autoriza (por defecto en live; en test solo con send_email: true). El correo también va como campo adicional Email, como en la factura.

Ítems y pagos

Son los mismos de la factura: quantity y unit_price con hasta 6 decimales, discount por línea, un IVA por ítem (0, 5, 15, exempt o not_subject) y formas de pago que suman el total (con una sola, el monto se puede omitir).

Por ahora no se admiten reembolsos, documentos negociables ni máquinas fiscales.

Si al proveedor también le retienes, emite después un comprobante de retención con la liquidación como documento de sustento (type: "03").

Las liquidaciones se consultan, descargan y reenvían igual que las facturas, en /v1/purchase-settlements. Para ver las de un proveedor: GET /v1/purchase-settlements?supplier=1710034065. Los webhooks son purchase_settlement.authorized, purchase_settlement.rejected y purchase_settlement.failed. En producción, cada liquidación consume cuota igual que una factura.