cfdi-cli

Parse, validate and convert Mexican CFDI 4.0 electronic invoices from your terminal.

A fast, single-binary CLI tool for working with Mexican CFDI 4.0 XML invoices. No internet required, no API keys, no runtime dependencies. Built with Rust for maximum performance.

Installation

Download binary (recommended)

Grab the latest release for your platform from GitHub Releases:

Platform	Download
Windows x86_64	`cfdi-cli-windows-x86_64.zip`
Linux x86_64	`cfdi-cli-linux-x86_64.tar.gz`
macOS Apple Silicon	`cfdi-cli-macos-aarch64.tar.gz`
macOS Intel	`cfdi-cli-macos-x86_64.tar.gz`

Install from crates.io

cargo install cfdi-cli

Build from source

git clone https://github.com/orbita-pos/cfdi-cli.git
cd cfdi-cli
cargo build --release
# Binary at target/release/cfdi-cli

Usage

Quick info

$ cfdi-cli info factura.xml

==================================================
  UUID: A1234567-B890-C123-D456-E78901234567
  Fecha: 2024-08-01T12:00:00
  Tipo: Ingreso (I)
  Serie: SRV  Folio: 2450
  Emisor: IIA040805DZ4 - INDUSTRIAS INTEGRALES DE ACERO SA DE CV
  Receptor: EKU9003173C9 - ESCUELA KEMPER URGATE SA DE CV
  Total: $46980.00 MXN
==================================================

Parse to JSON

$ cfdi-cli parse factura.xml
{
  "version": "4.0",
  "fecha": "2024-08-01T12:00:00",
  "emisor": { "rfc": "IIA040805DZ4", "nombre": "INDUSTRIAS INTEGRALES DE ACERO SA DE CV" },
  "receptor": { "rfc": "EKU9003173C9", "nombre": "ESCUELA KEMPER URGATE SA DE CV" },
  "total": "46980.00",
  ...
}

Parse to table

$ cfdi-cli parse factura.xml -o table

============================================================
  UUID: 7E5FD72B-13A1-4B84-B6F7-1E5F2A4D78C9
  Fecha: 2024-06-15T09:45:30  Tipo: Ingreso  Moneda: MXN

  EMISOR
    RFC:    EKU9003173C9
    Nombre: ESCUELA KEMPER URGATE SA DE CV

  CONCEPTOS
    1. Laptop HP ProBook 450 G10 (x10) $1500.00 = $15000.00

  TOTALES
    SubTotal: $15000.00
    IVA Trasladado: $2400.00
    Total: $17400.00
============================================================

Parse to CSV

$ cfdi-cli parse factura.xml -o csv
UUID,Fecha,Tipo,Serie,Folio,EmisorRFC,EmisorNombre,...
7E5FD72B-...,2024-06-15T09:45:30,I,F,1001,EKU9003173C9,...

Validate

$ cfdi-cli validate factura.xml
VALIDO factura.xml

If there are issues:

$ cfdi-cli validate bad.xml
INVALIDO bad.xml
  ERROR: Emisor RFC invalido: ABC
  ERROR: Debe tener al menos un Concepto
  WARN: No tiene TimbreFiscalDigital (UUID)

Bulk process a directory

$ cfdi-cli bulk ./facturas/ -o reporte.csv
# Exports all XMLs as a single CSV file

$ cfdi-cli bulk ./facturas/ -f json
# Output as JSON array to stdout

Summary

$ cfdi-cli summary ./facturas/

RESUMEN DE CFDIS
==================================================
  Archivos procesados: 4/4

  Por tipo:
    Ingreso: 3
    Egreso: 1

  Totales:
    Ingresos: $69600.00
    Egresos: $4060.00
    IVA Trasladado: $10880.00
    Neto: $65540.00

  Por RFC Emisor:
    IIA040805DZ4: $46980.00
    EKU9003173C9: $21460.00
    EMP010101AAA: $5220.00
==================================================

Commands

Command	Description
`info <file>`	Quick metadata: UUID, emisor, receptor, total
`parse <file> -o json\|csv\|table`	Parse CFDI to structured output
`validate <file>`	Validate structure, RFC, required fields, totals
`bulk <dir> -o <file> -f csv\|json\|table`	Batch process a directory
`summary <dir>`	Totals by type, IVA, by RFC emisor

CFDI fields extracted

Comprobante: UUID, fecha, serie, folio, tipo, moneda, tipo de cambio, metodo/forma de pago
Emisor: RFC, nombre, regimen fiscal
Receptor: RFC, nombre, uso CFDI, domicilio fiscal
Conceptos: clave producto, cantidad, unidad, descripcion, valor unitario, importe
Impuestos: IVA trasladado, IVA retenido, ISR retenido
Timbre: UUID, fecha timbrado, sello SAT, certificado SAT

WebAssembly

The parser core compiles to WebAssembly for use in web applications:

wasm-pack build --target web --features wasm --no-default-features

Exports: parseCfdi, parseCfdiPretty, validateCfdi, infoCfdi, parseCfdiBulk

import init, { parseCfdi, validateCfdi } from './pkg/cfdi_cli.js';

await init();

const json = parseCfdi(xmlString);
const result = JSON.parse(validateCfdi(xmlString));
// { valid: true, errors: [], warnings: [] }

Performance

Single XML: < 1ms
10,000 XMLs: < 5 seconds
Binary size: ~3 MB
WASM size: ~210 KB

License

MIT - Built by Orbita POS

cfdi-cli 0.1.0