Aquí encontrará un resumen completo de las API públicas que puede usar con Factorial para crear integraciones de gastos, automatizaciones, exportaciones y flujos en tiempo real. Le guiará a las páginas de documentación adecuadas y le recomendará los puntos de conexión y las funciones que puede usar en los casos más comunes.
Consulta las guías para desarrolladores de Factorial para obtener una orientación rápida: Primeros pasos, Autenticación (claves API y OAuth), Webhooks, Paginación y creación de integraciones. Estas guías muestran los flujos recomendados, los métodos de autenticación y las notas de implementación. Factorial
Recursos principales de la API que utilizarás para Gastos
La referencia de la API presenta los recursos más útiles para la automatización y conciliación de gastos. Entre los recursos clave se incluyen:
- Gastos y Gastables (leer e inspeccionar registros de gastos)
- Puntos finales de kilometraje y viáticos para datos programáticos de viáticos y kilometraje
- Documentos para adjuntar y URL de descarga
- Puntos finales bancarios como CardPayment y Transaction para conciliar la actividad de la tarjeta
- Puntos finales financieros como JournalEntry , FinancialDocument , AccountingSetting y CostCenter para contabilización y mapeo
Encontrará la lista completa de recursos en la referencia de la API. Factorial
Casos de uso prácticos y puntos finales recomendados
- Exportación de gastos programáticamente
- Utilice los puntos de conexión Gastos/Gastables para extraer datos a nivel de transacción. Incluya campos como importe del documento, importe reembolsable, moneda, tipo de cambio, estado de aprobación, enlace entre recibos y documentos, códigos contables y proyecto/centro de coste. Compruebe si el recurso admite solo GET o la creación/actualización según la referencia.
- Manejo de archivos adjuntos y recibos
- Utilice el recurso Documentos para obtener URL de descarga o vincular documentos a gastos. Si necesita archivos adjuntos incrustados para un ERP, considere solicitar un extracto SQL personalizado o empaquetado a través de Factorial en lugar de descargar repetidamente archivos adjuntos binarios mediante la API.
- Conciliación de transacciones con tarjetas
- Utilice los puntos finales bancarios (Pago con tarjeta, Transacción) para comparar las fuentes de datos del emisor/tarjeta con los registros de gastos. Incluya card_last4 y los identificadores de transacción en sus exportaciones para una coincidencia fiable.
- Automatización de dietas y kilometraje
- Extraiga los puntos finales de PerDiem y Mileage para conciliar los reclamos de per diem con los recibos enviados y para calcular los ajustes de nómina cuando sea necesario.
- Notificaciones en tiempo real y sincronizaciones bidireccionales
- Suscríbete a los webhooks para recibir notificaciones sobre "expense.created", "expense.updated", "card.payment" o eventos similares (consulta la guía de webhooks). Usa los webhooks para activar flujos de trabajo posteriores, como alertas de Slack, creación de facturas o tareas del programador.
Notas de implementación importantes y mejores prácticas
- Autenticación : utilice claves API u OAuth, como se describe en las guías de introducción. Rote las claves y siga las prácticas recomendadas de almacenamiento seguro. Factorial
- Verificar las capacidades de los recursos : algunos puntos finales son de solo lectura, mientras que otros aceptan POST/PUT. Confirmar en la referencia antes de codificar. Factorial
- Paginación : Implemente siempre la paginación en los puntos finales de lista para evitar tiempos de espera o datos incompletos. Consulte la guía de paginación para obtener más información. Factorial
- Webhooks : Use suscripciones de webhooks para flujos en tiempo real e implemente controladores idempotentes. Consulte las políticas y ejemplos de webhooks en la documentación. Factorial
- Versiones y registro de cambios : Vincula las solicitudes a una versión específica de la API y supervisa el registro de cambios para detectar cambios importantes. Consulta el registro de cambios con frecuencia durante el desarrollo y antes de las implementaciones en producción. Factorial
- Campos de exportación a solicitud : incluya importe_documento, importe_reembolsable, moneda, tipo_de_cambio, importe_base, URL_recibo, estado_aprobación, código_de_cuenta_contable, código_de_proyecto, centro_de_costo y últimos 4_tarjetas para una conciliación posterior limpia. (Estos campos son recomendados, no requisitos estrictos de la API).
Manejo de errores y consejos operativos
- Detecta y concilia diferencias de divisas incluyendo
document_amount
ybase_amount
conexchange_rate
. - Para extracciones históricas de gran tamaño, es preferible contar con informes de SQL Analytics programados o del equipo de datos en lugar de extracciones de API grandes y repetidas.
- Pueden aplicarse límites de velocidad, cuotas o accesos especiales. Consulta las guías de inicio y la referencia de la API para obtener información sobre el uso. Factorial
Dónde encontrar detalles y realizar un seguimiento de los cambios
- Guías para desarrolladores y guías de inicio rápido: Páginas de introducción. Factorial
- Referencia completa de endpoints y lista de recursos: Referencia de API. Factorial
- Historial de versiones y registro de cambios importantes: Registro de cambios. Factorial
¿Necesitas ayuda o quieres un extracto personalizado?
Si necesita un archivo CSV/XLSX programado, archivos adjuntos incrustados o una combinación compleja de gastos y transacciones con tarjeta, solicite un informe personalizado de SQL Analytics a través del soporte. Para consultas técnicas sobre la API, utilice el formulario de contacto/soporte técnico en la documentación. Factorial