Conector de Factura Electrónica para México, R Dominicana, Panamá y San Salvador

Perfil del Proyecto - Desarrollo Plataforma de Facturación Electrónica Multipaís (API + Portal Web)
Objetivo
Desarrollar una solución por país que permita integrar el erp con los servicios de certificación tributaria locales (sat) para gestionar y visualizar documentos electrónicos (facturas, notas de crédito, etc.). Esta solución debe contemplar tanto un API RESTful por país, como un portal web (Blazor WASM) para la consulta de documentos por parte de las empresas.
Funcionalidades del Proyecto
• Desarrollo de un api rest por país (méxico, república dominicana, panamá, el salvador) que:
o reciba documentos electrónicos en formato json estándar enviados desde el erp
o almacene esos documentos en una base de datos sql server exclusiva por país.
O Transforme los documentos al formato exigido por el SAT del país correspondiente.
O Conecte con el certificador tributario local mediante API.
O Gestione y almacene los estados y respuestas del certificador.
O Genere registros, logs, bitácoras y trazabilidad de cada documento.
O Procese y almacene los archivos generados (pdf, xml, txt, xlsx) en aws s3.
O Envíe notificaciones a emisores y receptores con dichos archivos adjuntos.
• Desarrollo de un Portal Web por país (Blazor WASM) que:
o Permita a los usuarios de cada empresa consultar, filtrar y visualizar documentos electrónicos.
O Exponga el estado y detalle de cada documento certificado.
O Autentique usuarios por empresa y país (multi-tenant).
Perfil del Desarrollador a Contratar (1 por país)
Formación
• Mínimo 5 años de experiencia en desarrollo backend y consumo de APIs.
• Experiencia comprobada desarrollando soluciones con .NET Framework / .NET Core / ASP.NET Core.
• Experiencia integrando con servicios tributarios SAT o certificadores de factura electrónica es un plus clave.
• Conocimiento de requerimientos legales de facturación electrónica de cada país
Habilidades Técnicas Requeridas
• Lenguaje: C#, .NET 6 o superior.
• Frameworks: ASP.NET Core Web API, Blazor WebAssembly.
• Base de datos: SQL Server (instalación, diseño de esquemas, performance tuning).
• ORM: Entity Framework Core (Database First / Code First).
• Diseño de APIs RESTful.
• Patrones de arquitectura: Clean Architecture, ddd, solid.
• Manejo de archivos y formatos: json, pdf, xml, xlsx, txt, soap.
• Servicios Cloud: AWS S3 (integración vía sdk o rest).
• Control de versiones: Git (GitHub).
• Seguridad y autenticación básica de usuarios.

Entregables Esperados
• api rest por país con documentación swagger.
• Base de datos estructurada por país.
• Portal web funcional en Blazor WASM.
• Integración con certificador local.
• Almacenamiento y notificación de documentos electrónicos.
• Manuales técnicos y de instalación por país.

1. Objetivo del proyecto

Diseñar, desarrollar e implementar conectores de Facturación Electrónica para México, República Dominicana, Panamá y El Salvador, integrados con el erp del cliente, utilizando un json estándar provisto por el erp y adaptándolo a los formatos exigidos por las autoridades tributarias y/o proveedores autorizados de certificación.

2. Alcance

Consumir el json estándar entregado por el erp.

Mapearlo al formato exigido por la autoridad local (xml, json, cfdi, e-cf, dte, etc.).

Consumir las APIs de:

México: pac autorizado (cfdi 4.0 + complementos básicos).

República Dominicana: dgii – e-cf.

Panamá: Proveedor Autorizado (PAC/local).

El Salvador: Ministerio de Hacienda – DTE.

Implementar:

Emisión de factura, nota de crédito y nota de débito.

Consulta de estado del documento (aceptado/rechazado).

Reintento de envío ante fallos de comunicación.

Manejo de errores y trazabilidad (logs).

Entregar:

Código fuente documentado.

Colección Postman de las APIs.

Manual técnico de integración.

Instructivo de despliegue (deployment).

3. Requerimientos técnicos mínimos

Lenguaje sugerido: [Node.js, C#, Java, Python – especificar lo que uses].

api rest con autenticación básica o token.

Consumo de JSON estándar (no modificarlo, solo extender si es necesario y acordado).

Uso de repositorio Git (GitHub, GitLab, Bitbucket).

Manejo de variables de entorno para credenciales y URLs de los entornos (sandbox, producción).

4. Entornos

El desarrollador debe trabajar con:

Entorno de pruebas (sandbox) de la autoridad o PAC.

Entorno de pruebas del erp, expuesto vía api (endpoint proporcionado por tu equipo).

Entorno de producción, una vez certificada la solución.

5. Entregables


Diseño técnico (documento):

Diagrama de flujo del proceso de emisión.

Campos requeridos vs json del erp.

Código fuente completo.

Colecciones Postman (pruebas unitarias de API).

Manual técnico (pdf o doc):

instalación

configuración

uso de endpoints

soporte post–producción mínimo: 30 días.