ERPNext Integration

Who can use this integration?

This integration is suitable for customers operating in India and primarily doing B2B MPS logistics movements. Movements like warehouse to store, warehouse to warehouse, vendor to warehouse etc are termed as B2B MPS movements.

Features

Using ClickPost app in ERPNext you can get access to following features:

  1. Carrier Recommendations
    1. Based on performance based allocation parameters or allocation rules set in ClickPost, you will get the list of recommended carriers.
  2. Shipment Creation and label generation
    1. Generate shipments via a form or bulk upload via file in ERPNext to create shipments with carrier of your choice. After the shipment is successfully created you will get waybill copy and box stickers generated via ClickPost in ERPNext.
  3. Shipment Tracking via Polling and Webhook
    1. Fetch the latest status and complete shipment timeline.
  4. Fetching Proof of Delivery
    1. After the shipment is Delivered, fetch the POD document.
  5. Shipment cancellation
    1. Cancel a shipment anytime before pickup.

Guide to setup ClickPost app in ERPNext

Follow these 3 steps to setup ClickPost app

  1. ClickPost App installation

    Please see the relevant steps below Based on whether you have a self hosted version of ERPNext or you are on Frappe Cloud

    1. Self Hosted Steps
      1. Run this command with frappe user from frappe-bench folder
        Bench get-app https://github.com/Akhilam-Inc/ClickPost-ERPNext-Integration.git
      2. After the app is successfully installed, load the app on your site using the below command. Replace clickpost_erpnext_integration with your own app name.
        Bench —site install-app clickpost_erpnext_integration
    2. Frappe Cloud
      1. If you are using the Frappe Cloud version of ERPNext, you can download the Clickpost app directly from marketplace.
  2. Configure ClickPost in ERPNext

    Once you have installed the ClickPost app, follow these steps to correctly configure it and hit save.

    1. Enter your username and key as received from your Onboarding Manger.

    2. Go to ClickPost configuration page under ClickPost app.


    3. Make sure all checkboxes- Enable, Enable Log are turned on.

    4. Keep the URL as https://www.clickpost.in


  3. Configure carriers and webhook URL in ClickPost

    Go to your ClickPost dashboard (b2b.clickpost.in) and follow these steps

    1. From settings, go to carrier integrations and choose your B2B carrier.

    2. Create carrier accounts under the carrier of your choice and enter credentials.

    3. Now, go to your ClickPost app in ERPNext.

      1. From configurations click on Get Carrier. This will fetch all the active carrier accounts from ClickPost in ERPNext.
      2. Now to Carrier Partner page and you should be able to see all the active carrier accounts that you created on clickpost dashboard.

    4. To get instant tracking updates for any shipment you need to set your webhook URL in ClickPost dashboard.

      1. To get the webhook URL which you can put in ClickPost dashboard, please follow the steps mentioned in this video.
      2. Go to settings > Notifications > webhook > All Status
      3. Enter your Webhook URL and hit submit. Follow these steps to get the webhook URL.
      4. From Auth Configurations, choose your authentication method and enter the required details.

Guide to carrier allocation

  1. From the ClickPost dashboard, make sure your Allocation rules are setup.
  1. In ERPNext, from ClickPost configuration make sure "Use carrier recommendation" checkbox is toggled on.

  2. You will see 2 options:

    1. Manual Selection- If this option is chosen then you can manually select a carrier account from a prioritised list of carrier accounts while creating a shipment. This prioritised list is generated after the recommmendation is successful. You will also be able to see the calculated shipping charge if the carrier pricing is uploaded in ClickPost.

    2. Automatic Order Creation- If this option is selected then recommendation and order creation will happen together. First the system will fetch the list of recommended carriers and automatically create order with the first carrier in the list. If the order creation fails with the first carrier then it will try with second carrier. The system will try order creation with top 3 carriers.

Guide to create shipments and print labels

  1. Before shipment creation make sure you have setup your customer and address master from ClickPost configuration. Adding an address in ERPNext will automatically create an entry in ClickPost location master.

  2. Also, add your sales invoice or Delivery note from ClickPost configuration.

  3. Go to the shipment page and click on "Add Shipment". To bulk create orders go to Data Import under ClickPost configuration.

  4. Fill the shipment form and Click on save.

  5. Once you have done all the changes, click on submit and then click on create shipment.

  6. After the shipment is successfully created, click on Update Shipment to fetch the shipping waybill and box stickers. These will be available under attachments. You can click on Print Options drop down to print the relevant documents.


Guide to track shipments and fetch POD

  1. After the shipment is created click on Track Shipment button on each Shipment page to see the latest status of each shipment.

  2. All the status updates will be visible under the Shipment Update table.

  3. After the shipment is Delivered, you will be to fetch the POD. The fetched POD will be available under the Attachments section.


Guide to register AWB for tracking

If you are not doing shipment creation and just want to register and already created AWB for tracking, follow these steps-

  1. Go to awb registration under Transactions.
  2. Fill the AWB registration form. only 2 details are mandatory- AWB Number and Carrier partner and save the form.
  3. Once you have done all the changes, click on submit and then click on create AWB registration.
  4. The AWB will now be registered in ClickPost system and we will start tracking the shipments.
  5. The rest of the steps are same as the previous point.

Did this page help you?