Get listings of a SKU¶

sku = flipkart.sku('my-special-sku', fsn='TSHDBN3326TEZHQZ')
for listing in sku.listings:
    print listing.attributes['mrp']

Create a listing¶

sku = flipkart.sku('my-special-sku', fsn='TSHDBN3326TEZHQZ')
listing = sku.create_listing(
    mrp=2400,
    selling_price=2300,
    listing_status="INACTIVE",
    fulfilled_by="seller",
    national_shipping_charge=20,
    zonal_shipping_charge=20,
    local_shipping_charge=20,
    procurement_sla=3,
    stock_count=23,
)
listing.save()
print listing.mrp

Update a listing¶

listing = flipkart.listing('LSTTSHDBN332XDYBZ5MHX30XI')
listing.attributes['mrp'] = 2600
listing.save()

Searching for orders¶

orders = flipkart.search_orders()

Find only orders of selected SKUs:

orders = flipkart.search_orders(
    filters={'sku': ['my-sku-1', 'my-sku-2']}
)

Filter by state:

orders = flipkart.search_orders(
    filters={'states': ['Approved']}
)

Fetching a specific order item¶

order_item = flipkart.order_item('1731')
order_item.attributes['quantity']

Or to get several order items at once

order_items = flipkart.order_items('1731', '1732')

Once the order is ready to pack, generate a label

label_request = order_item.generate_label(
    date.today(),   # Invoice date
    'INV12345',     # Invoice number
)

When there are items that need serial numbers

label_request = order_item.generate_label(
    date.today(),   # Invoice date
    'INV12345',     # Invoice number
    [['IMEI1']],
)

If the item was dual sim

label_request = order_item.generate_label(
    date.today(),   # Invoice date
    'INV12345',     # Invoice number
    [['IMEI1', 'IMEI2']],
)

If 2 units of dual sim mobiles

label_request = order_item.generate_label(
    date.today(),   # Invoice date
    'INV12345',     # Invoice number
    [['IMEI1', 'IMEI2'], ['IMEI3', 'IMEI4']],
)

The response of generate_label is a Label Request. The label request is a lazy API. The status can be refreshed by calling

label_request.refresh_status()

Once the status is cleared, the item can be shipped out. To get the label to ship call the get_label method to get a PDF of the label and possibly the invoice.

pdf = order_item.get_label()

Once your shipment is ready to be picked by Flipkart logistics partner, call the ready to dispatch API.

order_item.dispatch()

Getting shipment details¶

The Shipments API gives the shipping details for orderitems

order_item.get_shipment_details()

the response items can be seen on Flipkart API documentation

Getting Access Token¶

If you have registered an application with your seller credentials and would like to access resources in your account, you could use the application id and secret alone to do so. The authentication helper in the API gives you a convenient way to get tokens

from auth import Authentication

auth = Authentication(
    '<application id>',
    '<application secret>',
    sandbox=True,           # If you are using sandbox
)
auth.get_token_from_client_credentials()

Report Bugs¶

Report bugs at https://github.com/fulfilio/python-flipkart/issues.

If you are reporting a bug, please include:

• Your operating system name and version.
• Any details about your local setup that might be helpful in troubleshooting.
• Detailed steps to reproduce the bug.

Fix Bugs¶

Look through the GitHub issues for bugs. Anything tagged with “bug” is open to whoever wants to implement it.

Implement Features¶

Look through the GitHub issues for features. Anything tagged with “feature” is open to whoever wants to implement it.

Write Documentation¶

Python Flipkart Marketplace API Client could always use more documentation, whether as part of the official Python Flipkart Marketplace API Client docs, in docstrings, or even on the web in blog posts, articles, and such.

Submit Feedback¶

The best way to send feedback is to file an issue at https://github.com/fulfilio/python-flipkart/issues.

If you are proposing a feature:

• Explain in detail how it would work.
• Keep the scope as narrow as possible, to make it easier to implement.
• Remember that this is a volunteer-driven project, and that contributions are welcome :)