SALES API                                                                                                  

 

Further Market offers an accessible portal for any developer wishing to view sales.

 

How does it work?

 

The developer creates its Mobile Money account if not exist, then he creates a Further Market account (free) and receives a unique identifier. He proceeds to the binding of its Mobile Money account with that of Further Market . If during the course of his services, he want to view sales, the only thing to do is to call a link like the one below:

 

http://api.furthermarket.com/FM/MARKET/Sales?MyAccountID= MyAccountID &Password= Password &StartIDDate= StartIDDate &StopIDDate= StopIDDate &StartMarketIDDate= StartMarketIDDate &StopMarketIDDate= StopMarketIDDate &ProductID= ProductID

 

This being done, the customer receives a feedback containing all the necessary information as wanted.

 

 Requirements:

 

As said above, the developer must have:

-         Mobile Money account associated with a number

-         Further Market Business Account

-         Couple your Mobile money number with your Further Market Business Account

-         Market service activated

About the link used:

 

The type

 

http://api.furthermarket.com/FM/MARKET/Sales?MyAccountID= MyAccountID &Password= Password &StartIDDate= StartIDDate &StopIDDate= StopIDDate &StartMarketIDDate= StartMarketIDDate &StopMarketIDDate= StopMarketIDDate &ProductID= ProductID

 

Filters Explanation

1. StartIDDate=Start purchase date (fill 0 to ignore)

2. StopIDDate=Stop purchase date (fill 0 to ignore)

3. StartMarketIDDate=Start purchase consomption date (fill 0 to ignore)

4. StopMarketIDDate=Start purchase consomption date (fill 0 to ignore)

5. ProductID =Specific product by ID (fill 0 to ignore)

 

 

Example of use

 

http://api.furthermarket.com/FM/MARKET/Sales?MyAccountID=123&Password=RETYYZYZ&StartIDDate= 737198&StopIDDate= 73719&StartMarketIDDate=73719&StopMarketIDDate=73719&ProductID=100

 

Results

 

Result example:

 

10|Count&

Fields(ProdDesignation|ProductID|Quantity|Amount|Currency|MarketDate|BuyerAccount|BuyerAccountID|PaymentID|UnitName|Publication|Request1Name|Request1Value|Request2Name|Request2Value|TimeStamp|ProdSerialNumber|ProdSerialReference|ProdSerialExpiry|Delivered|DeliveryOperatorName|DeliveryCost|Weigth|WeigthCategory|ElectronicDelivery|PhysicalDelivery|DeliveryFullNames|DeliveryTelephone|DeliveryAddress|DeliveryCountry|DeliveryCity|DeliveryInformation|ProdInformations|SMSGenerated|TimeZoneID|StockDailyRenew|StocksManagement|SerialNumberManagement)

&"SEAT 10`SEAT 01`SEAT 01`SEAT 10`SEAT 11`SEAT 01`SEAT 01`SEAT 01`SEAT 01`SEAT 01`"&247`238`238`247`248`238`238`238`238`238`&1`1`1`1`1`1`1`1`1`1`&3500`3501`3501`3501`3501`3501`3501`3500`3500`2000`&XAF`XAF`XAF`XAF`XAF`XAF`XAF`XAF`XAF`XAF`&13/03/2013`13/03/2013`13/03/2013`13/03/2013`13/03/2013`14/03/2013`14/03/2013`15/03/2013`16/03/2013`24/03/2013`&"CEDRIC TRESOR`CEDRIC TRESOR`JEUNE ET JOLIE`JEUNE ET JOLIE`JEUNE ET JOLIE`TOUT ELECTRIC SARL`JEUNE ET JOLIE`CEDRIC TRESOR`CEDRIC TRESOR`CEDRIC TRESOR`"&34`34`141`141`141`146`141`34`34`34`&0`0`0`0`0`0`0`0`0`0`&Unit`Unit`Unit`Unit`Unit`Unit`Unit`Unit`Unit`Unit`&"BDA-DLA 10H`BDA-DLA 12H`BDA-DLA 10H`BDA-DLA 10H`BDA-DLA 10H`LE MEILLEUR DES JEANS`BDA-DLA 10H`BDA-DLA 12H`BDA-DLA 12H`BDA-DLA 10H`"&CNI`CNI`CNI`CNI`CNI`CNI`CNI`CNI`CNI`CNI`&105423561`105423561`14529641`7458694554`45268454`1452668454`12548996`105423561`105423561`105423561`&``````````&``````````&"13/03/2013 07:49:56`13/03/2013 12:39:13`13/03/2013 12:44:18`13/03/2013 13:58:02`13/03/2013 14:00:02`14/03/2013 14:22:34`14/03/2013 14:33:03`15/03/2013 09:08:49`15/03/2013 09:09:45`21/03/2013 13:08:40`"&``````````&``````````&``````````&0`0`0`0`0`0`0`0`0`0`&``````````&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&``````````&``````````&``````````&``````````&``````````&``````````&``````````&1`1`1`1`1`1`1`1`1`1`&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&0`0`0`0`0`0`0`0`0`0`&&&&&

 

 

WHERE

10= Number of rows and &=Row separator. Fileds represents the set of items which are returned

 

IDDate Compilation

 

As example, we want to extract IDDate of the 15/03/2015

---------------------------------------

We proceed as follow with Delphi code:

 

//-----------------------------------------------------

Function TForm1.GetIDDate(Unedate: String): Integer;

begin

  Result := 0;

  IF Unedate = '' THEN  Exit;

  TRY

    Result := DayOfTheYear(StrToDate(Unedate)) +                                   // Here is the number of days in the current year

      (366 * (YearOf(StrToDate(Unedate)) - 1));             // Here is the number of days since J.C. until the last year

  EXCEPT

  END;

end;

 

//-----------------------------------------------------

Procedure TForm1.Button1Click(Sender: TObject);

var LaDate    : WideString;

            LaIDDate : Integer;

begin

  LaDate := '15/03/2015';

  LaIDDate := GetIDDate(LaDate);

  ShowMessage(IntToStr(LaIDDate));

end;

 

LaIDDate = 737198

GetIDDate('15/03/2015') = 737198