Emision de comprobantes con receptor manual, consulta RUT y tipo de cambio automatico

El endpoint de emision ahora puede completar receptores por documento, consultar DGI para RUT y resolver tipo de cambio automaticamente en monedas extranjeras.

Nueva funcionalidad 02/04/2026 REST Version: v1

Endpoints afectados

  • POST /api/v1/comprobante/emitir

Migracion recomendada

Ahora se puede omitir receptor.idCliente y cfe.totales.tipoCambio en escenarios soportados, manteniendo compatibilidad con requests existentes.

Que cambia

POST /api/v1/comprobante/emitir ahora permite emitir comprobantes enviando el receptor y los items en forma manual, sin depender obligatoriamente de receptor.idCliente ni de detalles[].idVariante.

Ademas:

  • Si no se informa receptor.idCliente pero se envia receptor.documento, el backend intenta resolver un cliente existente de la empresa por documento.
  • Si no existe cliente local y el documento es un RUT valido, el backend puede consultar DGI para completar los datos fiscales faltantes del receptor.
  • Si la moneda del comprobante es extranjera y no se informa tipoCambio, el backend intenta resolverlo primero desde la cotizacion interna de la empresa y luego desde BCU.

Impacto para integradores

  • Ya no es obligatorio conocer el idCliente interno para emitir si se dispone del documento del receptor y los datos necesarios del comprobante.
  • Ya no es obligatorio conocer el idVariante interno para emitir lineas manuales.
  • Integraciones existentes no cambian comportamiento si ya enviaban idCliente, idVariante y tipoCambio.

Consideraciones

  • El sistema no crea productos automaticamente.
  • Si se informa receptor.idCliente, debe pertenecer a la misma empresa.
  • Si no se puede resolver una razon social valida para un RUT, la emision se rechaza.
  • Si no se puede obtener tipoCambio para una moneda extranjera, la emision se rechaza.