Path parameters

• externalPurchaseNo string Required

  External Purchase Number

Query parameters

• productFields array[string]

  Fields of the product each line points at to return in its productFields object (LineProduct). Repeat the parameter once per field: ?productFields=size&productFields=color. The values are the product as it is now, not as sent with the order; a field the product has no value for (an empty text included) is left out, numbers are returned as stored (0 included), and productFields is left out for a line whose key matches no product. info, customFields and externalAttributes can make the response much larger

• global string

  Find the purchase order under any api key. If several match, the caller's own is returned, otherwise the most recently updated. Default = false

Responses

• 200 application/json

  OK

  Hide response attributes Show response attributes object

  • cancelledDate string
  • completedDate string
  • createdAt string

    Date the Purchase Order was created in Madden

  • 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

      External ID of the warehouse (leave the warehouse)

    • fromExternalWarehouseID string

      From Warehouse External ID (accepted but not exposed)

    • id integer
    • key string Required

      Key, used as a reference to source system.

    • productFields object

      The SKU the key points at as it is now, with the fields named in productFields. Absent when productFields is not sent or the key matches no SKU. Read-only: ignored when sent on a write.

      Hide productFields attributes Show productFields attributes object

      • ageGroup string

        AgeGroup associated with the product

      • brandName string

        Name of the products brand

      • categoryName string

        Category of product

      • collection string

        Collection that the product belongs to

      • color string

        Color associated with the variant

      • costPrice number

        CostPrice of the variant

      • costPriceCurrency string

        CostPriceCurrency of the variant

      • customFields object

        Custom fields of the product (json)

      • department string

        Department associated with the product

      • ean string

        EAN of variant

      • endDate string

        Date the SKU stops selling (YYYY-MM-DD)

      • externalAttributes object

        External attributes of the product (json)

      • gender string

        Gender associated with the product

      • imageUrl string

        Image of the product

      • info object

        Any info / data needed by the integration (json)

      • key string

        Key used between products, transaction & stock tables, without the season on accounts with versions

      • moq integer

        Minimum Order Quantity of variant

      • packsize integer

        Packsize

      • productGroupID string

        ProductGroupID is used to group products together within Madden

      • productMoq integer

        Minimum Order Quantity of product

      • productName string

        Name of product

      • productType number

        Type of product (1: Normal/standard, 2: Commission, 3: Local)

      • productionLeadTimeDays integer

        Production lead time of the SKU in days

      • season string

        Season that the product belongs to

      • shippingLeadTimeDays integer

        Shipping lead time of the SKU in days

      • size string

        Size associated with the variant

      • sku string

        SKU of product. Unique per size/variant

      • startDate string

        Date the SKU starts selling (YYYY-MM-DD)

      • status number

        Status of the variant (1: Inactive, 2: Active, 3: Outgoing)

      • subCategory string

        Subcategory of product

      • supplier string

        Supplier of the product

      • supplierPrice number

        Price to produce

      • supplierPriceCurrency string

        Currency to produce

      • unitVolume number

        Unit volume of the product in meters (l*w*h) (CBM)

      • variantExternalID string

        ID of variant in external platform

      • variantGroupID string

        VariantGroupID is used to group variants

      • variantName string

        Name of specific variant

      • vatValue number

        Vat Value is the percentage of VAT

      • vendorSKU string

        Vendors SKU if using own sku structure

      • weight number

        Weight of the product in kilograms (kg)

      • year string

        Start of the products life-cycle

    • 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

    • season string

      Season that the key belong to. Only used for product versioning.

    • 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

  • maDraftPurchaseNo string

    Madden draft Purchase No the order was sent from. Replaces the order Madden sent (batch and create only, not stored)

  • 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

  • updatedAt string

    Date the Purchase Order was last updated in Madden

• default application/json

  All errors will return the same object with a describing code & message

  Hide response attributes Show response attributes object

  • error string
  • message string
  • statusCode integer