Solicitar acceso a la API
Para conectar tu sistema con la API DeCA, contacta con soporte de SERTEC PESAGE y solicita el alta de tu integración.
Datos para el alta
Indica la empresa que utilizará el servicio, el nombre de la integración y, si quieres restringir el acceso, las IP públicas de salida de los servidores que realizarán las peticiones. Si utilizas un proxy, NAT o varias máquinas, facilita todas las IP de salida que deba autorizar soporte.
Soporte configurará la integración y te proporcionará un token de acceso seguro por el canal acordado. Cada integración utiliza su propia credencial. Si no se configura una lista de IP, el token permite acceso desde cualquier IP. Si cambia una IP, solicita su actualización antes de empezar a utilizarla.
Primeros pasos
- Solicita el token y, si procede, el alta de las IP a soporte de SERTEC PESAGE.
- Guarda el token en la configuración segura de tu servidor.
- Incluye la cabecera y utiliza una IP autorizada si el token tiene restricciones:
Authorization: Bearer YOUR_API_TOKEN.
Los tokens sk_test_ utilizan el entorno de desarrollo y los tokens sk_live_
el de producción. Ambos usan las mismas rutas, con documentos y referencias
independientes.
Consulta Credenciales y seguridad para configurar la conexión. La Referencia de la API contiene las operaciones, sus parámetros y ejemplos. Puedes descargar el contrato como OpenAPI JSON o OpenAPI YAML.
Idioma de los documentos
El idioma documentos de la organización determina el idioma de los PDF nuevos.
Cambiarlo no modifica PDF ya almacenados. El idioma de la documentación, los nombres
de los campos JSON y los mensajes de error de la API en inglés son independientes.
document_locale registra en el resultado el idioma utilizado. Los ocho idiomas
traducen títulos y etiquetas del PDF; no traducen los datos enviados por la integración.
Cuenta y archivo
El código de recuperación pertenece a la cuenta del portal y no sustituye el token de la API. Al crear una cuenta se configura una passkey, se imprime o descarga el código y se vuelve a introducir antes de completar el alta.
Los PDF se conservan un año y los datos estructurados cifrados cuatro años, desde la emisión o la fecha de transporte si es posterior. Tras retirar el PDF, una persona autorizada puede generar una copia privada desde los datos conservados. Consulta Credenciales y seguridad para conocer los límites de acceso y recuperación.
Probar sin dar de alta una integración
La demostración pública permite obtener un token sk_demo_ temporal y emitir PDF marcados como DEMO con datos ficticios. Caduca en 24 horas y no genera documentos válidos para el transporte.