Create Transactions
Create new Transactions in batch. Max Batch Size = 500 transactions All dates must be in range 1970-01-01 00:00:00 and 2105-12-31 23:59:59 or null (where applicable)
Body Required
id should be omitted on creation of new orders
-
cancelledDate string(date-time)
Date that the transaction was cancelled
-
Channel of the transaction (1: D2C, 2: B2B)
-
completedDate string(date-time)
Date that the transaction was completed
-
Date that the transaction was created
-
Currency Code of transaction (ISO 4217)
-
customerName string
Name of the Customer (Only used on B2B transactions)
-
deliveryDate string
The estimated Delivery Date of the transaction
-
externalCostCenterID string
External ID of an assosciated cost center. Will be added as a suffix to externalStoreID
-
externalCustomerID string
External Customer ID of the B2B customer
-
externalInfo string
JSON body that can be used for integration purposes
-
externalParentID string
Reference externalTransactionID of initial transaction when adding returns
-
externalRowID string
Additional ExternalID of transaction
-
External ID of the store (Store must exist in Madden)
-
The ID of the transaction in the source platform (used to query single transacitons)
-
id integer
Maddens ID of the transaction (Used as reference on replace)
-
items array[object]
The items/product rows of the transaction
-
Market that the transaction was destined for. (Ex. Delivery Country)
-
orderType string
OrderType of the transaction
-
statements array[object]
Any fees/discounts applied to the whole transaction that are not directly tied to a transaction item
-
Type of the transaction (1: Sale, 2: Return)
curl \
-X POST https://ma-api.maddenanalytics.com/v1/transactions \
-H "Authorization: $API_KEY" \
-d '[{"cancelledDate":"null","channel":1,"completedDate":"2022-08-17T17:00:00+02:00","createdDate":"2022-08-17T10:53:53+02:00","currencyCode":"SEK","customerName":"B2B Company Inc","deliveryDate":"2021-11-15T10:15:30Z","externalCostCenterID":"OL","externalCustomerID":"1234-567","externalInfo":"{}","externalParentID":"string","externalRowID":"string","externalStoreID":"store101","externalTransactionID":"779644","id":42,"items":[{"ageGroup":"Senior","brandName":"ACME","category":"Sneakers","collection":"SS21","color":"Black","costPrice":45.5,"costPriceCurrency":"USD","customFields":"{}","deliveryWindow":"IMMEDIATE","ean":"7340192703345","externalID":"99887766","externalItemID":"779644-1000","fulfillmentType":0,"gender":"gender","key":"7340192703345","moneyDiscount":380,"moneyItemTotalNet":3040,"moneyItemTotalVat":760,"primaryWarehouseExternalID":"central-ws","productGroupID":"123456","productName":"Petter","productType":1,"quantity":1,"season":"Spring/Summer","shipments":[{"externalWarehouseID":"central-ws","quantity":1,"shipmentDate":"2022-08-17T16:50:50+02:00","shipmentID":"779644-1"}],"size":"43","sku":"123456-001-43","supplier":"Acme Enterprises AB","variantGroupID":"123456-001","variantName":"Petter Black","vatValue":25,"vendorSKU":"9876543-001-43","year":"2021"}],"market":"Sweden","orderType":"Standard","statements":[{"customFields":"{}","name":"Cart Discount","priceNet":159.2,"priceVat":39.8,"type":6}],"type":1}]'
[
{
"cancelledDate": "null",
"channel": 1,
"completedDate": "2022-08-17T17:00:00+02:00",
"createdDate": "2022-08-17T10:53:53+02:00",
"currencyCode": "SEK",
"customerName": "B2B Company Inc",
"deliveryDate": "2021-11-15T10:15:30Z",
"externalCostCenterID": "OL",
"externalCustomerID": "1234-567",
"externalInfo": "{}",
"externalParentID": "string",
"externalRowID": "string",
"externalStoreID": "store101",
"externalTransactionID": "779644",
"id": 42,
"items": [
{
"ageGroup": "Senior",
"brandName": "ACME",
"category": "Sneakers",
"collection": "SS21",
"color": "Black",
"costPrice": 45.5,
"costPriceCurrency": "USD",
"customFields": "{}",
"deliveryWindow": "IMMEDIATE",
"ean": "7340192703345",
"externalID": "99887766",
"externalItemID": "779644-1000",
"fulfillmentType": 0,
"gender": "gender",
"key": "7340192703345",
"moneyDiscount": 380,
"moneyItemTotalNet": 3040,
"moneyItemTotalVat": 760,
"primaryWarehouseExternalID": "central-ws",
"productGroupID": "123456",
"productName": "Petter",
"productType": 1,
"quantity": 1,
"season": "Spring/Summer",
"shipments": [
{
"externalWarehouseID": "central-ws",
"quantity": 1,
"shipmentDate": "2022-08-17T16:50:50+02:00",
"shipmentID": "779644-1"
}
],
"size": "43",
"sku": "123456-001-43",
"supplier": "Acme Enterprises AB",
"variantGroupID": "123456-001",
"variantName": "Petter Black",
"vatValue": 25,
"vendorSKU": "9876543-001-43",
"year": "2021"
}
],
"market": "Sweden",
"orderType": "Standard",
"statements": [
{
"customFields": "{}",
"name": "Cart Discount",
"priceNet": 159.2,
"priceVat": 39.8,
"type": 6
}
],
"type": 1
}
]
[
{
"cancelledDate": "null",
"channel": 1,
"completedDate": "2022-08-17T17:00:00+02:00",
"createdDate": "2022-08-17T10:53:53+02:00",
"currencyCode": "SEK",
"customerName": "B2B Company Inc",
"deliveryDate": "2021-11-15T10:15:30Z",
"externalCostCenterID": "OL",
"externalCustomerID": "1234-567",
"externalInfo": "{}",
"externalParentID": "string",
"externalRowID": "string",
"externalStoreID": "store101",
"externalTransactionID": "779644",
"id": 42,
"items": [
{
"ageGroup": "Senior",
"brandName": "ACME",
"category": "Sneakers",
"collection": "SS21",
"color": "Black",
"costPrice": 45.5,
"costPriceCurrency": "USD",
"customFields": "{}",
"deliveryWindow": "IMMEDIATE",
"ean": "7340192703345",
"externalID": "99887766",
"externalItemID": "779644-1000",
"fulfillmentType": 0,
"gender": "gender",
"key": "7340192703345",
"moneyDiscount": 380,
"moneyItemTotalNet": 3040,
"moneyItemTotalVat": 760,
"primaryWarehouseExternalID": "central-ws",
"productGroupID": "123456",
"productName": "Petter",
"productType": 1,
"quantity": 1,
"season": "Spring/Summer",
"shipments": [
{
"externalWarehouseID": "central-ws",
"quantity": 1,
"shipmentDate": "2022-08-17T16:50:50+02:00",
"shipmentID": "779644-1"
}
],
"size": "43",
"sku": "123456-001-43",
"supplier": "Acme Enterprises AB",
"variantGroupID": "123456-001",
"variantName": "Petter Black",
"vatValue": 25,
"vendorSKU": "9876543-001-43",
"year": "2021"
}
],
"market": "Sweden",
"orderType": "Standard",
"statements": [
{
"customFields": "{}",
"name": "Cart Discount",
"priceNet": 159.2,
"priceVat": 39.8,
"type": 6
}
],
"type": 1
}
]
{
"error": "Error Type (if any)",
"message": "Message describing the error",
"statusCode": 400
}