🔌 API VeriHub
Explora todos los endpoints disponibles para integrar VeriHub con tu sistema
✅ 100% RESTful
🔐 Autenticación JWT + API Keys
📚 Documentación OpenAPI
📄 Facturas
Gestión completa de facturas y envío a AEAT Verifactu
GET
/api/v1/facturasListar todas las facturas del usuario
Parámetros:
pagelimitestadofechaDesdefechaHasta
Request:
GET /api/v1/facturas?page=1&limit=20&estado=enviada
Response:
{
"success": true,
"data": [
{
"id": "fact_123",
"numero": "2025/A-001",
"fecha": "2025-08-29",
"cliente": {
"nombre": "Empresa Ejemplo SL",
"nif": "B12345678"
},
"total": 121,
"estado": "enviada",
"csv": "AEAT123456789"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1
}
}
POST
/api/v1/facturasCrear nueva factura
Parámetros:
clienteIdserieIdconceptosfechaVencimiento
Request:
POST /api/v1/facturas
Body:
{
"clienteId": "cliente_123",
"serieId": "serie_a",
"conceptos": [
{
"descripcion": "Servicio de consultoría",
"cantidad": 1,
"precioUnitario": 100,
"tipoIva": 21
}
],
"fechaVencimiento": "2025-09-28"
}
Response:
{
"success": true,
"data": {
"id": "fact_456",
"numero": "2025/A-002",
"fecha": "2025-08-29",
"estado": "borrador",
"total": 121
}
}
GET
/api/v1/facturas/:idObtener factura específica
Parámetros:
id
Request:
GET /api/v1/facturas/fact_123
Response:
{
"success": true,
"data": {
"id": "fact_123",
"numero": "2025/A-001",
"fecha": "2025-08-29",
"cliente": {
"nombre": "Empresa Ejemplo SL",
"nif": "B12345678"
},
"conceptos": [
{
"descripcion": "Servicio de consultoría",
"cantidad": 1,
"precioUnitario": 100,
"tipoIva": 21,
"total": 121
}
],
"subtotal": 100,
"iva": 21,
"total": 121,
"estado": "enviada",
"csv": "AEAT123456789",
"qrUrl": "https://aeat.es/..."
}
}
POST
/api/v1/facturas/:id/enviarEnviar factura a AEAT Verifactu
Parámetros:
id
Request:
POST /api/v1/facturas/fact_123/enviar
Response:
{
"success": true,
"data": {
"csv": "AEAT123456789",
"qrUrl": "https://aeat.es/...",
"estado": "enviada",
"fechaEnvio": "2025-08-29T10:15:23+02:00"
}
}
🔐 Autenticación
VeriHub soporta múltiples métodos de autenticación para adaptarse a tus necesidades
JWT Token
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
API Key
X-API-Key: vhub_live_1234567890abcdef
¿Necesitas ayuda con la API?
Nuestro equipo de desarrolladores está aquí para ayudarte