Marko Manual de uso · Configuración

Paso a paso

Cómo conectar un facturador electrónico

Aquí eliges con qué proveedor tu empresa emite guías de despacho y facturas electrónicas desde Marko en vez de digitarlas a mano en otro sistema, y por separado, si quieres que Marko traiga solas las facturas de venta desde el SII. Son dos conexiones distintas que viven en la misma pantalla.

Qué vas a conseguir

La empresa conectada a Bsale, RelBase u OpenFactura (Haulmer) para emitir documentos sin digitarlos a mano, y — si quieres — el SII vinculado para traer solas las facturas de venta.

Para quién

Roles Administrador y Manager. El resto de los roles no ve Configuración en el menú.

Qué necesitas antes

Las credenciales que te dio el proveedor que tu empresa contrató: un token (Bsale, RelBase) o un token + código de sucursal SII + actividad económica (Haulmer). Para el SII, el RUT (lo trae Marko solo) y la clave.

Cuánto toma

Un par de minutos si ya tienes la credencial a mano.

El token queda a la vista de cualquiera con esta pantalla abierta El campo Token Haulmer —y los de Bsale y RelBase— es un campo de texto normal, no una contraseña: se ve completo mientras esté escrito, sin ningún botón para taparlo. No dejes la pantalla abierta ni la compartas por captura de pantalla con el token visible.

Los pasos

  1. Abre Configuración en el menú de la izquierda y, en el hub que se abre, pulsa la pestaña Integraciones.

    Pestaña Integraciones del hub de Configuración, con los bloques Integración SII y Facturador Electrónico
    Qué deberías verDos bloques dentro de la misma tarjeta: Integración SII arriba y Facturador Electrónico abajo, con el botón Guardar Integraciones fijo arriba a la derecha de la tarjeta. Si esta empresa ya tiene un facturador contratado, el desplegable Proveedor llega con esa opción ya elegida y sus campos llenos — como en la imagen.
    Si no ves «Integraciones» entre las pestañasTu rol no es Administrador ni Manager: esa pestaña, igual que casi todas las del hub de Configuración, está reservada a esos dos.
  2. Si quieres que Marko traiga solas las facturas de venta desde el SII, escribe la Contraseña SII y pulsa Integrar SII.

    Bloque Integración SII: RUT de solo lectura, campo Contraseña SII y botón Integrar SII, con el estado No integrado con SII
    Qué deberías verEl RUT Empresa (SII) ya viene puesto — es de solo lectura, lo toma de la ficha de tu empresa —, así que solo falta la clave. Arriba, una pastilla dice Integrado con SII (verde) o No integrado con SII (roja) según el estado actual. El botón Integrar SII se mantiene apagado mientras el campo de la clave esté vacío.
    Esto no es lo mismo que el facturadorIntegrar el SII solo sirve para traer las facturas de venta ya emitidas y habilita el módulo de cobranza; no emite nada. Para emitir guías y facturas necesitas además el bloque de abajo, Facturador Electrónico.
    El campo de la clave siempre llega vacíoAunque la pastilla diga Integrado con SII, la contraseña nunca se vuelve a mostrar: cada vez que entras a esta pestaña tienes que volver a escribirla si quieres reintegrar. Y si la empresa cambia su clave del SII directamente en el sitio del SII, Marko no se entera sola — hay que venir aquí a actualizarla.
  3. En Facturador Electrónico, abre el desplegable Proveedor y elige el que tu empresa haya contratado.

    Bloque Facturador Electrónico con el proveedor OpenFactura (Haulmer) elegido: Token Haulmer, Actividad Económica, Código Sucursal SII y Ambiente Haulmer
    Qué deberías verTres opciones: Bsale, RelBase y OpenFactura (Haulmer). Elegir una cambia los campos de abajo al instante — nada se guarda todavía, eso solo pasa cuando pulses Guardar Integraciones. La imagen muestra OpenFactura (Haulmer), con su Token, la Actividad Económica (Acteco), el Código Sucursal SII y el selector Ambiente HaulmerAmbiente de Pruebas o Ambiente de Producción — y el botón Probar Conexión Haulmer, que valida el token contra Haulmer y, si responde bien, autocompleta solo la Sucursal y la Actividad Económica.
    Cambiar de proveedor borra los datos del anteriorSi tenías Haulmer configurado y pasas a RelBase, los campos de Haulmer quedan en blanco en el formulario, sin avisar ni pedir confirmación. Mientras no pulses Guardar Integraciones no se pierde nada en firme, pero si guardas por error, tienes que volver a escribir las credenciales del proveedor anterior para recuperarlo.
  4. Si tu proveedor es Bsale, pega el Token Bsale que te dio Bsale.

    Bloque Facturador Electrónico con el proveedor Bsale elegido: un único campo, Token Bsale
    Qué deberías verUn único campo: Token Bsale. Es el proveedor más simple de conectar de los tres.
    Bsale no tiene botón de pruebaA diferencia de Haulmer y RelBase, aquí no hay forma de validar el token antes de guardar: si está mal escrito, Marko lo guarda igual y el error solo aparece más adelante, al intentar emitir un documento.
  5. Si tu proveedor es RelBase, completa el Authorization Token y el Company Token, y — si tu empresa los usa — la Categoría, la Bodega por defecto y el Tipo de Traslado por Defecto para las guías de despacho.

    Bloque Facturador Electrónico con el proveedor RelBase elegido: Authorization Token, Company Token, ID Categoría por Defecto, ID Bodega por Defecto, Tipo de Traslado por Defecto y los botones Probar Bodegas RelBase y Probar Categorías RelBase
    Qué deberías verAuthorization Token (la «Tu clave API» de tu usuario en RelBase) y Company Token (el token de empresa, que pide directamente el soporte de RelBase) son obligatorios. ID Categoría por Defecto y ID Bodega por Defecto son opcionales — IDs numéricos de RelBase, no nombres. El selector Tipo de Traslado por Defecto trae 9 códigos del SII para las guías de despacho, de Operación constituye venta a Venta para exportación. Los botones Probar Bodegas RelBase y Probar Categorías RelBase quedan apagados hasta que completes ambos tokens.
  6. Pulsa Guardar Integraciones, arriba a la derecha de la tarjeta.

    Cabecera de la tarjeta Configuración De Integraciones con el botón Guardar Integraciones
    Qué deberías verEl botón se apaga solo mientras falte un campo obligatorio del proveedor que elegiste. Al guardar bien, un mensaje verde confirma «Configuración de integraciones guardada exitosamente.» Si algo falla al escribir en la base de datos, el mensaje es rojo: «Hubo un error al guardar la configuración. Inténtalo de nuevo.»
    Probar antes de guardar, cuando se puedaCon Haulmer y RelBase, usa el botón de prueba del paso anterior antes de guardar: te confirma que el token funciona sin tener que esperar a que falle la próxima guía o factura que intentes emitir.

Lo que esta pantalla todavía no hace

Para consultar después

DatoRegla
Quién entra a la pestaña IntegracionesAdministrador y Manager, dentro del hub Configuración. El resto de los roles no tiene Configuración en el menú.
Proveedores de facturador soportadosBsale, RelBase y OpenFactura (Haulmer). Uno solo activo a la vez.
Campos obligatorios por proveedorBsale: Token. RelBase: Authorization Token y Company Token (Categoría, Bodega y Tipo de Traslado son opcionales). Haulmer: Token, Actividad Económica y Código Sucursal SII.
Quién tiene botón de pruebaHaulmer (Probar Conexión Haulmer) y RelBase (Probar Bodegas / Probar Categorías, por separado). Bsale no tiene.
Integración SIIIndependiente del facturador: trae automáticamente las facturas de venta y habilita cobranza. Usa el RUT de la empresa (de solo lectura) y una clave que hay que volver a escribir cada vez.
Ambiente de HaulmerAmbiente de Pruebas o Ambiente de Producción. Con Pruebas, lo que emitas queda marcado como prueba y no llega al SII real.
Qué guarda «Guardar Integraciones»El facturador elegido con sus campos, en un solo movimiento. La integración SII se guarda aparte, al pulsar Integrar SII.

Cuando algo no sale

Lo que vesQué pasa
«Integraciones» no aparece en las pestañasTu rol no es Administrador ni Manager.
Guardar Integraciones apagadoFalta un campo obligatorio del proveedor que elegiste. Repasa el paso correspondiente.
«Ingresa RUT y contraseña SII.»Pulsaste Integrar SII sin escribir la clave (el RUT siempre está puesto).
«Por favor, ingresa el token de Haulmer.»Pulsaste Probar Conexión Haulmer con el campo vacío.
«Error de autenticación (401). Verifica el apikey / los tokens.»El token de Haulmer o los de RelBase están mal copiados o vencieron.
«Por favor, ingresa ambos tokens de RelBase.»Falta el Authorization Token o el Company Token antes de probar Bodegas o Categorías.
«Hubo un error al guardar la configuración. Inténtalo de nuevo.»Falló la escritura en la base de datos al pulsar Guardar Integraciones; no es un problema de las credenciales del proveedor.