API

Dentro del módulo API podrás gestionar la integración de tu cuenta Facto con tiendas online (e-commerce) o sistemas propios. Desde este módulo es posible crear y administrar llaves API, consultar el historial de documentos emitidos mediante API y revisar los logs de las solicitudes realizadas, facilitando el seguimiento y control de las integraciones.

También permite realizar configuraciones adicionales de la integración y configurar webhooks, facilitando la sincronización de información de los productos entre Facto y tu e-commerce.

Existen 2 tipos de llaves API actualmente en Facto:

• API REST: para integrar todo tipo de e-commerce y plataformas web.
• API SOAP: sólo compatible para integrar el e-commerce "Woocommerce".

Se recomienda realizar las integraciones con la API REST tanto para e-commerce como para plataformas web.

¿Cómo puedo crear una llave API REST?

1. Ingresa en el módulo Administración → API → Llaves de acceso API.

2. Haz clic en Crear llave API REST:

   

3. Se abrirá una ventana emergente donde se deberán llenar los siguientes campos:

   • Propósito: se indica el e-commerce o plataforma web con la que se realizará la integración.
   • Account ID: Identificador único de la cuenta. Campo autocompletado por Facto.
   • Resource Owner Name: es el identificador / nombre de usuario. Campo autocompletado por Facto.
   • Resource Owner Password: es la contraseña del usuario. Campo autocompletado por Facto.
   • Client identification: identificador público que permite al servidor reconocer la aplicación o sistema externo que realiza la consulta. Campo autocompletado por Facto.
   • Client secret: es una contraseña privada y única que usa una aplicación para identificarse ante un servidor de autenticación cuando quiere acceder a la API. Campo autocompletado por Facto.
   • Asociar un certificado: por defecto Facto selecciona el certificado digital que se encuentra cargado.

4. Copia los parámetros en un bloc de notas y guárdalo, ya que una vez creada la llave API no es posible acceder a los datos generados para la creación de esta.

5. Haz clic en Guardar para crear la llave API:

   

¿Cómo puedo ver el historial de Documentos Tributarios Electrónicos emitidos por medio de API?

1. Ingresa al módulo Administración → API → Historial de API.

2. Selecciona el periodo a buscar y haz clic en Buscar:

   

3. Dentro del resultado obtenido se observa:

   • Usuario API que generó el documento.
   • Tipo de documento emitido.
   • Número de folio del documento.
   • Fecha de emisión del documento.
   • Monto total del documento generado.

¿Cómo puedo ver los logs de las solicitudes API?

1. Ingresa al módulo Administración → API → Logs API.

2. Ingresa la fecha desde y fecha hasta, y selecciona el estado del log.

3. Haz clic en Buscar.

4. Dentro del resultado obtenido se observa:

   • Total de solicitudes API exitosas.

   • Total de solicitudes API rechazadas.

   • Total solicitudes API sin información o detalle.

   • Total solicitudes API.

     

¿Cómo puedo hacer la integración Webhooks para sincronización de stock con mi tienda web?

1. Ingresa al módulo Administración → API → Webhooks.

2. Haz clic en Agregar suscripción.

3. Ingresa los campos requeridos:

   • URL a la cual se comunicará cada vez que ocurra un evento.

   • Usuario API.

   • Clave del usuario API.

   • Evento (seleccionar si la suscripción será para editar producto, editar stock, borrar producto, actualizar producto o crear producto).

   • Tipo de mensaje a enviar (se selecciona el e-commerce que corresponda).

     

4. Haz clic en Guardar para crear la suscripción Webhooks.

¿Cómo sincronizo el stock de Facto con mi tienda Shopify y elijo la bodega?

Con los webhooks de tipo Shopify, cada cambio de stock, creación, actualización o eliminación de productos en Facto se refleja en tu tienda Shopify, en la bodega (ubicación) de Shopify que elijas.

Antes de empezar, verifica que:

• Tienes contratado el complemento Webhooks.
• La app Facto está instalada en tu tienda Shopify y su pestaña API está configurada en modo Emisión real con una llave API REST de Facto (ver Integración con Shopify).
• Los productos tienen el mismo SKU en Facto y en Shopify.

Pasos:

1. Ingresa al módulo Administración → API → Webhooks y haz clic en Agregar suscripción.
2. En Tipo de mensaje a enviar selecciona Shopify.
3. En URL ingresa la URL interna de tu tienda, con el formato https://tutienda.myshopify.com. La encuentras en Shopify en Settings → Domains. No uses el dominio público de tu tienda.
4. En Usuario de la llave API y Clave de la llave API ingresa el Resource Owner Name y el Resource Owner Password que configuraste en la pestaña API de la app Facto en Shopify.
5. Haz clic en Cargar bodegas. Facto mostrará las bodegas (ubicaciones) activas de tu tienda Shopify; selecciona la bodega donde se actualizará el stock.
6. Selecciona el Evento y haz clic en Guardar. Crea una suscripción por cada evento que necesites:
   • Inventario: Cambio stock: actualiza la cantidad disponible en la bodega elegida.
   • Inventario: Crear producto: crea el producto en Shopify con stock 0 en la bodega elegida.
   • Inventario: Actualizar producto: actualiza los datos del producto en Shopify.
   • Inventario: Borrar producto: elimina el producto en Shopify.
7. En la tabla de suscripciones verás la bodega de Shopify bajo Bodega de Origen, por ejemplo Bodega general / Shopify: Bodega Santiago.

Para cambiar la bodega de una suscripción existente, haz clic en Editar, presiona Cargar bodegas, elige la nueva bodega y guarda.

ℹ️ Importante: Facto sincroniza el stock de su bodega general con la bodega de Shopify elegida. Las ubicaciones administradas por apps de despacho (fulfillment) no aparecen en la lista, porque Shopify no permite que otra app modifique su stock.

¿Cómo puedo ver los logs de las solicitudes webhooks?

1. Ingresa al módulo Administración → API → Logs Webhooks.
2. Selecciona la fecha desde y fecha hasta para filtrar la búsqueda.
3. Haz clic en Buscar.
4. Dentro del resultado obtenido se observará:
   • Solicitudes webhooks exitosas.
   • Solicitudes webhooks rechazadas.
   • Solicitudes webhooks pendientes.
   • Solicitudes webhooks totales.
   • Usuario API que generó la solicitud webhooks.
   • SKU del producto asociado al evento.
   • Tipo de evento.
   • Estado de la solicitud webhooks (aceptado o rechazado).
   • Respuesta sobre la solicitud webhooks.

¿Cómo puedo seleccionar una caja para registrar de forma interna los pagos de los documentos emitidos por medio de API?

1. Ingresa al módulo Administración → API → Configuración.

2. En el campo Configuración de API selecciona una caja donde serán registrados los pagos de los documentos emitidos por medio de API:

   

3. Haz clic en Guardar para guardar la configuración.

Preguntas frecuentes

• ¿Qué hago si creé la llave API y no guardé las credenciales generadas? → Una vez creada la llave API no es posible acceder a la información generada, por lo tanto tendrás que eliminar esa llave API y crear una nueva y asegurarte de copiar los datos.
• ¿Cómo puedo acceder a la documentación API? → Puedes acceder a la documentación API en el siguiente enlace: https://facto.cl/documentacion/api/es/bienvenida/.
• ¿Cómo puedo hacer integraciones API de prueba? → Debes usar las credenciales de prueba que puedes obtener del siguiente enlace https://facto.cl/documentacion/api/es/referencia-api/sandbox/, con estas podrás realizar las integraciones de prueba.
• ¿Dónde puedo ver los precios de los planes de Facto que incluyen integración API? → En el siguiente enlace https://facto.cl/precios/ puedes visualizar los precios de los planes actuales de Facto.
• ¿Qué e-commerces tienen integración directa con Facto? → Puedes integrar de forma sencilla los siguientes e-commerce: Mercado Libre, Jumpseller, Woocommerce, Prestashop, Shopify y TiendaNube.
• ¿Hay algún ERP para constructoras que se pueda integrar a Facto? → Sí, Facto tiene integración directa con Magistra ERP, para obtener más información te recomendamos que te comuniques con [email protected].
• ¿Qué hago si mis documentos emitidos por medio de API aparecen impagos en Facto? → Debes configurar una caja receptora de pagos, de esa forma al emitir un DTE por medio de API este se generará pagado en Facto. La configuración se realiza en el módulo Administración → API → Configuración.
• Al presionar "Cargar bodegas" aparece "La tienda no tiene la app Facto instalada o configurada", ¿qué hago? → Verifica que la URL sea la URL interna https://tutienda.myshopify.com y que la app Facto esté instalada en esa tienda con la pestaña API configurada y guardada.
• Al presionar "Cargar bodegas" aparece "El usuario o la clave no coinciden", ¿qué hago? → Ingresa exactamente el Resource Owner Name y el Resource Owner Password guardados en la pestaña API de la app Facto en Shopify. No uses tu usuario y contraseña de Facto.
• Al presionar "Cargar bodegas" aparece "No fue posible obtener las bodegas de Shopify", ¿qué hago? → Abre la app Facto en el administrador de Shopify para renovar la conexión y vuelve a intentarlo. Si el problema continúa, escríbenos a [email protected].
• ¿Por qué una suscripción antigua de Shopify dice "Shopify: automática (primera activa)"? → Fue creada antes de que existiera la opción de elegir bodega, por lo que el stock se actualiza en la primera bodega activa de tu tienda. Edítala y selecciona la bodega que corresponda.
• ¿Cómo puedo saber el detalle de error de una solicitud API? → Se puede obtener el detalle de error de una solicitud API desde el módulo Administración → API → Logs API haciendo clic en el botón Vista Respuesta del log que se requiera revisar.