Skip to content

← Back

Receipt of Waste - API Production Approval Tests

When you’ve completed developing and testing your integration, please send a test submission for each of these scenarios and note down the corresponding Waste Tracking ID’s so we can review.

Sending Production Approval Tests

Email the corresponding Waste Tracking IDs used for each of these scenarios to: WasteTracking_Developers@defra.gov.uk. You can use the same Waste Tracking ID for multiple scenarios. You won't have a Waste Tracking ID for the error scenarios, so in this case, just advise the time tested.

The scenarios to be demonstrated are:
- R01 Basic Waste receipt - single waste item
- R02 Basic waste receipt - with multiple waste items
- R03 Basic Waste receipt - with means of transport ‘Road’
- R04 Basic waste Receipt - with no 'Disposal or Recovery’ codes
- R05 Basic waste Receipt - with multiple 'Disposal or Recovery’ codes
- R06 Basic waste Receipt - with multiple receiver authorisation numbers
- R07 Basic waste Receipt - with Mirror EWC codes
- C01 Basic waste Receipt - with no Carrier details and no reason (ERROR)
- C02 Basic waste Receipt - with no Carrier details and reason
- B01 Basic waste Receipt - with a Broker / Dealer
- P01 POPs Waste Receipt - multiple POPs components
- H01 Hazardous Waste Receipt - multiple hazardouse components
- H02 Hazardous Waste Receipt - with no Consignment Note Code and no reason
- H03 Hazardous Waste Receipt - with no Consignment Note Code and a reason
- X01 Hazardous & POPs Waste Receipt

Below are a list of Gherkin style Scenarios outlining, in a behavioural sense, the scenarios to be demonstrated. As a quick note on Gherkin Scenarios:
- ”Scenario” - A title for Given, When, and Then combinations illustrating a behaviour that can occur within a system
- ”Given” - A precondition step outlining a state a system needs to be in
- ”When” - An action step that can be carried out by a user/actor within a system
- ”Then” - An expectation step of what should be achieved by the combination of the Given and When steps

The following is not an exhaustive set of tests and you will be expected to review our documentation in full to ensure that you have integrated as per the specification.

Feature: Basic Receipt of Waste Scenarios

As a user,
I want to submit a basic waste movement receipt,
so that I can record the receipt of non-hazardous waste.

Scenario: Submit basic receipt of waste with single waste item (R01)

Given I have authenticated
And I have a basic waste movement
And there is a single waste item
And there is an accompanying ‘Disposal or Recovery’ code
And there are no POPs properties
And there are no Hazardous properties
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Scenario: Submit basic receipt of waste with multiple waste items (R02)

Given I have authenticated
And I have a basic waste movement
And there are multiple waste items
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Scenario: Submit basic receipt of waste with Road transport (R03)

Given I have authenticated
And I have a basic waste movement
And the means of transport is ‘Road’
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Scenario: Submit basic receipt of waste with no Disposal or Recovery codes (R04)

Given I have authenticated
And I have a basic waste movement
And there are no accompanying ‘Disposal or Recovery’ codes
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID
And I should receive a warning about missing codes

Scenario: Submit basic receipt of waste with multiple Disposal or Recovery codes (R05)

Given I have authenticated
And I have a basic waste movement
And there are multiple accompanying ‘Disposal or Recovery’ codes
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Scenario: Submit basic receipt of waste with multiple receiver authorisation numbers (R06)

Given I have authenticated
And I have a basic waste movement
And there are multiple receiver authorisation numbers
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Scenario: Submit basic receipt of waste with Mirror EWC codes (R07)

Given I have authenticated
And I have a basic waste movement
And there is a Mirror / Dual EWC code
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Feature: Carrier Details Scenarios

As a user,
I want to submit a receipt of waste with appropriate carrier information,
so that the movement is properly documented and compliant.

Scenario: Submit receipt of waste with no carrier details and no reason (C01)

Given I have authenticated
And I have a basic waste movement
And there are no carrier details
And no reason is provided
When I attempt to submit the waste movement receipt
Then the waste movement receipt should be rejected
And I should receive an error message

Scenario: Submit receipt of waste with no carrier details but with reason (C02)

Given I have authenticated
And I have a basic waste movement
And there are no carrier details
And a reason is provided
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Feature: Broker/Dealer Scenarios

As a user,
I want to submit waste movement receipts involving brokers or dealers,
so that all parties in the waste movement chain are properly recorded.

Scenario: Submit receipt of waste with Broker/Dealer involvement (B01)

Given I have authenticated
And I have a basic waste movement
And there is a Broker/Dealer involved in the movement
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Feature: POPs Waste Scenarios

As a user,
I want to submit waste movement receipts containing POPs components,
so that persistent organic pollutants are properly tracked and managed.

Scenario: Submit receipt of waste with multiple POPs components (P01)

Given I have authenticated
And I have a basic waste movement
And it contains multiple POPs Components
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Feature: Hazardous Waste Scenarios

As a user,
I want to submit waste movement receipts containing hazardous components,
so that hazardous waste is properly classified and tracked.

Scenario: Submit receipt of waste with multiple hazardous components (H01)

Given I have authenticated
And I have a basic waste movement
And it contains multiple Hazardous Components
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Scenario: Submit receipt of hazardous waste with no Consignment Note Code and no reason (H02)

Given I have authenticated
And I have a basic waste movement
And it contains Hazardous Components
And there is no Consignment Note Code
And no reason is provided
When I attempt to submit the waste movement receipt
Then the waste movement receipt should be rejected
And I should receive an error message

Scenario: Submit receipt of hazardous waste with no Consignment Note Code but with reason (H03)

Given I have authenticated
And I have a basic waste movement
And it contains Hazardous Components
And there is no Consignment Note Code
And a reason is provided
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Feature: Combined Hazardous and POPs Scenarios

As a user,
I want to submit waste movement receipts containing both hazardous and POPs components,
so that complex waste streams are properly classified and tracked.

Scenario: Submit receipt of waste with both hazardous and POPs components (X01)

Given I have authenticated
And I have a basic waste movement
And it contains Hazardous Components
And it contains POPs components
When I submit the waste movement receipt
Then the waste movement receipt should be created
And I should receive a Waste Tracking ID

Technical Exemptions

The following scenarios may be exempted if the integrating system doesn’t handle these specific waste types or business processes, you will need to provide rationale/evidence for any of these exemptions when applying to go into production:

Scenario Technical Exemption
R02 If all entities that use the software only handle one waste item per receipt
R05 If all entities that use the software only record one DoR per receipt
R07 If all entities that use the software only receive non-hazardous waste
B01 If all entities that use the software never receive waste from brokers/dealers
P01 If all entities that use the software never receive waste containing POP’s
H01, H02 If all entities that use the software never receive hazardous waste
X01 If all entities that use the software never receive both types of waste

If your circumstances change at any point, you will need to:
a) Let us know immediately.
b) Test your software against the additional categories otherwise your users may not be able to fulfil their obligations and may be at risk of being non-compliant.