Manual de integracion de bandejas de entrada
Referencia técnica para manual de integracion de bandejas de entrada dentro del cliente local.
Objetivo
Esta pagina es el punto de entrada recomendado para integrar con el modulo local por:
- bandeja REST local
- bandeja de intercambio de archivos
El objetivo del integrador es poder:
- enviar un CFE sin firmar
- obtener numeracion y firma local
- consultar estado local
- reimprimir
- generar PDF
Introduccion
El modulo local ejecuta un daemon en el equipo del usuario y expone dos mecanismos de entrada:
- un servicio REST local por loopback o por IP de red local
- una bandeja de intercambio de archivos
Ambos canales usan el mismo motor de negocio para:
- validar XML
- reservar numeracion local
- firmar
- opcionalmente enviar al servidor
- opcionalmente imprimir
- devolver una respuesta al integrador
Funcionalidades del modulo local
El modulo local permite:
- validar XML de CFE antes de emitir
- reservar y administrar rangos CAE localmente
- numerar y firmar comprobantes
- persistir constancias y estados en base local
- procesar ingresos por REST o por archivos
- generar PDF de representacion impresa
- imprimir en impresoras comunes o ESC/POS
- reimprimir comprobantes emitidos
- consultar estado operativo y proximos folios
Proceso de integracion para la emision
sequenceDiagram
participant S as Sistema de la empresa
participant B as Bandeja de entrada
participant U as servidor
S->>B: Requerimiento (operacion, ID, campos)
Note over B: Normalizacion y validacion
B->>U: Requerimiento normalizado
U-->>B: Respuesta funcional
Note over B: Persistencia y desnormalizacion
B-->>S: Respuesta final al integrador
Vista general
flowchart LR
A[Sistema integrador] --> B{Canal de entrada}
B --> C[REST local]
B --> D[Intercambio de archivos]
C --> E[Daemon modulo local]
D --> E
E --> F[Validacion local]
F --> G[Numeracion y firma]
G --> H[Persistencia local]
H --> I[Envio opcional]
H --> J[Impresion opcional]
H --> K[Respuesta al integrador]
Recorrido recomendado
- Proceso de integracion para emision
- Bandeja REST del cliente local
- Integracion por bandeja de archivos
- Catalogo de campos de las bandejas de entrada
- Operaciones disponibles de las bandejas
- Formato del CFE para el envio
Mapa de contenido
Bandejas de entrada
Operacion y contratos
- Catalogo de campos de las bandejas de entrada
- Operaciones disponibles de las bandejas
- Integracion por REST local
Formato del comprobante
Alcance
Este bloque de documentacion cubre:
- contratos de request y response
- estructuras de carpetas
- formato de archivos
- endpoints
- campos soportados
- formatos de envio de CFE
No cubre:
- instalacion del modulo local
- build del proyecto
- configuracion interna del updater