Acceso y credenciales
Base: https://decaerp.com/api-di/v1/. Todas las peticiones usan HTTPS. Envíe una sola clave: X-Api-Key para la empresa (32 caracteres hexadecimales), X-User-Api-Key para un usuario (prefijo du_ y 48 caracteres hexadecimales), o Authorization: Bearer <clave>. No incluya claves en la URL ni en el JSON.
La clave de empresa accede a todos los DI de esa empresa. La clave personal solo accede a los DI creados por su usuario. El acceso requiere empresa y usuario activos, suscripción vigente y módulo DI habilitado. El administrador puede generar, rotar o revocar claves personales desde Usuarios; si ya tiene una clave de empresa, también puede usarla. No hace falta contratar el suplemento de API DeCA para usar una clave personal con DI.
Operaciones
GET v1/catalogos.php | Articulos y codigos LER disponibles para la empresa o usuario, estados y operaciones R/D admitidas. Los articulos se mantienen en Articulos LER. |
|---|---|
GET v1/documentos.php | Lista paginada; parámetros pagina (1–1000000) y limite (1–100, por defecto 20). |
GET v1/documentos.php?id=123 | Datos, estado, versión y enlaces de consulta y PDF de un DI. |
POST v1/documentos.php | Crea un DI. Requiere claveAlta aleatoria de 64 caracteres hexadecimales, estado y objeto datos. Repetir la misma clave y contenido no duplica el DI; usarla con otro contenido devuelve 409. |
PUT v1/documentos.php?id=123 | Actualiza el DI completo. Requiere la version vigente, estado y todos los datos. Una versión antigua devuelve 409. Los estados RECIBIDO y RECHAZADO quedan cerrados. |
La respuesta contiene urlPdf, el enlace directo de descarga. Es un enlace público con token: compártalo solo con quien deba ver el documento. Al desactivar DI para la empresa, el enlace deja de estar disponible.
Crear un DI en preparación
EN_PREPARACION admite datos incompletos. Para PREPARADO se exigen partes, LER, operación, pesos y revisión manual de notificación previa. Consulte el catálogo y las reglas actuales antes de enviar documentos completos.
curl -X POST "https://decaerp.com/api-di/v1/documentos.php" \
-H "X-Api-Key: SU_CLAVE" \
-H "Content-Type: application/json" \
-d '{"claveAlta":"e1c4d127e6177628497868da510c567930bda45570a91cbfddcce590a01dab69","estado":"EN_PREPARACION","datos":{"referencia":"ERP-001","observaciones":"Pendiente de completar"}}'Para actualizar, consulte primero el documento y reenvíe el objeto datos completo con su version actual. El PDF puede descargarse desde urlPdf o compartirse con el botón de WhatsApp en la gestión web de DI.
Respuestas y errores
Altas: 201; consultas y actualizaciones: 200. Error JSON: {"error":{"codigo":"...","mensaje":"..."}}.
| 400 | JSON, campo, transición o método de envío inválido. |
|---|---|
| 401 | Clave ausente, no válida o revocada. |
| 403 | Módulo DI no habilitado, suscripción o usuario sin acceso. |
| 404 | DI inexistente o fuera del alcance de la clave. |
| 409 | Conflicto de versión, documento cerrado o clave de alta reutilizada con otros datos. |
| 413 | JSON superior a 256 KiB. |
Instalaciones de destino
Los lugares habituales activos y marcados como destino en DeCA aparecen automáticamente en Instalaciones destino. No se crean clientes. Los datos adicionales de DI se guardan por separado y cada documento conserva la copia usada al guardarlo.
Alcance funcional actual
El módulo guarda documentos en preparación, documentos preparados, recepción o rechazo manual, historial, PDF con QR y enlace de consulta. La validación LER se limita al catálogo DI visible para la credencial. Los codigos introducidos por el usuario no se contrastan con registros oficiales. No verifica inscripciones, autorizaciones ni contratos ante registros públicos; tampoco determina automáticamente si un traslado exige notificación previa. La contratación no añade funciones distintas de las descritas aquí.