Frequently Asked Question
Importante: Esta integración permite generar boletas y facturas. En caso de que se necesite generar una factura, el usuario puede definir campos obligatorios con los datos que una factura requiera, explicados en la siguiente documentación.
Pasos:
Debemos entrar en el administrador de nuestra cuenta en Spincommerce, nos debemos dirigir a Integraciones y luego a Webhooks.
Dentro de Webhook debemos seleccionar "CREAR WEBHOOK".
Rellenamos los campos con los siguientes datos:
- Nombre: Añadimos BillMySales.
- Evento: Seleccionamos "Orden actualizada".
- URL: Ingresaremos la URL del Webhook de BillMySales. El que se obtiene en la pestaña "Webhook" de la pasarela de facturación (https://billmysales.com/billing_gateways).
La URL del webhook la encontrarás en la pasarela de facturación de BillMySales en la pestaña Webhook:
URL:
La siguiente imagen muestra como se ven datos. El siguiente paso es "Guardar".
Una vez guardado el Webhook, nos dará un token.
Debe ser copiado y añadido en la pasarela de facturación de Spincommerce en BillMySales en el siguiente campo.
Origen de datos/Datos de conexión/Token webhook.
Copiamos y pegamos el Token entregado por Spincommerce, tal como se muestra en la siguiente imagen:
Vamos al final de la página y seleccionamos "Guardar cambios".
En nuestro administrador de Spincommerce, nos dirigimos nuevamente a Integraciones, pero ahora, seleccionamos "API tokens".
Seleccionamos el botón para "GENERAR NUEVO API TOKEN".
Se configura de la siguiente manera:
- Nombre: BillMySales.
- Permisos: Seleccionamos la opción de permisos de Lectura.
Guardamos el API Token generado, tal como se muestra en la siguiente imagen:
Ya creado debemos copiar el token que nos entrega .
Debe ser copiado y añadido en la pasarela de facturación de Spincommerce en BillMySales en el siguiente campo.
Origen de datos/Datos de conexión/Token API.
Copiamos y pegamos el Token entregado por Spincommerce, tal como se muestra en la siguiente imagen:
Vamos al final de la página y seleccionamos "Guardar cambios".
Una vez configurado nuestra integración ya puede recibir notificaciones del pago de tus pedidos y se generarán boletas no nominativas por defecto.
¿Cómo emitir boletas y facturas?
Debemos entrar en el administrador de nuestra tienda en Spincommerce, nos dirigimos a configuración y luego a Checkout.
Dentro de Checkout nos encontramos con "Campos adicionales", donde seleccionamos "Agregar nuevo campo".
Nombre del campo: Documento.
Tipo: Selector opciones.
Agregar opciones : Opciones.
En opciones añadimos:
- Boleta
- Factura
Seleccionamos "Guardar".
Importante: los nombres "Documento", "Boleta" y "Factura" deben ser exactamente escritos de esta forma. Ya que si están de otra forma (ejemplo: todo en mayúsculas o minúsculas, no funcionará).
Nuevamente seleccionamos "Agregar nuevo campo".
Nombre del campo: RUT.
Tipo: Texto corto.
Seleccionamos"Guardar".
Agregamos el último campo, seleccionamos "Agregar nuevo campo".
Nombre del campo: Giro.
Tipo: Texto corto.
Seleccionamos"Guardar".
Importante: La selección de campo requerido es opcional, esto depende de como tu quieras que se personalice el Checkout. Si el cliente no llega a añadir su RUT o Giro, en caso de que sea opcional y no requerido, se emitirá una boleta no nominativa por defecto.
Ya añadido los campos adicionales, seleccionamos guardar y nos quedará visualmente de la siguiente manera:
A continuación, nos dirigimos a BillMySales y dentro de la Pasarela de facturación de Spincommerce, nos dirigimos a Origen de datos:
En la parte de abajo de la página nos vamos a encontrar con "Campos del documento" y lo editaremos.
Dentro de este campo añadiremos el "Documento" tal como se muestra en la siguiente imagen:
order.custom_fields.Documento
En la misma página, ya en el final, nos vamos a encontrar con "Campos del cliente" y editaremos los campos:
- Identificador fiscal.
- Actividad económica.
Dentro del campo Identificador fiscal añadiremos el "RUT" tal como se muestra en la siguiente imagen:
order.custom_fields.RUT
Dentro del campo Actividad económica añadiremos el "Giro" tal como se muestra en la siguiente imagen:
order.custom_fields.Giro
Vamos al final de la página y seleccionamos "Guardar cambios".
Una vez terminado ya se podrían emitir boletas y facturas de las ventas que se realicen en la tienda.
¿Cómo configuro el tipo de precio en el facturador LibreDTE?
En Spincommerce sus precios se deben configurar como "Sólo items afectos con precio bruto", esto es debido a que por el momento es la configuración integrada.
La configuración para definir en BillMySales si quieres que tus precios sean "Sólo items afectos con precio bruto", es la siguiente:
En la configuración del impuesto, la casilla destacada en la imagen debe ir marcada "Los precios de mis productos ya incluyen impuesto".