Scoping your integration

This first step is about gathering information and aligning teams to ensure the project starts smoothly. It involves two key parts: completing a questionnaire and holding a technical kick-off call.

The questionnaire

Before the technical work begins, Shippit need to understand your services and capabilities. This section details each of the questions on the questionnaire, and helps you find the appropriate information to complete the section. Your Shippit account manager can send you a link to provide your answers.

The information you provide helps Shippit configure your services correctly on the platform. A complete and accurate questionnaire is crucial for avoiding delays later in the project.

The questions

Question Description Example answer
Which TMS do you use? Identifies the Transport Management System (TMS) your business operates. CargoWise
Are the validation criteria we provided enough for you to prevent failed bookings? If not, what else do you require? Checks if the provided validation rules are sufficient or if there is additional criteria needed to avoid booking errors. We also require phone number validation
Do you make account-specific exceptions for weights and dimensions? If so, can you give an example? Determines if there are exceptions to dimension rules for specific accounts. Yes, Account X is allowed parcels up to 1.20m instead of the standard 1.05m
Are there any reasons that would prevent you accurately representing your pricing structure using the standard Shippit rate card format? If so, what’s missing? Determines if the standard rate card format can capture your pricing We have surcharges for remote areas not covered in the standard format
Please confirm that the serviceability format we provided works for you, or detail any challenges. Shippit uses a serviceability file to define valid collection and delivery regions, this question determines if the file format is compatible. The format works, but we need to add a field for delivery time windows
Do you use the same suburb and postcode combinations as Australia Post? The serviceability file format assumes that you are using the Australia Post suburb and postcode mapping Yes
Does your zoning logic assume that every suburb is always in the same zone, regardless of the distance between the pickup and drop off This question determines if your zoning logic matches that used by the Shippit serviceability file. Yes
Does your ETA structure align with Shippit’s ETA structure? Determines if your Estimated Time of Arrival (ETA) calculations are compatible Yes
Do you make account-specific exceptions for surcharges? If so, can you give an example? Determines if there are exceptions to surcharges rules for specific accounts. Account Y is exempt from fuel surcharges
Are your flat surcharges based on weights (dead and volumetric), volume, dimensions, or location? If not, what are they based on? Determines the basis for your surcharges. Surcharges are based on delivery location and parcel weight
Do you have a GS1 account? If not, are you open to applying for one? Determines if you have a GS1 account for barcoding, or are willing to get one. No, but we are open to applying for a GS1 account
Are there any blockers that would prevent you adopting this format? Determines if there are any obstacles to using the serviceability file format. No blockers
Are there any blockers that would prevent you adhering to the standard Shippit label format? Determines if there are any obstacles to using Shippit’s label format. No blockers
Are there any additional fields not included in the standard Shippit label format that are critical for your carrier? Determines if there are additional fields required for the label. We need a field for 'Authority to Leave' instructions
Are there any blockers that would prevent you adhering to Shippit’s cancellation process? Determines if there are any obstacles to maintaining Shippit’s cancellation process. No blockers
Does your system accept batch manifesting for at least 25 orders? Determines if batch manifesting is feasible within your system. Yes, we support batch manifesting
Please provide details of the maximum number of orders you accept in a single batch. Determines the upper limit for batch processing. Our system can handle up to 500 orders per batch
Do you require a paper manifest? Determines if manifests must be paper or digital. No, we accept digital manifests
Are there any blockers that would prevent you adhering to Shippit’s tracking process? Determines if there are any obstacles to maintaining Shippit’s tracking process. No blockers

When you send in your completed questionnaire, our team review it, and schedule the technical kick-off call.

Serviceability file

The serviceability file uses these column headers:

Header Required Description Example
courier Yes Shippit’s representation of the carrier (provided by Shippit) carriername
suburb Yes The name of the suburb to map to the zone Sydney
postcode Yes The postcode to map to the zone 2000
state No The state code to map to the zone NSW
country Yes The country code to map to the zone AU
courier_zone Yes The code that represents the zone that the suburb belongs to SYD1
pickup Yes Can pickups occur in the mapped suburb Y
dropoff Yes Can dropoffs occur in the mapped suburb Y
onforwarding Yes Does the mapped suburb support onforwarding N
is_country_zone Yes Does the zone contain an entire country N
sort_code No The sort code associated with the suburb and postcode of the delivery, used during labelling SYD2010

Rate card

There are two pricing methods supported by the rate card:

  • Fixed pricing
  • Weight-based pricing

Fixed pricing is calculated as a fixed price multiplied by the number of articles, with a fuel surcharge added if required.

cost = (fixed_price + price_extra_article × number of articles) × (1 + fuel_surcharge)

Weight-based pricing is calculated based on the chargeable weight of the item. To calculate the chargeable weight, use this formula:

total chargeable weight = CEIL(MAX(total dead weight, total volume / cubic_ratio) / weight_rounding) × weight_rounding

When you have established the chargeable weight, you can use it to determine the cost based on this formula:

cost = MAX((price_order + price_kg × (total chargeable weight - kilos_included) + price_extra_article* number of articles), minimum) × (1 + fuel_surcharge)

The rate card contains this information:

Category Header Required Description Example
Identifier courier Yes Shippit’s representation of the carrier (provided by Shippit) carriername
Identifier account_number Yes The account number configured by the merchant to identify the customer of the carrier 123456
Pricing - fixed fixed_price Yes The fixed cost for this rate 10.00
Pricing - weight price_order Yes The base price for the rate 5.00
Pricing - weight price_kg Yes The price per kg added onto the base price 2.50
Pricing - weight weight_rounding Yes The number of decimals to round up by (1 = 0.1, 2 = 0.01, etc) 1
Pricing - weight kilos_included No The number of kg already included in price_order (subtracts this from total weight in calculation) 3
Pricing - weight cubic_ratio Yes The cubic ratio used to calculate volumetric (cubic) weight 250
Pricing - weight minimum Yes The minimum price charged irrespective of weight or number of articles 8.00
Pricing price_extra_article Yes The cost for every additional article past the first 1.00
Pricing fuel_surcharge Yes The fuel surcharge percentage to add to the cost 0.12
Pricing small_margin Yes The small margin to apply (set to 0) 0
Pricing medium_margin Yes The medium margin to apply (set to 0) 0
Pricing large_margin Yes The large margin to apply (set to 0) 0
Quote product_code Yes The product code associated with the quote EXPRESS
Quote delivery_timeframe Yes The ETA (in days) associated with the quote 2
Validation - lane pickup_zone Yes The pickup zone of the lane this rate is for (from serviceability file) SYD1
Validation - lane delivery_zone Yes The drop off zone of the lane this rate is for (from serviceability file) MEL1
Validation - weight minimum_weight Yes The minimum total chargeable weight; if not exceeded, the rate is invalid 0.5
Validation - weight fixed_price_weight_limit Yes The maximum total dead weight; if exceeded, the rate is invalid 20
Validation - weight fixed_price_volumetric_limit Yes The maximum total volumetric weight. If exceeded, the rate is invalid (use cubic_ratio to calculate volumetric weight) 40
Validation - weight article_weight_limit Yes The maximum article dead weight; if exceeded, the rate is invalid 10
Validation - weight article_volumetric_limit Yes The maximum article volumetric weight. If exceeded, the rate is invalid (use cubic_ratio to calculate volumetric weight) 15
Validation - dimensions max_dimension_cm Yes If the maximum dimension from any article exceeds this value, the rate is invalid 120
Validation - dimensions min_dimension_upper_bound_cm Yes If the minimum dimension from any article exceeds this value, the rate is invalid 10
Validation - dimensions med_dimension_upper_bound_cm Yes If the median dimension from any article exceeds this value, the rate is invalid 60
Validation - dimensions max_parcel_combined_length_cm Yes If the maximum combined dimension (length + depth + width) from any article exceeds this value, the rate is invalid 200
Validation - other max_article_count Yes The maximum number of articles; if exceeded, the rate is invalid 5
Validation - other requires_atl Yes If Y and the order doesn’t have authority to leave, the rate is invalid N

The technical kick-off call

This meeting formally begins the integration project and ensures both teams agree on the scope and timeline. The goal of the call is to review the technical requirements, confirm the project plan, and answer any initial questions you may have.

It’s important that your designated technical contact and any project managers responsible for the integration attend this call.

The agenda for the call includes:

  • Introductions of the key contacts from both Shippit and your team
  • A final review of the information you provided in the questionnaire
  • Confirmation of your chosen tracking method and its technical requirements
  • A walk through the project timeline, milestones, and the next steps
  • An open question and answer session to cover any other concerns

After this call, both teams should have a clear understanding of the project and are ready to move on to technical configuration.