Ayuda - Preguntas / Respuestas


Integraciones y API

Preguntas :

Tempolia ofrece varias soluciones para la integración con su software de contabilidad, reunidas en « Herramientas > Exportación de facturas a contabilidad ». Usted elige su software y Tempolia selecciona el formato adecuado.

Captura Tempolia: La página de exportación contable para elegir perímetro y formato.
La página de exportación contable para elegir perímetro y formato.

El método estándar es la exportación de archivos, CSV o TXT, que contienen los asientos contables, como cuentas de clientes 411, cuentas de ingresos 7xx e IVA, que después puede importar en su sistema contable.

Tempolia desarrolla activamente integraciones mediante API con los principales softwares contables franceses, incluidos Fulll, Cegid Loop, ACD, Sage, Pennylane, MyUnisoft e Inqom. El uso de API permite transferir automáticamente asientos, facturas, pagos y gastos a su software contable desde la emisión de las facturas, reduciendo considerablemente el trabajo manual. Algunas API incluso permiten recuperar durante la noche datos como clientes y colaboradores desde su software contable hacia Tempolia. Aunque la API suele ser más eficiente, algunas pueden ser a veces bastante lentas.

Captura Tempolia: Las facturas listas para exportar a contabilidad.
Las facturas listas para exportar a contabilidad.

La oferta Tempolia Enterprise incluye nuestras interconexiones con las API de los softwares contables.

Para utilizar la API Fulll, solo tiene que contactar con Fulll para activar su API. Podrá conectarse desde Tempolia con sus credenciales habituales de Fulll y realizar sus exportaciones sin ninguna otra configuración. Para otras API de exportación contable, normalmente debe seguir las indicaciones del editor de su software contable para crear una clave API y una contraseña para que podamos configurar el acceso. Después podrá utilizar la API para la exportación a contabilidad.

Captura Tempolia: Los pagos listos para exportar a contabilidad.
Los pagos listos para exportar a contabilidad.

Puede recuperar automáticamente la producción del área laboral desde el software de nómina Silae dentro de la oferta Enterprise.

Captura de Tempolia que muestra la página de importación Silae y sus correspondencias de producción social
La página de importación Silae y sus correspondencias de producción social.

Respecto a la API Silae, puede suscribirse a su API REST dirigida a despachos. Deberá contactar con Silae para obtener sus credenciales de conexión a la API y transmitírnoslas para que podamos integrarlas en nuestro sistema. Nota: el acceso a su API puede ser facturado aparte por Silae, pero según nuestra información la API despacho no es de pago para nuestro uso, es decir, nivel 1 según su codificación. Para información, la documentación de la API de Silae está disponible en https://silae-api.document360.io/docs

Por nuestra parte, llamamos a las funcionalidades de su API para recuperar la producción de su área laboral, con el fin de conocer lo que desea facturar, normalmente nóminas emitidas, entradas y salidas. Después hacemos una correspondencia con las tareas definidas en Tempolia y para las que haya configurado sus tarifas de venta.

Captura Tempolia: Los precios de tareas por cantidad utilizados después de la importación Silae.
Los precios de tareas por cantidad utilizados después de la importación Silae.

Durante la importación, la correspondencia de expedientes entre Silae y Tempolia se hace:

  • automáticamente si el código cliente en Tempolia es idéntico al código expediente en Silae
  • mediante el campo "Código SILAE". Este campo se rellena en la pestaña "Características parametrizables" de las fichas de clientes de Tempolia para indicar un código expediente específico en Silae. Puede completarse manualmente o importando un archivo CSV de 2 columnas: código cliente en Tempolia y código expediente en Silae.
Captura Tempolia: Las correspondencias de códigos de venta usadas durante la importación Silae.
Las correspondencias de códigos de venta usadas durante la importación Silae.

Para realizar la importación:
Vaya a « Herramientas > Importación de la producción social de Silae » e indique el intervalo de fechas en el que desea recuperar su producción de Silae, así como un colaborador al que se asociarán ficticiamente las líneas creadas.

Puedes enviar tus facturas de Factur-X en el sitio web de Chorus Pro, que es la plataforma estatal para enviar facturas.

Captura Tempolia: La lista de facturas y estados que revisar tras un rechazo de Chorus Pro.
La lista de facturas y estados que revisar tras un rechazo de Chorus Pro.

Dependiendo de la naturaleza de tus clientes, es posible que el número de compromiso y el servicio El código es obligatorio.
Los mensajes de Chorus Pro no son muy explícitos, hay que mirar el nombre del campo que falta y deducir la información que falta:

Captura Tempolia: Rechazos Chorus Pro acciones PA recordatorio.
Rechazos Chorus Pro acciones PA recordatorio.
  • El mensaje "Compromiso legal (FichierXml.SupplyChainTradeTransaction .ApplicableHeaderTradeAgreement .BuyerReference.value) es obligatorio" significa que debes rellenar el código de servicio en la pestaña Características configurables de la hoja Negocios de tu factura.
  • El mensaje "El compromiso legal (Archivo Xml. SupplyChainTradeTransaction. ApplyHeaderTradeAgreement.BuyerOrderReferencedDocument.IssuerAssignedID.value) es obligatorio" significa que debes completar el número de compromiso en la pestaña Características configurables de la hoja Negocios de tu factura.

Después de modificar tus datos, regenera el PDF de tu factura y vuelva a enviarla a Chorus Pro.

Captura Tempolia: Rechazos Chorus Pro historico PA errores.
Rechazos Chorus Pro historico PA errores.

Tempolia expone los tiempos realizados o presupuestados de un colaborador mediante un enlace de calendario ICS compartido de solo lectura. El formato ICS, también llamado iCal y regido por la RFC 5545, es un formato internacional que permite a los calendarios intercambiar información; no debe confundirse con ICS, Identificador de Acreedor SEPA, que identifica a una sociedad que emite adeudos.

Captura de Tempolia que muestra la pestaña Calendario de la ficha del colaborador con enlaces ICS
La pestaña Calendario de la ficha del colaborador con enlaces ICS.

Para recuperar la URL ICS y añadirla a su calendario: vaya a "Colaboradores > Colaboradores", edite un colaborador y abra la pestaña "Calendario". Encontrará dos enlaces: "Calendario ICS de tiempos realizados" y "Calendario ICS de tiempos presupuestados". Puede copiar estos enlaces y utilizarlos en Office 365 o Google Calendar mediante funciones que suelen llamarse "Suscribirse desde la web" u "Otros calendarios > Desde URL".

Captura Tempolia: Calendario colaborador agenda Tempolia.
Calendario colaborador agenda Tempolia.

El flujo es de solo lectura: las modificaciones se realizan únicamente en Tempolia. La frecuencia de actualización depende de Outlook / Google y no es instantánea.

Nota: no es posible hacer lo contrario, es decir, visualizar datos de Office 365 o Google Calendar en Tempolia, porque esos calendarios no tienen todos los campos necesarios para completar los datos esperados en Tempolia.

Tempolia tiene una colaboración con el servicio de firma electrónica jesignexpert.com, dirigido exclusivamente a despachos de expertos contables en Francia. Si es elegible, ha abierto una cuenta con ellos y utiliza Tempolia Enterprise, puede hacer firmar documentos PDF mediante jesignexpert.com permaneciendo en la interfaz de Tempolia. Para la puesta en marcha, envíe al soporte de Tempolia el shortcut y el secret de su API Jesignexpert, recibidos tras crear su cuenta jesignexpert.com.

Captura de Tempolia que muestra la lista de presupuestos usada en el flujo de firma electrónica
La lista de presupuestos usada en el flujo de firma electrónica.

Una vez activada la interconexión, puede ir a la página « Herramientas > Firma de documentos ». Cargue su documento en formato PDF, por ejemplo un presupuesto, una carta de encargo o un contrato, e introduzca la información del firmante: apellidos, nombre, dirección de correo electrónico y número de teléfono móvil. Puede indicar hasta 5 firmantes, y el número móvil es necesario para cada firmante porque se utiliza en el procedimiento de firma.

Cada firmante recibe después una notificación de jesignexpert.com con un enlace seguro que le permite acceder al documento, consultarlo y firmarlo electrónicamente, sin crear una cuenta. Una vez realizada la firma, el documento queda fechado y certificado. Usted recibe una notificación por correo electrónico confirmando la firma, y el documento firmado se archiva automáticamente en su espacio.

También puede seguir en todo momento el estado de avance de sus solicitudes de firma desde la interfaz de Tempolia, especialmente para saber si un documento está pendiente, en proceso de firma, rechazado o terminado.

Captura Tempolia: Firma electronica cartas mision formulario.
Firma electronica cartas mision formulario.

La firma electrónica realizada es totalmente desmaterializada y tiene un valor jurídico reconocido. Las firmas se escribirán en la parte inferior de la última página del PDF; asegúrese de dejar espacio libre para que se añada ese texto. Lo que da fe es la justificación por jesignexpert.com del proceso de firma, y no la simple adición de los textos de firma en el PDF.

Captura Tempolia: Firma electronica presupuestos estado seguimiento.
Firma electronica presupuestos estado seguimiento.

El servidor MCP de Tempolia, Model Context Protocol, permite a una IA externa, como Claude, ChatGPT, Gemini, Grok o cualquier otro agente compatible con MCP, interactuar directamente con su base Tempolia para leer o realizar acciones, como creación o modificación. No está autorizado el uso de un robot, agente automatizado o scraping de la interfaz web. Para cualquier uso automatizado o pilotado por su IA de los datos presentes en Tempolia, lo adecuado es utilizar el MCP, que es la interfaz oficial para que su IA pueda manipular sus datos y realizar acciones. En cambio, para interactuar con sus datos de Tempolia mediante un software tercero distinto de un motor de IA, nuestra API es adecuada y requiere desarrollos.

El uso del MCP es independiente de Tempolia AI: puede conectar cualquier IA compatible con MCP a su servidor Tempolia para automatizar acciones, consultar sus datos o integrar Tempolia en sus agentes inteligentes.

Para utilizar el servidor MCP de Tempolia, primero debe activarlo, sin coste adicional: « Configuración > Opciones generales », pestaña « Varios ». Una vez activado, el acceso al servidor MCP está disponible para cada colaborador.

Captura de Tempolia que muestra las opciones de activación MCP y Tempolia AI
Las opciones de activación MCP y Tempolia AI.

En la ficha del colaborador, aparece una nueva pestaña "Tempolia AI" en la página "Colaboradores > Colaboradores > ficha colaborador > pestaña Tempolia AI".
En esta pestaña se indican:
- la URL personalizada del servidor MCP
- la clave de autenticación
- información explicativa
También hay una sección específica para el uso con Claude.

Captura de Tempolia que muestra la pestaña Tempolia AI del colaborador con la URL MCP ocultada
La pestaña Tempolia AI del colaborador con la URL MCP ocultada.

Cada servidor MCP está asociado a un colaborador y a sus derechos. Por tanto, la IA actúa exactamente como ese usuario en Tempolia: todas las reglas de negocio y restricciones de derechos se aplican igual que en la interfaz web.

Captura Tempolia: MCP Tempolia AI interfaz chat.
MCP Tempolia AI interfaz chat.

Para conectar su IA, basta con declarar este servidor MCP en su herramienta de IA proporcionando la URL y la clave de autenticación, según el procedimiento previsto por el LLM utilizado. Una vez conectada, la IA consulta automáticamente el servidor MCP para descubrir las funcionalidades disponibles, herramientas, parámetros y formatos de datos. Este autodescubrimiento forma parte del estándar MCP y depende de los derechos del colaborador utilizado.

El MCP le permite interactuar con su base Tempolia como si estuviera conectado con un colaborador determinado: los derechos, restricciones y reglas de negocio aplicados en la interfaz también se aplican mediante MCP. Por tanto, debe prestar atención a los derechos del perfil utilizado.

Captura de Tempolia que muestra la pestaña Tempolia AI que muestra que MCP respeta los derechos del colaborador
La pestaña Tempolia AI que muestra que MCP respeta los derechos del colaborador.

Las acciones de lectura pueden realizarse directamente. Las acciones que modifican la base, creación, modificación o eliminación, requieren confirmación antes de su ejecución cuando son llamadas por Tempolia AI.
Si utiliza el servidor MCP mediante su propia IA, debe dar instrucciones a su IA para que solicite su confirmación y limite las operaciones que desea que realice.

Captura Tempolia: MCP acciones Tempolia AI chat.
MCP acciones Tempolia AI chat.
Dominio Operaciones posibles vía MCP Ejemplos de uso
SociedadesBúsqueda, lectura, creación, modificación, eliminaciónActualizar una dirección, un IBAN, un estado
ClientesBúsqueda, lectura, creación, modificación, eliminaciónCorregir una dirección, indicar un email de facturación, modificar parámetros
ExpedientesBúsqueda, lectura, creación, modificación, eliminaciónCrear un expediente, modificar su estado o sus parámetros
ColaboradoresBúsqueda, lectura, creación, modificación, eliminaciónActualizar grupo, función o información asociada
ReferencialesBúsqueda, lectura, creación, modificación, eliminaciónGestionar familias de clientes, grupos, sectores o actividades
CódigosBúsqueda y lecturaEncontrar un código de venta o una tarea facturable o no facturable
TiemposBúsqueda, lectura, creación, modificación, eliminaciónConsultar, corregir o introducir tiempos realizados o presupuestados
GastosBúsqueda, lectura, creación, modificación, eliminaciónConsultar o introducir gastos incurridos o presupuestados
FacturaciónBúsqueda y lecturaConsultar facturas emitidas y líneas de factura
Facturas pendientes de validarBúsqueda, lectura, creación, modificación, eliminaciónPreparar o modificar facturas antes de validarlas
PresupuestosBúsqueda, lectura, creación, modificación, eliminaciónConsultar o gestionar presupuestos y líneas de presupuesto
PagosLecturaConsultar cierta información vinculada a pagos
InformesLecturaLanzar ediciones como balance de antigüedad, saldos de clientes o diario de ventas
Búsqueda SIRET / SIRENLecturaEncontrar la denominación y dirección de una sociedad

El MCP es la interfaz oficial para interactuar con Tempolia desde una IA. Para cualquier solicitud, indique simplemente el colaborador afectado y la acción deseada.

Captura Tempolia: MCP derechos login colaboradores.
MCP derechos login colaboradores.