Conectar asistentes a Facturación

El servidor MCP conecta asistentes externos a las mismas operaciones fiscales de la API. La conexión OAuth identifica a la persona; la autorización en Bigu determina el negocio y los permisos. No compartas claves API en una conversación.

Si querés hablar con el asistente dentro de Bigu, usá Bigu Chat: no necesitás crear esta conexión. Esta guía es para permitir que una aplicación externa acceda a la facturación de un negocio autorizado.

Los permisos de una conexión no amplían el plan. En Bigu Facturas, los borradores y reglas emiten comprobantes independientes. En Integra, emitir un borrador genera su venta y su comprobante; cada fecha programada genera una venta a cobrar y la factura automáticamente. Preparar o validar no crea la venta. Revisá el efecto sobre el cobro antes de confirmar: contado usa el medio habitual disponible, mientras que una programación nunca registra dinero recibido.

Si conectás el asistente con Estudio Jacarandá y concedés sólo consultas, podrá consultar dentro de ese acceso, pero no emitir ni activar reglas. Esas acciones requieren su autorización específica, además del plan y el alta fiscal; pedirlas por chat no amplía lo concedido.

Autorizar consultas no autoriza emisiones

Conexión del asistente con Estudio Jacarandá

Permisos elegidos

Consultar comprobantes

Concedido

Emitir comprobantes

No concedido

Programar reglas

No concedido

Resultado de cada pedido

Consultar un estado

Dentro del permiso de consulta

Emitir un comprobante

Requiere otra autorización

Activar una regla

Requiere otra autorización

Conexión

El endpoint es https://bigu.ai/mcp. Para emitir, el negocio debe tener el alta fiscal completa y la autorización correspondiente.

Agregá el endpoint como conector MCP remoto en tu cliente. Ingresá con tu cuenta de Bigu. En la autorización, comprobá el nombre de la aplicación y su dirección de regreso, elegí un negocio cuya facturación puedas administrar y los permisos concretos. Podés autorizar consultas, preparación, emisión, entrega, cobros y reglas por separado. Rechazar vuelve al cliente sin crear una autorización fiscal nueva.

Si una conexión existente responde connection_required, su enlace a Asistentes conectados a Facturación permite revisar el negocio y autorizar nuevamente ese identificador. Las reglas existentes siguen perteneciendo al negocio: pausarlas es una acción distinta de desconectar el asistente.

La disponibilidad del alta de conectores y las confirmaciones de escritura las determina cada cliente. Consultá las instrucciones actuales de ChatGPT y Claude.

Autorizar el negocio en la conexión

La pantalla Conectar identifica la aplicación y la cuenta con la que ingresaste. Revisá Identificador de la aplicación y Ver dirección completa de regreso si necesitás comprobar quién solicita acceso.

1. En Negocio, elegí uno en el que tengas Administrar facturación electrónica. Si no aparece ninguno, revisá la cuenta y los permisos con los que ingresaste.
2. Marcá los permisos fiscales que necesita el asistente. Consulta no implica permiso para emitir, registrar cobros ni activar reglas.
3. Revisá también el acceso a tu identidad informado por Clerk.
4. Elegí Autorizar conexión para guardar la autorización del negocio y volver al cliente. Rechazar vuelve sin crear una autorización fiscal nueva.

Si la solicitud pide permisos de identidad no admitidos o Bigu no puede verificar la aplicación y su regreso, el formulario no permite autorizarla. Volvé al cliente e iniciá una conexión válida. Cada operación posterior comprueba que conserves acceso al negocio.

Recuperar una autorización pendiente

Los enlaces directos a Asistentes conectados a Facturación siguen abriendo la página propia para autorizar el identificador que te dio el asistente.

Si el cliente informa connection_required, abrí su enlace a Asistentes conectados a Facturación. Comprobá el nombre del negocio, el Identificador del asistente y los permisos de la conexión antes de elegir Autorizar estos permisos.

Esperá Asistente autorizado. Volvé al asistente para seguir. y regresá al cliente para retomar la operación. El identificador viene en el enlace de conexión: abrir esta página sin esa solicitud permite consultar las conexiones existentes, pero no inventa una conexión nueva.

Operaciones

Empezá consultando fiscal_capabilities y fiscal_emitter. Así comprobás el negocio, los permisos y los requisitos del emisor antes de preparar una operación. Para un primer recorrido sin emitir, guardá un borrador, validalo y revisá sus importes; emitir es un paso separado.

Herramienta	Resultado
fiscal_capabilities	Negocio, permisos y operaciones disponibles
fiscal_emitter	Habilitación actual y requisitos pendientes
fiscal_documents	Búsqueda de pedidos con paginación
fiscal_document	Estado fiscal actual por identificador
fiscal_issue	Emisión con identidad estable y reintentos sin duplicados
fiscal_file	PDF o XML firmado como recurso embebido
fiscal_drafts	Borradores recuperables con cursor
fiscal_delivery_send / fiscal_delivery_get	Envío y seguimiento de PDF/XML
fiscal_payment_record / fiscal_document_balance	Cobros parciales y saldo por comprobante
fiscal_summary_export	Resumen paginado por moneda e impuesto
fiscal_rule_create / fiscal_rule_status	Autorización, pausa y reanudación de recurrencias
fiscal_rules / fiscal_occurrences	Programación y progreso de cada ocurrencia

La conexión necesita acceso vigente para consultar las finanzas de todo el negocio. Emitir y las demás operaciones que modifican datos requieren además Administrar facturación electrónica y su autorización específica en la conexión. Los pedidos pendientes, observados o en duda no se deben presentar como aceptados. Consultá la guía API para importes, monedas, referencias, estados y recuperación.

Revocar y reconectar

En Tu negocio › Facturación › Conectá tu sistema, abrí Asistentes conectados y localizá el asistente por su nombre, cuándo se conectó y sus permisos. Elegí Revocar, confirmá con Revocar conexión y comprobá que diga Revocado el…. Bigu rechaza sus siguientes operaciones, incluso si el token OAuth aún no venció. Para reconectar al mismo negocio, volvé a autorizar el cliente; se conserva el registro de la autorización revocada. Un cliente ya vinculado no puede cambiar silenciosamente a otro negocio. Revocar la conexión no pausa las reglas automáticas que ya autorizaste; pausalas por separado si deben detenerse. Quien administra la facturación puede retirar su conexión aunque el negocio ya no pueda operar nuevas emisiones.

Preparar antes de emitir

También están disponibles fiscal_draft_get, fiscal_draft_save, fiscal_draft_validate y fiscal_draft_issue. Conservá un UUID estable desde el primer guardado. Usá revisión 0 para crear y la revisión devuelta para editar. Cada edición invalida la validación previa.

La validación devuelve bases, IVA y total en centésimos con el motor fiscal de Bigu. La emisión requiere esa revisión validada y congela el contenido. Ante una respuesta perdida, consultá fiscal_document con external_id: draft_UUID y recuperá el mismo envío. Nunca cambies la identidad para resolver un estado incierto.

Los pasos y formatos completos están en Borradores y revisión fiscal.

Clientes y conceptos

Usá fiscal_customers_search y fiscal_concepts_search antes de preparar un borrador. fiscal_customer_save y fiscal_concept_save guardan con un UUID estable y requieren fiscal:prepare. La guía del catálogo explica recuperación, precios y límites.