API

Conecta FACTO con otros sistemas (tiendas online, ERP o software propio) a través de llaves de acceso a la API. Desde esta sección puedes crear y administrar tus llaves API, revisar el historial de documentos generados por API, consultar los logs de solicitudes, configurar webhooks y ajustar el comportamiento general del servicio.

Pantalla de Servicios API en FACTO mostrando el listado de llaves de acceso

¿Cuándo usar esta sección?

Úsala cuando:

Necesitas conectar FACTO con una tienda online (Woocommerce, Shopify, Jumpseller, Tienda Nube, Prestashop, Mercado Libre, etc.) o con tu propio software.
Debes crear una llave de acceso para que un sistema externo pueda emitir o consultar documentos en FACTO.
Quieres revisar qué documentos se generaron a través de la API o diagnosticar un error en una integración.
Necesitas configurar notificaciones automáticas (webhooks) hacia otro sistema cuando ocurre un evento en FACTO.

No la uses para:

Importar o exportar datos en bloque desde un archivo Excel. Eso se hace en Herramientas.
Configurar el certificado digital de la empresa. Eso se hace en Certificados digitales.

Cómo acceder

Ve a Administración → API.

Diferencia entre llave API SOAP y llave API REST

FACTO permite crear dos tipos de llave de acceso, según el protocolo que use el sistema con el que te vas a integrar:

Tipo de llave	Credenciales que genera	Uso típico
Llave API SOAP	Login y Contraseña (autogenerados)	Integraciones que consumen el servicio SOAP de FACTO
Llave API REST	Account ID, Resource Owner Name, Resource Owner Password, Client Identification y Client Secret (autogenerados)	Integraciones que consumen la API REST de FACTO (plugins de tiendas online, software propio)

Ambos tipos de llave se asocian a un certificado digital de la empresa y a un propósito (la plataforma o software con el que te integras).

Atención: Las credenciales se generan automáticamente y no se pueden editar. Cópialas y guárdalas en un lugar seguro apenas se crean — algunos campos, como la contraseña de una llave SOAP, no vuelven a mostrarse.

Pestañas disponibles

Dentro de Administración → API encontrarás las siguientes pestañas:

Pestaña	¿Para qué sirve?
Llaves de acceso API	Lista tus llaves SOAP y REST, y permite crear nuevas
Historial de API	Muestra los documentos (facturas, boletas, etc.) generados a través de la API, filtrando por usuario, tipo y fecha
Logs API	Muestra el detalle técnico de las solicitudes enviadas a la API y las respuestas recibidas, filtrando por rango de fechas
Webhooks	Permite crear suscripciones para recibir notificaciones automáticas cuando ocurren eventos en FACTO, como cambios de stock, nuevos clientes o nuevos productos
Logs Webhooks	Muestra el estado de los eventos enviados a tus webhooks (actualizado, pendiente, rechazado) y permite reintentar un envío
Configuración	Define el comportamiento general del servicio de API: generación de borradores, marcado de documentos pagados y notificaciones por correo

💡 Consejo: La pestaña Webhooks puede aparecer bloqueada, con un ícono de candado, si tu cuenta no tiene activo el complemento de Webhooks. Consulta con soporte o revisa tu plan para habilitarlo.

Crear una llave API SOAP paso a paso

Ve a Administración → API → Llaves de acceso API.
Haz clic en Crear Llave API SOAP.
Selecciona el Propósito de la llave (por ejemplo, Woocommerce, Shopify, Mercado Libre, Software Propio, Otro, entre otros).
FACTO genera automáticamente el Login y la Contraseña de la llave — cópialos y guárdalos, la contraseña no se mostrará nuevamente.
Selecciona el certificado digital asociado.
Marca los permisos que tendrá la llave (por defecto quedan todos marcados).
Haz clic en Agregar.

Crear una llave API REST paso a paso

Ve a Administración → API → Llaves de acceso API.
Haz clic en Crear Llave API REST.
Selecciona el Propósito de la llave.
FACTO muestra el Account ID de tu cuenta y genera automáticamente el Resource Owner Name, Resource Owner Password, Client Identification y Client Secret.
Selecciona el certificado digital asociado.
Haz clic en Guardar.

Propósito y permisos de las llaves

Cada llave API que creas tiene:

Un propósito, que identifica con qué plataforma o software se usará (Jumpseller, Magento, Magistra, Mercado Libre, Opencart, Prestashop, Shopify, Tienda Nube, Woocommerce, Software Propio u Otro).
Un certificado digital asociado, necesario para firmar los documentos que se emitan a través de esa llave.
Un conjunto de permisos, que determina qué acciones puede realizar esa llave dentro de FACTO.

En el listado de Llaves de acceso API puedes distinguir cada llave por su tipo (SOAP o REST) y su propósito.

Acciones disponibles sobre una llave

Desde la columna de acciones del listado de llaves puedes:

Acción	¿Qué hace?
Administrar plugin	Abre la configuración del plugin de la tienda asociada al propósito de la llave. Disponible para integraciones como Mercado Libre, Jumpseller, Shopify, Tienda Nube, Prestashop y Woocommerce
Instrucciones instalación	Abre la guía de instalación e integración correspondiente al propósito de la llave
Borrar	Elimina la llave API. Pide confirmación antes de eliminarla

Atención: Al eliminar una llave, cualquier integración que la esté usando dejará de funcionar de inmediato. Verifica que no esté en uso antes de borrarla.

Configuración del servicio de API

En la pestaña Configuración puedes ajustar:

Generación de borradores: define qué ocurre si se intenta generar un documento vía API y no hay folios CAF disponibles o el certificado digital no es válido. Puedes optar por generar un borrador que deberás cerrar manualmente, o no generar borrador y exigir que el documento se vuelva a emitir.
Configuración de API: selecciona la caja que se usará para marcar como pagado un documento generado por API (o dejarlo sin marcar), y define si se permite generar documentos con el mismo número de pedido.
Configuración de correo: define un correo adicional para enviar copias, y el texto que se incluirá en los nuevos correos de envío de documentos.

Preguntas frecuentes

¿Cuál es la diferencia entre una llave SOAP y una REST? → La llave SOAP genera un Login y una Contraseña para integraciones que usan el servicio SOAP de FACTO. La llave REST genera credenciales tipo cliente (Client Identification, Client Secret, Resource Owner Name y Password) para integraciones que usan la API REST.
¿Puedo crear más de una llave API? → Sí. Puedes crear varias llaves SOAP y REST según la cantidad de integraciones que necesites.
¿Qué pasa si elimino una llave API? → La integración que la usaba deja de funcionar de inmediato. No se puede recuperar una llave eliminada; deberás crear una nueva.
¿Por qué no veo la pestaña Webhooks? → Aparece bloqueada si tu cuenta no tiene activo el complemento de Webhooks.
¿Puedo reintentar el envío de un webhook que falló? → Sí, desde Logs Webhooks puedes revisar el estado de cada evento y reintentar su envío si quedó pendiente o fue rechazado.

API