Shopify/PDFDataNet Documentation
This page will guide you through the automation of your Shopify store, with the help of our PDFDataNet solution.
Configuration Instructions
1. Request A New Template
What we require from you:
- 3-5 Source File Examples (for PDF’s please give us a variation of order’s that go onto one and also multiple pages, where possible)
- Up-to-date exports of your Customer and Product lookup files (see 2. Export A Customer Lookup File and 3. Export A Product Lookup File for instructions on how to do this).
- Any extra information that you deem relevant/useful for us know when building your new template.
2. Export A Customer Lookup File
Please follow the instructions provided by Shopify here.
3. Export A Product Lookup File
Please follow the instructions provided by Shopify here (Make sure to use the Plain CSV file option): https://help.shopify.com/en/manual/products/import-export/export-products#export-your-products
Once your system is configured, you’ll be able to click on the the ‘refresh product lookup’ URL provided to you by our team, to update the product lookup file from your Shopify store (if you’ve lost this please open a support ticket on the Portal).
4. Update Customer/Product Lookup Files
- Follow the steps in 2-3 on this page on how to export the relevant, new lookup files.
- Login to the Support Portal and send us the new exports as attachments, we will do the rest for you.
Messages & Errors Explained
If none of the solutions below resolve your issue, please get in touch via the Support Portal.
#MAK001 - Order Not Attached
The Error
An email was submitted for order processing but the email did not include an attached order file.
Common Fixes
Please make sure that any email sent for order processing has the order attached.
#MAK002 - Shopify Order Creation Failed
The Error
The order failed at order creation.
Common Fixes
Please check the email sent, notifying of the error, for the error description.
#MAK003 - Order Processed Before
The Error
The order submitted for processing has already been processed previously.
Common Fixes
Please check the email sent notifying the error for the date when the order was previously processed.
#MAK004 - Invalid Product Code
The Error
The order submitted for processing has an invalid product not found in the Shopify Store.
Common Fixes
Incorrect data in your exported product lookup: Please make sure this is corrected in your Shopify store. Once done, follow the instructions under “3. Export A Product Lookup File”. The order must be re-submitted.
#MAK005 - Invalid Product Variant
The Error
The order submitted for processing has an invalid product variant not found in the Shopify Store.
Common Fixes
Incorrect data in your exported product lookup: Please make sure this is corrected in your Shopify store. Once done, follow the instructions under “3. Export A Product Lookup File”. The order must be re-submitted.
#MAK006 - No Pay As You Go Credits Available
The Message
An order was submitted for processing but there were no Pay As You Go credits available.
Contact the OiC accounts team to top-up your Pay As You Go credits.
#MAK007 - Subscription Has Expired
The Message
An order was submitted for processing but your Subscription has expired.
Contact the OiC accounts team to renew your Subscription to continue to use the service.
#PDN000 - Order File Not Recognised
The Error
You have received this error because the order could not be recognised in our PDFDataNet program. This could either be because we haven’t created a template for this order or because the ADR (automatic document recognition) text, that is determined, cannot be found in the document.
Common Fixes
Please note: We advise you to check what it says in the error email you’ve received from us, under the “Error description” section. As this will provide better context for why this field couldn’t be determined, for example if it’s due to a default value set in the template or something to do with another variable field.
- Changing ADR Text: Open a new support ticket on the Portal, make sure to attach your order file, we will then look to check the ADR text set for this template and modify where required.
- Template Creation: Open a new support ticket on the Portal using the category “New Template”, make sure to attach 3-5 order file examples (please include at least one where it goes onto multiple pages – if this exists) and let us know you would like a template created.
#PDN001 - Shopify Client ID
The Error
You have received this error because the Shopify Client ID couldn’t be determined, this can be due to a number of reasons.
Common Fixes
Please note: We advise you to check what it says in the error email you’ve received from us, under the “Error description” section. As this will provide better context for why this field couldn’t be determined, for example if it’s due to a default value set in the template or something to do with another variable field.
- Necessary information not present in order: Contact your customer and ask them to add the relevant information to future order’s.
- Data missing from your exported customer lookup: Please make sure this is updated and added via your Shopify store. Once done, follow the instructions under “2. Export A Customer Lookup File”.
- PDFDataNet not extracting data from the order: Open a new support ticket on the Portal, make sure to attach your source file along with a description of the issue (what we’re extracting incorrectly/what it should be extracting), so that we can investigate this further for you.
- PDFDataNet haven’t hard-coded a default value for a template: Open a new support ticket on the Portal and let us know what the default value for the Shopify Client ID should be. Please note that this is only possible if the default value is the same for all orders, otherwise we need to use another variable field (such as the Shipping Post Code) to do a conversion on the data, using the customer lookup.
#PDN002 - Shopify SKU Code
The Error
You have received this error because the Shopify SKU Code couldn’t be determined, this can be due to a number of reasons.
Common Fixes
Please note: We advise you to check what it says in the error email you’ve received from us, under the “Error description” section. As this will provide better context for why this field couldn’t be determined, for example if it’s due to a default value set in the template or something to do with another variable field.
- Necessary information not present in order: Contact your customer and ask them to add the relevant information to future order’s.
- Data missing from your exported product lookup: Please make sure this is updated and added via your Shopify store. Once done, follow the instructions under “3. Export A Product Lookup File”.
- PDFDataNet not extracting data from the order: Open a new support ticket on the Portal, make sure to attach your source file along with a description of the issue (what we’re extracting incorrectly/what it should be extracting), so that we can investigate this further for you.
#PDN003 - Unit Price Ex Tax
The Error
You have received this error because the Unit Price Ex Tax couldn’t be determined, this can be due to a number of reasons.
Common Fixes
Please note: We advise you to check what it says in the error email you’ve received from us, under the “Error description” section. As this will provide better context for why this field couldn’t be determined, for example if it’s due to a default value set in the template or something to do with another variable field.
- Necessary information not present in order: Contact your customer and ask them to add the relevant information to future order’s.
- Data missing from your exported product lookup: Please make sure this is updated and added via your Shopify store. Once done, follow the instructions under “2. Export A Product Lookup File”.
- Data missing from another lookup file: Please make sure that we have a copy of the latest/up-to-date lookup files from you (for example a Catolog Pricing lookup).
#PDN004 - Shipping Post Code
The Error
You have received this error because the Shipping Post Code couldn’t be determined, this can be due to a number of reasons.
Common Fixes
Please note: We advise you to check what it says in the error email you’ve received from us, under the “Error description” section. As this will provide better context for why this field couldn’t be determined, for example if it’s due to a default value set in the template or something to do with another variable field.
- Necessary information not present in order: Contact your customer and ask them to add the relevant information to future order’s.
- Data missing from your exported customer lookup: Please make sure this is updated and added via your Shopify store. Once done, follow the instructions under “2. Export A Customer Lookup File”.
- PDFDataNet not extracting data from the order: Open a new support ticket on the Portal, make sure to attach your source file along with a description of the issue (what we’re extracting incorrectly/what it should be extracting), so that we can investigate this further for you.
