Emitir fapiao directamente desde Odoo: un puente hacia la factura electrónica digital de China
Toda empresa que opera en China continental debe emitir fapiao (发票), la factura fiscal oficial regulada por el gobierno. No es papeleo que se pueda omitir. Una venta no está debidamente documentada, a efectos fiscales, hasta que existe un fapiao conforme para ella.
China también está en plena transición hacia el e-fapiao totalmente digital, conocido como 数电票, y las reglas que lo acompañan son genuinamente intrincadas. Cada línea de artículo necesita un código nacional de clasificación fiscal. La cuenta fiscal digital del vendedor necesita una sesión activa con la oficina de impuestos, o la emisión falla en silencio. Cancelar una factura no es un borrado; es una reversión en rojo (红冲) que puede requerir que el comprador confirme dentro de 72 horas.
Las empresas que usan Odoo tienen todas sus ventas y facturación justo ahí, en el ERP. Odoo, sin embargo, no tiene un puente nativo hacia el sistema de facturación electrónica de China. El resultado habitual es una doble captura manual entre Odoo y la plataforma de fapiao, lo cual es lento, propenso a errores, y un riesgo de cumplimiento genuino: si un código o una tasa de impuesto están mal, la autoridad fiscal rechaza la factura de plano.
Qué construimos, y qué hay de nuevo
Majorbird construyó una integración que conecta Odoo directamente con Baiwang (百望云), una de las principales plataformas de facturación electrónica de China, de modo que un fapiao pueda emitirse, y revertirse, directamente desde una factura de Odoo, sin volver a capturar nada manualmente. Eso era el diseño original. Lo que desde entonces pasó de "construido" a demostrado de principio a fin: un usuario toma una factura existente de Odoo, y tanto el fapiao como el número de factura y el PDF oficial regresan y aterrizan directamente en ese mismo registro de factura de Odoo. No hay un portal separado de Baiwang en el que iniciar sesión. La persona que hace el trabajo nunca sale de Odoo.
Un servicio conector se encarga de toda la complejidad específica de China: autenticación, firma de solicitudes, el modelo de emisión asíncrono, el flujo de reversión en rojo, el manejo de códigos fiscales, de modo que Odoo mismo nunca tiene que hablar el dialecto técnico de Baiwang. Odoo se comunica con una interfaz limpia y neutral, y el conector se encarga de la parte difícil.
Cómo funciona, y dónde vive dentro de Odoo
Un usuario hace clic en Generar Fapiao en una factura de cliente. Como la emisión es asíncrona, Baiwang acepta la solicitud primero y produce el fapiao real momentos después, así que el conector consulta hasta que se confirma, y luego escribe el número de fapiao y el PDF de vuelta en Odoo. Cancelar funciona de la misma manera, a través de una nota de crédito estándar de Odoo, que impulsa el proceso conforme de reversión en rojo detrás de escena.
Dos detalles hacen que se sienta nativo en lugar de añadido. Primero, el autocompletado del encabezado de factura del comprador: escribe el nombre de un cliente y trae su encabezado oficial de factura, razón social registrada, número fiscal, dirección, banco, directamente desde la plataforma fiscal, así nadie teclea a mano el 抬头 de una empresa y se equivoca en un carácter. Segundo, el conector aloja su propia lista de códigos de clasificación fiscal, con un mecanismo de actualización, de modo que los productos se mapean al código nacional correcto sin que alguien mantenga una tabla de referencia a mano.
Un registro dedicado rastrea el ciclo de vida completo de cada fapiao, desde enviado hasta emitido o fallido y a través de los estados de reversión, con el número de fapiao, el estado y el PDF justo ahí en la factura. Y el lado de Odoo está construido con campos limpios y neutrales respecto al proveedor, en lugar de codificar "Baiwang" directamente en el modelo de datos, lo que mantiene la solución portátil si eso alguna vez necesita cambiar.
Robusto por diseño, no solo en la demo
La mayoría de los primeros intentos de algo así logran que funcione el camino feliz y se detienen ahí. La verdadera ingeniería está en lo que pasa fuera de ese camino. La emisión es idempotente y confirmada por el proveedor, así que un reintento nunca produce un documento fiscal duplicado. El manejo de errores es deliberadamente inteligente en lugar de reflexivo: el sistema distingue un fallo transitorio que vale la pena reintentar de un problema de datos que necesita una corrección humana, así que nunca golpea ciegamente a la autoridad fiscal con la misma solicitud mala. La sesión de la cuenta digital con la oficina de impuestos se monitorea de forma proactiva, porque si caduca, cada emisión falla en silencio hasta que alguien lo nota, que es uno de los puntos más delicados de la facturación electrónica china en la práctica. La reversión en rojo se soporta como el proceso genuino y de varios pasos que exige la ley fiscal china, no un botón ficticio de deshacer. Los callbacks push en tiempo real desde la plataforma fiscal, en lugar de solo consultas periódicas, son un próximo paso ya documentado.
Nuestra opinión
El objetivo no es solo conectar Odoo a una plataforma fiscal. Es hacer que el cumplimiento del fapiao chino se sienta como una parte nativa del ERP, robusta por diseño, en lugar de un portal añadido que alguien tiene que acordarse de abrir. Eso es la experiencia de Majorbird en Odoo y localización china hecha concreta, y se ha probado de principio a fin en un entorno de pruebas. Si el cumplimiento de la facturación electrónica china está en algún punto entre "en la hoja de ruta" y "nos quita el sueño", esa es una conversación que vale la pena tener con el equipo de Majorbird en odoo@majorbird.com o www.majorbird.com.
Sources & Links
- Baiwang : plataforma china de facturación electrónica / fapiao (contratista de servicios de e-invoice de la Administración Estatal de Tributación).