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.

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

1. 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.
2. 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.
3. 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.
4. 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.
5. 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 y base_amount con exchange_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