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
- Crea tu cuenta en Kopiloto y baja tus facturas del SAT con tu e.firma.
- En tu empresa: Configuración → 🔑 API → Crear llave. Cópiala: solo se ve una vez.
- 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-01Rutas
| Ruta (GET) | Qué regresa |
|---|---|
/api/v1/empresa | RFC y razón social de la empresa de la llave. |
/api/v1/facturas | Tus 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}/xml | El XML original, tal como vino del SAT. |
/api/v1/consultas | La 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.
| Consulta | Para qué sirve |
|---|---|
resumen_financiero | Totales de ingresos, gastos e IVA trasladado. Úsala para preguntas como "¿cuánto he facturado?", "¿cuánto llevo de gastos?", "¿cuánto IVA trasladé?". |
cuentas_pendientes | Facturas 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_contrapartes | Tus 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_sat | Revisa 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_duplicados | Folios 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_proveedor | Agrupa 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_mes | Ingresos (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_tasa | Base 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_facturas | Lista 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_cuenta | Lista 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_banco | Busca 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_mes | IVA 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_faltantes | Facturas 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.