API DAVATEL para distribuidores

Tarificador IA, tarifas reales y contratación integrada en DAVATEL.

Autenticación

Incluye la clave en cada petición:

X-API-Key: dvt_live_...

La clave identifica al distribuidor; nunca debe exponerse en código público sin restricciones de dominio.

Endpoints v1

Método	Ruta	Uso
GET	`/api/v1/operators`	Operadores disponibles
GET	`/api/v1/rates`	Catálogo sin comisiones
POST	`/api/v1/rates/search`	Resultados del tarificador IA
GET	`/api/v1/order-fields`	Campos actuales de contratación
POST	`/api/v1/orders`	Crear contratación
GET	`/api/v1/orders/:referencia`	Consultar estado

SDK JavaScript

<script src="https://davatel.com/davatel-api-sdk.js"></script>
<script>
const api = new DavatelApi({apiKey:'TU_CLAVE'});
const resultado = await api.buscarTarifas({necesidad:'FIBRA_MOVIL', lineas:2});
</script>

Widget

<script src="https://davatel.com/davatel-api-sdk.js"></script>
<div data-davatel-widget data-api-key="TU_CLAVE" data-color="#0057b8"></div>
<script src="https://davatel.com/davatel-widget.js"></script>

Especificación y pruebas

Archivos incluidos: openapi-davatel-v1.yaml y DAVATEL_API.postman_collection.json.

Integraciones backend

PHP y WordPress deben enviar X-Davatel-Domain: www.tudominio.es además de X-API-Key.

Límites de productos por contratación

Máximo 50 unidades de una misma tarifa.
Máximo 50 tarifas distintas por paquete.
Máximo 100 unidades totales por contratación.
tarifa_id debe ser un entero positivo y cantidad un entero mayor que cero.
Las entradas repetidas de una tarifa se suman. Nunca se recortan silenciosamente: si se supera un límite, la API responde HTTP 400.

{
  "productos": [
    { "tarifa_id": 12, "cantidad": 1 },
    { "tarifa_id": 37, "cantidad": 3 }
  ]
}

Claves estables de campos

Consulta GET /api/v1/order-fields y envía los datos usando la propiedad clave de cada campo, por ejemplo campo_12. El nombre visible puede cambiar en DAVATEL sin romper la integración.