# Facturama MCP Integration > Servicio de facturación electrónica para México. Permite crear y gestionar CFDIs 4.0 (facturas, notas de crédito, complementos de pago), administrar clientes y productos, y consultar catálogos del SAT. ## Overview | Property | Value | |----------|-------| | Category | Facturación & Contabilidad | | Type | MCP | | Tools | 18 | | URL | https://jelou.ai/pt-br/marketplace/facturama | ## Available Tools (18) ### Cancelar CFDI Cancelar un CFDI. IMPORTANTE: Esta acción es irreversible y notifica al SAT. Puede buscar por: ID interno, UUID o número de folio. Motivos de cancelación: - "01": CFDI emitido con errores relacionados con la relación - "02": CFDI emitido con errores sin relación (la más común) - "03": Operación no realizada - "04": Operación nominativa relacionada con una factura global ### Crear CFDI Crear una factura electrónica (CFDI 4.0) a través del sistema SAT de México mediante Facturama. Requisitos: información del receptor y al menos un concepto. Si el RFC existe en los clientes guardados, los campos del receptor (Nombre, Régimen Fiscal, Código Postal Fiscal) se completan automáticamente. Si no, todos los campos del receptor son obligatorios. Establezca save_client=true para guardar al cliente para facturas futuras (recomendado para clientes recurrentes). Tipos de CFDI: "I"=Ingreso, "E"=Egreso, "T"=Transferencia, "N"=Nómina, "P"=Pago Formas de pago: "01"=Efectivo, "02"=Cheque, "03"=Transferencia, "04"=Tarjeta de crédito, "28"=Tarjeta de débito, "99"=Otra Métodos de pago: "PUE"=Pago en una sola exhibición, "PPD"=Pago en parcialidades o diferido Objeto del impuesto: "01"=Sin impuesto, "02"=Gravable con desglose, "03"=Gravable sin desglose ### Crear Cliente Crear un nuevo cliente en Facturama. Guarda la información fiscal de un cliente para reutilizarla al crear facturas. Esta herramienta puede ayudar a buscar códigos de régimen fiscal y códigos de uso de CFDI si no los conoces. Utiliza las herramientas del catálogo del SAT (facturama_get_fiscal_regimes, facturama_get_cfdi_uses) para encontrar los códigos correctos. ### Crear nota de crédito Cree una Nota de Crédito (CFDI tipo "E"). Utilícelo para: - Devoluciones/reembolsos - Descuentos aplicados después de la factura - Correcciones para reducir el monto de la factura original Esta herramienta busca la factura original y utiliza automáticamente los datos del receptor, la forma de pago y el lugar de expedición. Puede buscar por: UUID, folio, RFC del receptor o ID interno. Nota: Buscar por folio o UUID puede tardar más, ya que busca a través de varias páginas de facturas. Devuelva únicamente el texto traducido sin explicaciones. ### Crear Complemento de Pago Crear un Complemento de Pago CFDI. IMPORTANTE: Esto es OBLIGATORIO cuando recibes pago de una factura que fue emitida con el Método de Pago "PPD" (pago diferido). Esta versión simplificada busca la factura original y rellena automáticamente los datos del receptor y los detalles de la factura. Puedes buscar por: folio, UUID, RFC, o ID interno. Ejemplo: Emitiste una factura por 10,000 MXN usando PPD. El cliente paga 5,000 MXN ahora. Creas un complemento de pago para ese pago parcial. Nota: CfdiUse se establece automáticamente en "CP01" (requerido por el SAT para complementos de pago). Nota: ReceiverTaxZipCode es obligatorio si el receptor es diferente del emisor, ya que Facturama no almacena esto para los clientes. ### Descargar CFDI Descargar un CFDI en formato PDF, XML o HTML. Puedes buscar por: ID interno, UUID o número de folio. Devuelve el contenido del archivo como una cadena codificada en base64. ### Obtener CFDI Obtenga información detallada para un CFDI específico. Puede buscar por: ID interno, UUID o número de folio. Obtenga los datos completos de la factura, incluyendo UUID, importes, receptor y conceptos. ### Obtener Usos del CFDI Obtenga todos los códigos de uso de CFDI disponibles del SAT. Ejemplos: G01=Compra de mercancías, G03=Gastos generales, P01=Definición pendiente ### Obtener Cliente Obtenga un cliente específico por ID o busque por RFC/nombre. Devuelve la información fiscal completa del cliente para su uso en facturas. Devuelve solo el texto traducido sin explicaciones. Devuelve solo el texto traducido sin explicaciones. ### Obtener Regímenes Fiscales Obtén todos los códigos de régimen fiscal disponibles del SAT. Opcionalmente, filtra por RFC para ver a qué regímenes se aplican a ese tipo de contribuyente. ### Obtener Formularios de Pago Obtén todos los códigos de forma de pago SAT disponibles. Ejemplos: 01=Efectivo, 02=Cheque, 03=Transferencia, 04=Tarjeta de crédito, 28=Tarjeta de débito ### Obtener Entidad Fiscal Obtén la información de la entidad fiscal para la cuenta autenticada. Devuelve RFC, razón social, régimen fiscal y estado de CSD. ### Listar Clientes Listar clientes registrados con filtrado de búsqueda opcional. Devuelve el RFC del cliente, su nombre, correo electrónico e información fiscal. Devuelve solo el texto traducido, sin explicaciones. ### Buscar CFDIs Buscar CFDIs utilizando filtros como palabra clave, estado y tipo. Devuelve resultados paginados con información básica de la factura. ### Buscar Sat Productos Buscar códigos del catálogo de productos y servicios del SAT. Utilice esto para encontrar el código correcto de productos al emitir facturas. ### Buscar unidades satelitales Buscar códigos de unidad SAT. Utilice esto para encontrar el código de unidad correcto para los productos (p. ej., H87=Pieza, E48=Servicio). ### Enviar CFDI por correo electrónico Envía un CFDI al receptor por correo electrónico. Puedes buscar por: ID interno, UUID o número de folio. El correo incluye los archivos PDF y XML como adjuntos. ### Validar RFC Valide un RFC con el SAT para verificar si es válido y obtener el nombre legal. Utilice esto antes de crear facturas para verificar los datos del cliente y evitar errores. ## Supported Channels This integration works with: - WhatsApp Business API - Facebook Messenger - Instagram Direct Messages - Web Chat Widget ## AI Assistants Compatible - ChatGPT (via MCP) - Claude (via MCP) - Gemini (via MCP) - Custom AI Agents ## Quick Start 1. Sign up at https://apps.jelou.ai/signup 2. Navigate to Marketplace and add Facturama 3. Authenticate your Facturama account 4. Configure your messaging channels (WhatsApp, Facebook, etc.) 5. Copy the MCP server URL to your AI assistant ## Example Use Cases - Automate customer inquiries using Facturama data - Send notifications via WhatsApp when Facturama events occur - Query Facturama data directly from ChatGPT or Claude - Build AI agents that interact with Facturama ## Resources - [All Integrations](https://jelou.ai/pt-br/marketplace) - [Full Documentation](https://jelou.ai/llms-full.txt) - [API Docs](https://docs.jelou.ai) - [Help Center](https://help.jelou.ai)