Recipe & Menu Engineering Import API Release Notes

Overview

This page explains the changes that have happened to our Recipe & Menu Engineering Import API since August 2020.

These Release Notes are up-to-date at the time of the release. Further improvements or corrections to our API documentation will normally occur in the guide and reference only.

If you have already integrated with Fourth would like to be kept abreast of API changes via email, please fill in this form.

26 August 2020 — New endpoints for ingredient costs and price bands

Two new endpoints have been introduced to GET ingredient costs and price bands.

Ingredient costs

The new endpoint is:

  • GET [ROOT]/ingredientcosts

By default, this returns details for all ingredients. You can filter the response using query parameters:

  • lastModifiedAfter — Returns only records modified on or after the date. Use the format: yyyy-mm-dd
  • groupGuid — The logical business grioup within Recipe & Menu Engineering.
  • productId or GUID — The unique identifier
  • setType — The ingredient set type, if these are in use. Options are: Blank, Trial, Archive, and Live.

This returns the existing and pending price details for an ingredient. If there is no value for a price it will be set to 0.00; for a date it will be set to null. For example:

[
  {
    "SupplierName": "The Vegan Butcher",
    "SupplierCode": "12A4D63C",
    "StarChefKey": 213,
    "ProductGUID": "a429bf60-bd54-4b82-8e28-151c4d94a1fb",
    "IngredientCostPrice": "13.99",
    "PendingIngredientCostPrice": "25.00",
    "PendingCostEffectiveDate": "8/21/2020 12:00:00 AM",
    "InvoicePrice": "0.00",
    "PendingInvoicePrice": "0.00",
    "PendingInvoicePriceEffectiveDate": null
  }
]

For more information on this endpoint, please see the API guide and reference.

Ingredients price band

The new endpoint is:

  • GET [ROOT]/ingredientspriceband

By default, this returns details for all ingredients. You can filter the response using query parameters:

  • lastModifiedAfter — Returns only records modified on or after the date. Use the format: yyyy-mm-dd
  • groupGuid — The business group within Recipe & Menu Engineering.

 

26 August 2020 — New batch endpoint for checking request processing

For successfully submitted POST requests, Fourth returns a status in the synchronous response body. For example:

{
  "Status": "Processed;Aug 10 2020 8:32AM",
  "BatchId": "2345"
}

The two possible states are Processed (with a timestamp) and Not processed. To check the processing status later, you can now use the /batches endpoint:

[ROOT]/api/ingredientandaccessimport/batches

You can filter the response by individual request; for example:

[ROOT]/api/ingredientandaccessimport/batches?batchId=3722

Or filter by the number of results want returned (from 1 to 100). For example, this returns the last processing status of the last two requests made:

[ROOT]/api/ingredientandaccessimport/batches?batchSize=2

Sample response:

[
  {
    "Status": "Not processed",
    "BatchId": 3724
  },
{
    "Status": "Processed;Aug 28 2020  8:32AM",
    "BatchId": 3722
  }
]

26 August 2020 — New Units of Measure

New Units of Measure

Fourteen new standard RME UoMs (units of measure) have been created. These UoMs are compatible for use with the Inventory application.

Unit Name (RME)

Unit Type (RME)

Unit Abbreviation

Equates to [number + UoM]

KEG (D) 1/2

Volume

KEG (D) 1/2

1984 Floz (US)

KEG (D) 1/4

Volume

KEG (D) 1/4

992  Floz (US)

KEG (D) 1/6

Volume

KEG (D) 1/6

661 Floz (US)

KEG (I) 1/2

Volume

KEG (I) 1/2

1690.70 Fl oz (US)

KEG (I) 1/3

Volume

KEG (I) 1/3

1014.42 Fl oz (US)

KEG (I) 1/4

Volume

KEG (I) 1/4

845.35 Fl oz (US)

PACK Each PK 1 Each

TRAY

Each

TRAY

1 Each

SHEET

Each

SHT

1 Each

Pan 1/3 4 " Deep

Volume

Pan 1/3 x 4"

4.5 Quarts (US)

PAN 1/6 6" Deep

Volume

Pan 1/6 x 6"

2.5 Quarts (US)

Quart, Dry (US)

Volume

QT, Dry (US)

37.2364 Fl oz (US)

Bushel

Volume

BU

1191.57 Fl oz (US)

BARREL

Volume

BRL

5376 Fl oz (US)