Skip to content

Dropship Wiki

Details about the FTP solution.
Last edited 98 days ago by Jacob Bay.
1
error
Under construction. Updates will be provided continuously.

2
MAXFPS AB - Dropship solution

3
Information

More information coming here soon.

5
FTP file structure

The FTP server we setup for you will contain 3 folders:
7
`DESADV` - Place delivery confirmations here.
8
`ORDERS` - Fetch orders from here.
9
`PRICE` - Place price/stock information file here.

10
File examples explanation

**Note**: Files ending with `.jsonc` in the examples are only for documentation purposes—`jsonc` allows inline comments.
Actual integration files must always be in standard `.json` format.
(If you remove all comments from the example files they should be valid json and could serve as test files)

14
Example file - Order.jsonc

Order file that we send to you, or you fetch from us depending on the setup, when an order is placed containing rows that you are expected to deliver.
16
The file contains **only the order lines relevant to you**.
17
You are expected to **deliver all rows present in the file**.
18
Some fields in the order file are required later when sending the delivery confirmation—make sure to save them even if you don’t need them for fulfillment.
**File naming convention**: `ORDER_<orderNumber>.json` Example: `ORDER_882293.json`
20
{
"orderHeader": {
"delieryPhoneNumber": "+46707332109", // Phone number for delivery contact
"orderType": "Normal", // Type of order, should always be 'Normal' in this case
"advisePhoneNumber": "+46707332109", // Phone number for sms notifications
"paymentType": "KlarnaPrepaid", // Payment method
"orderNumber": "4610540", // MaxGaming order number (Order number - End customer)
"deliveryAddress": {
"address1": "Johanneslundsvägen 12", // Street address
"postalCode": "36295", // Zip code
"city": "Urshult",
"countryCode": "SE", // 2 letter ISO country code
"address2": "", // Additional address information
"name1": "Jacob Bay" // First and last name
},
"salesChannel": "MaxGaming (Sweden)", // Which market (domain) the order was placed on
"customerNumber": "754246", // MaxGaming customer number (End customer)
"deliveryMethod": "PN_SE_MPH", // Delivery method code
"adviseEmail": "jacob@maxgaming.se", // Email for email notifications
"deliveryEmail": "jacob@maxgaming.se" // Email for delivery contact
},
"servicePoint": {
"countryId": "SE", // 2 letter ISO country code
"city": "URSHULT", // Service point city
"name": "Tempo Urshult", // Service point display name
"provider": "POS", // Identifier for the delivery service provider
"postalCode": "36254", // Service point zip code
"address1": "Södra Vägen 21A", // Service point street address
"deliveryLocationId": "184578" // Unique ID of the pickup point
},
"orderRows": [
{
"salesData": {
"unitPrice": "3831.20", // Price per item, ex VAT (Price for end customers)
"quantity": "1",
"vatPercent": "25", // VAT as a percentage (Price for end customers)
"currency": "SEK", // Can come in different currencies
"unit": "ST"
},
"purchaseOrderInfo": {
"cost": "3028.98", // Expected cost per item (Our purchase cost from you)
"currency": "SEK",
"purchaseOrder": "PC-19080" // Purchase order reference number
},
"externalRow": {
"externalRowId": "3440057", // Unique order row identifier
"externalPosition": 0, // Extend row position (Extend = Our backend)
"externalSubPosition": 0 // Extend row subposition (Extend = Our backend)
},
"product": {
"productName": "EPIC PU-Leather - Svart / Guld", // Product display name
"productNumber": "NBL-PU-GOL-002", // External product number (SKU)
"productEan": "4250144800264", // EAN
"externalProductNumber": "28440" // MaxGaming product number
}
}
]
}

21
Example file - Delivery_Confirmation.jsonc

Delivery confirmation is provided to us, or fetched from you depending on the setup, once an order is delivered. We recommend including an identifier, such as a purchase order number, in the file name for easier troubleshooting.
23
{
"orderHeader": {
"consignmentNumber": "03015155155344I", // Required. Shipment tracking number
"deliveryAddress": { // Optional.
"address1": "Saikogasse 1D/1/2", // Optional. Street address
"address2": "", // Optional. Additional address information
"city": "Wien", // Optional.
"countryCode": "AT", // Optional. 2 letter ISO country code
"name1": "Jacob Bay", // Optional. First and last name
"postalCode": "1220" // Optional. Zip code
},
"deliveryId": "547602", // Optional. Carrier shipment ID
"deliveryMethod": "PN_SE_MPH", // Optional. Delivery method code
"orderNumber": "4610540" // Required. MaxGaming order number (End customer)
},
"orderRows": [
{
"deliveryData": {
"quantity": "1" // Required. Quantity delivered
},
"externalRow": {
"externalRowId": "3440057" // Required. Unique order row identifier
},
"product": {
"productEan": "4250144800264", // Optional. EAN
"productName": "EPIC PU-Leather - Svart / Guld", // Optional. Product display name
"productNumber": "NBL-PU-GOL-002" // Required. External product number (SKU)
},
"purchaseOrderInfo": {
"purchaseOrder": "PC-19080" // Required. Purchase order reference number
}
}
]
}

24
📋 FAQ

25
Coming soon

Want to print your doc?
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.