Back

API disponibles relacionades amb les despeses

Explora diverses API que et poden ajudar a gestionar i fer un seguiment eficaç de les despeses per a ús personal o empresarial.

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


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

 

Was this article helpful?

Give feedback about this article

Can’t find what you’re looking for?

Our customer care team is here for you.

Contact us

Knowledge Base Software powered by Helpjuice