API para integraciones

Aduanas360 expone una API REST: la misma que usa la app móvil. Sirve para conectar otro sistema con tu cuenta (un ERP, un portal propio, una hoja de reportes) sin pasar por la pantalla.

Qué permite

Lo que la app móvil hace: consultar y crear expedientes, contenedores y documentos; cotizaciones con sus líneas; clientes y actividades del CRM; facturas en borrador y cobros; declaraciones y su ciclo ante Aduanas; arribos, notificaciones, el buscador global y el reporte de estatus. Lo irreversible de facturación (emitir, anular, rectificar) no se expone por API.

Cómo se accede

No hay llaves aparte: se entra con un usuario y contraseña de tu organización. Al iniciar sesión, la API devuelve un token de acceso que vive 15 minutos y uno de renovación para pedir el siguiente. Si la cuenta tiene verificación en dos pasos, el inicio de sesión pide también el código antes de entregar los tokens.

Para una integración conviene crear un usuario dedicado, con un rol que tenga solo los permisos que la integración necesita, y activarle la verificación en dos pasos si el sistema que se conecta la soporta. Ver Usuarios y Roles y permisos.

Dónde está la referencia

• Esquema OpenAPI: https://admin.aduanas360.com/api/v1/esquema/
• Documentación interactiva: https://admin.aduanas360.com/api/v1/docs/ (y /api/v1/redoc/)

El esquema se genera del código, así que siempre describe lo que la API hace. Hay además una colección de ejemplos lista para importar en un cliente de pruebas: pedila desde Ayuda → Escribinos.

Principios

• Los mismos permisos que la web. Un usuario ve y hace por API exactamente lo que ve y hace en pantalla: módulos de su organización, permisos de su rol, y costos y márgenes solo si su rol los ve. Lo que no puede ver no viaja en la respuesta.
• Aislamiento. La organización se resuelve del token, no de la dirección ni de ningún parámetro: no hay forma de pedir datos de otra organización.
• Cada cambio queda firmado. Lo que se crea o modifica por API aparece en Administración → Auditoría con el usuario que lo hizo, igual que desde la web.
• Errores con código estable. Toda respuesta de error tiene la misma forma y un código que no cambia entre versiones: rechazo de negocio, cuota o suscripción, servicio externo caído, sin permiso. Un error 403 explica que no tenés acceso y quién puede habilitarlo.
• Nunca reemplazo total. Las ediciones son parciales: mandás solo los campos que cambian y el resto queda como estaba.
• Límite de peticiones. Hay un tope por usuario; una integración que lo supere recibe un error y espera, no se bloquea la cuenta.
• Versión mínima de la app. La API declara qué versión de la app móvil acepta; una integración propia no está sujeta a eso.

Lo que no cubre esta página

Esta es una referencia de principios. El detalle de cada operación, sus campos y sus códigos de error está en el esquema y en la documentación interactiva, que son la fuente de verdad.