Skip to content
`DESADV` - Place delivery confirmations here.`ORDERS` - Fetch orders from here.`PRICE` - Place price/stock information file here.
The file contains **only the order lines relevant to you**.You are expected to **deliver all rows present in the file**.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.
Coming soon
Dropship Wiki
Details about the FTP solution.
Last edited 98 days ago by Jacob Bay.
1
Under construction. Updates will be provided continuously.
2MAXFPS AB - Dropship solution
2
3Information
3
More information coming here soon.
5FTP file structure
5
The FTP server we setup for you will contain 3 folders:
7
8
9
10File examples explanation
10
**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)
14Example file - Order.jsonc
14
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
17
18
**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
}
}
]
}
21Example file - Delivery_Confirmation.jsonc
21
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
24
25
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ⋯ next to your doc name or using a keyboard shortcut (
CtrlP
) instead.