Entregar comprobantes y registrar cobros

Un comprobante independiente de $ 1.220 UYU puede estar Aceptado por DGI, tener $ 500 registrados como recibidos y mantener $ 720 pendientes. Si el correo dice Recibido por el servicio de correo, su entrega todavía no está confirmada. Son tres resultados distintos; el registro de ese cobro fiscal no mueve Caja.

Primero revisá la aceptación fiscal y el origen del documento. Los pagos de una venta o un trabajo se registran en su operación, para conservar un solo saldo.

Registrar un cobro desde la web

1. Abrí un comprobante aceptado del circuito web o API. En Cobros, revisá lo Cobrado y el Saldo pendiente antes de cargar otro pago, y elegí Registrar cobro. 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.
2. En el diálogo, 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.
3. Elegí Registrar cobro recibido una sola vez y comprobá Pago registrado o el aviso de que ese pago ya quedó registrado.
4. 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

Los importes registrados 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 Tu negocio › Facturación, en Informes, elegí Descargar en la fila Resumen fiscal, al lado de Totales de IVA. 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. Cerrar el diálogo con la X 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, en Entrega del comprobante elegí Enviar por correo. En el diálogo, 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.

Mandar el comprobante por WhatsApp

Desde el detalle de un comprobante que DGI aceptó, Mandar por WhatsApp prepara un mensaje para tu cliente con un enlace privado al PDF. El enlace se crea recién cuando lo compartís, y el mensaje lo mandás vos: Bigu no lo envía ni puede confirmar que llegó.

1. Abrí el comprobante en Ventas y tocá Mandar por WhatsApp.
2. Revisá el mensaje y tocá Abrir WhatsApp, al pie de la ventana. Si el receptor es un cliente que podés ver y tiene teléfono, WhatsApp se abre en su chat; si no, elegí el destinatario.
3. Si preferís otro medio, tocá Copiar mensaje: queda copiado con el enlace.
4. Mandá el mensaje desde tu WhatsApp y tocá Listo.

El cliente abre el enlace sin crear una cuenta y descarga el PDF del comprobante. Un e-Ticket va en la hoja en que imprime el negocio; una e-Factura y sus notas, siempre en A4. El enlace abre sólo ese PDF y dura 30 días: el mensaje dice qué día vence, y Invalidar enlace lo corta antes.

Entrega del comprobante anota cada vez que lo compartiste, junto a los correos: Preparado para WhatsApp · entrega sin confirmar o Mensaje copiado · entrega sin confirmar, y después WhatsApp · enlace vencido, WhatsApp · enlace invalidado o WhatsApp · enlace vencido o invalidado, con el teléfono con que se abrió WhatsApp o Sin destinatario (al copiar, Bigu no sabe a quién lo mandás). Si no podés ver todos los clientes, en lugar del número dice Teléfono del cliente. Bigu no sabe si mandaste el mensaje ni si llegó, así que ese estado nunca dice que se entregó.

Para una venta, el mismo botón está en su detalle y en cada comprobante: ver cómo se manda una venta por WhatsApp.

Entrega por correo

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

{
  "id": "f9cbfe2e-d7b4-4fc0-97b4-92b894170127",
  "external_id": "venta-001",
  "to": "cliente@ejemplo.com"
}

El correo incluye el PDF y el logo configurado para los comprobantes, salvo que hayas elegido ocultarlo. Cuando el receptor está identificado con RUT, 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.

Asistentes

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.