--- title: "PUT /movements/{wasteTrackingId}/receive" method: PUT path: "/movements/{wasteTrackingId}/receive" --- # PUT /movements/{wasteTrackingId}/receive `PUT /movements/{wasteTrackingId}/receive` Endpoint used to update a waste movement record that has already been submitted. It uses the waste tracking ID (wasteTrackingId) returned when the POST endpoint successfully submitted the original waste movement record. The waste tracking ID must be used in the URL path. ## Path parameters - `wasteTrackingId` string, required ## Request body - object - `apiCode` string, uuid, required — This is the unique sixteen byte identifier of the receiving organisation produced by the registration process found within the Waste Tracking Service. - `dateTimeReceived` string, date-time, required — This is the date and exact time waste was received at the site. This API uses the UTC ISO 8601 and BST standards for machine-readable dates and times.

Key Differences:

UTC is the global time standard and does not observe daylight saving time. BST is UTC+1, used in the UK during daylight saving time (typically from late March to late October). - `hazardousWasteConsignmentCode` string — Hazardous waste consignment code. If the EWC is HAZ, then this field is mandatory.

England & Wales:

Format- XXXXXX/YYYYY

Where XXXXXX can be a mixture of letters and/or numbers, i.e. alphanumeric.

The consignment note code must follow the format- XXXXXX/YYYYY.

The first XXXXXX part is made up of six alphanumeric characters and must be followed by a forward slash /

The YYYYY part is a five alphanumeric character unique identifier of the users' choice (no spaces or symbols).

Scotland

Format- SA, SB or SC followed by a 7-digit number (e.g. SB1234567). Also known as Special Waste Consignment Note

Northern Ireland and Eire:

Format- DA, DB or DC followed by a 7-digit number (e.g. DA5301234)

More information here

Business Rules:

- `reasonForNoConsignmentCode` 'Non-Haz Waste Transfer' | 'No documentation provided with Waste' | 'Household Waste Recycling Centre Receipt' — If you have not provided a hazardous waste consignment code, then there are three reason codes you can choose to provide. See the table below.
Reason Reason Code
Non-Haz Waste Transfer NON_HAZ_WASTE_TRANSFER
No documentation provided with Waste NO_DOC_WITH_WASTE
Household Wast Recycling Centre Receipt HWRC_RECEIPT
Note: The field is case-sensitive, please use the case for the code specified in the table.

Business Rules:

- `yourUniqueReference` string — This could be a unique weighbridge ticket number, waste transfer note number etc. - `otherReferencesForMovement` object[] — Optional array of label-reference pairs for additional tracking information - `label` string, required — The type/label of the reference (e.g., 'PO Number', 'Waste Ticket', 'Haulier Note') - `reference` string, required — The actual reference value - `specialHandlingRequirements` string — Required when abnormal hazardous waste and some non-hazardous waste contains harmful chemical, biological or physical characteristics that require some special handling to prevent harm. - `wasteItems` WasteItem[], required - `ewcCodes` string[], required — An EWC code is a six digit code listed in the European Waste Catalogue (EWC) and the List of Wastes Regulations 2005 for the UK. The EWC catalog is a list of waste types which categorise waste based on a combination of what they are and the process or activity that produces them.

Notes:
- users must already know their correct code before using the API
- the GET ewc-codes method returns a reference for all EWC codes
- there is no maximum number of waste items that can be entered per movement, but there is a maximum of five EWC codes that can be applied to each waste item, thus allowing for multiple EWC codes on some edge cases e.g. Clinical Waste

To find an EWC code for a particular waste item, refer to the official Waste Classification Technical Guidance WM3 document.

POPs can also be present in hazardous and non-hazardous waste. See wasteItem.containsPops and wasteItem.pops for more information.

Business Rules:

- Must be six digits (no spaces) and be in the official wasteItem.ewcCode EWC catalog EUR-Lex.
- From one to a maximum of five codes per movement can be provided.

- `wasteDescription` string, required — A detailed description of a specific waste material including its physical characteristics, composition and any potential hazards associated with it. - `physicalForm` 'Gas' | 'Liquid' | 'Solid' | 'Powder' | 'Sludge' | 'Mixed', required — This is the form of the waste. This could be a Gas, Liquid, Solid, Powder, Sludge or Mixed.

Business Rule:

Must be “Gas”, “Liquid”, “Solid”, Powder”, “Sludge” or “Mixed”. Note: The field is case-sensitive, please use the case specified in the description. - `numberOfContainers` integer, required — Number of containers for storing, transporting and disposing of waste materials.

Business Rule:

This must be a non-negative integer (0 or greater). - `typeOfContainers` string, required — Containers are receptacles used for storing, transporting and disposing of waste materials. They come in various sizes and types, ranging from small desk-side bins to large industrial skips. Enter the container code, e.g. DRU for Drum.

Notes:
- A list of all container types can be obtained using the GET container-types method.
- The field is case-sensitive, please use the case specified for the code returned by the GET method.

Business Rule:

Must be in typeOfContainers list. - `weight` Weight, required - `metric` 'Grams' | 'Kilograms' | 'Tonnes', required — Unit of measurement in which the waste is being accepted.

Business Rule:

Must be “Grams”, “Kilograms” or “Tonnes” - `amount` number, required — Total weight of the waste in a unit specified - Grams - Kilograms - Tonnes

Business Rule:

Must be a positive number (greater than 0). Note-

Weight in terms of the Waste Item is the total weight of the waste being received.

Weight in terms of the DisposalRecoveryCode is the total weight of the waste being disposed of or recovered for final treatment.

- `isEstimate` boolean, required — Specifies whether the weight of waste is estimated. This a boolean value, i.e. true for estimated or false for not estimated. - `containsPops` boolean, required — Does the waste consignment contain POPs? This should be a boolean value, i.e. true or false. Persistent organic pollutants (POPs) are chemical substances that do not break down in the environment. They are a danger to human health and the environment. POPs can be present in hazardous and non-hazardous waste. - `pops` object - `sourceOfComponents` 'NOT_PROVIDED' | 'PROVIDED_WITH_WASTE' | 'GUIDANCE' | 'OWN_TESTING', required — Indicates the source of POP component details. - NOT_PROVIDED: Carrier did not provide component details - PROVIDED_WITH_WASTE: Components provided with the waste - GUIDANCE: Components determined from guidance - OWN_TESTING: Components determined from own testing

Note: The field is case-sensitive, please use the case specified in the list above.

Business Rules:

- `components` object[] — The list of POP components.

Business Rules:

- `code` string, required — The code of the POP (Persistent Organic Pollutant) component. Notes:
- A list of POP names and codes can be obtained using the GET pop-names method.
- The field is case-sensitive, please use the case specified for the code returned by the GET method.

Business Rule:

Optional field. If provided, it must be a valid POP code from the reference list returned by the GET method. The code is validated against reference data to ensure accuracy. - `concentration` number — The concentration of the POP in mg per kg, e.g. 50 mg per kg of Chlordane.

Business Rule:

Optional field. If provided, must be a positive decimal number (greater than 0) - `containsHazardous` boolean, required — Does the waste consignment contain Hazardous Properties, true or false?. This is a mandatory indication. This is a boolean value, i.e. true (contains hazardous properties) or false (does not contain hazardous properties). - `hazardous` object - `sourceOfComponents` 'NOT_PROVIDED' | 'PROVIDED_WITH_WASTE' | 'GUIDANCE' | 'OWN_TESTING', required — Indicates the source of hazardous component details. - NOT_PROVIDED: Carrier did not provide component details - PROVIDED_WITH_WASTE: Components provided with the waste - GUIDANCE: Components determined from guidance - OWN_TESTING: Components determined from own testing

Business Rules:

- `hazCodes` string[] — Hazardous property codes are a list of codes that identify the hazardous waste and the potential risks associated with waste materials, guiding their safe transportation and handling protocols. Common types could include codes, HP_1 - HP_15. The format of the code to be entered is HP_'number', e.g. HP_1 for Explosive, HP_2 for Oxidizing, etc.

The official hazardous code list is found here in Appendix C: Waste Classification Technical Guidance WM3 document.

Notes:

Business Rule:

If wasteItem.containsHazardous is true then wasteItem.hazardous.hazCodes must be a valid code. - `components` object[] - `name` string, required — Name of the hazardous component, e.g. Mercury.

Business Rule:

Optional field. If provided, must be a valid chemical or biological component name. - `concentration` number — The concentration of the hazardous component in milligrams per kilo, e.g. 30mg per kg.

Business Rule:

Optional field. If provided, must be a positive numeric value (greater than 0). - `disposalOrRecoveryCodes` DisposalOrRecoveryCode[], required - `code` string, required — Disposal and Recovery Codes play a crucial role in categorising the methods by which waste is managed, whether through recovery or disposal processes. These codes (Recovery (R) and Disposal (D)) serve as a standardised system to ensure proper handling and treatment of waste materials. Specifically, they aid in classifying whether waste is to be recovered for further use or disposed of in a safe and environmentally responsible manner.

Notes:

Business Rule:

If disposalOrRecoveryCode.code entered, then it should be in the disposalOrRecoveryCode.code listed in EUR-Lex. - `weight` Weight, required - `metric` 'Grams' | 'Kilograms' | 'Tonnes', required — Unit of measurement in which the waste is being accepted.

Business Rule:

Must be “Grams”, “Kilograms” or “Tonnes” - `amount` number, required — Total weight of the waste in a unit specified - Grams - Kilograms - Tonnes

Business Rule:

Must be a positive number (greater than 0). Note-

Weight in terms of the Waste Item is the total weight of the waste being received.

Weight in terms of the DisposalRecoveryCode is the total weight of the waste being disposed of or recovered for final treatment.

- `isEstimate` boolean, required — Specifies whether the weight of waste is estimated. This a boolean value, i.e. true for estimated or false for not estimated. - `carrier` Carrier, required - `registrationNumber` string, nullable, required —

A waste carrier registration number is a legal requirement for businesses that transport, buy, sell or dispose of waste. This license ensures that waste is handled and transported in a responsible and environmentally friendly manner.

Home Nations Codes:

General Format where 9 is a digit 0-9

Wales NRW:

CBDL9, CBDL99, CBDU999 (1+ digits)

i.e. CBDU999999 (Upper Tier) or CBDL999999 (Lower Tier), where "CBD" stands for "Carrier, Broker, Dealer"

England:

CBDL9, CBDL99, CBDU999 (1+ digits)

i.e. CBDU999999 (Upper Tier) or CBDL999999 (Lower Tier), where "CBD" stands for "Carrier, Broker, Dealer"

Scotland SEPA:

WCR/R/9999999, SCO/999999, SEA/999999, SNO/999999, SWE/999999, WCR/999999, PCT-X-999, PCT-X-9999, PCT-X-99999, PCT-X-999999 and PCT-X-9999999 (where X = a single capital letter and 9 = a single numeral of between 3 and 7 digits in length).

Typically starts with WCR followed by numbers and potentially letters according to the Scottish Environment Protection Agency (SEPA).

Current format – WCR/R/1234567

Previous formats – SCO/123456, SEA/123456, SNO/123456, SWE/123456, WCR/123456, PCT-E-083, PCT-N-0050000

Northern Ireland NI

ROC UT 9,ROC UT 99,ROC UT 999,ROC UT 9999,ROC UT 99999, ROC LT 9, ROC LT 99, ROC LT 999, ROC LT 9999, ROC LT 99999

Include a prefix like ROC followed by UT (Upper Tier) or LT (Lower Tier) and then numbers. Note the spaces are not mandatory.

For example: ROC UT 9999 ROCLT9999

General Format where 9 is a digit 0-9

- `reasonForNoRegistrationNumber` string — If you have not provided a registration number, then here you must provide an appropriate reason code from the list below:

Business Rules:

- `organisationName` string, required — The business name of the carrier. - `address` Address - `fullAddress` string — The business location address of the carrier or broker/dealer. - `postcode` string, required — A valid postcode must be included.

Note-

Carriers, Brokers/Dealers accept UK and Irish post codes. - `emailAddress` string, email — The email address of the carrier. - `phoneNumber` string — The UK or international phone number of the carrier. - `vehicleRegistration` string — This is the carrier's vehicle registration number.

Business Rules:

- `meansOfTransport` 'Road' | 'Rail' | 'Air' | 'Sea' | 'Inland Waterway' | 'Piped' | 'Other', required — This describes how the waste is transported (road, rail, air, sea, piped, inland waterway, other) Note: The field is case-sensitive, please use the case specified in the business rule.

Business Rule:

Must be either Road, Rail, Air, Sea, “Inland Waterway”, Piped or Other. - `brokerOrDealer` BrokerOrDealer - `organisationName` string, required — The broker or dealer organisation name who arranged this transfer. - `address` Address - `fullAddress` string — The business location address of the carrier or broker/dealer. - `postcode` string, required — A valid postcode must be included.

Note-

Carriers, Brokers/Dealers accept UK and Irish post codes. - `emailAddress` string, email — The email address of the broker or dealer. - `phoneNumber` string — The phone number of the broker or dealer. - `registrationNumber` string —

A waste broker or dealer who buys or sells waste or arranges the buying, selling or disposal of waste must be registered. Upon registration, a registration number is given to the organisation.

Home Nations Codes:

General Format where 9 is a digit 0-9

Wales NRW:

CBDL999999, CBDU999999

i.e. CBDU999999 (Upper Tier) or CBDL999999 (Lower Tier), where "CBD" stands for "Carrier, Broker, Dealer"

England:

CBDL999999, CBDU999999

i.e. CBDU999999 (Upper Tier) or CBDL999999 (Lower Tier), where "CBD" stands for "Carrier, Broker, Dealer"

Scotland SEPA:

WCR/R/9999999, SCO/999999, SEA/999999, SNO/999999, SWE/999999, WCR/999999 and PCT-X-999, PCT-X-9999, PCT-X-99999, PCT-X-999999 and PCT-X-9999999 (where X = a single capital letter and 9 = a single numeral of between 3 and 7 digits in length).

Typically starts with WCR followed by numbers and potentially letters according to the Scottish Environment Protection Agency (SEPA).

Current format – WCR/R/1234567

Previous formats – SCO/123456, SEA/123456, SNO/123456, SWE/123456, WCR/123456, PCT-E-083, PCT-N-0050000

Northern Ireland (NI)

ROC UT 9,ROC UT 99,ROC UT 999, ROC UT 9999, ROC UT 99999, ROC LT 9, ROC LT 99, ROC LT 999, ROC LT 9999, ROC LT 99999

Include a prefix like ROC followed by UT (Upper Tier) or LT (Lower Tier) and then numbers. Note that spaces are not mandatory.

ROC UT 9999 ROCLT9999

Note: where 9 is a digit 0-9

- `receiver` Receiver, required - `siteName` string, required — The name of the site receiving the waste. - `emailAddress` string — The email address of the organisation receiving the waste. - `phoneNumber` string — The UK or Irish phone number of the organisation receiving the waste. - `authorisationNumber` string, required — This is the site's authorisation (permit) number that allows it to accept waste for intended recovery and disposal operation. Only one authorisation number is required per site.

Home Nations Codes:

(where 9 is a digit 0-9, X is a letter A-Z)

England:

Scotland (SEPA):

Wales (NRW):

Northern Ireland (NRI):

Business Rules:

- `regulatoryPositionStatements` integer[] — An array of regulatory position statement (RPS) numbers. A regulatory position statement is issued when the Regulator (EA, SEPA, NIEA, NRW), doesn't require you to have a permit to carry out certain activities that they regulate. The statement will explain which activities you do not require a permit for. Each must be a positive integer.

Business Rule:

Must be positive integers (greater than 0). - `receipt` Receipt, required - `address` ReceiptAddress, required - `fullAddress` string, required — This is the address the waste is received at. - `postcode` string, required — A valid postcode must be included.

Note-

Carriers, Brokers/Dealers accept UK and Irish post codes. Receivers accept only UK post codes.

Business Rule:

Must be in specified receiptAddress.postcode format. ## Response `200` The waste movement receipt has been updated. - object - `validation` object - `warnings` ValidationResult[] - `key` string - `errorType` string — can be one of the following type: - NotProvided: A required field was not provided - NotAllowed: The value provided is not allowed - InvalidType: The value provided is of the wrong type - InvalidFormat: The value provided is not in the correct format - InvalidValue: The value provided is not valid based on the business rules - OutOfRange: The value provided is outside the allowed range - BusinessRuleViolation: The value provided violates a specific business rule. - `message` string — Waste description is/is not successfully stored. ## Other responses - `400` — Input was not in the correct format. - `404` — Movement not found. The waste tracking ID used is not correct. --- [API](https://skmtc.net/defra/apis/digital-waste-tracking-receipt-api.md) · [All operations](https://skmtc.net/defra/apis/digital-waste-tracking-receipt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/defra/digital-waste-tracking-receipt-api/versions/752d63fbbe3b/schema)