Files

consultoria-as 08362c5677 docs: FASES_IMPLEMENTADAS + MULTI_BRANCH + GLOBAL_INVOICE

- Actualiza FASES_IMPLEMENTADAS.md con Fase 7 (precios proveedor, multi-sucursal, factura global)
- Agrega docs/MULTI_BRANCH.md con arquitectura y endpoints
- Agrega docs/GLOBAL_INVOICE.md con requerimiento SAT y flujo de uso

2026-06-11 09:02:14 +00:00

1.9 KiB

Raw Permalink Blame History

Factura Global Mensual — Documentación Técnica

Versión DB: v4.1
Commit: 2b73c2c

Requerimiento SAT

El SAT permite agrupar tickets de contado (menores a $2,000) en una sola factura mensual tipo Ingreso con InformacionGlobal.

Criterios de elegibilidad

Una venta es elegible para factura global si:

metodo_pago_sat = 'PUE' (pagado al momento)
total <= $2,000
status = 'completed'
No tiene CFDI individual timbrado (cfdi_queue.status = 'stamped')
No está ya en una factura global (sales.global_invoiced_at IS NULL)
Fecha dentro del mes/año solicitado

Arquitectura

Tablas

global_invoice_sales (global_invoice_id, sale_id) — relación N:M
sales.global_invoiced_at — marca de inclusión

XML

build_global_invoice_xml() en cfdi_builder.py
InformacionGlobal Periodicidad="04" (mensual)
Receptor: PUBLICO EN GENERAL (RFC XAXX010101000)

Endpoints

Método	Endpoint	Descripción
`GET`	`/pos/api/invoicing/global-invoice/eligible-sales?year=&month=&branch_id=`	Preview de ventas elegibles
`POST`	`/pos/api/invoicing/global-invoice`	Genera factura global
`GET`	`/pos/api/invoicing/global-invoice/<id>`	Estado y ventas vinculadas

POST body

{
  "year": 2026,
  "month": 6,
  "branch_id": 1
}

Response

{
  "id": 42,
  "status": "pending",
  "sales_count": 15,
  "total": 18450.00,
  "provisional_folio": "PRE-00042",
  "xml": "<?xml ...>"
}

Flujo de uso (Frontend)

Ir a Facturación
Clic en botón Factura Global
Seleccionar año y mes
Clic en Vista previa para ver ventas elegibles
Clic en Generar para crear y encolar el CFDI
Procesar cola de timbrado normalmente

Timbrado

La factura global entra en la cola cfdi_queue con:

type = 'ingreso'
sale_id = NULL
Se timbra igual que cualquier otro CFDI vía Horux360

1.9 KiB Raw Permalink Blame History