Easy Production Sync

• Download new orders (order files, photos, and invoices) from GotPhoto to your local hard drive
• Send status updates and tracking details back to our servers about your processed orders

When you first open the app, you’ll be prompted to log in. Please use the same email address and password that you use to log into your GotPhoto account.

Note: you won’t be able to log into the app unless you already have a lab added to your account, i.e. you must have the Production tab visible in your GotPhoto account.

After logging in, you will see the main screen:

The main screen consists of three parts:

1. Order Download: This button can be toggled on and off to download orders.
2. Status Sync: This button can toggle the status updates on and off.
3. Debug Messages: This is where messages about events happening in the app (orders downloading, status updates, errors, etc.) will appear.

Within the settings, you will see two selections under Order Download:

• Check every…: From this dropdown, you can specify how often you want the app to check for and download new orders.
• Download Files: Here you will select the folder where you want the orders (order file, photos, and delivery notes) to download. 

After selecting a destination folder, go back to the main screen, and toggle the Order download on. When you have new orders, they will be downloaded into the specified folder.

There is a set of advanced features that you can use for downloading orders. This will be necessary if you need the order file, photos, and delivery notes to be saved separately in different locations on your hard drive. It will also allow you to customize how the downloaded files and folders are named.

To access the advanced settings, toggle the “Show Advanced Settings” button in the Order Download section on the settings page.

In the advanced settings, direct shipping and batch shipping orders are handled separately:

Select the folders where you want the order files, photos, and delivery notes for direct shipping and batch shipping orders to be stored on your local hard drive. You need to select folders to be able to start downloading orders from the main screen.

There are also placeholders, which you can use as variables in the folder paths you specify. 

Go back to the main screen and toggle the order download, and if you have new orders, they will be downloaded into the specified folders.

You will also need to indicate what should happen to the status files once they’ve been processed by the app. The app can either:

• Append “.done” to the filename, or
• Delete the files

Once you’ve set your status sync settings, you can go back to the main screen and toggle Status Sync on. The application will automatically parse all files with .json or .xml extensions from the folder you selected in the settings screen every few seconds.

Note: the frequency of status updates is unrelated to the time duration you have selected for order downloads.

To be able to parse status update files, they need to be in a particular format: 

• A status file in .json formatshould have an array called ‘orders’. Within this array, there should be objects that have their ‘id’ and ‘status’ fields set. For example, this is a valid status file in .json format:

  {
    "orders": [
  
      {
  
        "id": "CICA1009",
  
        "status": "production",
  
        "date": "2019-07-22",
  
        "time": "14:43:42"
  
      },
  
      {
  
        "id": "CICA1006",
  
        "status": "production",
  
        "date": "2019-07-22",
  
        "time": "14:43:42"
  
      }
  
    ]
  
  }

• A status file in .xml format should also have an ‘orders’ tag, with individual orders within, that have ‘id’ and ‘status’ fields:

  <?xml version="1.0" encoding="utf-8"?>
  
  <orders>
  
  <order>
  
  <id>CICA1009</id>
  
  <status>production</status>
  
  <date>2019-07-22</date>
  
  <time>14:43:42</time>
  
  </order>
  
   
  
  <order>
  
  <id>CICA1006</id>
  
  <status>production</status>
  
  <date>2019-07-22</date>
  
  <time>14:43:42</time>
  
  <trackingservice>DHL</trackingservice>
  
  <trackingnumber>123456789</trackingnumber>
  
  <trackingurl></trackingurl>
  
  </order>
  
  </orders>

The order IDs in the above examples can have the lab prefix before the order ID, but it’s NOT a requirement. 
Both ‘CICA1009’ and ‘1009’ are valid IDs. 

You can see more detailed logging by toggling Verbose logging in the top right corner of the main screen:

Errors will automatically be flagged in red.

All orders in the Debug Messages section also include a hyperlink to the order within your GotPhoto account for easy access and troubleshooting.

These order logs are stored locally as well, you can find them in the following location:

• On MacOs: ~/Library/Logs/easyproduction/
• On Windows: %USERPROFILE%\AppData\Roaming\easyproduction\logs\

As always, please feel free to reach out to our Customer Care team with any questions.