Conecta tu software con VetControl eReceta
Una API REST moderna y documentada para que software veterinario, farmacias, laboratorios y colegios profesionales se integren con el ecosistema de receta electrónica.
Qué ofrecerá la API
Todo lo necesario para construir integraciones robustas con el sistema de receta electrónica veterinaria.
REST API versionada
Endpoints JSON bajo /api/v1/ con versionado semántico. Versiones futuras convivirán sin romper contratos.
API keys con scopes
Autenticación mediante claves con prefijo vc_ y permisos granulares por recurso y operación.
Entorno sandbox
Entorno de pruebas completo con datos ficticios para desarrollar y validar integraciones sin riesgo.
Webhooks en tiempo real
Recibe notificaciones instantáneas de eventos: receta creada, firmada, dispensada o cancelada.
Documentación OpenAPI
Especificación Swagger interactiva con ejemplos de request/response para cada endpoint.
SDKs oficiales
Librerías cliente para TypeScript y Python. Próximamente más lenguajes.
Valida recetas en una sola llamada
Farmacias y dispensadores pueden verificar la autenticidad y vigencia de cualquier receta electrónica con una simple petición HTTP. Sin SDKs, sin dependencias — solo HTTPS y JSON.
- Verificación de firma digital
- Estado en tiempo real (activa, dispensada, vencida)
- Datos del prescriptor y medicamentos
- Acceso protegido por PIN de 6 dígitos
// POST /api/public/prescriptions/validate
curl -X POST \
https://ereceta.vetcontrol.es/api/public/prescriptions/validate \
-H "Content-Type: application/json" \
-d '{
"prescriptionNumber": "VET-A1B2C3-2501-0042",
"accessPin": "847291"
}'
// Response 200 OK
{
"valid": true,
"status": "ACTIVE",
"prescriptionNumber": "VET-A1B2C3-2501-0042",
"validUntil": "2025-01-30T23:59:59.000Z",
"veterinarian": {
"name": "Dra. Martínez López",
"collegiateNumber": "28-4521",
"province": "Madrid"
},
"signature": { "signed": true, "method": "AUTOFIRMA" }
}Casos de integración
La API está diseñada para cubrir los flujos más habituales del sector veterinario español.
Software de gestión veterinaria
Sincroniza clientes, mascotas y recetas entre tu software de gestión y VetControl eReceta de forma bidireccional.
Farmacias
Verifica la autenticidad de recetas electrónicas, consulta medicamentos prescritos y registra dispensaciones.
Laboratorios
Consulta prescripciones de antimicrobianos y accede a datos agregados para informes de resistencia.
Colegios veterinarios
Valida números de colegiado, consulta actividad prescriptora y genera informes de cumplimiento.
Seguridad de nivel empresarial
Cada llamada a la API está protegida por múltiples capas de seguridad diseñadas para el sector sanitario.
TLS 1.3
Cifrado en tránsito obligatorio en todas las conexiones.
FLE
Cifrado a nivel de campo para datos sensibles en reposo.
Rate limiting
Límites por API key y endpoint para prevenir abuso.
Audit logs
Registro completo de cada operación para trazabilidad.