Madden Analytics API

Create/Update Purchase Orders in batch

POST /v1/purchaseorders/batch

Create or replace existing Purchase Orders with updates. Can be done in batch. Max size 500. 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

externalPONo is required when updating/replacing a PurchaseOrder

cancelledDate string
completedDate string
deliveryStatus number

Status of the Delivery (0: Not Delivered, 1: PartiallyDelivered, 2: FullyDelivered, 3: Cancelled)

Default value is 0.
deliveryWindow string

Delivery Window of the Purchase Order
externalComment string

Any relevant comment
externalPurchaseNo string

External Purchase No
factory string

Factory of the Purchase Order
id integer

Maddens Purcher Order id
items array[object]

The items on the Purchase Order
Hide items attributes Show items attributes object
- brandName string
  
  Name of the products brand
- deliveries array[object]
  Hide deliveries attributes Show deliveries attributes object
  
  deliveryDate string
  
  The date of the event
  
  deliveryID string
  
  Extenal ID of the delivery
  
  quantity integer
  
  Quantity delivered for the event
- deliveryDate string
  
  (Original) DeliveryDate is the initial date that the purchase order item is expected to be delivered. (arrive)
- departureDate string
  
  (Original) DepartureDate is the initial date that the purchase order item is expected to leave warehouse.
- ean string
  
  EAN of variant
- externalRowID string
  
  External id for row
- externalWarehouseID string Required
  
  Extermal ID of the warehouse (leave the warehouse)
- key string Required
  
  Key, used as a reference to source system.
- productName string
  
  Name of product
- quantity integer
  
  Quantity ordered
- revisedDeliveryDate string
  
  RevisedDeliveryDate is the "actual" date that the purchase order item is expected to be delivered (arrive). Same as ETA
- revisedDepartureDate string
  
  RevisedDepartureDate is the "actual" date that the purchase order item is expected to leave warehouse. Same as ETD
- sku string
  
  SKU of variant. Should be unique per size/variant
- supplier string
  
  Name of the products supplier
- totalPriceCurrency string
  
  Currency of order totals
- totalPriceNet number
  
  Net total of row
- totalPriceVat number
  
  Total VAT of row
label string

External Description/Label of PO
orderDate string Required

Date that the Purchase Order was created
orderType string

Order Type of the Purchase Order
transportMethod string

Transport Method of the Purchase Order

Responses

• 200

OK
Hide response attributes Show response attributes object
- message string
- reference string
- referenceField string
- statusCode integer
• default

All errors will return the same object with a describing code & message
Hide response attributes Show response attributes object
- message string
- reference string
- referenceField string
- statusCode integer

POST /v1/purchaseorders/batch

curl \
 -X POST https://ma-api.maddenanalytics.com/v1/purchaseorders/batch \
 -H "Authorization: $API_KEY" \
 -d '[{"cancelledDate":"2021-07-19T14:05:22.257Z","completedDate":"2021-07-19T14:05:22.257Z","deliveryStatus":10,"deliveryWindow":"SS24","externalComment":"AW21 - Footwear","externalPurchaseNo":"PO-14534","factory":"Factory B","id":42,"items":[{"brandName":"Acme","deliveries":[{"deliveryDate":"2021-10-13T09:05:14.113Z","deliveryID":"RP-14534","quantity":4}],"deliveryDate":"2021-07-19T14:05:22.257Z","departureDate":"2021-07-19T14:05:22.257Z","ean":"7340192703345","externalRowID":"21020","externalWarehouseID":"ecom","key":"7340192703345","productName":"Petter","quantity":4,"revisedDeliveryDate":"2021-07-19T14:05:22.257Z","revisedDepartureDate":"2021-07-19T14:05:22.257Z","sku":"123456-001-43","supplier":"Factory B","totalPriceCurrency":"EUR","totalPriceNet":180,"totalPriceVat":0}],"label":"string","orderDate":"2021-03-19T14:05:22.257Z","orderType":"Standard","transportMethod":"Air"}]'

Request example

[
  {
    "cancelledDate": "2021-07-19T14:05:22.257Z",
    "completedDate": "2021-07-19T14:05:22.257Z",
    "deliveryStatus": 10,
    "deliveryWindow": "SS24",
    "externalComment": "AW21 - Footwear",
    "externalPurchaseNo": "PO-14534",
    "factory": "Factory B",
    "id": 42,
    "items": [
      {
        "brandName": "Acme",
        "deliveries": [
          {
            "deliveryDate": "2021-10-13T09:05:14.113Z",
            "deliveryID": "RP-14534",
            "quantity": 4
          }
        ],
        "deliveryDate": "2021-07-19T14:05:22.257Z",
        "departureDate": "2021-07-19T14:05:22.257Z",
        "ean": "7340192703345",
        "externalRowID": "21020",
        "externalWarehouseID": "ecom",
        "key": "7340192703345",
        "productName": "Petter",
        "quantity": 4,
        "revisedDeliveryDate": "2021-07-19T14:05:22.257Z",
        "revisedDepartureDate": "2021-07-19T14:05:22.257Z",
        "sku": "123456-001-43",
        "supplier": "Factory B",
        "totalPriceCurrency": "EUR",
        "totalPriceNet": 180,
        "totalPriceVat": 0
      }
    ],
    "label": "string",
    "orderDate": "2021-03-19T14:05:22.257Z",
    "orderType": "Standard",
    "transportMethod": "Air"
  }
]

Response examples (200)

[
  {
    "message": "Missing BrandName",
    "reference": "123456-001-43",
    "referenceField": "key",
    "statusCode": 400
  }
]

Response examples (default)

[
  {
    "message": "Missing BrandName",
    "reference": "123456-001-43",
    "referenceField": "key",
    "statusCode": 400
  }
]