...
For additional information or to be set up with fDaemon for your fulfillment lab, please contact your sales rep. or account manager.
Order Status
...
Updates
fDaemon can be used to post order status updates to the platform by creating simple JSON text files dropped into a hotfolder than fDaemon monitors.
Filenames
Status Update JSON files should have the following naming scheme:
...
For example, if Mugs 'r Us (8600) is fulfilling order #23051234 placed on the ABC Photo (6301) site, the filename would be:
23051234.8600.6301.json
JSON Text File Content
The contents of the JSON file are the same payload as would be sent to the Photo Finale API3 UpdateOrders endpoint.
Code Block |
---|
{
"DealerCode": "9071",
"Status": "Complete",
"OrderLineItemList": [ id, id, id, ... ],
"ProductList": [ id, id, id, ... ],
"StationLocation": id
"TrackingInfo": {
"CarrierName": "UPS",
"TrackingNumber": "12345",
"TrackingURL": "https://ups.com/track/12345"
}
} |
For descriptions of the fields and a list of accepted status values, please see this page: Updating Order Status.
You will need Wiki credentials to access this page. If you have not been given credentials, please contact your Photo Finale representative.
Notes
- The following fields and nodes are optional:
- OrderLineItemList
- ProductList
- StationLocation
- TrackingInfo
- The DealerCode in the text file is your fulfiller dealer code.
- If either the OrderLineItemList or ProductList fields is not included, the status update will apply to all products in the order to be fulfilled by the fulfilling dealer.
- The optional ProductList node allows the status update to be applied to only those line items which match the specified list of products.
- The optional OrderLineItemList allows the status update to be applied to only those individual line items specified in the list by ID number. Each line item has a unique ID number provided in the original order metadata xml.
- TrackingInfo is should only be sent when sending Status "Complete".
- Within the TrackingInfo node, the TrackingURL field is optional.
Status Values
The following are the valid values for the Status field. Many of these statuses are optional. Most fulfillment orders only go through the basic, highlighted statuses.
ID | Value | Description |
---|---|---|
12 | "OrderSubmitted" | Order Placed [internal PF status] |
13 | "Queued" | Order Processing [internal PF status] |
0 | "New" | Order Available for Fulfillment Lab |
20 | "PreparingOrder" | Preparing for Production |
25 | "PreparationComplete" | Order Ready for Production |
30 | "ImageCorrection" | Color Correction In Progress |
35 | "Printing" | Order in Production |
1 | "Printed" | Order Produced |
40 | "ProductionComplete" | Order Produced, Ready for Quality Check |
45 | "QualityAssurance" | Quality Review In Progress |
50 | "QualityAssuranceComplete" | Quality Review Passed |
55 | "InTransitToStore" | In Transit to Pickup Store |
3 | "Complete" | Order Ready for Pickup / Order Shipped |
2 | "Cancelled" | Order Cancelled |
Shipping Carriers
These are the valid values for the optional "CarrierName" field:
- USPS
- UPS
- UPS Mail Innovations
- Canada Post
- DHL
- FedEx
- FedEx SmartPost
- GLS
- Intelcom
- LSO
- OnTrac
- Purolator
- Spring GDS
- AustPost (AU)
- Express Post (AU)
- Fastway Couriers (AU)
- Interparcel (AU)
- TNT (AU)
- MRW España (ES)
- InPost Paczkomaty (PL)
- 99 Minutos (MX)
- AMPM (MX)
- Carssa (MX)
- PaqueteExpress (MX)
- Redpack (MX)
- Estafeta (MX)
- NZ Couriers (NZ)
- NZ Post (NZ)
- Post Haste (NZ)
- DPD (UK)
- Royal Mail (UK)
- (Other)
Additional carriers can be added by request.