Entregar comprobantes y registrar cobros

Registrar un cobro desde la web

Abrí un comprobante aceptado del circuito web o API. En Cobros de este comprobante, revisá lo Cobrado y el Saldo pendiente antes de cargar otro pago. Los trabajos de servicios y las ventas de gestión registran su cobro en sus propios recorridos, por lo que no muestran este formulario fiscal duplicado.
Completá Importe recibido en la moneda indicada, Fecha de recepción y una referencia opcional para reconocerlo. La web recibe importes decimales; la fecha se interpreta en la zona horaria del negocio.
Elegí Registrar cobro recibido una sola vez y comprobá Pago registrado o el aviso de que ese pago ya quedó registrado.
Usá Actualizar cobros para consultar el saldo. Si recibiste otro pago real y todavía hay saldo, Registrar otro cobro prepara un registro distinto.

Esta acción anota dinero que ya recibiste. No inicia un pago, no mueve caja y no representa la deuda global del cliente. Si se pierde la respuesta, recuperá el mismo registro antes de preparar otro; repetir un pago con otra identidad puede duplicar lo anotado.

Cobros recibidos

Desde el detalle de un comprobante aceptado podés registrar un pago parcial: importe, fecha y referencia externa. Bigu anota un pago que ya recibiste; no cobra al cliente ni mueve dinero. Los importes deben usar la moneda del comprobante y no superar su saldo.

Por API, POST /api/v1/fiscal/cobros requiere fiscal:payments y estos campos:

{
  "id": "5dd6870d-a001-4e7e-a5bf-936733f50e86",
  "external_id": "venta-001",
  "amount": 5000,
  "currency": "UYU",
  "paid_at": "2026-09-06T10:00:00-03:00",
  "reference": "transferencia-001"
}

amount está en centésimos: 5000 son 50 pesos. Elegí un UUID nuevo por pago real y conserválo. Repetir el mismo UUID y contenido recupera el registro existente; cambiar sus datos produce payment_idempotency_conflict.

GET /api/v1/fiscal/saldos?external_id=venta-001 devuelve los cobros y el saldo de ese comprobante. No es el saldo global del cliente: las notas de crédito y débito se reportan por separado. No uses el saldo de una sola factura para decidir cuánto debe un cliente que tiene otros comprobantes o ajustes.

Descargar un resumen desde la web

En Comprobantes, abrí Exportar resumen por moneda e impuesto. En Exportar resumen fiscal, indicá Desde y Hasta si querés limitar el período, o dejalos vacíos para recorrer el registro disponible. Filtra la fecha de creación del pedido del circuito web y API. Las fechas de la web incluyen el día elegido y se interpretan en la zona horaria del negocio.

Elegí Descargar resumen. Bigu recorre las páginas y descarga bigu-resumen-fiscal.json con los resultados y totales de cada página, separados por moneda e impuesto. Esperá a que termine el recorrido para considerar completo el archivo; para obtener un total global sumá todas las páginas de la misma moneda. Cancelar detiene la descarga; no cancela ni modifica ningún comprobante.

Revisá los documentos excluidos y los estados pendientes antes de usarlo para conciliar. Los valores provienen del XML firmado, y las monedas se mantienen separadas. El alcance y formato de la exportación por API se detallan a continuación.

Importes firmados y exportación

GET /api/v1/fiscal/resumen?external_id=venta-001 devuelve bases, IVA, total y monto a pagar leídos del XML firmado. No recalcula una factura histórica con los valores actuales del catálogo.

GET /api/v1/fiscal/exportar exporta JSON paginado. Acepta los filtros query, from, to, limit y cursor de la búsqueda de comprobantes. from y to filtran la fecha de creación del pedido, con límite superior exclusivo.

Cada respuesta contiene items, totals de esa página, estados excluded y next_cursor. Recorré todas las páginas antes de presentar un resumen completo. Sumá únicamente importes de la misma moneda. Las notas de crédito restan; las de débito suman. Los comprobantes todavía no aceptados quedan excluidos explícitamente y deben volver a consultarse para completar la conciliación.

Enviar y consultar el correo desde la web

Desde el detalle de un comprobante aceptado, abrí Entregar por correo. Completá Correo del destinatario, revisalo y elegí Enviar comprobante. El envío usa los archivos y la presentación de ese momento.

Consultá el resultado en el mismo panel. Recibido por el servicio de correo significa que el proveedor aceptó el envío; Entregado requiere su confirmación de entrega. Rebotado, Reclamado por destinatario o Falló necesitan revisar el motivo. Un estado sin confirmación no justifica mandar otra copia.

Consultar entrega actualiza el estado sin preparar un correo nuevo.
Recuperar este envío continúa la misma entrega cuando Bigu ofrece esa recuperación; conserva su identidad y destinatario.
Preparar otro envío sirve para una entrega nueva e intencional. No lo uses para eludir un envío que sigue Buscando confirmación.

No cambies el destinatario dentro de una recuperación. Si necesitás enviar una copia a otra dirección, primero verificá el resultado del envío anterior y prepará otra entrega con esa nueva dirección.

Entrega por correo

POST /api/v1/fiscal/entregas requiere fiscal:deliver:

{
  "id": "f9cbfe2e-d7b4-4fc0-97b4-92b894170127",
  "external_id": "venta-001",
  "to": "[email protected]"
}

El correo incluye el PDF y el logo configurado para los comprobantes, salvo que hayas elegido ocultarlo. Cuando el receptor está identificado con RUC, también se adjunta el XML firmado; para los demás receptores se envía el PDF. Este correo no sustituye el intercambio fiscal entre emisores electrónicos.

El envío congela destinatario, mensaje y todos sus archivos, incluido el logo. Solo permite documentos aceptados. Repetir exactamente la misma solicitud recupera la misma entrega; otro destinatario o comprobante con el mismo UUID produce un conflicto.

Consultá GET /api/v1/fiscal/entregas?id=UUID. submitted significa que el proveedor recibió el envío; delivered confirma la entrega informada por el proveedor. Los rebotes y reclamos se distinguen en status y provider_event.

Después de una respuesta incierta, seguí next_action conservando el UUID. No crees otro envío para evitar un estado reconciling: podrías entregar dos copias. Bigu congela el contenido y usa idempotencia del proveedor; después de su ventana segura busca la identidad del envío por consulta periódica, sin reenviar a ciegas. Si el proveedor no permite confirmar el resultado, conserva el estado incierto.

Resend conserva sus claves de idempotencia durante 24 horas. Bigu usa un margen conservador de 23 horas y recupera mediante la consulta de envíos y sus etiquetas. Esto no depende de webhooks.

Agentes

MCP usa las mismas operaciones: fiscal_payment_record, fiscal_document_balance, fiscal_document_summary, fiscal_summary_export, fiscal_delivery_send y fiscal_delivery_get. La conexión necesita los permisos correspondientes. Los resultados incluyen la próxima acción permitida cuando hay seguimiento o recuperación.