josep.2526
/
VerifactuMidAPI
mirror of https://github.com/BYolivia/VerifactuMidAPI.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
27 Commits 1 Branch 6 Tags 114 KiB
Go 60.6%
Python 39.4%
Go to file
lite 1d3e781c7b fix: soporte PascalCase en registro de certificados y actualizacion de documentacion 
- Añadir campos PascalCase (CertName, CertFile, PasswordEncrypted) para compatibilidad con frontend
- Metodos CertNameResolved(), CertFileResolved(), PasswordResolved() para resolver campos
- Actualizar documentacion/api.md con ejemplos PascalCase, anulacion completa y errores AEAT
- Actualizar documentacion/certificado_pruebas.md con solucion de problemas P12 legacy
- Actualizar README.md con estado actual del proyecto
 		2026-05-21 19:31:11 -04:00
.github/workflows fix(ci): fix packaging step for cross-compilation 2026-05-17 17:29:26 -04:00
api fix: soporte PascalCase en registro de certificados y actualizacion de documentacion 2026-05-21 19:31:11 -04:00
documentacion fix: soporte PascalCase en registro de certificados y actualizacion de documentacion 2026-05-21 19:31:11 -04:00
internal fix: StoreFromBase64 writes to tmp/ instead of permanent location 2026-05-19 17:19:44 -04:00
test Update documentation and organize test files 2026-05-14 20:50:55 +02:00
verifactu refactor: accept certificates as base64, remove external dependencies 2026-05-19 16:03:28 -04:00
.gitignore base: project structure and configuration 2026-04-08 14:30:50 +02:00
AGENTS.md base: project structure and configuration 2026-04-08 14:30:50 +02:00
README.md fix: soporte PascalCase en registro de certificados y actualizacion de documentacion 2026-05-21 19:31:11 -04:00
config.yml Implement VeriFactu API with certificate management, invoice submission and local fallback 2026-04-17 13:03:06 +02:00
go.mod refactor: accept certificates as base64, remove external dependencies 2026-05-19 16:03:28 -04:00
go.sum refactor: accept certificates as base64, remove external dependencies 2026-05-19 16:03:28 -04:00
main.go feat: add format system with auto-detection 2026-05-17 16:27:27 -04:00

README.md

VeriFactu MidAPI

API intermediaria para enviar facturas a la AEAT a través del protocolo VeriFactu.

Recibe facturas en JSON, calcula el hash encadenado, genera el XML SOAP y lo envía a la AEAT. Si la AEAT no está disponible, guarda la factura localmente (fallback).

Documentación
Requisitos y setup Go, Python, OpenSSL, certificado, configuración
API Reference Endpoints, requests, responses
Protocolo VeriFactu Operaciones, hash, URLs AEAT, XML
Formato de datos NIF, fechas, tipos factura, IVA, ejemplo JSON
Formatos de entrada native, dolibarr, y cómo añadir nuevos
Arquitectura Capas, flujo de datos, cifrado
Seguridad Certificados, RSA, HTTPS
Certificados Obtener y configurar certificado FNMT
Tokens Sistema de autenticación por tokens
Configuración config.yml, variables de entorno
Testing Tests, depuración
Errores Códigos de error

Endpoints

Método Ruta Descripción
GET /api/v1/health Health check
GET /api/v1/auth/public-key Clave pública RSA
POST /api/v1/auth/register Registrar certificado .p12
GET /api/v1/formats Lista formatos disponibles
POST /api/v1/facturas Alta de factura (formato auto-detectado)
POST /api/v1/facturas/anular Anular factura

Estado

  • Alta de facturas con hash encadenado
  • Fallback local
  • Registro y validación de certificados
  • Anulación de facturas
  • Consultas
  • Subsanación
  • Soporte de campos PascalCase y snake_case en registro
  • Documentación de errores AEAT y solución de problemas con certificados P12