Contents
What is included in this enhancement
1. Introduction
What is the functionality
W3W (What3Words) is a location system that converts a precise place into a unique 3-word address, such as apple.book.chair.
In Anchanto WMS, the W3W field is used as an optional address field to help capture more accurate location details, especially when a normal billing or shipping address is unclear, incomplete, or difficult to identify.
Earlier, W3W support was available only in some B2C order creation flows. With this enhancement, W3W support is now available for B2B orders in addition to B2C orders. It is also made available more consistently across UI, bulk upload, and APIs.
This helps users capture W3W details more uniformly across different order creation methods and improves address accuracy for both billing and shipping addresses.
What is included in this enhancement
1. W3W on B2B Order Creation UI
W3W fields are now available on the B2B order creation screen.
Users can add W3W details for:
- Billing Address
- Shipping Address
This means B2B orders can now capture more precise address details directly from the UI.
2. W3W in B2C Bulk Upload
W3W fields are now added to the B2C bulk upload template.
This allows users to include W3W details while creating B2C orders in bulk.
3. W3W in B2B Bulk Upload
W3W fields are now added to the B2B bulk upload template.
This allows users to create B2B orders in bulk with W3W details for both billing and shipping addresses.
4. W3W in APIs
W3W fields are now added to the relevant B2B and B2C order APIs.
This means users can create, update, and retrieve orders with W3W details through API for both billing and shipping addresses.
Who can use it
This enhancement is useful for users who create or update:
- B2B orders
- B2C orders
- orders through UI
- orders through bulk upload
- orders through API
Use cases
Capture more accurate location details:
Add W3W information when the regular address is not enough to identify the exact billing or shipping location.
Use W3W across more order flows:
Capture W3W details for both B2B and B2C orders across different order creation methods.
Improve address consistency:
Store W3W details in a more uniform way across UI, bulk upload, and API workflows.
2. How to Use this functionality
Web / UI Workflow
Step 1: Go to the Order module, select the B2B or B2C order type, and open the respective Order Creation screen.
Step 2: Enter the required order details such as customer(company), product, quantity, and other mandatory order information.
Step 3: Go to the Billing Address section.
Step 4: Enter the standard billing address details and add the W3W value in the W3W field.
Step 5: Go to the Shipping Address section.
Step 6: Enter the standard shipping address details and add the W3W value in the W3W field.
Step 7: Save or create the order.
Step 8: The system stores the W3W information against the respective billing and shipping address.
Bulk Upload Workflow
Step 1: Go to the B2B or B2C bulk order upload screen.
Step 2: Download the latest bulk order upload template.
Step 3: Fill in the required order details in the template.
Step 4: Enter W3W values in the newly added W3W columns for billing and/or shipping address.
Step 5: Upload the completed bulk order template.
Step 6: The system validates the uploaded data.
Step 7: Orders are created with the W3W details saved against the billing and shipping address.
API Workflow
Step 1: External system calls the required Create Order, Update Order, or Update Address API.
Step 2: Pass the W3W value in the billing and/or shipping address payload.
{
"b2c_order": {
"company_code": "string",
"shipping_type": "standard_delivery",
"payment_collection_name": "online",
"payment_collection_presentation": "string",
"payment_collection_cod": true,
"number": "string",
"reference_number": "string",
"currency_code": "string",
"delivery_date": "string",
"collection_date": "string",
"instruction": "string",
"packing_instructions": "string",
"source": "string",
"channel_name": "string",
"campaign_code": "string",
"media_code": "string",
"gift_message": "string",
"order_vas": [
"Gift Wrapping",
"Quality Check"
],
"order_gift_message": "string",
"invoice": "string",
"custom_duty": "ddu",
"total_sla_hours": 0,
"is_tax_inclusive": true,
"is_fbm_order": true,
"is_fbs_order": true,
"is_return_order": true,
"is_cancel_order": true,
"parent_order_number": "string",
"order_type": "exchange",
"bill_of_exit": "BOE123",
"buyer_eori": "string",
"marketplace_order_date": "string",
"awb_number": "string",
"is_historical_order": true,
"b2c_order_state": "string",
"b2c_shipment_state": "string",
"wms2_order_state": "string",
"created_at": "string",
"updated_at": "string",
"tracking_number": "string",
"dispatch_no": "string",
"dispatch_date": "string",
"delivered_at": "string",
"originated_from": "string",
"cancel_reason": "string",
"carrier": {
"carrier_code": "string",
"carrier_name": "string",
"carrier_email": "string",
"carrier_contact_number": "string",
"carrier_tracking_url": "string"
},
"adjustment_attributes": {
"total_paid": 0,
"sub_total": 0,
"shipping_cost": 0,
"tax_amount": 0,
"discount": 0,
"discount_details": {},
"insurance_amount": 0,
"sender_vat": 0
},
"additional_attribute_attributes": {
"extra_details": "string",
"seller_store_code": "string",
"do_number": "string"
},
"order_items_attributes": [
{
"line_number": 0,
"unit_price": 0,
"retail_price": 0,
"selling_price": 0,
"quantity": 0,
"sku": "string",
"upc": "string",
"location_code": "string",
"transaction_number": "string",
"batch_number": "string",
"expiry_date": "string",
"coo": "TR",
"base_line_number": "string",
"delete_item": true,
"uom": "string",
"uom_quantity": 0,
"item_udfs_attributes": {
"udf1": "string",
"udf2": "string",
"udf3": "string",
"udf4": "string",
"udf5": "string",
"udf6": "string",
"udf7": "string"
},
"item_gift_message": "string",
"tier_id": 0,
"line_item_detail": {
"kit_product_sku": "string",
"kit_product_quantity": 0,
"kit_product_price": 0,
"seller_voucher_amount": 0
},
"sku_vas": [
"Engraving",
"Gift Wrap"
],
"sku_gift_message": "string",
"sku_etching_message": "string",
"b2c_order_item_vas_attributes": [
{
"quantity": 0,
"message": "string",
"cost": 0
}
]
}
],
"value_added_services_attributes": [
{
"name": "string",
"value": "string"
}
],
"billing_address_attributes": {
"first_name": "string",
"last_name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"business_name": "string",
"city": "string",
"zipcode": "string",
"country_iso": "SK",
"state_abbreviation": "string",
"phone": "+1234567890",
"email": "customer@example.com",
"sender_tax_id": "string",
"receiver_tax_id": "string",
"receiver_type": "passport",
"w3w": "string",
"suburb": "string"
},
"shipping_address_attributes": {
"first_name": "string",
"last_name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"business_name": "string",
"city": "string",
"zipcode": "string",
"country_iso": "US",
"state_abbreviation": "string",
"phone": "+1234567890",
"email": "customer@example.com",
"sender_tax_id": "string",
"receiver_tax_id": "string",
"receiver_type": "passport",
"w3w": "string",
"suburb": "string"
},
"sender_address_attributes": {
"first_name": "string",
"last_name": "string",
"address1": "string",
"address2": "string",
"address3": "string",
"business_name": "string",
"city": "string",
"zipcode": "string",
"country_iso": "VO",
"state_abbreviation": "string",
"phone": "+1234567890",
"email": "customer@example.com",
"sender_tax_id": "string",
"receiver_tax_id": "string",
"receiver_type": "passport",
"suburb": "string",
"sender_ioss": "string",
"sender_vat": "string"
}
}
}
Step 3: The system validates and saves the W3W value against the order address.
Step 4: To retrieve the saved W3W information, call the respective Get Order or Order Details API.
Step 5: The API response returns the saved W3W details in the billing and/or shipping address section.
Comments
0 comments
Please sign in to leave a comment.