Aquí trobareu un resum únic de les API públiques que podeu utilitzar amb Factorial per crear integracions de despeses, automatitzacions, exportacions i fluxos en temps real. Us indica les pàgines de documentació adequades i recomana quins punts finals i funcions utilitzar per als escenaris més comuns.
Comença amb les guies per a desenvolupadors de Factorial per a una orientació ràpida: Introducció, Autenticació (claus API i OAuth), Webhooks, Paginació i creació d'integracions. Aquestes guies mostren els fluxos recomanats, els mètodes d'autenticació i les notes d'implementació. Factorial
Recursos principals de l'API que utilitzaràs per a les despeses
La referència de l'API exposa els recursos que són més útils per a l'automatització i la reconciliació de despeses. Els recursos clau inclouen:
- Despeses i comptes de despeses (llegir i inspeccionar els registres de despeses)
- Punts finals de quilometratge i per diem per a dades de per diem i quilometratge programàtiques
- Documents per adjuntar-los i URL de descàrrega
- Punts finals bancaris com ara pagament amb targeta i transaccions per conciliar l'activitat de la targeta
- Punts finals de finances com ara JournalEntry , FinancialDocument , AccountingSetting i CostCenter per a la publicació i el mapatge.
Trobareu la llista completa de recursos a la referència de l'API. Factorial
Casos d'ús pràctics i punts finals recomanats
- Exportació de despeses mitjançant programàtica
- Utilitzeu els punts finals Despeses / Despeses disponibles per obtenir dades a nivell de transacció. Incloeu camps com l'import del document, l'import reemborsable, la moneda, el tipus de canvi, l'estat d'aprovació, l'enllaç de rebut/document, els codis comptables i el centre de projecte/cost. Comproveu si el recurs només admet GET o si es crea/actualitza en funció de la referència.
- Gestió d'adjunts i rebuts
- Feu servir el recurs Documents per recuperar URL de descàrrega o per vincular documents a despeses. Si necessiteu fitxers adjunts incrustats per a un ERP, considereu la possibilitat de sol·licitar un extracte SQL/empaquetat personalitzat a través de Factorial en comptes de descarregar repetidament fitxers adjunts binaris a través de l'API.
- Conciliació de transaccions amb targeta
- Utilitzeu els punts finals bancaris (CardPayment, Transaction) per comparar els feeds de l'emissor/targeta amb els registres de despeses. Incloeu card_last4 i els identificadors de transacció a les vostres exportacions per a una coincidència fiable.
- Automatització de dietes i quilometratge
- Extraieu els punts finals de PerDiem i Mileage per reconciliar les reclamacions de per diem amb els rebuts presentats i per calcular els ajustos de nòmina quan sigui necessari.
- Notificacions en temps real i sincronitzacions bidireccionals
- Subscriu-te als webhooks per rebre notificacions de expense.created, expense.updated, card.payment o esdeveniments similars (consulta la guia de Webhooks). Fes servir els webhooks per activar fluxos de treball posteriors com ara alertes de Slack, creació de factures o tasques de planificació.
Notes d'implementació importants i bones pràctiques
- Autenticació : utilitzeu claus API o OAuth tal com es documenta a les guies d'introducció. Roteu les claus i seguiu les millors pràctiques d'emmagatzematge segur. Factorial
- Comproveu les capacitats dels recursos : alguns punts finals són de només lectura mentre que d'altres accepten POST/PUT. Confirmeu-ho a la referència abans de codificar. Factorial
- Paginació : implementeu sempre la paginació per als punts finals de la llista per evitar temps d'espera o dades parcials. Utilitzeu la guia de paginació per obtenir més informació. Factorial
- Webhooks : utilitzeu subscripcions a webhooks per a fluxos en temps real i implementeu controladors idempotents. Vegeu les polítiques i els exemples de webhooks a la documentació. Factorial
- Control de versions i registre de canvis : vincula les sol·licituds a una versió específica de l'API i supervisa el registre de canvis per detectar canvis importants. Revisa el registre de canvis amb freqüència durant el desenvolupament i abans de les implementacions en producció. Factorial
- Exporta els camps a la sol·licitud : inclou document_amount, reimbursable_amount, currency, exchange_rate, base_amount, receive_url, approval_status, accounting_account_code, project_code, cost_center, card_last4 per a una reconciliació posterior neta. (Aquests són camps recomanats, no requisits estrictes de l'API.)
Gestió d'errors i consells operatius
- Detecta i reconcilia les diferències de divises incloent tant
document_amount
combase_amount
ambexchange_rate
. - Per a grans extractes històrics, és preferible que els informes programats de SQL Analytics o l'equip de dades siguin més que no pas les extraccions repetides de grans quantitats d'API.
- Es poden aplicar límits de tarifa, quotes o accés especial. Consulteu les guies d'introducció i la referència de l'API per obtenir notes d'ús. Factorial
On puc trobar detalls i fer un seguiment dels canvis
- Guies per a desenvolupadors i inicis ràpids: pàgines d'introducció. Factorial
- Referència completa de punts finals i llista de recursos: Referència de l'API. Factorial
- Historial de versions i registre de canvis importants: Registre de canvis. Factorial
Necessites ajuda o vols un extracte personalitzat?
Si necessiteu un fitxer CSV/XLSX programat, fitxers adjunts incrustats o una unió complexa entre despeses i transaccions amb targeta, sol·liciteu un informe SQL Analytics personalitzat a través del servei d'assistència. Per a preguntes tècniques sobre l'API, utilitzeu el formulari de contacte/assistència tècnica que trobareu a la documentació. Factorial