This guide helps you get started testing integrations in our sandbox environment, where you can freely experiment with the API without affecting production data.
Please note that this is an advanced guide, which requires experience in setting up an API integration!
Important: This guide requires that you already have access to the sandbox and have set up the API.
Preparation: Create master data before testing
Before testing, you need to create the basic master data before testing the EUDR endpoint.
Follow the steps below:
1. Create a supplier
Use the endpoint
/companiesand specify type:"supplier".Add relevant custom fields (e.g. whether the supplier uses ASN). Please note that custom fields can currently only be created via the UI – not via API.
Remember to specify an
external_id, typically your ERP creditor number.
2. Create a data model for products
This can be done via the UI or API. Once the data model is created, you need to:
Retrieve your data models to find the
data_model_id.Retrieve your document types to find the type ID for “products.”
3. Create a product
Use the endpoint
/documents.Specify
data_model_idanddocument_type_id.Create a few test products.
Remember to link the product to the supplier through the field
company, using theexternal_idyou provided when creating the supplier.Also, give the product an
external_idfrom your product catalog.
Test with transaction data
Once the master data is ready, you can start testing with transaction data.
Use the EUDR endpoint, which represents a purchase order.
Do not use
associated_ddsandlocationsat the root of the object.Instead, use batches, which correspond to order lines.
If your order line already contains an EDI reference number, you can include it in
associated_ddsinside the batches – otherwise, this field can be omitted.If the item comes from outside the EU, use
locationsto specify the location (however, this is not part of the current test).Always refer to products and suppliers by using their
external_idfrom your ERP system.
Support and questions
If you encounter any issues or have questions along the way, feel free to contact us.
Reach out via the chatbot in the lower-right corner or at support@prduct.com