libofx.h

Go to the documentation of this file.

/*-*-c-*-*******************************************************************
              libofx.h  -  Main header file for the libofx API
                             -------------------
    copyright            : (C) 2002-2011 by Benoit Grégoire
    email                : benoitg@coeus.ca
***************************************************************************/
/***************************************************************************
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 ***************************************************************************/
 
#ifndef LIBOFX_H
#define LIBOFX_H
#include <time.h>
 
#define LIBOFX_MAJOR_VERSION 0
#define LIBOFX_MINOR_VERSION 10
#define LIBOFX_MICRO_VERSION 9
#define LIBOFX_BUILD_VERSION 0
#define LIBOFX_VERSION_RELEASE_STRING "0.10.9"
 
#ifdef IN_LIBOFX
#  include "config.h"
#  ifdef __GNUC__
#    pragma GCC visibility push(default)
#  endif
#endif
 
#ifdef LIBOFX_DLL
#  ifdef IN_LIBOFX
#     define LIBOFX_API __declspec(dllexport)
#  else 
#     define LIBOFX_API __declspec(dllimport)
#  endif
#else
#define LIBOFX_API
#endif
 
 
#ifdef __cplusplus
extern "C" {
#else
#define true 1
#define false 0
#endif
 
#define OFX_ELEMENT_NAME_LENGTH         100
#define OFX_SVRTID2_LENGTH             (36 + 1)
#define OFX_CHECK_NUMBER_LENGTH        (12 + 1)
#define OFX_REFERENCE_NUMBER_LENGTH    (32 + 1)
#define OFX_FITID_LENGTH               (255 + 1)
#define OFX_TOKEN2_LENGTH              (36 + 1)
#define OFX_MEMO_LENGTH                (255 + 1)
#define OFX_FIID_LENGTH                (32 + 1)
#define OFX_MEMO2_LENGTH               (390 + 1)
#define OFX_BALANCE_NAME_LENGTH        (32 + 1)
#define OFX_BALANCE_DESCRIPTION_LENGTH (80 + 1)
#define OFX_CURRENCY_LENGTH            (3 + 1) /* In ISO-4217 format */
#define OFX_BANKID_LENGTH              (9 + 1)
#define OFX_BRANCHID_LENGTH            (22 + 1)
#define OFX_ACCTID_LENGTH              (22 + 1)
#define OFX_ACCTKEY_LENGTH             (22 + 1)
#define OFX_BROKERID_LENGTH            (22 + 1)
  /* Must be MAX of <BANKID>+<BRANCHID>+<ACCTID>, <ACCTID>+<ACCTKEY> and <ACCTID>+<BROKERID> */
#define OFX_ACCOUNT_ID_LENGTH (OFX_BANKID_LENGTH + OFX_BRANCHID_LENGTH + OFX_ACCTID_LENGTH + 1)
#define OFX_ACCOUNT_NAME_LENGTH        255
#define OFX_MARKETING_INFO_LENGTH      (360 + 1)
#define OFX_TRANSACTION_NAME_LENGTH    (96 + 1)
#define OFX_UNIQUE_ID_LENGTH           (32 + 1)
#define OFX_UNIQUE_ID_TYPE_LENGTH      (10 + 1)
#define OFX_SECNAME_LENGTH             (120 + 1)
#define OFX_TICKER_LENGTH              (32 + 1)
#define OFX_ORG_LENGTH                 (32 + 1)
#define OFX_FID_LENGTH                 (32 + 1)
#define OFX_USERID_LENGTH              (32 + 1)
#define OFX_USERPASS_LENGTH            (32 + 1)
#define OFX_URL_LENGTH                 (500 + 1)
#define OFX_APPID_LENGTH               (32)
#define OFX_APPVER_LENGTH              (32)
#define OFX_HEADERVERSION_LENGTH       (32)
#define OFX_CLIENTUID_LENGTH           (36 + 1)
#define OFX_SECURITY_RATING_LENGTH     (32 + 1)
#define OFX_FIASSET_CLASS_LENGTH       (32 + 1)
#define OFX_LOANID_LENGTH              (32 + 1)
 
  /*
  #define OFX_STATEMENT_CB               0;
  #define OFX_ACCOUNT_CB                 1;
  #define OFX_TRACSACTION_CB             2;
  #define OFX_SECURITY_CB                3;
  #define OFX_STATUS_CB                  4;
  */
 
  typedef void * LibofxContextPtr;
 
  LibofxContextPtr libofx_get_new_context();
 
  int libofx_free_context( LibofxContextPtr );
 
  void libofx_set_dtd_dir(LibofxContextPtr libofx_context,
                          const char *s);
 
  enum LibofxFileFormat
  {
    AUTODETECT, 
    OFX, 
    OFC, 
    QIF, 
    UNKNOWN, 
    LAST 
  };
 
  struct LibofxFileFormatInfo
  {
    enum LibofxFileFormat format;
    const char * format_name;  
    const char * description; 
  };
 
 
#ifndef OFX_AQUAMANIAC_UGLY_HACK1
 
  const struct LibofxFileFormatInfo LibofxImportFormatList[] =
  {
    {AUTODETECT, "AUTODETECT", "AUTODETECT (File format will be automatically detected later)"},
    {OFX, "OFX", "OFX (Open Financial eXchange (OFX or QFX))"},
    {OFC, "OFC", "OFC (Microsoft Open Financial Connectivity)"},
    {QIF, "QIF", "QIF (Intuit Quicken Interchange Format) NOT IMPLEMENTED"},
    {LAST, "LAST", "Not a file format, meant as a loop breaking condition"}
  };
 
  const struct LibofxFileFormatInfo LibofxExportFormatList[] =
  {
    {QIF, "QIF", "QIF (Intuit Quicken Interchange Format) NOT IMPLEMENTED"},
    {LAST, "LAST", "Not a file format, meant as a loop breaking condition"}
  };
 
  enum LibofxFileFormat libofx_get_file_format_from_str(const struct LibofxFileFormatInfo format_list[], const char * file_type_string);
 
  const char * libofx_get_file_format_description(const struct LibofxFileFormatInfo format_list[], enum LibofxFileFormat file_format);
 
#endif
 
  int libofx_proc_file(LibofxContextPtr libofx_context,
                       const char * p_filename,
                       enum LibofxFileFormat ftype);
 
 
  struct OfxStatusData
  {
    char ofx_element_name[OFX_ELEMENT_NAME_LENGTH];
    int ofx_element_name_valid;
 
    int code;            
    const char* name;          
    const char* description;   
    int code_valid;      
    enum Severity
    {
      INFO, 
      WARN, 
      ERROR 
    } severity;
    int severity_valid;
 
    char* server_message; 
    int server_message_valid;
  };
 
 
  typedef int (*LibofxProcStatusCallback)(const struct OfxStatusData data, void * status_data);
 
  struct OfxAccountData
  {
 
    char account_id[OFX_ACCOUNT_ID_LENGTH];
 
    char account_name[OFX_ACCOUNT_NAME_LENGTH];
    int account_id_valid;/* Use for both account_id and account_name */
 
    enum AccountType
    {
      OFX_CHECKING,  
      OFX_SAVINGS,   
      OFX_MONEYMRKT, 
      OFX_CREDITLINE,
      OFX_CMA,       
      OFX_CREDITCARD,
      OFX_INVESTMENT,
      OFX_401K       
    } account_type;
    int account_type_valid;
 
    char currency[OFX_CURRENCY_LENGTH];
    int currency_valid;
 
    char account_number[OFX_ACCTID_LENGTH];
    int account_number_valid;
 
    char bank_id[OFX_BANKID_LENGTH];
    int bank_id_valid;
 
    char broker_id[OFX_BROKERID_LENGTH];
    int broker_id_valid;
 
    char branch_id[OFX_BRANCHID_LENGTH];
    int branch_id_valid;
 
  };
 
  typedef int (*LibofxProcAccountCallback)(const struct OfxAccountData data, void * account_data);
 
  struct OfxSecurityData
  {
    enum SecurityType
    {
      OFX_DEBT_SECURITY,   
      OFX_FUND_SECURITY,   
      OFX_OPTION_SECURITY, 
      OFX_STOCK_SECURITY,  
      OFX_OTHER_SECURITY,  
    } security_type;
    int security_type_valid;
 
    char unique_id[OFX_UNIQUE_ID_LENGTH];   
    int unique_id_valid;
 
    char unique_id_type[OFX_UNIQUE_ID_TYPE_LENGTH];
    int unique_id_type_valid;
 
    char secname[OFX_SECNAME_LENGTH];
    int secname_valid;
 
    char ticker[OFX_TICKER_LENGTH];
    int ticker_valid;
 
    double unitprice;
    int unitprice_valid;
 
    char rating[OFX_SECURITY_RATING_LENGTH]; 
    int rating_valid;
 
    time_t date_unitprice;
    int date_unitprice_valid;
 
    char currency[OFX_CURRENCY_LENGTH];
    int currency_valid;
 
    double currency_ratio;
    int currency_ratio_valid;
 
    int amounts_are_foreign_currency;
    int amounts_are_foreign_currency_valid;
 
    char memo[OFX_MEMO2_LENGTH];
    int memo_valid;
 
    char fiid[OFX_FIID_LENGTH];
    int fiid_valid;
 
    enum AssetClass
    {
      OFX_ASSET_CLASS_DOMESTICBOND,
      OFX_ASSET_CLASS_INTLBOND,
      OFX_ASSET_CLASS_LARGESTOCK,
      OFX_ASSET_CLASS_SMALLSTOCK,
      OFX_ASSET_CLASS_INTLSTOCK,
      OFX_ASSET_CLASS_MONEYMRKT,
      OFX_ASSET_CLASS_OTHER
    } asset_class;
    int asset_class_valid;
 
    char fiasset_class[OFX_FIASSET_CLASS_LENGTH];
    int fiasset_class_valid;
 
    enum MutalFundType
    {
      OFX_MFTYPE_OPENEND,
      OFX_MFTYPE_CLOSEEND,
      OFX_MFTYPE_OTHER
    } mutual_fund_type;
    int mutual_fund_type_valid;
 
    enum StockType
    {
      OFX_STOCKTYPE_COMMON,
      OFX_STOCKTYPE_PREFERRED,
      OFX_STOCKTYPE_CONVERTIBLE,
      OFX_STOCKTYPE_OTHER
    } stock_type;
    int stock_type_valid;
 
    double yield;
    int yield_valid;
 
    time_t yield_asof_date;     
    int yield_asof_date_valid;
 
    double par_value;
    int par_value_valid;
 
    enum DebtType
    {
      OFX_DEBT_TYPE_COUPON,
      OFX_DEBT_TYPE_ZERO
    } debt_type;
    int debt_type_valid;
 
    enum DebtClass
    {
      OFX_DEBTCLASS_TREASURY,
      OFX_DEBTCLASS_MUNICIPAL,
      OFX_DEBTCLASS_CORPORATE,
      OFX_DEBTCLASS_OTHER
    } debt_class;
    int debt_class_valid;
 
    double coupon_rate;
    int coupon_rate_valid;
 
    time_t date_coupon;
    int date_coupon_valid;
 
    enum CouponFreq
    {
      OFX_COUPON_FREQ_MONTHLY,
      OFX_COUPON_FREQ_QUARTERLY,
      OFX_COUPON_FREQ_SEMIANNUAL,
      OFX_COUPON_FREQ_ANNUAL,
      OFX_COUPON_FREQ_OTHER
    } coupon_freq;
    int coupon_freq_valid;
 
    double call_price;
    int call_price_valid;
 
    double yield_to_call;
    int yield_to_call_valid;
 
    time_t call_date;
    int call_date_valid;
 
    enum CallType
    {
      OFX_CALL_TYPE_CALL,
      OFX_CALL_TYPE_PUT,
      OFX_CALL_TYPE_PREFUND,
      OFX_CALL_TYPE_MATURITY
    } call_type;
    int call_type_valid;
 
    double yield_to_maturity;
    int yield_to_maturity_valid;
 
    time_t maturity_date;
    int maturity_date_valid;
 
    enum OptionType
    {
      OFX_OPTION_TYPE_CALL,
      OFX_OPTION_TYPE_PUT
    } option_type;
    int option_type_valid;
 
    double strike_price;
    int strike_price_valid;
 
    time_t date_expire;
    int date_expire_valid;
 
    double shares_per_cont;
    int shares_per_cont_valid;
 
    char unique_id2[OFX_UNIQUE_ID_LENGTH];
    int unique_id2_valid;
 
    char unique_id2_type[OFX_UNIQUE_ID_TYPE_LENGTH];
    int unique_id2_type_valid;
 
  };/* end struct OfxSecurityData */
 
  typedef int (*LibofxProcSecurityCallback)(const struct OfxSecurityData data, void * security_data);
 
  typedef enum
  {
    OFX_CREDIT,     
    OFX_DEBIT,      
    OFX_INT,        
    OFX_DIV,        
    OFX_FEE,        
    OFX_SRVCHG,     
    OFX_DEP,        
    OFX_ATM,        
    OFX_POS,        
    OFX_XFER,       
    OFX_CHECK,      
    OFX_PAYMENT,    
    OFX_CASH,       
    OFX_DIRECTDEP,  
    OFX_DIRECTDEBIT,
    OFX_REPEATPMT,  
    OFX_OTHER       
  } TransactionType;
 
  typedef enum
  {
    OFX_BUYDEBT,        
    OFX_BUYMF,          
    OFX_BUYOPT,         
    OFX_BUYOTHER,       
    OFX_BUYSTOCK,       
    OFX_CLOSUREOPT,     
    OFX_INCOME,         
    OFX_INVEXPENSE,     
    OFX_JRNLFUND,       
    OFX_JRNLSEC,        
    OFX_MARGININTEREST, 
    OFX_REINVEST,       
    OFX_RETOFCAP,       
    OFX_SELLDEBT,       
    OFX_SELLMF,         
    OFX_SELLOPT,        
    OFX_SELLOTHER,      
    OFX_SELLSTOCK,      
    OFX_SPLIT,          
    OFX_TRANSFER,       
    OFX_INVBANKTRAN     
  } InvTransactionType;
 
  typedef enum
  {
    DELETE, 
    REPLACE 
  } FiIdCorrectionAction;
 
  struct OfxTransactionData
  {
 
    char account_id[OFX_ACCOUNT_ID_LENGTH];
    struct OfxAccountData * account_ptr; 
    int account_id_valid;
 
    TransactionType transactiontype;
    int transactiontype_valid;
 
    InvTransactionType invtransactiontype;
    int  invtransactiontype_valid;
 
    double units;
    int units_valid;
 
    double unitprice; 
    int unitprice_valid;
 
    double amount;    
    int amount_valid;
 
    char fi_id[OFX_FITID_LENGTH];  
    int fi_id_valid;
 
    char unique_id[OFX_UNIQUE_ID_LENGTH];
    int unique_id_valid;
    char unique_id_type[OFX_UNIQUE_ID_TYPE_LENGTH];
    int unique_id_type_valid;
 
    struct OfxSecurityData *security_data_ptr;  
    int security_data_valid;
 
    time_t date_posted;
    int date_posted_valid;
 
    time_t date_initiated;
    int date_initiated_valid;
 
    time_t date_funds_available;
    int date_funds_available_valid;
 
    char fi_id_corrected[OFX_FITID_LENGTH];
    int fi_id_corrected_valid;
 
    FiIdCorrectionAction fi_id_correction_action;
    int fi_id_correction_action_valid;
 
    char server_transaction_id[OFX_SVRTID2_LENGTH];
    int server_transaction_id_valid;
 
    char check_number[OFX_CHECK_NUMBER_LENGTH];
    int check_number_valid;
 
    char reference_number[OFX_REFERENCE_NUMBER_LENGTH];
    int reference_number_valid;
 
    long int standard_industrial_code;
    int standard_industrial_code_valid;
 
    char payee_id[OFX_SVRTID2_LENGTH];
    int payee_id_valid;
 
    char name[OFX_TRANSACTION_NAME_LENGTH];
    int name_valid;
 
    char memo[OFX_MEMO2_LENGTH];
    int memo_valid;
 
    double commission;
    int commission_valid;
 
    double fees;
    int fees_valid;
 
    double oldunits;     
    int oldunits_valid;
 
    double newunits;     
    int newunits_valid;
 
    double market_value;
    int market_value_valid;
 
    char currency[OFX_CURRENCY_LENGTH];
    int currency_valid;
 
    double currency_ratio;
    int currency_ratio_valid;
 
    int amounts_are_foreign_currency;
    int amounts_are_foreign_currency_valid;
 
    double accrued_interest; 
    int accrued_interest_valid;
 
    double avg_cost_basis;  
    int avg_cost_basis_valid;
 
    enum BuyType
    {
      OFX_BUY_TYPE_BUY,
      OFX_BUY_TYPE_BUYTOCOVER,
      OFX_BUY_TYPE_BUYTOOPEN,
      OFX_BUY_TYPE_BUYTOCLOSE
    } buy_type;
    int buy_type_valid;
 
    double denominator;   
    int denominator_valid;
 
    time_t date_payroll;  
    int date_payroll_valid;
 
    time_t date_purchase; 
    int date_purchase_valid;
 
    double gain;          
    int gain_valid;
 
    double cash_for_fractional;   
    int cash_for_fractional_valid;
 
    enum IncomeType
    {
      OFX_CGLONG,       
      OFX_CGSHORT,      
      OFX_DIVIDEND,     
      OFX_INTEREST,     
      OFX_MISC          
    } income_type;
    int income_type_valid;
 
    enum Inv401kSource
    {
      OFX_401K_SOURCE_PRETAX,
      OFX_401K_SOURCE_AFTERTAX,
      OFX_401K_SOURCE_MATCH,
      OFX_401K_SOURCE_PROFITSHARING,
      OFX_401K_SOURCE_ROLLOVER,
      OFX_401K_SOURCE_OTHERVEST,
      OFX_401K_SOURCE_OTHERNONVEST
    } inv_401k_source;
    int inv_401k_source_valid;
 
    double load;    
    int load_valid;
 
    char loan_id[OFX_LOANID_LENGTH];   
    int loan_id_valid;
 
    double loan_interest;   
    int loan_interest_valid;
 
    double loan_principal;   
    int loan_principal_valid;
 
    double markdown;    
    int markdown_valid;
 
    double markup;    
    int markup_valid;
 
    double numerator;   
    int numerator_valid;
 
    enum OptAction
    {
      OFX_OPTACTION_EXERCISE,
      OFX_OPTACTION_ASSIGN,
      OFX_OPTACTION_EXPIRE
    } opt_action;
    int opt_action_valid;
 
    double penalty;   
    int penalty_valid;
 
    enum PosType
    {
      OFX_POSTYPE_LONG,
      OFX_POSTYPE_SHORT
    } pos_type;
    int pos_type_valid;
 
    int prior_year_contrib;
    int prior_year_contrib_valid;
 
    char related_fi_tid[OFX_FITID_LENGTH];
    int related_fi_tid_valid;
 
    enum RelatedType
    {
      OFX_RELTYPE_SPREAD,
      OFX_RELTYPE_STRADDLE,
      OFX_RELTYPE_NONE,
      OFX_RELTYPE_OTHER
    } related_type;
    int related_type_valid;
 
    enum OptionSecured
    {
      OFX_SECURED_NAKED,
      OFX_SECURED_COVERED
    } option_secured;
    int option_secured_valid;
 
    enum SellReason
    {
      OFX_SELLREASON_CALL,    
      OFX_SELLREASON_SELL,    
      OFX_SELLREASON_MATURITY 
    } sell_reason;
    int sell_reason_valid;
 
    enum SellType
    {
      OFX_SELL_TYPE_SELL,
      OFX_SELL_TYPE_SELLSHORT,
      OFX_SELL_TYPE_SELLTOOPEN,
      OFX_SELL_TYPE_SELLTOCLOSE
    } sell_type;
    int sell_type_valid;
 
    double shares_per_cont;
    int shares_per_cont_valid;
 
    double state_withholding;
    int state_withholding_valid;
 
    enum SubAcctType
    {
      OFX_SUBACCT_CASH,
      OFX_SUBACCT_MARGIN,
      OFX_SUBACCT_SHORT,
      OFX_SUBACCT_OTHER
    } subacct_from, subacct_funding, subacct_security, subacct_to;
    int subacct_from_valid;     
    int subacct_funding_valid;  
    int subacct_security_valid; 
    int subacct_to_valid;       
    double taxes;
    int taxes_valid;
 
    int tax_exempt;
    int tax_exempt_valid;
 
    enum TransferAction
    {
      OFX_TFERACTION_IN,
      OFX_TFERACTION_OUT
    } transfer_action;
    int transfer_action_valid;
 
    enum UnitType
    {
      OFX_UNITTYPE_SHARES,
      OFX_UNITTYPE_CURRENCY
    } unit_type;
    int unit_type_valid;
 
    double withholding;
    int withholding_valid;
 
    /*********** NOT YET COMPLETE!!! *********************/
  };
 
  typedef int (*LibofxProcTransactionCallback)(const struct OfxTransactionData data, void * transaction_data);
 
  struct OfxStatementData
  {
 
    char currency[OFX_CURRENCY_LENGTH];
    int currency_valid;
 
    char account_id[OFX_ACCOUNT_ID_LENGTH];
    struct OfxAccountData * account_ptr; 
    int account_id_valid;
 
    double ledger_balance;
    int ledger_balance_valid;
 
    time_t ledger_balance_date;
    int ledger_balance_date_valid;
 
    time_t date_asof;
    int date_asof_valid;
 
    double available_balance; 
    int available_balance_valid;
 
    time_t available_balance_date;
    int available_balance_date_valid;
 
    double margin_balance;
    int margin_balance_valid;
 
    double short_balance;
    int short_balance_valid;
 
    double buying_power;
    int buying_power_valid;
 
    time_t date_start;
    int date_start_valid;
 
    time_t date_end;
    int date_end_valid;
 
    char marketing_info[OFX_MARKETING_INFO_LENGTH];
    int marketing_info_valid;
  };
 
  typedef int (*LibofxProcStatementCallback)(const struct OfxStatementData data, void * statement_data);
 
  struct OfxCurrency
  {
    char currency[OFX_CURRENCY_LENGTH]; 
    double exchange_rate;  
    int must_convert;   
  };
 
  struct OfxPositionData
  {
    char account_id[OFX_ACCOUNT_ID_LENGTH];
    struct OfxAccountData * account_ptr; 
    int account_id_valid;
 
    char unique_id[OFX_UNIQUE_ID_LENGTH];
    int unique_id_valid;
    char unique_id_type[OFX_UNIQUE_ID_TYPE_LENGTH];
    int unique_id_type_valid;
 
    enum HeldInAccountType
    {
      OFX_HELDINACCT_CASH,     
      OFX_HELDINACCT_MARGIN,   
      OFX_HELDINACCT_SHORT,    
      OFX_HELDINACCT_OTHER     
    } heldinaccount_type;
    int heldinaccount_type_valid;
 
    enum PositionType
    {
      OFX_POSITION_SHORT,
      OFX_POSITION_LONG
    } position_type;
    int position_type_valid;
 
    double units;
    int units_valid;
 
    double unit_price;
    int unit_price_valid;
 
    double market_value;
    int market_value_valid;
 
    time_t date_unit_price;
    int date_unit_price_valid;
 
    char memo[OFX_MEMO_LENGTH];
    int memo_valid;
 
    enum Inv401kPosnSource
    {
      OFX_401K_POSN_SOURCE_PRETAX,
      OFX_401K_POSN_SOURCE_AFTERTAX,
      OFX_401K_POSN_SOURCE_MATCH,
      OFX_401K_POSN_SOURCE_PROFITSHARING,
      OFX_401K_POSN_SOURCE_ROLLOVER,
      OFX_401K_POSN_SOURCE_OTHERVEST,
      OFX_401K_POSN_SOURCE_OTHERNONVEST
    } inv_401k_source;
    int inv_401k_source_valid;
 
    char currency[OFX_CURRENCY_LENGTH];
    int currency_valid;
 
    double currency_ratio;
    int currency_ratio_valid;
 
    int amounts_are_foreign_currency;
    int amounts_are_foreign_currency_valid;
 
    struct OfxSecurityData *security_data_ptr;  
    int security_data_valid;
 
  };
 
  typedef int (*LibofxProcPositionCallback)(const struct OfxPositionData data, void * position_data);
 
 
  void ofx_set_status_cb(LibofxContextPtr ctx,
                         LibofxProcStatusCallback cb,
                         void *user_data);
 
  void ofx_set_account_cb(LibofxContextPtr ctx,
                          LibofxProcAccountCallback cb,
                          void *user_data);
 
  void ofx_set_security_cb(LibofxContextPtr ctx,
                           LibofxProcSecurityCallback cb,
                           void *user_data);
 
  void ofx_set_transaction_cb(LibofxContextPtr ctx,
                              LibofxProcTransactionCallback cb,
                              void *user_data);
 
  void ofx_set_statement_cb(LibofxContextPtr ctx,
                            LibofxProcStatementCallback cb,
                            void *user_data);
 
  void ofx_set_position_cb(LibofxContextPtr ctx,
                            LibofxProcPositionCallback cb,
                            void *user_data);
 
 
  /*int libofx_proc_buffer(LibofxContextPtr ctx,
                         const char *s, unsigned int size);*/
 
 
  /* **************************************** */
 
 
  struct OfxFiServiceInfo
  {
    char fid[OFX_FID_LENGTH];
    char org[OFX_ORG_LENGTH];
    char url[OFX_URL_LENGTH];
    int accountlist; 
    int statements; 
    int billpay; 
    int investments; 
  };
 
  struct OfxFiLogin
  {
    char fid[OFX_FID_LENGTH];
    char org[OFX_ORG_LENGTH];
    char userid[OFX_USERID_LENGTH];
    char userpass[OFX_USERPASS_LENGTH];
    char header_version[OFX_HEADERVERSION_LENGTH];
    char appid[OFX_APPID_LENGTH];
    char appver[OFX_APPVER_LENGTH];
    char clientuid[OFX_CLIENTUID_LENGTH];
  };
 
#define OFX_AMOUNT_LENGTH (32 + 1)
#define OFX_PAYACCT_LENGTH (32 + 1)
#define OFX_STATE_LENGTH (5 + 1)
#define OFX_POSTALCODE_LENGTH (11 + 1)
#define OFX_NAME_LENGTH (32 + 1)
 
  struct OfxPayment
  {
    char amount[OFX_AMOUNT_LENGTH];
    char account[OFX_PAYACCT_LENGTH];
    char datedue[9];
    char memo[OFX_MEMO_LENGTH];
  };
 
  struct OfxPayee
  {
    char name[OFX_NAME_LENGTH];
    char address1[OFX_NAME_LENGTH];
    char city[OFX_NAME_LENGTH];
    char state[OFX_STATE_LENGTH];
    char postalcode[OFX_POSTALCODE_LENGTH];
    char phone[OFX_NAME_LENGTH];
  };
 
  char* libofx_request_statement( const struct OfxFiLogin* fi, const struct OfxAccountData* account, time_t date_from );
 
  char* libofx_request_accountinfo( const struct OfxFiLogin* login );
 
  char* libofx_request_payment( const struct OfxFiLogin* login, const struct OfxAccountData* account, const struct OfxPayee* payee, const struct OfxPayment* payment );
 
  char* libofx_request_payment_status( const struct OfxFiLogin* login, const char* transactionid );
 
 
extern LIBOFX_API int ofx_PARSER_msg; 
extern LIBOFX_API int ofx_DEBUG_msg;
extern LIBOFX_API int ofx_DEBUG1_msg;
extern LIBOFX_API int ofx_DEBUG2_msg;
extern LIBOFX_API int ofx_DEBUG3_msg;
extern LIBOFX_API int ofx_DEBUG4_msg;
extern LIBOFX_API int ofx_DEBUG5_msg;
extern LIBOFX_API int ofx_STATUS_msg;
extern LIBOFX_API int ofx_INFO_msg;
extern LIBOFX_API int ofx_WARNING_msg;
extern LIBOFX_API int ofx_ERROR_msg;
extern LIBOFX_API int ofx_show_position;
#ifdef __cplusplus
} // end of extern "C"
#endif
 
#if __GNUC__ && defined(IN_LIBOFX)
#  pragma GCC visibility pop
#endif
 
#endif // end of LIBOFX_H