Conectar Bsale
Bsale es la primera integración de Drometra. Cada comercio conecta su propia cuenta, sin mandar claves por correo, y Drometra lee el catálogo, el stock y los clientes para usarlos en pedidos y despachos.
Un administrador conecta la cuenta
Desde la consola, un administrador con verificación en dos pasos indica el RUT de la empresa y un nombre para la conexión. Drometra lo lleva a iniciar sesión en Bsale y, al volver, comprueba que la cuenta de Bsale sea de ese mismo RUT. Si no coincide, la autorización falla y no se crea nada. La autorización pendiente vence a los 10 minutos.
Detrás están POST /v1/integrations/bsale/authorizations y su /complete. La credencial de Bsale queda cifrada y la API nunca la devuelve.
Elige qué se sincroniza
Hay tres flujos: catalog (productos y variantes), stock (existencias por sucursal) y customers (clientes y contactos). Cada uno tiene su mapeo, que dice cómo pasa cada dato a Drometra, y se importa por separado. La conexión empieza en solo lectura.
Lee lo sincronizado
Los registros quedan normalizados y se leen por flujo, paginados con after y limit, filtrando por conexión o buscando con q. Cuando un dato de Bsale choca con uno de Drometra, queda como conflicto para que lo revises, sin pisar ninguno de los dos.
curl "https://api.drometra.com/v1/integrations/canonical/stock?limit=100" \
-H "Authorization: Bearer $DROMETRA_TOKEN" \
-H "x-tenant-id: $DROMETRA_TENANT"Emitir documentos (opcional)
Para emitir desde Drometra, un administrador elige la sucursal, el IVA y los tipos de documento entre los que ofrece la cuenta del comercio. Drometra vuelve a leer la cuenta antes de guardar y exige boleta, factura y nota de crédito electrónicas (códigos SII 39, 33 y 61) con IVA del 19 %. Las conexiones son de producción, así que lo emitido se declara al SII.
Desconectar
Al desconectar se borra la credencial y la conexión queda inactiva. Si después se autoriza el mismo RUT, se reactiva la misma conexión con la credencial nueva.