Meat Messaging Data upload API

Issue Date: 20200423

The Meat Messaging Upload API provides a simple method to upload messages about a consignment.

Recommended Method

The recommended method involves performing a HTTP post of either a JSON or XML payload to a designated endpoint

• Validation Endpoint (validates the payload without commiting data - for testing): https://api.meatmessaging.info/v1/message/validate
• Process Endpoint (validates and commits data): https://api.meatmessaging.info/v1/message/process

The detailed explanation of the JSON data elements within the payload is available here: https://www.meatmessaging.info/json_api_format.asp

The detailed explanation of the XML data elements within the payload is available here: https://www.meatmessaging.info/xml_email_format.asp

An API demo page is available here: https://dl.meatmessaging.info/view/api-upload-demo

The API documentation is available via Swagger UI located at https://api.meatmessaging.info/

Legacy Method

This data upload provides an HTTP Multiform Post interface to upload data directly into the Meat Messaging system in the form of a file upload. The content type of this form is: multipart/form-data.

• XML File Upload Endpoint: https://meatmessaging.info/api/mpprocessfile.aspx

The detailed explanation of the XML data elements within the payload is available here: https://www.meatmessaging.info/xml_email_format.asp

The parameters related to the XML upload include:

• A 12 character API key (also referred to as the 'Meat Messaging Company Email Send Code') shown on the company page.
• tx_function - Control function 0,1,2,3.
• tx_rffaak - Message reference.
• tx_filename - The file name. This file name should comply with the File naming conventions as described.
• tx_file - The local file path of the file to be uploaded. This should be a fully qualified path name. The file should contain data that comply with the spec for meat messaging.

The XML filename must follow a 2 part convention and naming rules:

• MMCID. 8-digit company identification value unique to each establishment e.g. 10000016.
• RFFAAK. Company specific reference number e.g. 093123450000017555
• File name length must not exceed 64 characters.

Example XML file name: 10000016-093123450000017555.XML

An XML API demo page is available here: https://www.meatmessaging.info/api/uploadtest.html