Registrar recepción de compras

Registra ante el SIAT compras que no fueron declaradas por sus emisores. Requiere X-API-Key con permiso facturas.crear; la empresa y el ambiente se obtienen de esa clave.

puntoVentaId es el UUID de un punto activo de la empresa; el backend obtiene desde allí la sucursal y los códigos SIAT. tipoCompra admite 1 a 5 como valor común del lote; cada compra puede reemplazarlo con su propio tipoCompra. Si todas las compras declaran el suyo, puede omitirse el valor común. Se aceptan de 1 a 500 compras del mismo mes y año. periodoFiscal es obligatorio y se declara como AAAA-MM, por ejemplo 2026-08. El backend lo convierte en gestion=2026 y periodo=8 para SIAT. No se infiere de las fechas. La gestión admite desde 2000 hasta el año siguiente al actual; las fechas de las compras deben coincidir con el período declarado, conforme a la validación actual de Falmus. fechaEmision acepta AAAA-MM-DDTHH:mm:ss (con fracciones opcionales) sin zona, como hora de Bolivia (UTC-04:00). También acepta RFC 3339 con zona para compatibilidad y lo convierte a hora de Bolivia antes de validar el período y generar XML. La fecha debe ser la original de la compra; no se reemplaza por la fecha actual.

En cada compra son obligatorios nitEmisor, razonSocialEmisor, codigoAutorizacion, numeroFactura, fechaEmision y montoTotalCompra. numeroDuiDim, importeIce, importeIehd, importeIpj, tasas, otroNoSujetoCredito, importesExentos, importeTasaCero, descuento, montoGiftCard y codigoControl son opcionales; los importes omitid...