Manually entering large volumes of purchase or expense data can be time-consuming and error-prone. To streamline this process, bulk uploading allows you to efficiently input multiple records at once, saving time and reducing the risk of mistakes. 

Whether you're updating purchases for inventory management or recording operational expenses (such as employee salaries, admin costs, freelancer/contracts outsourcing, etc.), this guide will help you navigate the bulk upload process effortlessly.


Getting Started

Navigate to Accounting > Purchases & Expenses > Record New Purchase (Drop-down Menu):



You’ll find three options:

  1. Bulk Uploading Purchases
  2. Bulk Uploading Purchases (Custom Config.)
  3. Bulk Uploading Expenses


Bulk Uploading Purchases & Bulk Uploading Purchases (Custom Config.) is similar to other documents bulk upload functions. You can learn more about these here>

Here we will learn about bulk uploading expenses:



Bulk Uploading Expenses


This method helps you bulk upload your operating/admin expenses such as utility bills, rent, office supplies, petty expenses, employee salaries, freelancer/contracts outsourcing, etc.



1) Supported File Format

  • Only CSV files are supported for bulk uploads.

2) Downloading the Sample File

Click Bulk Upload Expenses to open a pop-up window:


From here, click on Download Sample File Format to get a CSV template. This is what it will look like:



3) Mandatory Fields that need to be filled:
 

Some columns are mandatory to be filled. You can leave other columns empty if not needed, but you will need to have data in the below-given columns:

 

3.1) expenseNumber: Your Expense number. If you keep this field empty, the system will automatically add Expense numbers based on your last expes

 

3.2) expenseDate: (must be in a format of dd-mm-yyyy, for example, 23-01-2022)

 

3.3) amount: Expense Amount that occurred.

 

3.4) currency:  You will need to add the currency as a currency code. for example, INR, USD, EUR, GBP, etc. You can see the full list of currency codes below.

 

3.5) country - You can add the country by adding country codes such as IN, US, AU, SA, and so on. If you add India, United States, Australia, etc., it will give you an error.

So please add the country code only. The full list of country codes is given below.

 

3.6) pettyExpense:

In case you have the vendor details, you have to add the vendor name in the vendorName column. In that case, you need to keep pettyExpense as “False”.

In case you don’t have vendor details, you can keep the vendorName column empty. In this case, you need to keep pettyExpense as “TRUE”.
 

3.7) itemLedger: Although this is optional, if you're doing your accounting on Refrens, you need to enter the name of the Ledger Account under which you want to record the particular expense. E.g. Rent Expense, Electricity Expense, etc.) 

(To know how to create Ledger Accounts, you can check out this help article.)



4) Handling Phone Numbers

  • If a phone number begins with a + sign, prefix it with an apostrophe (') to avoid errors (e.g., ' +1234567890).




Adding Payment Details

If you want to update payment details as well in bulk, you can do that by adding 4 more columns:


1. paymentDate: (must be in a format of dd-mm-yyyy, for example, 23-01-2022)

 

2. paymentAccount: Name of the payment account through which you did the payment for an expense. (Bank A/c., Cash A/c., Employee A/c., Debit/Credit Card A/c., etc.)

 

3. paymentMethod: Add the method via which the payment was made (Account Transfer, UPI, etc.)

 

4. paidAmount: Amout which you paid.

Important Note: If your purchase includes multiple line items, ensure that the total payment amount for the entire purchase is entered when adding payment details. Do not enter the payment amount for individual line items. For example:


The system will automatically update the status of a purchase or expense as Paid, Partially Paid, or Unpaid based on the total purchase/expense amount and the payment made.


Key Things To Take Care of

  1. Always use the sample CSV file format.
  2. Avoid altering column names.
  3. Ensure correct formats for dates, currencies, and country codes.
  4. Allow processing time for uploads to reflect in the system.
    • Avoid re-uploading unless you receive an error.
    • You’ll get a confirmation email once the upload is successful.



List of Country/Currency Codes


A) Country Codes

CountryCountry Code
AfghanistanAF
Aland IslandsAX
AlbaniaAL
AlgeriaDZ
American SamoaAS
AndorraAD
AngolaAO
AnguillaAI
AntarcticaAQ
Antigua and BarbudaAG
ArgentinaAR
ArmeniaAM
ArubaAW
AustraliaAU
AustriaAT
AzerbaijanAZ
BahamasBS
BahrainBH
BangladeshBD
BarbadosBB
BelarusBY
BelgiumBE
BelizeBZ
BeninBJ
BermudaBM
BhutanBT
BoliviaBO
Bosnia and HerzegovinaBA
BotswanaBW
Bouvet IslandBV
BrazilBR
British Virgin IslandsVG
British Indian Ocean TerritoryIO
Brunei DarussalamBN
BulgariaBG
Burkina FasoBF
BurundiBI
CambodiaKH
CameroonCM
CanadaCA
Cape VerdeCV
Cayman IslandsKY
Central African RepublicCF
ChadTD
ChileCL
ChinaCN
Hong Kong, SAR ChinaHK
Macao, SAR ChinaMO
Christmas IslandCX
Cocos (Keeling) IslandsCC
ColombiaCO
ComorosKM
Congo (Brazzaville)CG
Congo, (Kinshasa)CD
Cook IslandsCK
Costa RicaCR
Côte d'IvoireCI
CroatiaHR
CubaCU
CyprusCY
Czech RepublicCZ
DenmarkDK
DjiboutiDJ
DominicaDM
Dominican RepublicDO
EcuadorEC
EgyptEG
El SalvadorSV
Equatorial GuineaGQ
EritreaER
EstoniaEE
EthiopiaET
Falkland Islands (Malvinas)FK
Faroe IslandsFO
FijiFJ
FinlandFI
FranceFR
French GuianaGF
French PolynesiaPF
French Southern TerritoriesTF
GabonGA
GambiaGM
GeorgiaGE
GermanyDE
GhanaGH
GibraltarGI
GreeceGR
GreenlandGL
GrenadaGD
GuadeloupeGP
GuamGU
GuatemalaGT
GuernseyGG
GuineaGN
Guinea-BissauGW
GuyanaGY
HaitiHT
Heard and Mcdonald IslandsHM
Holy See (Vatican City State)VA
HondurasHN
HungaryHU
IcelandIS
IndiaIN
IndonesiaID
Iran, Islamic Republic ofIR
IraqIQ
IrelandIE
Isle of ManIM
IsraelIL
ItalyIT
JamaicaJM
JapanJP
JerseyJE
JordanJO
KazakhstanKZ
KenyaKE
KiribatiKI
Korea (North)KP
Korea (South)KR
KuwaitKW
KyrgyzstanKG
Lao PDRLA
LatviaLV
LebanonLB
LesothoLS
LiberiaLR
LibyaLY
LiechtensteinLI
LithuaniaLT
LuxembourgLU
Macedonia, Republic ofMK
MadagascarMG
MalawiMW
MalaysiaMY
MaldivesMV
MaliML
MaltaMT
Marshall IslandsMH
MartiniqueMQ
MauritaniaMR
MauritiusMU
MayotteYT
MexicoMX
Micronesia, Federated States ofFM
MoldovaMD
MonacoMC
MongoliaMN
MontenegroME
MontserratMS
MoroccoMA
MozambiqueMZ
MyanmarMM
NamibiaNA
NauruNR
NepalNP
NetherlandsNL
Netherlands AntillesAN
New CaledoniaNC
New ZealandNZ
NicaraguaNI
NigerNE
NigeriaNG
NiueNU
Norfolk IslandNF
Northern Mariana IslandsMP
NorwayNO
OmanOM
PakistanPK
PalauPW
Palestinian TerritoryPS
PanamaPA
Papua New GuineaPG
ParaguayPY
PeruPE
PhilippinesPH
PitcairnPN
PolandPL
PortugalPT
Puerto RicoPR
QatarQA
RéunionRE
RomaniaRO
Russian FederationRU
RwandaRW
Saint-BarthélemyBL
Saint HelenaSH
Saint Kitts and NevisKN
Saint LuciaLC
Saint-Martin (French part)MF
Saint Pierre and MiquelonPM
Saint Vincent and GrenadinesVC
SamoaWS
San MarinoSM
Sao Tome and PrincipeST
Saudi ArabiaSA
SenegalSN
SerbiaRS
SeychellesSC
Sierra LeoneSL
SingaporeSG
SlovakiaSK
SloveniaSI
Solomon IslandsSB
SomaliaSO
South AfricaZA
South Georgia and the South Sandwich IslandsGS
South SudanSS
SpainES
Sri LankaLK
SudanSD
SurinameSR
Svalbard and Jan Mayen IslandsSJ
SwazilandSZ
SwedenSE
SwitzerlandCH
Syrian Arab Republic (Syria)SY
Taiwan, Republic of ChinaTW
TajikistanTJ
Tanzania, United Republic ofTZ
ThailandTH
Timor-LesteTL
TogoTG
TokelauTK
TongaTO
Trinidad and TobagoTT
TunisiaTN
TurkeyTR
TurkmenistanTM
Turks and Caicos IslandsTC
TuvaluTV
UgandaUG
UkraineUA
United Arab EmiratesAE
United KingdomGB
United States of AmericaUS
US Minor Outlying IslandsUM
UruguayUY
UzbekistanUZ
VanuatuVU
Venezuela (Bolivarian Republic)VE
Viet NamVN
Virgin Islands, USVI
Wallis and Futuna IslandsWF
Western SaharaEH
YemenYE
ZambiaZM
ZimbabweZW



B) Currency Codes


 

ENTITYCurrencyAlphabetic Code
AFGHANISTANAfghaniAFN
ÅLAND ISLANDSEuroEUR
ALBANIALekALL
ALGERIAAlgerian DinarDZD
AMERICAN SAMOAUS DollarUSD
ANDORRAEuroEUR
ANGOLAKwanzaAOA
ANGUILLAEast Caribbean DollarXCD
ANTARCTICANo universal currency
ANTIGUA AND BARBUDAEast Caribbean DollarXCD
ARGENTINAArgentine PesoARS
ARMENIAArmenian DramAMD
ARUBAAruban FlorinAWG
AUSTRALIAAustralian DollarAUD
AUSTRIAEuroEUR
AZERBAIJANAzerbaijan ManatAZN
BAHAMAS (THE)Bahamian DollarBSD
BAHRAINBahraini DinarBHD
BANGLADESHTakaBDT
BARBADOSBarbados DollarBBD
BELARUSBelarusian RubleBYN
BELGIUMEuroEUR
BELIZEBelize DollarBZD
BENINCFA Franc BCEAOXOF
BERMUDABermudian DollarBMD
BHUTANNgultrumBTN
BOLIVIA (PLURINATIONAL STATE OF)BolivianoBOB
BOLIVIA (PLURINATIONAL STATE OF)MvdolBOV
BONAIRE, SINT EUSTATIUS AND SABAUS DollarUSD
BOSNIA AND HERZEGOVINAConvertible MarkBAM
BOTSWANAPulaBWP
BOUVET ISLANDNorwegian KroneNOK
BRAZILBrazilian RealBRL
BRITISH INDIAN OCEAN TERRITORY (THE)US DollarUSD
BRUNEI DARUSSALAMBrunei DollarBND
BULGARIABulgarian LevBGN
BURKINA FASOCFA Franc BCEAOXOF
BURUNDIBurundi FrancBIF
CABO VERDECabo Verde EscudoCVE
CAMBODIARielKHR
CAMEROONCFA Franc BEACXAF
CANADACanadian DollarCAD
CAYMAN ISLANDS (THE)Cayman Islands DollarKYD
CENTRAL AFRICAN REPUBLIC (THE)CFA Franc BEACXAF
CHADCFA Franc BEACXAF
CHILEChilean PesoCLP
CHINAYuan RenminbiCNY
CHRISTMAS ISLANDAustralian DollarAUD
COCOS (KEELING) ISLANDS (THE)Australian DollarAUD
COLOMBIAColombian PesoCOP
COMOROS (THE)Comorian Franc KMF
CONGO (THE DEMOCRATIC REPUBLIC OF THE)Congolese FrancCDF
CONGO (THE)CFA Franc BEACXAF
COOK ISLANDS (THE)New Zealand DollarNZD
COSTA RICACosta Rican ColonCRC
CÔTE D'IVOIRECFA Franc BCEAOXOF
CROATIAKunaHRK
CUBACuban PesoCUP
CURAÇAONetherlands Antillean GuilderANG
CYPRUSEuroEUR
CZECHIACzech KorunaCZK
DENMARKDanish KroneDKK
DJIBOUTIDjibouti FrancDJF
DOMINICAEast Caribbean DollarXCD
DOMINICAN REPUBLIC (THE)Dominican PesoDOP
ECUADORUS DollarUSD
EGYPTEgyptian PoundEGP
EL SALVADOREl Salvador ColonSVC
EL SALVADORUS DollarUSD
EQUATORIAL GUINEACFA Franc BEACXAF
ERITREANakfaERN
ESTONIAEuroEUR
ESWATINILilangeniSZL
ETHIOPIAEthiopian BirrETB
EUROPEAN UNIONEuroEUR
FALKLAND ISLANDS (THE) [MALVINAS]Falkland Islands PoundFKP
FAROE ISLANDS (THE)Danish KroneDKK
FIJIFiji DollarFJD
FINLANDEuroEUR
FRANCEEuroEUR
FRENCH GUIANAEuroEUR
FRENCH POLYNESIACFP FrancXPF
FRENCH SOUTHERN TERRITORIES (THE)EuroEUR
GABONCFA Franc BEACXAF
GAMBIA (THE)DalasiGMD
GEORGIALariGEL
GERMANYEuroEUR
GHANAGhana CediGHS
GIBRALTARGibraltar PoundGIP
GREECEEuroEUR
GREENLANDDanish KroneDKK
GRENADAEast Caribbean DollarXCD
GUADELOUPEEuroEUR
GUAMUS DollarUSD
GUATEMALAQuetzalGTQ
GUERNSEYPound SterlingGBP
GUINEAGuinean FrancGNF
GUINEA-BISSAUCFA Franc BCEAOXOF
GUYANAGuyana DollarGYD
HAITIGourdeHTG
HAITIUS DollarUSD
HEARD ISLAND AND McDONALD ISLANDSAustralian DollarAUD
HOLY SEE (THE)EuroEUR
HONDURASLempiraHNL
HONG KONGHong Kong DollarHKD
HUNGARYForintHUF
ICELANDIceland KronaISK
INDIAIndian RupeeINR
INDONESIARupiahIDR
INTERNATIONAL MONETARY FUND (IMF) SDR (Special Drawing Right)XDR
IRAN (ISLAMIC REPUBLIC OF)Iranian RialIRR
IRAQIraqi DinarIQD
IRELANDEuroEUR
ISLE OF MANPound SterlingGBP
ISRAELNew Israeli SheqelILS
ITALYEuroEUR
JAMAICAJamaican DollarJMD
JAPANYenJPY
JERSEYPound SterlingGBP
JORDANJordanian DinarJOD
KAZAKHSTANTengeKZT
KENYAKenyan ShillingKES
KIRIBATIAustralian DollarAUD
KOREA (THE DEMOCRATIC PEOPLE’S REPUBLIC OF)North Korean WonKPW
KOREA (THE REPUBLIC OF)WonKRW
KUWAITKuwaiti DinarKWD
KYRGYZSTANSomKGS
LAO PEOPLE’S DEMOCRATIC REPUBLIC (THE)Lao KipLAK
LATVIAEuroEUR
LEBANONLebanese PoundLBP
LESOTHOLotiLSL
LIBERIALiberian DollarLRD
LIBYALibyan DinarLYD
LIECHTENSTEINSwiss FrancCHF
LITHUANIAEuroEUR
LUXEMBOURGEuroEUR
MACAOPatacaMOP
NORTH MACEDONIADenarMKD
MADAGASCARMalagasy AriaryMGA
MALAWIMalawi KwachaMWK
MALAYSIAMalaysian RinggitMYR
MALDIVESRufiyaaMVR
MALICFA Franc BCEAOXOF
MALTAEuroEUR
MARSHALL ISLANDS (THE)US DollarUSD
MARTINIQUEEuroEUR
MAURITANIAOuguiyaMRU
MAURITIUSMauritius RupeeMUR
MAYOTTEEuroEUR
MEMBER COUNTRIES OF THE AFRICAN DEVELOPMENT BANK GROUPADB Unit of AccountXUA
MEXICOMexican PesoMXN
MICRONESIA (FEDERATED STATES OF)US DollarUSD
MOLDOVA (THE REPUBLIC OF)Moldovan LeuMDL
MONACOEuroEUR
MONGOLIATugrikMNT
MONTENEGROEuroEUR
MONTSERRATEast Caribbean DollarXCD
MOROCCOMoroccan DirhamMAD
MOZAMBIQUEMozambique MeticalMZN
MYANMARKyatMMK
NAMIBIANamibia DollarNAD
NAMIBIARandZAR
NAURUAustralian DollarAUD
NEPALNepalese RupeeNPR
NETHERLANDS (THE)EuroEUR
NEW CALEDONIACFP FrancXPF
NEW ZEALANDNew Zealand DollarNZD
NICARAGUACordoba OroNIO
NIGER (THE)CFA Franc BCEAOXOF
NIGERIANairaNGN
NIUENew Zealand DollarNZD
NORFOLK ISLANDAustralian DollarAUD
NORTHERN MARIANA ISLANDS (THE)US DollarUSD
NORWAYNorwegian KroneNOK
OMANRial OmaniOMR
PAKISTANPakistan RupeePKR
PALAUUS DollarUSD
PALESTINE, STATE OFNo universal currency
PANAMABalboaPAB
PANAMAUS DollarUSD
PAPUA NEW GUINEAKinaPGK
PARAGUAYGuaraniPYG
PERUSolPEN
PHILIPPINES (THE)Philippine PesoPHP
PITCAIRNNew Zealand DollarNZD
POLANDZlotyPLN
PORTUGALEuroEUR
PUERTO RICOUS DollarUSD
QATARQatari RialQAR
RÉUNIONEuroEUR
ROMANIARomanian LeuRON
RUSSIAN FEDERATION (THE)Russian RubleRUB
RWANDARwanda FrancRWF
SAINT BARTHÉLEMYEuroEUR
SAINT HELENA, ASCENSION AND TRISTAN DA CUNHASaint Helena PoundSHP
SAINT KITTS AND NEVISEast Caribbean DollarXCD
SAINT LUCIAEast Caribbean DollarXCD
SAINT MARTIN (FRENCH PART)EuroEUR
SAINT PIERRE AND MIQUELONEuroEUR
SAINT VINCENT AND THE GRENADINESEast Caribbean DollarXCD
SAMOATalaWST
SAN MARINOEuroEUR
SAO TOME AND PRINCIPEDobraSTN
SAUDI ARABIASaudi RiyalSAR
SENEGALCFA Franc BCEAOXOF
SERBIASerbian DinarRSD
SEYCHELLESSeychelles RupeeSCR
SIERRA LEONELeoneSLL
SINGAPORESingapore DollarSGD
SINT MAARTEN (DUTCH PART)Netherlands Antillean GuilderANG
SISTEMA UNITARIO DE COMPENSACION REGIONAL DE PAGOS "SUCRE"SucreXSU
SLOVAKIAEuroEUR
SOLOMON ISLANDSSolomon Islands DollarSBD
SOMALIASomali ShillingSOS
SOUTH AFRICARandZAR
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDSNo universal currency
SOUTH SUDANSouth Sudanese PoundSSP
SPAINEuroEUR
SRI LANKASri Lanka RupeeLKR
SUDAN (THE)Sudanese PoundSDG
SURINAMESurinam DollarSRD
SVALBARD AND JAN MAYENNorwegian KroneNOK
SWEDENSwedish KronaSEK
SWITZERLANDSwiss FrancCHF
SYRIAN ARAB REPUBLICSyrian PoundSYP
TAIWAN (PROVINCE OF CHINA)New Taiwan DollarTWD
TAJIKISTANSomoniTJS
TANZANIA, UNITED REPUBLIC OFTanzanian ShillingTZS
THAILANDBahtTHB
TIMOR-LESTEUS DollarUSD
TOGOCFA Franc BCEAOXOF
TOKELAUNew Zealand DollarNZD
TONGAPa’angaTOP
TRINIDAD AND TOBAGOTrinidad and Tobago DollarTTD
TUNISIATunisian DinarTND
TURKEYTurkish LiraTRY
TURKMENISTANTurkmenistan New ManatTMT
TURKS AND CAICOS ISLANDS (THE)US DollarUSD
TUVALUAustralian DollarAUD
UGANDAUganda ShillingUGX
UKRAINEHryvniaUAH
UNITED ARAB EMIRATES (THE)UAE DirhamAED
UNITED KINGDOM OF GREAT BRITAIN AND NORTHERN IRELAND (THE)Pound SterlingGBP
UNITED STATES OF AMERICA (THE)US DollarUSD
URUGUAYPeso UruguayoUYU
UZBEKISTANUzbekistan SumUZS
VANUATUVatuVUV
VENEZUELA (BOLIVARIAN REPUBLIC OF)Bolívar SoberanoVEF
VIET NAMDongVND
VIRGIN ISLANDS (BRITISH)US DollarUSD
VIRGIN ISLANDS (U.S.)US DollarUSD
WALLIS AND FUTUNACFP FrancXPF
WESTERN SAHARAMoroccan DirhamMAD
YEMENYemeni RialYER
ZAMBIAZambian KwachaZMW
ZIMBABWEZimbabwe DollarZWL