Documentación

Liquidación de compra

Compras a proveedores que no pueden emitir factura.

Se emite con POST /v1/liquidaciones-compra (o POST /v1/comprobantes con "tipo": "liquidacionCompra"). Los totales los calcula el servicio a partir de los ítems.

Campos

proveedorObligatorio: síDescripción: tipoIdentificacion (cédula, pasaporte, exterior…), identificacion, razonSocial y, opcionales, direccion y email.
items[].descripcionObligatorio: síDescripción: Hasta 300 caracteres.
items[].cantidadObligatorio: síDescripción: Mayor que cero, hasta 6 decimales.
items[].precioUnitarioObligatorio: síDescripción: Precio sin IVA, hasta 6 decimales.
items[].ivaObligatorio: síDescripción: Tarifa: 15, 5, 8, 0, noObjeto o exento.
items[].descuentoObligatorio: noDescripción: Descuento del ítem en dólares (no porcentaje).
items[].codigoObligatorio: noDescripción: Tu código de producto (hasta 25 caracteres).
items[].codigoAuxiliarObligatorio: noDescripción: Código auxiliar; el de la Tabla 31 para materiales de construcción al 5 %.
items[].iceObligatorio: noDescripción: ICE: { codigoPorcentaje, tarifa } según la Tabla 18 del SRI.
items[].detallesAdicionalesObligatorio: noDescripción: Hasta 3 pares nombre: valor que se imprimen en el RIDE (talla, color, lote…).
pagos[].formaPagoObligatorio: síDescripción: efectivo, transferencia, tarjetaCredito, tarjetaDebito… (ver Formatos).
pagos[].totalObligatorio: con varios pagosDescripción: Lo pagado con esa forma; con un solo pago es el total de la factura.
pagos[].plazoObligatorio: noDescripción: Plazo de crédito, con unidadTiempo (dias, meses…).

Campo	Obligatorio	Descripción
proveedor	sí	tipoIdentificacion (cédula, pasaporte, exterior…), identificacion, razonSocial y, opcionales, direccion y email.
items[].descripcion	sí	Hasta 300 caracteres.
items[].cantidad	sí	Mayor que cero, hasta 6 decimales.
items[].precioUnitario	sí	Precio sin IVA, hasta 6 decimales.
items[].iva	sí	Tarifa: `15`, `5`, `8`, `0`, `noObjeto` o `exento`.
items[].descuento	no	Descuento del ítem en dólares (no porcentaje).
items[].codigo	no	Tu código de producto (hasta 25 caracteres).
items[].codigoAuxiliar	no	Código auxiliar; el de la Tabla 31 para materiales de construcción al 5 %.
items[].ice	no	ICE: `{ codigoPorcentaje, tarifa }` según la Tabla 18 del SRI.
items[].detallesAdicionales	no	Hasta 3 pares nombre: valor que se imprimen en el RIDE (talla, color, lote…).
pagos[].formaPago	sí	efectivo, transferencia, tarjetaCredito, tarjetaDebito… (ver `Formatos`).
pagos[].total	con varios pagos	Lo pagado con esa forma; con un solo pago es el total de la factura.
pagos[].plazo	no	Plazo de crédito, con `unidadTiempo` (`dias`, `meses`…).

Casos

Compra a un proveedor sin RUC

Cuando compras a alguien que no puede emitirte factura (un artesano, un agricultor), tú emites la liquidación de compra.

POST /v1/liquidaciones-compra

curl -X POST "https://api.devfact.fonles.com/v1/liquidaciones-compra" \
  -H "Authorization: Bearer $DEVFACT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: liq-artesano-1" \
  -d '{
  "proveedor": {
    "tipoIdentificacion": "cedula",
    "identificacion": "1710034065",
    "razonSocial": "Rosa Chango",
    "direccion": "Salasaca, Tungurahua",
    "email": "proveedor@example.com"
  },
  "items": [
    {
      "descripcion": "Tapiz artesanal de lana",
      "cantidad": 3,
      "precioUnitario": "40.00",
      "iva": "15"
    }
  ],
  "pagos": [
    {
      "formaPago": "efectivo"
    }
  ]
}'