Manual de configuración de Jumpseller
Requisitos
-
Tener cuenta en Jumpseller con cualquier plan de pago.
-
Tener cuenta en BillMySales con cualquier plan, incluyendo gratuito.
- Si requiere usar sondeo necesitará un plan que lo permita.
-
Crear pasarela usando el origen Jumpseller y el facturador de su elección.
Configuración básica de pasarela de facturación
1. Configurar el Sondeo
Realizando esta configuración la integración permitirá recuperar las órdenes generadas en Jumpseller y se generarán boletas no nominativas por defecto.
NOTA: Es importante haber iniciado sesión en la tienda de Jumpseller.
Paso 1: Guardar configuración inicial
Antes de conectar BillMySales con Jumpseller guarda la configuración en el botón “Guardar cambios”. Luego podrás realizar la conexión.
Paso 2: Conectar con Jumpseller
Ingresar configuración de la pasarela de Jumpseller en la pestaña “Origen de datos” presionar en el Botón “Conectar BillMySales con Jumpseller”:
Paso 3: Autorizar la aplicación
Esto nos redirigirá a otra página en donde debemos presionar en “Autorizar”:
Paso 4: Verificar conexión
Con esto, ya tendremos conectado BillMySales con nuestra tienda de Jumpseller:
Paso 5: Activar la pasarela
Finalmente en la pestaña “General” en “Estado de la pasarela” seleccionamos “Activada” y presionamos “Guardar cambios”. Con esto la pasarela estará activada.
2. Configurar el Webhook
Para conectar el Webhook en primera instancia se debió haber completado el paso “Configurar el Sondeo”.
Paso 1: Crear conexión Webhook
Para configurar el webhook solo se debe presionar “Crear conexión Webhook de Jumpseller”:
Configuración para boletas nominativas
Para poder emitir boletas nominativas, es decir, con el RUT del cliente debes:
1. Acceder a Checkout en Jumpseller
Entrar en el administrador la tienda en Jumpseller, pero ahora debes ir a la configuración y luego a “Checkout”:
2. Configurar Campos del Sistema
Dentro de Checkout ir a la sección “Campos del Sistema”, donde los campos de identificación fiscal se marcan como obligatorios, tal como se muestra en la imagen:
Con esta configuración ya se deberían poder emitir boletas nominativas.
Configuración para facturas o boletas nominativas
Configuración en Jumpseller
1. Acceder a Checkout
Ingresar en el administrador de la tienda en Jumpseller e ingresar a “Checkout”:
2. Agregar Campos Personalizados
Dentro de “Checkout” debes bajar a “Campos Personalizados” y seleccionar “Agregar Campo”:
3. Crear campo “Documento”
El primer campo será “Documento”, el cual será configurado de la siguiente forma para permitir la elección del tipo de documento que el cliente desea:
- Etiqueta: Documento.
- Área: “Otro”.
- Tipo: Lista de selección.
4. Agregar opciones del documento
En opciones se debe añadir:
- Boleta.
- Factura.
Nota: Los nombres “Documento”, “Boleta” y “Factura” deben ser exactamente escritos de esta forma. Ya que si están de otra forma, por ejemplo, todo en mayúsculas o minúsculas, no funcionará.
5. Guardar campo Documento
Luego debes seleccionar “Guardar”.
6. Crear campo “Giro”
El segundo campo será “Giro”, el cual debe ser configurado de la siguiente forma:
- Etiqueta: Giro.
- Área: Otro.
- Tipo: Campo entrada.
7. Guardar campo Giro
Luego debes seleccionar “Guardar”.
8. Campo Giro opcional
Si deseas que el campo giro sea opcional lo debes dejar de la siguiente forma:
9. Verificar campos creados
Una vez creados estos campos se verán de la siguiente manera:
10. Vista en el checkout
Y en en el checkout de tu tienda se verá de la siguiente manera:
Configuración en BillMySales
1. Acceder a Origen de datos
A continuación, te debes dirigir a la configuración de la pasarela e ingresar a la pestaña “Origen de datos”:
2. Editar Campos del documento
Al final de la página te encontrarás con el recuadro de “Campos del documento” y lo debes editar:
3. Añadir campo Documento
Dentro de este campo se debe añadir el “Documento” tal como se muestra en la siguiente imagen:
4. Editar Campos del cliente
En la misma página te encontrarás con el recuadro “Campos del cliente” y lo debes editar:
5. Añadir campo Giro
Dentro de este campo se debe añadir el “Giro” tal como se muestra en la siguiente imagen:
6. Guardar configuración
Finalmente debes guardar la configuración en “Guardar cambios”.
Con esta configuración ya podrás emitir boletas nominativas y facturas electrónicas a tus clientes a través de tu tienda.
¿Cómo configuro el tipo de precio en BillMySales?
En Jumpseller sus precios se pueden configurar con precios brutos y netos, dependiendo de la configuración del impuesto de tu cuenta, es decir, puede utilizar las siguientes opciones en BillMySales:
Configuración con precios NETOS
La configuración para definir en BillMySales si quieres que tus precios sean “Precios configurados para items afectos y exentos, el origen de datos envía los montos neto”, es la siguiente:
Esto quiere decir que en los precios que le asignes a tus productos no incluirán el impuesto, si no que será sumado al producto en el momento de la compra.
Ejemplo:
Precio asignado en producto:
Precio compra del producto:
Se incluirá en caso de Chile, el impuesto de un 19%, esto dependerá de tu país o región.
Configuración con precios BRUTOS
La configuración para definir en BillMySales si quieres que tus precios sean “Precios configurados para items afectos y exentos, el origen de datos envía montos brutos”, es la siguiente:
Esto quiere decir que en los precios que le asignes a tus productos incluirán el impuesto, es decir, el impuesto ya se encuentra sumado al producto en el momento de la compra.
Ejemplo:
Precio asignado en producto:
Precio compra del producto:
El impuesto está incluido en el precio.
Importante: Si nuestros precios están definidos como “Precios configurados para items afectos y exentos, el origen de datos envía montos brutos”, también se debe asignar el envió bruto:
Anexos
¿Cómo identificar si un ítem es afecto o exento?
Para identificar si la orden es afecta o exenta se debe ingresar en el listado de órdenes e ingresar a la orden que desea revisar, luego en el historial ir al campo “Datos recibidos” donde podrá ver el JSON de la orden con los datos que envía Jumpseller para generar el documento.
Caso afecto
El índice tax debe tener un valor distinto de cero además, en el índice taxes debe venir la información relacionada con el impuesto.
Caso exento
El índice tax debe tener un valor cero además, el índice taxes debe estar vacío.
Orden afecta con valores netos
Para identificar si la orden afecta es neta se debe revisar el índice products.
Dentro de products en el índice taxes se encuentra el campo tax_on_product_price en donde si su valor es False indica que el IVA no se encuentra agregado al precio del ítem.
Orden afecta con valores brutos
Para identificar si la orden afecta es bruto se debe revisar el índice products.
Dentro de products en el índice taxes se encuentra el campo tax_on_product_price en donde si su valor es True indica que el IVA se encuentra agregado al precio del ítem.