Kopiloto

Integraciones ›

API de facturas del SAT

Tus CFDI del SAT, el XML original y los cálculos de Kopiloto (IVA del mes, DIOT, faltantes, lista 69-B, bancos) en tu sistema, Excel o Power BI. Solo lectura, con una llave por empresa.

Cómo empezar

  1. Crea tu cuenta en Kopiloto y baja tus facturas del SAT con tu e.firma.
  2. En tu empresa: Configuración → 🔑 API → Crear llave. Cópiala: solo se ve una vez.
  3. Manda la llave en cada petición: Authorization: Bearer kp_…
curl -H "Authorization: Bearer TU_LLAVE" https://kopiloto.mx/api/v1/facturas?direccion=recibido&desde=2026-10-01

Rutas

Ruta (GET)Qué regresa
/api/v1/empresaRFC y razón social de la empresa de la llave.
/api/v1/facturasTus CFDI, del más reciente al más antiguo. Filtros: direccion (emitido o recibido), desde y hasta (AAAA-MM-DD), limite (hasta 200) y despues (el cursor siguiente de la página anterior). Importes en pesos.
/api/v1/facturas/{id}/xmlEl XML original, tal como vino del SAT.
/api/v1/consultasLa lista de consultas disponibles y sus parámetros.
/api/v1/consultas/{nombre}Ejecuta una consulta; sus parámetros van en la URL (por ejemplo ?mes=2026-09).

En Excel, Power BI y Google Sheets (CSV)

Agrega formato=csv a /facturas y recibes una tabla plana (hasta 20,000 facturas; para más, filtra por fechas). Para conectarlo pegando solo una liga, la llave puede ir en la dirección:

https://kopiloto.mx/api/v1/facturas?formato=csv&llave=TU_LLAVE&desde=2026-01-01
  • Google Sheets: en una celda, =IMPORTDATA("…la liga…").
  • Excel: Datos → Obtener datos → Desde la web → pega la liga.
  • Power BI: Obtener datos → Web → pega la liga.

Quien tenga esa liga puede ver tus facturas: compártela solo con quien deba verlas. Si se filtra, revoca la llave en Configuración → API y crea otra.

Ejemplo de respuesta

{
  "datos": [
    {
      "id": "8f1c…", "uuid": "AE3B1029-…", "fecha": "2026-10-15T12:31:04",
      "direccion": "recibido", "tipo": "I", "serie": "A", "folio": "1201",
      "emisorRfc": "DDV890119HC9", "emisorNombre": "DEPOSITO DENTAL…",
      "receptorRfc": "EKU9003173C9", "receptorNombre": "ESCUELA KEMPER URGATE",
      "moneda": "MXN", "subtotal": 497.63, "iva": 79.62, "total": 577.25,
      "metodoPago": "PUE", "formaPago": "04", "estadoSat": "vigente"
    }
  ],
  "siguiente": "eyJm…"
}

Consultas disponibles

Son las mismas que usan el chat de Kopiloto y los conectores de ChatGPT y Claude, así que siempre dan las mismas cifras.

ConsultaPara qué sirve
resumen_financieroTotales de ingresos, gastos e IVA trasladado. Úsala para preguntas como "¿cuánto he facturado?", "¿cuánto llevo de gastos?", "¿cuánto IVA trasladé?".
cuentas_pendientesFacturas PPD con saldo pendiente: quién te debe (por cobrar, direccion emitida) y a quién le debes (por pagar, direccion recibida), con el saldo exacto y hace cuántos días. Úsala para "¿qué me deben?", "¿qué le debo a mis proveedores?", "¿tengo cuentas por cobrar vencidas?".
principales_contrapartesTus clientes o proveedores con más monto facturado, de mayor a menor, en un periodo opcional. Úsala para "¿quién es mi cliente más grande?", "¿a qué proveedor le compré más en enero?".
revisar_lista_negra_satRevisa si algún cliente o proveedor tuyo (por RFC) aparece en la lista negra del SAT (Artículo 69-B, empresas fantasma). Úsala para "¿algún cliente mío está en la lista negra?", "¿mis proveedores están limpios ante el SAT?".
folios_y_duplicadosFolios faltantes o repetidos en tu numeración, y facturas duplicadas (mismo UUID guardado más de una vez). Úsala para "¿tengo folios faltantes?", "¿hay facturas duplicadas?".
diot_por_proveedorAgrupa tus facturas recibidas por proveedor, con base e IVA por tasa — para preparar tu DIOT. Úsala para "ayúdame con mi DIOT", "¿cuánto IVA acreditable tengo por proveedor?".
resumen_por_mesIngresos (emitidas) o gastos (recibidas) mes por mes: cantidad de facturas, subtotal, IVA y total de cada mes. Úsala para tendencias, "¿en qué mes vendí más?", "¿cómo van mis gastos este año?", comparar meses.
iva_por_tasaBase e IVA trasladado agrupado por tasa (16%, 8%, 0%, exento), separado para emitidas (IVA que cobraste) o recibidas (IVA que te trasladaron). Úsala para "¿cuánto IVA cobré?", "¿cuánto IVA me trasladaron?", "¿cuánto facturé en la frontera al 8%?".
buscar_facturasLista facturas individuales (las más recientes primero) con fecha, tipo, contraparte, total, método de pago y folio fiscal. Se puede filtrar por dirección, fechas y por texto en el RFC o nombre de la contraparte. Úsala para "¿qué facturas le hice a X?", "¿cuál fue mi última factura?", "muéstrame las facturas de Amazon", "¿cuál es la factura más grande del mes?".
estados_de_cuentaLista los estados de cuenta bancarios guardados: banco, cuenta (últimos 4 dígitos), periodo, saldo inicial y final, total de abonos y cargos, cuántos movimientos y cuántos ya están conciliados con facturas. Úsala para "¿cuánto tenía en el banco?", "¿qué estados de cuenta tengo?", "¿cuánto entró este mes al banco?".
buscar_movimientos_bancoBusca movimientos del banco (de todos los estados de cuenta guardados) por fecha, tipo (cargo = salida de dinero, abono = entrada), monto exacto, texto en la descripción, o solo los que NO tienen factura ligada. Úsala para "¿qué depósitos no tienen factura?", "¿cuándo le pagué a X?", "¿de dónde salió este cargo de $5,000?".
iva_del_mesIVA del mes ESTIMADO, base flujo de efectivo: IVA cobrado (PUE del mes + PPD cobradas con REP − notas de crédito), IVA retenido por clientes, IVA acreditable pagado y el resultado a cargo o a favor. Úsala para "¿cuánto IVA voy a pagar este mes?", "¿tengo IVA a favor?". Aclara siempre que es un estimado a validar con el contador.
facturas_faltantesFacturas VIGENTES que el SAT tiene registradas (según los metadatos descargados) y que no están guardadas en Kopiloto. Úsala para "¿me falta alguna factura?", "¿tengo todas mis facturas del SAT?". Si no hay metadatos descargados, dilo y sugiere hacer una descarga del SAT.

Errores

  • 401: falta la llave, es incorrecta o se revocó.
  • 402: la empresa no tiene un plan que incluya la API.
  • 429: llegaste al límite de 5,000 peticiones del día.
  • 405: la API solo acepta GET (es de solo lectura).

Preguntas frecuentes

¿Cuánto cuesta la API?

Está incluida en todos los planes de pago de Kopiloto (Persona Física, Persona Moral y Contador) y en la prueba gratis de 14 días. El plan Descarga XML no la incluye.

¿La API puede crear o cancelar facturas?

No. Es de solo lectura: consulta tus facturas del SAT, sus XML y los cálculos de Kopiloto. No timbra, no cancela y no presenta nada ante el SAT.

¿De dónde salen las facturas?

Del SAT: Kopiloto las baja con tu e.firma y las revisa todos los días, así que la API siempre trae lo más reciente, incluidas las canceladas.

¿Hay límites?

Hasta 5,000 peticiones al día por empresa y hasta 200 facturas por página (con paginación por cursor).

¿Cómo la conecto a Power BI, Excel o Google Sheets?

Con la liga en CSV: /api/v1/facturas?formato=csv&llave=TU_LLAVE. En Sheets usa =IMPORTDATA(liga); en Excel, Datos → Desde la web; en Power BI, Obtener datos → Web. Se actualiza cada vez que refrescas.